Manual do Usuário Solução para Integração B2B Siagri x Conecta BASF Thiago Borges de Oliveira thiago.oliveira@siagri.com.br AGOSTO/2009
Sumário 1 Introdução 2 2 Configurando o exportador 2 3 Informando os Parâmetros da Exportação 2 4 Informando as Empresas 3 5 Informando os Grupos 4 6 Informando os Fabricantes 4 7 Preenchendo a Planilha da Sterling 5 8 Automatizando a Exportação 5 9 Arquivos de Logs Gerados 6 10 Envio de E-Mail 7
1 Introdução Este manual aborda a configuração do Siagri Agribusiness para que seja feita a exportação de dados para o integrador Conecta da BASF. As próximas seções tratarão a respeito da configuração das empresas, fornecedores BASF, Grupos de produtos e configuração da Planilha da Sterling. Conceitos usados neste manual: Função do tipo de operação: Função cadastrada no formulário Tran121, identificando quais tipos de operações compõem um determinado saldo. Como exemplo tem-se a função de Estoque - Devoluções, na qual o tipo de operação 20-Venda Normal adiciona e o 40-Devolução de venda subtrai o saldo da função. Tarefas agendadas: Função do sistema operacional Windows que permite que o usuário agende tarefas (aplicativos) para serem executadas em intervalos de tempo. 2 Configurando o exportador A configuração dos parâmetros para exportação dos dados para o Integrador Conecta é feita no módulo Integração Fornecedores - BASF, que está disponível no Login do sistema, através da opção: Escolhendo a opção BASF no menu será apresentada uma tela com um botão no centro, referente a Exportação Conecta. Duas opções são exibidas ao clicar neste botão: Configuração Conecta: Para abrir a tela de configuração e Exportar dados para Conecta: Para executar a exportação manualmente. Ao clicar no botão de configuração será apresentada uma tela com cinco abas, onde serão informados os seguintes dados: Parâmetros: Configuração dos parâmetros gerais e campos opcionais. Empresas: Quais empresas terão seus dados exportados. Grupos: Quais grupos de produtos são do fabricante BASF. Fabricantes: Quais são os parceiros Fabricantes BASF (Matriz e Filiais). Preencher planilha: Rotinas que auxiliam o preenchimento das informações na planilha fornecida pela Sterling. 3 Informando os Parâmetros da Exportação A configuração dos parâmetros da exportação é feita através da aba Parâmetros. É utilizada para informar como obter as quantidades de vendas, compras e devoluções, bem como os campos opcionais que serão enviados durante a exportação do arquivo:
1. Função de estoque para Vendas: A função do estoque que possui os tipos de operações relacionados que correspondem as vendas menos as devoluções de vendas. Por padrão é informado o código 102. 2. Função de estoque para Compras: A função do estoque que possui os tipos de operações relacionados que correspondem as compras menos as devoluções de compras. Por padrão é informado o código 2. 3. Diretório do Integrador BASF para gravar os arquivos: Diretório onde serão gravados os arquivos da exportação. 4. Tipo Arquivo Destino: Esta configuração é informada pela empresa Sterling. Deve-se preencher com BASF, a menos que a Sterling solicite alteração. 5. Campos opcionais arquivo de Nota Fiscal: Estes campos são opcionais e podem ou não ser enviados. Fica a critério do cliente ativar ou não. Deve-se alterar a planilha Sterling para refletir as opções marcadas/desmarcadas. 6. Exportar Clientes: Se esta opção for desmarcada, as informações do arquivo de Clientes não serão exportadas. Estas informações incluem Nome do Cliente, CPF/CNPJ e Endereço completo. 7. Exportar Inventário: Se esta opção for desmarcada, as informações de estoque não serão exportadas. Estas informações incluem a quantidade de entradas e saídas e a quantidade em estoque dos produtos BASF. 4 Informando as Empresas Na aba Empresa devem ser informadas quais empresas terão seus dados exportadas para o Conecta.
Para incluir uma empresa clique no botão Incluir. Será apresentada uma tela de pesquisa. Posicione na empresa desejada e clique em Fechar. É possível incluir várias empresas de uma só vez. Para isso, utilize a tecla Ctrl enquanto seleciona com o mouse ou Shift com seta para baixo. Para remover uma empresa, selecione-a na grade e em seguida clique no botão Remover. 5 Informando os Grupos Na aba Grupos devem ser informados quais grupos de produtos possuem os produtos BASF. Somente os produtos que estão configurados neste Grupo serão exportados. Há ainda o filtro de Fabricante, na seção a seguir. De forma que mesmo se neste grupo existirem produtos de outros fabricantes que não seja BASF, os mesmos devem ser informados. Para incluir um grupo clique no botão Incluir. Será apresentada uma tela de pesquisa. Posicione no grupo desejado e clique em Fechar. É possível incluir vários grupo de uma só vez. Para isso, utilize a tecla Ctrl enquanto seleciona com o mouse ou Shift com seta para baixo. Para remover um grupo, selecione-o na grade e em seguida clique no botão Remover. 6 Informando os Fabricantes Na aba Fabricantes devem ser informadas quais são os parceiros que são Fabricantes BASF. Somente serão exportados os produtos dos Grupos (seção anterior) e Fabricantes informados nesta tela.
Para incluir um parceiro clique no botão Incluir. Será apresentada uma tela de pesquisa. Posicione no parceiro desejado e clique em Fechar. É possível incluir vários parceiros de uma só vez, da mesma forma que Empresas. Para remover um parceiro, selecione-o na grade e em seguida clique no botão Remover. 7 Preenchendo a Planilha da Sterling Na aba Preencher Planilha estão disponíveis alguns botões para auxiliar no preenchimento da planilha enviada pela Sterling. Ao clicar em cada botão os dados serão copiados para a Área de Transferência do computador. É o mesmo que você tivesse efetuado um Editar/Copiar ou ainda Ctrl+C nos dados do respectivo botão. Com os dados copiados, mude o foco para a planilha, selecione a respectiva Guia e cole os dados utilizando o comando Ctrl+V ou Editar/Colar. Existe uma opção para o botão Produtos especificando que tipo de Embalagem será exportada. Isto fará os cálculos para exportar a fração correta da embalagem, conforme a opção escolhida: Básica, Primária ou Secundária. A informação do tamanho da embalagem pode ser encontrada no Cadastro de Produtos do sistema. 8 Automatizando a Exportação A automatização da exportação é feita pelo agendamento de tarefas do Windows. Para configurar siga os passos:
1. Abra o agendamento de tarefas em: Iniciar - Todos os Programas - Acessórios - Ferramentas do Sistema - Tarefas Agendadas; 2. Clique em Adicionar tarefa agendada; 3. No assistente exibido, clique em Avançar; 4. Escolher o programa a ser executado, clicando em Procurar e localizando o arquivo SAgrBASF.exe, que fica na pasta de instalação do Siagri Agribusiness, por padrão em c:\arquivos de Programas\Siagri\ Agribusiness\bin. 5. Digite o nome para a tarefa: Exportação para BASF ; 6. Escolha o período de execução Diariamente ; 7. Clique em Avançar e escolha a hora de início. Marque todos os dias e informe uma data de início; Atenção! Quando executado pelo agendador de tarefas, o exportador considera a data atual para exportação, desde que seja executado após às 18:00 hrs no horário local. Se for executado antes deste horário, serão exportados apenas as informações do dia anterior. Exemplo: Agendado para 17:30 (Dia 03/06/XXXX) - Só irá exportar os dados referentes a 02/06/XXXX Agendado para 18:01 (Dia 04/06/XXXX) - Irá exportar os dados referentes a 04/06/XXXX 8. Clique em Avançar e informe o nome do usuário e a senha. Este nome de usuário e senha será utilizado para executar a tarefa, mesmo se não houver um usuário logado no sistema. Este usuário deve ter permissão de executar o sistema e gravar arquivos no diretório do Integrador BASF. 9. Clique em Avançar, marque a opção Abrir as propriedades avançadas desta tarefa... e em seguida Concluir. 10. Na janela exibida, na caixa de texto Executar acrescente o texto: ExportaBasf. 11. Clique em Ok. Você pode testar a execução da tarefa, clicando com o botão direito do Mouse sobre a tarefa e escolhendo o menu Executar. A tarefa irá executar em background, sem que seja mostrada nenhuma janela ao usuário. Para verificar o andamento das tarefas serão gerados arquivos de log, conforme seção a seguir. 9 Arquivos de Logs Gerados Durante a execução como tarefa agendada, o exportador gera um arquivo de log para cada execução da exportação. Os arquivos de logs são colocados dentro de uma pasta chamada SAgrBasf, por padrão dentro da pasta de instalação do Siagri Agribusiness, em c:\arquivos de Programas\Siagri\Agribusiness\bin. Neste arquivo são listados a data do início e fim da exportação, as datas de movimentos exportados, as empresas e os produtos que foram processados durante o processo.
10 Envio de E-Mail Para cada problema encontrado durante a exportação será enviado um e-mail para o endereço cadastrado na etapa de configuração da exportação, aba Parâmetros. Para que este e-mail seja enviado é necessário configurar os parâmetros de comunicação, no módulo Transacionadores, pasta Cadastros\Configurações, aba Comunicação. Caso a exportação seja multi-empresa, deve-se configurar o parâmetro para cada uma das empresas.