Versions Compared

Old Version 2

changes.mady.by.user Maria Eduarda Battisti

Saved on

compared with

New Version 3

changes.mady.by.user Maria Eduarda Battisti

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  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.

    image-20241104-181240.png

  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.

    image-20241104-181515.png

  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.

    image-20241104-181532.png

  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

      image-20241104-181606.pngimage-20241104-181614.png

  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)

      image-20241104-181826.png

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

      image-20241104-181845.png

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

      image-20241104-181901.png

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

      image-20241104-181918.png

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

      image-20241104-181935.png

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

      image-20241104-182001.png

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

      image-20241104-182018.png

    8. Almoxarifado (Estoque » Basicos » Almoxarifado)

      image-20241104-182040.png

  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.

      image-20241104-182206.png

  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:

    image-20241104-193545.png

    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:

        image-20241104-193649.png

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

        image-20241104-193712.png

        image-20241104-193721.png

    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.

        image-20241104-193752.png

      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.

        image-20241104-193814.png

    3. Configurações gerais

      1. Configurador > Configurador Farmbox

        image-20241108-165943.pngImage 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.

    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:

      image-20241108-170932.pngImage Added

    6. Apontamentos excluídos:

      image-20241108-170948.pngImage Added

    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.

        image-20241108-171006.pngImage Added

    8. Tela de ajuste de atividade nos apontamentos:

      image-20241108-171036.pngImage Added

  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

Nome do Campo no Sistema

Funcionalidade

...