Integração UPCAMPO - ATF

Considerações iniciais

Atualmente, a integração com a upCampo, considera várias informações tabelas do sistema para trabalhar com apontamentos, que são levadas do Agrotitan Fazendas para a upCampo. As tabelas utilizadas são:

Cadastro de Produtos.
Cadastro de Fazendas.
Cadastro de Grupos/subgrupos.
Cadastro de Almoxarifados.
Cadastro de Máquinas.
Cadastro de Campos.
Cadastro de Variedades.
Cadastro de Pessoas.
Cadastro de Atividades.
Cadastro de Safras.
Cadastro de Culturas.

No entanto, é importante salientar que, atualmente, a única tabela que é de responsabilidade do sistema atualizar e enviar os cadastros, é a de Cadastro de Produto, dado o que foi combinado durante a análise que gerou esta integração. Também é necessário deixar claro que para o funcionamento correto da exportação dos produtos do Agrotitan Fazendas para a upCampo, é necessário estarem cadastrados os Grupos e Subgrupos dos produtos que serão utilizados na integração, porém, estas tabelas são de responsabilidade do cliente cadastrar manualmente junto a upCampo.

Os registros das demais tabelas, também deverão ser cadastrados manualmente junto a upCampo antes de rodar a integração.

Configuração Integração upCampo

Parametrizações Necessárias:

Acesse Configurador » Parâmetros do Servidor:
Configure os parâmetros abaixo:
- Mude o valor do parâmetro P_INTEGRACAO_LAVOURA_SOLUCAO para: upCampo;
- Mude o valor do parâmetro P_INTEGRACAO_LAVOURA_HOST para: https://api.upCampo.com.br;
- Mude o valor do parâmetro P_FARMBOX_BLOQUEIA_BTN_IMPORTAR para: N.

Cadastro de Credenciais Por Centro de Custo:

OBS.: Se o PSGA-Mãe estiver aberto antes do Passo 1, pressione CTRL + K antes de abrir a tela de Cadastro de Centro de Custos ou feche e abra o sistema.

Acesse PSGA » Ativos » Básicos » Centro de Resultados/Custos;
Na aba Geral - Outras Informações:
- Clique no Botão Credenciais;
- Na grid, a coluna Integração será preenchida automaticamente pelo parâmetro P_INTEGRACAO_LAVOURA_SOLUCAO, com o valor UP (de upCampo).
- Por hora só existe essa integração por centro de custo, portanto, só pode ser possível o cadastro de uma linha na grid por integração e centro de custo.
- Preencha a coluna Client_ID com o Client_ID de autenticação da upCampo (Client_ID será disponibilizado pela upCampo).
- Preencha a coluna Client_Secret com o Client_Secret de autenticação da upCampo (Client_Secret será disponibilizado pela upCampo).
- Após salvar a linha, os campos serão criptografados, salvos e prontos para serem utilizados na integração.

Configurações dos Produtos

Os produtos que serão exportados do Agrotitan Fazendas para a upCampo, serão somente os que pertencerem aos subgrupos configurados no sistema pela flag Exporta upCampo, portanto, os grupos/subgrupos devem estar devidamente cadastrados na upCampo. Para isso:
- Abrir o Agrotitan Fazendas;
- acessar a tela de Grupo produtos;
- selecionar o grupo na tela;
- marcar os subgrupos quais os produtos daquele subgrupo serão exportados (inserção, atualização e exclusão).

Configurações do PSGA-APP

Acesse o PSGA-APP;
Clique em mostrar ícones ocultos, localizado na barra de tarefas do Windows;
Clique no Ícone do PSGA-APP (símbolo do Android, de cor preta);
Clique e Configuração do APP;

Será aberta a tela de configuração do Robô PSGA-APP.
Estas configurações servem para realizar a ativação, controle de a partir de quando o bot será executado e o intervalo em que ocorrerá cada tarefa.
A coluna Rotina, é um combo-form com todas as rotinas de integração disponíveis no sistema. Para a upCampo, cadastramos a configuração apenas das seguintes rotinas:
- Integração upCampo - Importação (para importar as ordens de serviço da upCampo e transformá-las em apontamentos no sistema).
- Integração upCampo - Cadastros Básicos (realiza exportação dos produtos criados no Agritotan Fazendas para a upCampo no momento).
- Integração upCampo - Exportação (realiza a exportação dos saldos dos produtos por almoxarifado integrados com a upCampo).

Para começar a configuração, clique em “Pausar Robô” na aba “Opções” no canto superior esquerdo.

Verifique se já existem as linhas das integrações Integração upCampo - Importação, Integração upCampo - Cadastros Básicos e Integração upCampo - Exportação. Caso não existam, realize o cadastro das linhas, informando as colunas:
- Rotina, informando cada uma das rotinas supracitadas;
- A partir de, informando a data em que cada rotina será executada (pode ser a data próxima a implantação do Agrotitan Fazendas).
- Intervalo, deve ser o intervalo de tempo em horas que cada rotina será executada, no formato 00:00:00 (horas, minutos, segundos). Como sugestão, 3 horas para Importação e Cadastros básicos, e 24 horas para exportação (para enviar o saldo do produto pelo menos uma vez ao dia).
- Ativo, define se uma rotina será executada ou não durante a execução do Bot.
Também é necessário configurar as datas de filtragem dos processos contidos dentro das rotinas, através da configuração de Processos:
- Clique com o botão direito do mouse em cima de cada linha, e abra o menu “Config. Processos”;

Será aberta outra tela para configurações dos processos:

Para a rotina Integração upCampo - Importação:
- Configure o PROCESSO para “Importação - Apontamentos”.
- Configure a DATA FILTRO para a data inferior a data da primeira ordem de serviço agrícola criada na upCampo, ou uma data próxima à data de implantação do Agrotitan Fazendas.
- Clique em “OK”.
Para a rotina Integração upCampo - Cadastros Básicos:
- Configure o PROCESSO para “Cadastros Básicos - Produtos”.
- Configure a DATA FILTRO para a data inferior a data de implantação do Sistema.
- Clique em “OK”.
Para a rotina Integração upCampo - Exportação:
- Configure o PROCESSO para “Exportação - Saldo Produto”.
- Configure a DATA FILTRO para a data inferior a data de implantação do Sistema.
- Clique em “OK”.
OBS.: Confirme que Configuração de processos pertence a rotina que está sendo alterada.

Marque os flags “Ativo?” das três rotinas;
Por último, clique em “Ligar Robô”

Importação de Apontamento Automática (BOT):

A importação dos “apontamentos” na verdade é a importação das Ordens de Serviço da upCampo, que contém a estrutura parecida com a dos Apontamentos do Agrotitan Fazendas, contendo um Cabeçalho, os Insumos, Talhões e as Máquinas (execuções na upCampo).
Considerações:
- Serão importados para o Agrotitan Fazendas, somente Ordens de Serviço da upCampo com o status ‘Finalizado’, ou que eventualmente foram importadas para o sistema e depois excluídas.
- Se faz necessário o preenchimento completo das Ordens de Serviço na upCampo para a importação ser realizada com sucesso.
  - Produtos devem conter Local de Estoque e quantidade total maior que zero;
  - Talhões devem possuir Setor (Fazenda);

Dado que o PSGA-APP está com todos os serviços referentes a upCampo configurados, ligue o Robô;
Acesse PSGA » Lavoura » Movimentação/Lavoura » Integração Lavoura » Integração Automática upCampo;
Após passado o tempo do intervalo configurado, confira na tela de importação automática:
- Na aba Importação:
  - No grupo Importação, pode ser realizada a importação manual com a data inicial e final das Ordens de Serviço (upCampo) desde que:
    - O centro de custo logado esteja configurado com as credenciais;
    - Recomendado pausar o bot antes de realizar a importação manual;
  - No item 1 da imagem consta as importações das ordens de serviço da upCampo, para geração de apontamentos no Agrotitan Fazendas.
    - A grid em si serve para consulta da última importação realizada pelo bot. Nota que há um botão “Consultar”. Clique nele para exibir as últimas importações realizadas.
  - No item 2 da imagem consta as informações itens dos apontamentos: Insumos, Campos/Talhões e Máquinas/Patrimônio.
  - No item 3 da imagem consta as inconsistências das ordens de serviço importados da upCampo, que impedem a geração dos apontamentos no Agrotitan Fazendas. As inconsistências devem ser sanadas para que o apontamento seja gerado no Agrotitan Fazendas com sucesso. Mais informações no item 6. deste manual.

Na aba Importados, é possível verificar os apontamentos já importados, de acordo com os filtros utilizados.

Manual de Inconsistências:

Na tela Integração Automática upCampo, no canto inferior direito existe um Manual de Inconsistências;
Ao clicar no botão, irá abrir uma nova tela, como mostrado abaixo:

O manual de inconsistência serve como auxiliar para corrigir as inconsistências das importações de Ordens de Serviço da upCampo, que impedem a geração dos apontamentos no Agrotitan Fazendas.
Este manual é genérico para as integrações TBDC, FARMBOX e upCampo, por se tratarem da mesma rotina de geração de apontamentos do sistema.
Na coluna Código Integração e Descrição Integração, (T = TBDC, F= FARMBOX e U = upCampo). O mesmo serve para os campos de descrição.
Visualize a(s) inconsistência(s) gerada(s) na importação dos apontamentos, e busque o código neste manual. Consulte a coluna Explicação e Solução para tentar sanar a inconsistência.