TOTVS AGRO

Páginas filhas
  • Integração com TOTVS Agro Multicultivo

CONTEÚDO

  1. Visão Geral
  2. Pré-requisitos para TOTVS Connector Client
    1. O que é TOTVS Connector
    2. O que é TOTVS Connector Client? 
    3. Requisitos Mínimos de Instalação
    4. Requisitos de Ambiente / Infraestrutura
  3. Pré-requisitos para TOTVS Agro Multicultivo
    1. Versão Mínima
    2. Requisitos de Ambiente / Infraestrutura
  4. Configuração TOTVS Agro Multicultivo
    1. Sincronismo MDM
    2. Totvs Connector Client
  5. Configuração Meu Fitossanitário
    1. Leitura QR Code
    2. Observação para clientes Meu Fitossanitário
  6. Como enviar (sincronizar) registros
  7. Tabelas que possuem sincronismo e Pré-requisitos 
    1. TOTVS Agro Multicultivo
      1. Configuração de Local de Produção
      2. Cultura / Ocupação
      3. Variedade / Híbridos
      4. Safra / Ano Agrícola
      5. Período de Produção
      6. Unidade Administrativa
      7. Fazenda
      8. Setor
      9. Talhão
    2. Meu Fitossanitário
      1. Variáveis
      2. Inspeções
      3. Armadilhas
  8. Observações Importantes
    1. Registros dependentes mandados fora de ordem
    2. Tempo de envio dos dados

01. Visão Geral

A integração com TOTVS Agro Multicultivo tem como objetivo sincronizar os dados do Meu Fitossanitário com TOTVS Agro Multicultivo e vice-versa. Os dados (tabelas) possuem apenas uma direção de envio. Por exemplo, a tabela Fazenda é enviada do TOTVS Multicultivo para o Meu Fitossanitário (o tópico 5 apresenta as tabelas, suas direções e os pré-requisitos para envio). Como a tabela tem apenas uma direção de envio, a inserção e atualização dessa Tabela são feitas em apenas uma aplicação. Quando um registro da tabela for alterado (inserido, editado ou removido), o registro é enviado automaticamente para a aplicação correspondente.

02. Pré-requisitos para TOTVS Connector Client

  • O que é TOTVS Connector?

O TOTVS Connector é uma ferramenta que permite a integração entre softwares, não importando a forma de distribuição do software, ou seja, integra dados entre aplicações Cloud e aplicações On Premise e vice-versa.

Como assim?

Por meio de dois componentes dispostos em ambientes diferentes, é possível uma aplicação On Premise ficar sincronizada com um aplicação em Cloud. Um desses componentes é o TOTVS Connector Client, que é instalado no ambiente On Premise / Private Cloud. O outro componente é o TOTVS Connector Server, gerenciado pela TOTVS, é o responsável de receber todo fluxo de dados. Portanto, será necessário apenas a configuração do TOTVS Connector Client para integrar com o Meu Fitossanitário.


  • O que é TOTVS Connector Client?

É a parte responsável por ler os dados das aplicações On Premises. Ele é instalado em uma máquina que possa se conectar com o banco de dados do produto On Premise/Private Cloud.
Portanto, o TOTVS Connector Client irá se conectar com a base de dados do TOTVS Agro Multicultivo e enviará os registros, que sofrerem alterações, para o Meu Fitossanitário.

Após a instalação do TOTVS Connector Client é necessário que haja a inclusão dos seguintes schemas para o correto funcionamento do TOTVS Agro Fitossanitário e nesse exemplo abaixo de schemas está a relação para versão 12.1.2406 no TOTVS Agro Multicultivo:

    • ParametroLocal
    • Instancia
    • Cultura
    • Cultivar
    • AnoAgricola
    • PeriodoSafra
    • LocalProducao1
    • LocalProducao2
    • LocalProducao3
    • LocalProducao3Fisico
    • Variavel
    • Armadilha
    • Inspecao
    • Insumo
    • UnidadeMedida
    • GrupoInsumo
    • InspecaoResultadoCalculado

  • Requisitos Mínimos de Instalação

    • Sugestão do sistema operacional: Debian ou Ubuntu ou CentOS GNU/Linux 10 (buster) ou distribuição Linux 64 bits (versões Server ou Desktop/GUI).
    • Memória RAM: 4GB.
    • Processador: Quad Core 1.8 GHZ ou superior.
    • Espaço em Disco: Espaço em disco de 40GB.
    • Ferramentas/Recursos principais: Docker (containers Linux) e Portainer (opcional, para monitoramento/gestão de ambientes baseados em Docker/containers).

Caso a sua máquina não atinja os requisitos mínimos, entre em contato conosco para avaliar outras possibilidades.


  • Requisitos de Ambiente / Infraestrutura


Também é preciso executar os dois comandos SQL, apresentados a seguir, no seu banco de dados. É preciso informar a versão do TOTVS Agro Multicultivo no segundo comando SQL (a informação está destacada em negrito).

  • create table tcc_product_metadata (name varchar(50), version varchar(50));
  • insert into tcc_product_metadata (name, version) values ('PIMSMC', '12.1.2305.002');

03. Pré-requisitos para TOTVS Agro Multicultivo

  • Versão Mínima

A versão mínima do TOTVS Agro Multicultivo deve ser a 12.1.2305.002 .


  • Requisitos de Ambiente / Infraestrutura

Caso exista bloqueio/restrição na rede, baseado em whitelist, adicionar os seguintes hosts na máquina em que o TOTVS Agro Multicultivo está instalado:

Esses hosts são serviços de integração, via APIs, com parceiros TOTVS. Ou seja, são Web Services para consumir e enviar dados entre soluções TOTVS e soluções de parceiros, como John Deere e Climatempo. 

04. Configuração TOTVS Agro Multicultivo

  • Sincronismo MDM

Para utilizar a integração, é preciso relacionar os registros da tabela de Cultivo / Ocupação com a Cultura MDM. Portanto, é necessário configurar o Grupo de Configuração 50. Navegue até a tela Configurações Gerais pelo menu Administração > Configurações Gerais e busque pela configuração 50.



Atualize o campo "Utiliza MDM" para o valor "Sim". Essa configuração permitirá o uso do Cultivo / Ocupação MDM nos registros da tabela Cultura / Ocupação.



É necessário preencher o campo "APP ID", que é um token para utilizar os serviços (Web Services) do MDM. Para receber o seu token, entre em contato conosco para providenciarmos um para você. A imagem a seguir mostra o campo "APP ID" com um token fictício.



Agora, é preciso ativar o processo agendado "IntegracaoMdmAsyncScheduler", na qual é responsável por manter os seus dados do MDM atualizados. Para ativar, navegue até a tela Cadastros de Processos Agendados pelo menu Administração > Processos Agendados, e digite "mdm" para buscar o processo do MDM.



Atualize o campo "Ativo", selecionando a caixa de seleção do campo "Ativo", e salve o registro.



Pronto. O Sincronismo do MDM está configurado.


  • Totvs Connector Client

A integração do Meu Fitossanitário com o TOTVS Agro Multicultivo é feita através da leitura de um QRCode. Esse QRCode contém um identificador único da integração, permitindo o Meu Fitossanitário e TOTVS Agro Multicultivo se comunicarem. Para o Meu Fitossanitário realizar a leitura do QRCode, é necessário configurar geração dele no TOTVS Agro Multicultivo. Para isso, navegue até a tela Configurações Gerais pelo menu Administração > Configurações Gerais, e busque pela configuração 53.



No campo "Valor", será colocado a URL do TOTVS Connector Client que retornará o seu identificador de integração. O formato da URL deve ser a seguinte: "http://XX_XX_XX_XXX:YYYY/api/v1/clientMetadata", onde XX_XX_XX_XXX é o IP da máquina em que está instalado o TOTVS Connector Client e YYYY é a porta da rede em que a aplicação está utilizando. A imagem mostra o campo "Valor" com um IP e porta da rede fictícios.



Agora, vamos testar a geração do QRCode. Navegue até a tela Configuração para TOTVS Connector pelo menu Administração > Configuração para TOTVS Connector.  Se não houve problemas com a configuração, a tela deve gerar o QRCode corretamente, como a imagem a seguir.



Se a tela apresentar o erro da imagem a seguir, verifique se o IP e a porta foram inseridos corretamente na tela de Configurações Gerais, explicado anteriormente neste mesmo tópico. Também verifique a liberação da URL do TOTVS Connector Client, explicado no tópico 3 - Pré-requisitos para TOTVS Agro Multicultivo.



05. Configuração Meu Fitossanitário

  • Leitura QRCode

Ao entrar pela primeira vez no Meu Fitossanitário, aparecerá a tela de integração, perguntando se deseja realizar a integração com o TOTVS Connector. Selecione a opção "Configurar App".



Selecione a opção "Realizar leitura" para abrir a câmera do dispositivo.



Aponte para o QRCode, gerado no TOTVS Agro Multicultivo para realizar a leitura do identificador da integração.




Ao fazer a leitura, aparecerá a tela de leitura realizada. Selecione "Continuar" para entrar na aplicação.




Pronto. Seu ambiente Meu Fitossanitário está integrado com o TOTVS Agro Multicultivo.


  • Observação para clientes Meu Fitossanitário

Se você já possui um ambiente e já utiliza o Meu Fitossanitário, entre em contato conosco para providenciarmos a integração com o TOTVS Agro Multicultivo.


06. Como enviar (sincronizar) os registros

O envio, ou sincronismo, dos registros é feito quando ocorre alguma operação de cadastro em um registro (inclusão, edição ou remoção). Esse registro será enviado junto com a sua operação de cadastro para refletir nos produtos integrados. Por exemplo, se incluir um novo registro no TOTVS Agro Multicultivo, esse registro será automaticamente enviado para o Meu Fitossanitário com a operação de inclusão, ou seja, será incluído no Meu Fitossanitário. Quais registros podem ser sincronizados e suas direções de produtos, são apresentados no tópico 07 - Tabelas que possuem sincronismo e Pré-requisitos. 

07. Tabelas que possuem sincronismo e Pré-requisitos

  • TOTVS Agro Multicultivo

Configuração do Local de Produção

A tela Configuração do Local de Produção (acessado através do menu Administração > Configuração do Local de Produção), possui parâmetros que são utilizados para configurar o Local de Produção, como "Utiliza Ano Agrícola" e "Utiliza Setor". Por padrão, esses parâmetros vêm desabilitados no Meu Fitossanitário. Caso você utilize algum desses parâmetros, é necessário enviar esse registro para o Meu Fitossanitário (explicado no tópico 07 - Como enviar os registros). 



Cultura / Ocupação

A tabela Cultura / Ocupação possui dependência com a configuração do Sincronismo MDM. Caso não tenha configurado o Sincronismo MDM no seu TOTVS Agro Multicultivo, leia o tópico 04 - Configuração TOTVS Agro Multicultivo. Como a Cultura / Ocupação do Meu Fitossanitário possui associação com a Cultura MDM, é preciso associar a Cultura / Ocupação do TOTVS Agro Multicultivo com a Cultura MDM correspondente. Importante: se a Cultura / Ocupação não estiver com a Cultura MDM associada, não acontecerá o envio do registro. Para associar a Cultura MDM, acesse a tela de cadastro da Cultura / Ocupação, através do menu Tabelas > Culturas > Cultura / Ocupação.



Selecione uma Cultura / Ocupação e clique em editar. No campo "Cultura MDM", clique na lupa para abrir a janela das Culturas MDM.



Após selecionar a Cultura MDM desejada, clique em salvar.



Pronto. A Cultura / Ocupação está associada à Cultura MDM.

Variedade / Híbridos

A tabela Variedade/Híbridos possui dependência com a configuração do Sincronismo MDM. Caso não tenha configurado o Sincronismo MDM no seu TOTVS Agro Multicultivo, leia o tópico 04 - Configuração TOTVS Agro Multicultivo. Como a Variedade/Híbridos do Meu Fitossanitário possui associação com a Variedade MDM, é preciso associar a Variedade/Híbridos do TOTVS Agro Multicultivo com a Variedade MDM correspondente. Importante: se a Variedade/Híbridos não estiver com a Variedade MDM associada, não acontecerá o envio do registro. Para associar a Variedade MDM, acesse a tela de cadastro da Variedade/Híbridos, através do menu Tabelas > Culturas > Variedade/Híbridos.



Selecione uma Variedade/Híbridos e clique em editar. No campo "Variedade MDM", clique na lupa para abrir a janela das Variedade MDM.


                                                                                               


       Após selecionar a Variedade MDM desejada, clique em salvar.



   

 Pronto. A Variedade/Híbridos está associada à Variedade MDM.


Safra / Ano Agrícola

Os registros da tabela Safra / Ano Agrícola não possuem dependências para ser enviada. Basta incluir ou atualizar um registro existente, que será enviado para o Meu Fitossanitário. Para acessar a tabela Safra / Ano Agrícola, navegue até o menu Tabelas > Calendário > Safra / Ano Agrícola.


Período de Produção

O registros da tabela Período de Produção possuem dependências dos registros da tabela Safra / Ano Agrícola. Ou seja, para o Meu Fitossanitário receber o Período de Produção, é preciso que a Safra / Ano Agrícola do Período de Produção, já tenha sido enviada anteriormente. Para acessar a tabela Período de Produção, navegue até o menu Tabelas > Calendário > Período de Produção.



Unidade Administrativa

Os registros da tabela Unidade Administrativa não possuem dependências. Basta incluir ou atualizar um registro existente, que será enviado para o Meu Fitossanitário. Para acessar a tabela Unidade Administrativa, navegue até o menu Administração > Unidade Administrativa.



Fazenda

Os registros da tabela Fazenda possuem dependências com os registros da tabela Unidade Administrativa. Ou seja, para o Meu Fitossanitário receber a Fazenda, é preciso que a Unidade Administrativa da Fazenda, já tenha sido enviada anteriormente. Para acessar a tabela Fazenda, navegue até o menu Tabelas > Locais de Produção > Fazenda.



Setor

Os registros da tabela Setor possuem dependências com os registros da tabela Fazenda. Ou seja, para o Meu Fitossanitário receber o Setor, é preciso que a Fazenda do Setor, já tenha sido enviada anteriormente. Para acessar a tabela Setor, navegue até o menu Tabelas > Locais de Produção > Setor.



Talhão

Os registros da tabela Talhão possuem dependências com os registros das tabelas Setor e Período de Produção . Ou seja, para o Meu Fitossanitário receber o Talhão, é preciso que o Setor e o Período de Produção do Talhão, já tenham sido enviados anteriormente. Além disso, é preciso que o registro do Talhão possua um mapa cadastrado. Caso contrário, o registro do Talhão não será enviado para o Meu Fitossanitário. Para acessar a tabela Talhão, navegue até o menu Tabelas > Locais de Produção > Talhão.



Para verificar se o Talhão possui um mapa cadastrado, selecione um Talhão na tela Cadastro de Talhão e clique em "Editar". Selecione a aba "Mapa" e selecione a opção "Visualizar Mapa". Se o Talhão estiver com mapa cadastrado, a tela apresentará o mapa cadastrado.




Caso não houver mapa cadastrado, a tela apresentará uma mensagem que não possui mapa cadastrado.



  • Meu Fitossanitário

Todos os registros das tabelas do Meu Fitossanitário são enviados, automaticamente, quando realiza o sincronismo dos dados pelo aplicativo Meu Fitossanitário. As dependências das tabelas do Meu Fitossanitário, são os cadastros dos registros das tabelas do TOTVS Agro Multicultivo, citadas anteriormente. Uma vez enviado esses registros para o Meu Fitossanitário, não há nenhuma outra dependência para enviar os dados do Meu Fitossanitário para o TOTVS Agro Multicultivo. 

Os nomes das tabelas do Meu Fitossanitário que são enviadas para o TOTVS Agro Multicultivo, são diferentes dos nomes das tabelas que já existem para o TOTVS Agro Multivultivo. Os nomes das tabelas do TOTVS Agro Multicultivo que representam as tabelas do Meu Fitossanitário, são apresentadas a seguir. Essas tabelas podem ser utilizadas para criar indicadores no TOTVS Agro Multicultivo com os dados coletados no Meu Fitossanitário.

Variáveis

As tabelas do TOTVS Agro Multicultivo que correspondem à tabela de Variável são: 

  • CF_VARIAVEL: possui informações do cadastro de variáveis.
  • CF_VARIAVEL_OPCAO: possui informações das opções cadastradas para as variáveis do tipo Lista. 
  • CF_VARIAVEL_RESULTADO: possui informações que definem se a variável é a principal ou não do talhão e seu valor (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).

Para saber mais sobre o cadastro de Variáveis no Meu Fitossanitário, acesse a documentação Variáveis.

Inspeção

As tabelas do TOTVS Agro Multicultivo que correspondem à tabela de Inspeção são: 

  • CF_INSPECAO: possui informações da inspeção, como data de abertura e nome do inspetor.
  • CF_PONTO: possui informações sobre cada ponto de determinada inspeção, como a data que o ponto foi inserido, a sua posição (latitude e longitude), se foi inserido de forma manual e se está excluído.

  • CF_APTO_VARIAVEL: possui informações sobre o apontamento das variáveis de inspeção. Essas variáveis podem ser variáveis da planta (ponto) ou da praga.

  • CF_APTO_PRAGA: possui informações sobre a praga, como nome, nome científico e o tipo da praga (doença, inseto ou erva daninha).

  • CF_INSPECAO_RESULTADO: possui informações dos resultados calculados  das variáveis inspecionadas com seus valores e os valores das legendas das variáveis (Alerta, Controle e Dano) (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).
  • CF_INSPECAO_RESULTADO_CALCULO:  possui informações dos status (legenda) de cada talhão e suas respectivas datas dos apontamentos.  (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).

Armadilha

As tabelas do TOTVS Agro Multicultivo que correspondem à tabela de Armadilha são: 

  • CF_ARMADILHA: possui informações sobre as armadilhas cadastradas. 
  • CF_APTO_ARMADILHA: possui informações sobre o apontamento das armadilhas, como a data do apontamento, o nome do inspetor, o nome e o nome científico da praga e o valor apontado.
  • CF_ARMADILHA_UPNIVEL1: possui informações sobre o apontamento das armadilhas nas Fazendas (Disponível a partir da versão 12.1.2406 do TOTVS Agro Multicultivo).


08.  Observações Importantes

  • Registros dependentes mandados fora de ordem

Conforme apresentado no tópico 06 - Tabelas que possuem sincronismo e Pré-requisitos, algumas tabelas possuem dependências de outras tabelas. Por exemplo, a tabela Período de Produção, depende das tabelas Cultura / Ocupação e Ano Agrícola. Ou seja, ao cadastrar um Período de Produção no TOTVS Agro Multicultivo, a Cultura / Ocupação e o Ano Agrícola já devem ter sidos cadastrados anteriormente. Caso contrário, você não conseguirá realizar o cadastro do Período de Produção. No aplicativo Meu Fitossanitário acontece a mesma coisa.  Ao enviar um registro de Período de Produção para o Meu Fitossanitário, espera-se que já foram enviados os registros dependentes (Cultura / Ocupação e Ano Agrícola), para o aplicativo. Mas não se preocupe, você não perderá os registros que possuem dependências com outros registros, caso as dependências ainda não estiverem no aplicativo. Ou seja, se você enviar um Período de Produção que não tem Cultura / Ocupação no Meu Fitossanitário, você não perderá esse registro. O Meu Fitossanitário possui um mecanismo que reconhece os registros dependentes que ainda não foram enviados. Ele salva o registro e espera os registros dependentes serem enviados, resolvendo as dependências automaticamente. 


  • Tempo de envio dos dados

Como as aplicações, Meu Fitossanitário e TOTVS Connector Client, estão em servidores diferentes (na nuvem e On Premise / Nuvem Privada, respectivamente), é preciso de conexão com a Internet para o envio dos dados entre as aplicações. Diante disso, é possível acontecer atrasos e lentidões no envio dos registros entre as aplicações. 


  • Sem rótulos