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 imagemconsta 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 imagemconsta as informações itens dos apontamentos: Insumos, Campos/Talhões e Máquinas/Patrimônio.
No item 3 da imagemconsta 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.