Page Comparison

...

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.

          

Dicionário de Dados

...

Nome do Campo no Sistema

...

Funcionalidade

Erros Comuns

Versão

...

Lote

...

Versão do Sistema

...

Versão do Banco de Dados

...

Versão da Documentação

...

1. 1. Configurações gerais

      1. Configurador > Configurador Farmbox

         Image Added

      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.

   2. 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.

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

      Image Added

   4. Apontamentos excluídos:

      Image Added

   5. 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.

        Image Added

   6. Tela de ajuste de atividade nos apontamentos:

      Image Added

2. 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.

...

Versão