Integração FarmBox - ATF

Descrição

Índice

Pré-Requisitos

• É preciso que o usuário ative o exe (PSGA-FBX.exe);

• É configurável o intervalo de consulta;

• Irá importar apontamentos de todas as fazendas/unidade de negócios;

• A data para consulta “a partir de” é atualizada automaticamente, também pode ser alterada pelo usuário;

• Atualmente, a exportação é realizada somente pelo BOT.

• P_FARMBOX_ATIVIDADE_PADRAO - parâmetro para a atividade genérica que irá para os apontamentos

• P_FARMBOX_AUTHORIZATION - chave de autorização para acesso ao Farmbox

• P_FARMBOX_HOST - URL para integração - farmbox.cc

• P_INTEGRACAO_LAVOURA_SOLUCAO – FARMBOX

Passo a passo

1. Neste manual vamos falar sobre o processo de Integração Farmbox x Psga automático. Esse processo tem como objetivo a importação de apontamentos Farmbox para o PSGA e exportação de movimentação de produto, sem a interação de usuário nos dados.
   Orientações sobre integração automática do Farmbox:
   ⦁ É preciso que o usuário ative o exe (PSGA-FBX.exe);
   ⦁ É configurável o intervalo de consulta;
   ⦁ Irá importar apontamentos de todas as fazendas/unidade de negócios;
   ⦁ A data para consulta “a partir de” é atualizada automaticamente, também pode ser alterada pelo usuário;
   ⦁ Atualmente, a exportação é realizada somente pelo BOT.

2. Tela de Integração Automática Farmbox (Lavoura » Movimentação/Lavoura »
   Integração Automática Farmbox) nessa tela irá acompanhar as integrações e até
   identificar problemas seja de cadastros ou outros.

   

3. Abra o arquivo srvconnfb.dat no Database Explorer (o arquivo está na pasta Data
   do sistema).

4. Esse arquivo é semelhante ao srvconn.dat; a diferença é que o usuário informado
   será o utilizado para importação automática de apontamentos através do BOT. Essa
   configuração permite definir um usuário para salvar o log com o nome dele.

   

5. No campo FIELD_5 irá a senha do usuário que está salva na tabela SUSR - campo
   PWD. O sistema irá tratar essa senha.

   

6. Parâmetros do Farmbox
   Principais parâmetros para Farmbox: (PSGA-CFG » Configurador » Parâmetros do
   servidor)

   • P_FARMBOX_ATIVIDADE_PADRAO - parâmetro para a atividade genérica que irá
     para os apontamentos

   • P_FARMBOX_AUTHORIZATION - chave de autorização para acesso ao Farmbox

   • P_FARMBOX_HOST - URL para integração - farmbox.cc

   • P_INTEGRACAO_LAVOURA_SOLUCAO – FARMBOX

     

7. Configurações do código do farmbox nos cadastros
   Deve configurar o de para nas seguintes cadastros abaixo, ou seja, indicar o código
   Farmbox no PSGA:

   1. Produtos (Estoque » Básicos » Produtos)

      

   2. Bens (Ativo » Básicos » Cadastro de bens)

      

   3. Campos/Talhões (Lavoura » Básicos » Agrícolas » Cadastro de
      Campos/Talhões)

      

   4. Variedades (Lavoura » Básicos » Agrícolas » Cadastro de variedades)

      

   5. Safras (Lavoura » Básicos » Agrícolas » Cadastro de safras)

      

   6. Centro de Resultados/Custos (Ativo » Básicos » Centro de Resultados/Custos)

      

   7. Pessoas (lavoura » básicos » Pessoas)

      

   8. Almoxarifado (Estoque » Basicos » Almoxarifado)

      

8. Configurador Farmbox
   Acessar (PSGA-CFG » Configurador » Configurador Farmbox). Segue as
   orientações:

   1. Define o intervalo da execução da integração conforme volume de dados.

   2. Quando o campo Intervalo estiver com valor 0, não irá executar a importação ou exportação.

   3. O Responsável no grupo de Exportação, é o código Farmbox da pessoa que irá na movimentação. (não é obrigatório)

   4. Os campos “buscar a partir de” e “exportar a partir de” podem ser alterados pelo usuário, porém após a execução do bot são atualizados automaticamente.

      

9. A importação automática pode ser feita de duas formas:

   1. Pela tela de importação no PSGA

      1. O usuário só consegue importar apontamentos para a fazenda que está logado (unidade de negócio);

      2. A tela posiciona para data de filtro o dia de hoje; é possível alterar.

   2. Pelo BOT

      1. É preciso que o usuário ative o exe (PSGA-FBX.exe);

      2. É configurável o intervalo de consulta;

      3. Irá importar apontamentos de todas as fazendas/unidade de negócios;

      4. A data para consulta “a partir de” é atualizada automaticamente, também pode ser alterada pelo usuário;

   3. Atualmente, a exportação é realizada somente pelo BOT.

10. Notificações:

    

    1. notificação precisa ser cadastrada manualmente no usuário.
       Criei essa notificação padrão, ela está configurada para executar com intervalo de 1 hora, notificar
       apenas por e-mail os usuários selecionados.

       • Utilizar a query FARMBOX_NOTIFICACAO ou outra que atenda o usuário.

       • O e-mail do usuário destinatário está é informado no Configurador > Cadastro de Usuários.

       • O e-mail do remetente é configurado através de parâmetro:

         

       • Para a notificação executar precisa ter os executáveis NOTIFY e PSGA-BOT. O PSGA-BOT fica em
         execução.

         
         

    2. Usuário para importação

       1. Abra o arquivo srvconnfb.dat no Database Explorer (o arquivo está na pasta Data do sistema).

       2. Esse arquivo é semelhante ao srvconn.dat; a diferença é que o usuário informado será o utilizado para importação automática de apontamentos através do BOT. Essa configuração permite definir um usuário para salvar o log com o nome dele.

          

       3. No campo FIELD_5 irá a senha do usuário que está salva na tabela SUSR - campo PWD. O sistema irá tratar essa senha.

          

    3. Configurações gerais

       1. Configurador > Configurador Farmbox

          

       2. Quando o campo Intervalo estiver com valor 0, não irá executar a importação ou exportação.

       3. O Responsável no grupo de Exportação, é o código Farmbox da pessoa que irá na movimentação.

    4. Importação

       1. Informações adicionais:

          1. P_FARMBOX_ATIVIDADE_PADRAO - parâmetro para a atividade genérica que irá para os
             apontamentos

          2. Data de abertura e fechamento - pega os campos DATE (hora é a que está indo pro banco) e
             END_DATE (23:59) no JSON.

          3. Apontamento em aplicação - caso não trabalhe com esse status, o apontamento com situação
             “sought” ficará aberto até ser finalizado.

       2. Validações iniciais para importação:

          1. Essas validações são feitas através de queries, podendo ser personalizadas pelo usuário;
             analisam todos os apontamentos de uma vez. Mais à frente haverá validação individual.

             1. Apontamentos Farmbox sem movimentação de produtos e sem variedade informada nos
                campos não serão considerados; (DEPOIS_IMPORTACAO_APONTA_FARMBOX_GERAL)

             2. Em geral, validações de cadastros, configurações e vínculos nos cadastros.
                (VALIDA_APONTAMENTO_AUT_FARMBOX)

                • Fazenda Farmbox não vinculada a uma Unidade de Negócio;

                • Safra, Fazenda, Produtos e Atividades não configurados;

                • Variedade e Campo não configurados;

                • Produto, Almoxarifado e Unidade de Medida não configurados;

                • Produto com custo zero;

                • Máquina e Operador não configurados;

                • Operador não cadastrado como funcionário

                • Cadastros inativos: almoxarifado, produto, máquina, operador, atividade e variedade.

       3. Posiciona apontamento

          1. Após consultar servidor, preencher as tabelas de trabalho e tratar inconsistências iniciais,
             ocorrerá a geração de apontamentos.

          2. Nesse momento todos os apontamentos importados serão analisados individualmente. Entra nessa etapa os apontamentos que não apresentaram inconsistências na validação inicial. É verificado também se outro usuário está importando o apontamento posicionado (LWIMPAFB.IMPORTANDO).

       4. Avaliação individual de apontamento:

          • Fechamento contábil

          • Fechamento de almoxarifado

          • Bloqueio por lançamentos contábeis

          • Campos encerrados

          • Parâmetro e autorização para abrir apontamento

          • Data de proteção

          • Permissão usuário movimentar almoxarifado

          • Saldo futuro negativo RETORNA_PRODUTOS_LAPTPROD_DEVOLUCAO_FICARAO_NEGATIVO

       5. Depois de passar pelas validações acima, é feito o cadastro do apontamento:

          • LAPONTA - se existe, é alterado;

          • LAPTPROD - se existe o produto, exclui ele e lança novamente; no final exclui os produtos que
            não estão mais no apontamento Farmbox;

          • LAPTCAMP - se existe, é alterado; exclui os campos que não existem mais;

          • LAPTPATR - se existe, é alterado; exclui os bens que não existem mais;

       6. Após os cadastros, é realizada a validação com estoque:

          • Saldo insuficiente;

          • Saldo futuro negativo.

       7. Caso o apontamento tenha uma dessas situações, ele permanecerá aberto no PSGA.

       8. Se o apontamento está com status “sought”, no PSGA ele ficará “em aplicação”;

       9. Com status “finalized”, será fechado no PSGA.

       10. Movimenta o estoque, atualiza status no LAPONTA e guarda a data/hora de importação
           (LAPONTA.DT_UPDATE_FARMBOX).

       11. Desmarca na tabela de trabalho que apontamento está sendo importado.

    5. Tela de importação automática:

       

    6. Apontamentos excluídos:

       

    7. Apontamento que não foi importado e os motivos:

       • Não é possível corrigir na tela! Precisa acertar o cadastro no PSGA e importar novamente.

         

    8. Tela de ajuste de atividade nos apontamentos:

       

11. Exportação

    1. Toda movimentação de estoque no PSGA irá executar a query EXPORTACAO_FARMBOX.

    2. Nessa query, insere a movimentação em uma tabela de controle para o BOT consultar posteriormente.

    3. Para a movimentação ser exportada, verifica se o parâmetro P_FARMBOX_HOST está preenchido e se o produto e almoxarifado movimentado tem código Farmbox no cadastro.

Dicionário de Dados

Erros Comuns

Versão