Histórico da Página

CONTEÚDO

1. Visão Geral
2. Premissas
3. Utilização
4. Demais Funcionalidades
5. Parametrização
6. Glossário

01. VISÃO GERAL

Integração com a Solinfec, que disponibiliza dados das operações realizadas com suas máquinas agrícolas. O aplicativo utiliza essas informações para gerar apontamentos temporários agrícolas no TOTVS Agro Multicultivo.

Esta integração foi construída para efetuar a comunicação entre Solinftec, baixando os apontamentos gerados através da telemetria da máquina, dando as tratativas iniciais e gerando os apontamentos no Totvs Agro Multicultivo. A comunicação entre Totvs Agro Data e a Solinftec foram desenvolvidas utilizando API (Application Programming Interface).

02. PREMISSAS

• Para o funcionamento correto das integrações entre as aplicações os seguintes cadastros precisam estar equalizados (mesmo código). Atualmente estes cadastros não possuem DE PARA.
  • Equipamento
  • Funcionário
  • Fazenda (nivel1)
  • Setor (Nivel2)
  • Talhão (Nivel3)
  • Operação
• Atentar para os seguintes cadastros:
  • o Código  da fazenda (Nível1) e do Setor(Nível2) no Totvs Agro Multicultivo não permiti informar letra no código, mais o mesmo pode ser iniciado com 0 a esquerda, exemplo 001, no cadastro de talhão permite informar letra, exemplo T-01 e  na Solinftec não permite zeros a esquerda ou letras no código.
  • O Código do equipamento no Totvs Agro Multicultivo é uma campo alfanumérico, permitindo informar letras ou zeros as esquerda e na Solinftec só permite informar números.

03. EXEMPLO DE UTILIZAÇÃO

• Esta solução funciona como um conector entre as aplicações no sentido de buscar a telemetria da máquina da na Solinftec efetuando as primeiras tratativas iniciais. como unificar os dados que são comuns para dia/máquina/operador/Jornada e inserir as informações no Totvs Agro Multicultivos.

...

04. DEMAIS FUNCIONALIDADES

• Funcionário Padrão
• Horário que será iniciado o processo para buscar os dados da Solinftec
  • Para definir o horário que o AgroData irá buscar as informações na Solinftec, entrar no banco de dados do AgroData, localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, para ID 10 com o NAME_PARAMETER='CRON_CLIENT_SCHEDULE', deverá definir uma expressão cron. Como default enviamos a seguinte expressão "0 0 22 * * ?", indicando que o processo será realizado todos os dias as 22:00 hs. Após finalizar o processo de baixar os apontamentos da Solinftec e o parâmetro "AUTOMATIC_TIMING" para o ID 11, estiver ativo o sistema ira começar a atualizar os apontamentos no Totvs Agro Multicultivo.
• Ativar a utilização da telemetria dos apontamentos das solinftec.
  • Para ativar o modulo da Solinftec entrar no banco do AgroData, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 15, com o NAME_PARAMETER='MODULO_SOLINFTEC'.
• Quantidade de dias para busca dos apontamento na Solinftec
  • Este parâmetro define a quantidade de dias para baixar as telemetrias das máquinas, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 19, com o NAME_PARAMETER='QUANTIDADE_DIAS_DATA_INICIAL', como valor padrão o parâmetro será  criado com 7 dias. Para definição deste parâmetro é importante levantar junto a Solinftec a quantidade de dias que ele pode liberar apontamentos. O apontamentos baixamos serão ignorados.
• Remover a quantidade de dias dos apontamentos baixados
  • Este parâmetro define a quantidade de dias  para remover os apontamentos baixados e processados, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 20, com o NAME_PARAMETER='REMOVER_REGISTROS_APOS_X_DIAS', como valor padrão o parâmetro será criado com 365 dias.
• Apontar horas improdutivas
  • Este parâmetro define se serão consideramos as horas improdutivas enviadas pela telemetria, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 21, com o NAME_PARAMETER='APONTAR_OPERACAO_IMPRODUTIVA', como valor padrão o parâmetro será criado com 'S'.
• Grupos Operativos que serão ignorados na integração dos apontamentos.
  • Este parâmetro será utilizado para desconsiderar os grupos operativos de equipamentos na integração com o Totvs Agro Multicultivo, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 23, com o NAME_PARAMETER='GRUPOS_EQUIPTO_NAO_APONTADOS', como valor padrão o parâmetro será vazio, caso necessite informar mais de um grupo operativo deverá ser criado separado com ';' ponto e virgua, exemplo 300;301.
• Agrupar apontamentos com a mesma sequência
  • Este parâmetro será utilizado para agrupar os apontamentos com a mesma sequencia, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 24, com o NAME_PARAMETER='AGRUPAR_SEQUENCIAL_OPERACOES_NAO_PRODUTIVAS', como valor padrão o parâmetro será 'S'. Nas experiências que tivemos nos clientes, quando o parâmetro estiver definido com 'S', gerou um grande quantidade de detalhe do apontamento.
• Busca código do funcionário ERP
  • Este parâmetros será utilizado para definir como será considerado a busca do código do funcionário, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor para o ID 22, com o NAME_PARAMETER='BUSCA_FUNCIONARIO_TABELA_ERP', como valor padrão o parâmetro será 'N'. Quando o parâmetro estiver definido como 'S", a integração irá considerar o Código ERP do cadastro de funcionário, caso esteja como "N", será considerado o Código do cadastro de funcionário.
• Considerar a jornada do apontamento
  • Este parâmetro será utilizados para definir como será considerado a jornada do operador, para isto localizar a tabela PARAMETERS e no campo VALUE_PARAMETER, definir o valor,  para o ID 25, com o NAME_PARAMETER='UTILIZA_PARAMETRO_DT_HR_INI_REGNAJORNADA', como valor padrão o parâmetro será 'S'. Quando o parâmetro estiver definido como 'N", a jornada do operador será considerado as horas das operações disponibilizada pela telemetria, caso esteja como "S", será considerado a jornada do operador disponibilizada pela Solinftec.
• Iniciar os detalhes do apontamento em 00:00 ou utilizar a hora real
  • Este parâmetro define a maneira que será iniciado a hora inicial no detalhe do apontamento, quando o parâmetro estiver definido como "S", será utilizado a hora real enviada pela telemetria da máquina, caso esteja definido como "N", a hora inicial no detalhe do apontamento será iniciado as "00:00".  Para isto localizar o ID 26, com NAME_PARAMETER='MOSTRAR_HORA_REAL_OPERADOR' na tabela PARAMETERS e no campo VALUE_PARAMETER definir a maneira que será iniciado a hora inicial. Valores validos (S/N). 
• Tipo de Apontamentos Agrícola
  • Para a funcionamento correto da integração entre o AgroData e o Totvs Agro Multicultivo criar um tipo de apontamento para receber a telemetria da máquina. O Código e Descrição fica a critério do usuário, porém os seguintes campos deve esta marcados:
    • Tipo: Mecanizado
    • Cabeçalho - Comum
      • Turno
      • Observação
      • Centro de Custo
      • Operação
      • Equipamento
    • Cabeçalho - Mecanizado
      • Operador
      • Hora Inicial (Jornada do Operador)
      • Hora Final (Jornada do Operador)
      • Jornada do Operador
    • Detalhe - Local de Produção
      • Ano Agrícola
      • Período de Produção
      • Bloco
      • Gleba
      • Área
    • Detalhe - Mecanizado
      • Ordem de Serviço de Campo (Obrigatório = N)
      • Ano Agríocla
      • Período de Produção
      • Fazenda (Nível 1)
      • Setor (Nível 2)
      • Talhão (Nível 3)
      • Operação
      • Implemento
      • Hr/Km Inicial
      • Hr/Km Final
      • Hr/Km Total
  • Efetuar uma consulta no Totvs Agro Multicultivo (Administração → Execução de Consulta) na tabela AU_TIPO, localizar o modelo criado e copiar o valor do campo ID_AU_TIPO
  • Entrar no banco de dados do Agrodata, localizar a tabela PARAMETERS e efetua um UPDATE no campo VALUE_PARAMETRO com o ID_AU_ATIPO selecionado na opção para o ID 17 e o NAME_PARAMETER='ID_AU_TIPO_SOLINFITEC'.
• Recuperar a Unidade Administrativa no Totvs Agro Multicultivo,
  • Recupera a Fazenda (Nível1) disponibilizado pela solinftec e efetua a busca pelo código na Totvs Agro Multicultivo, caso encontre o sistema irá considerar a unidade administrativa da fazenda e os apontamentos serão descarregados nesta unidade, caso não encontre a unidade administrativa o sistema ira desconsiderar esta linha e gerar mensagem que a unidade administrativa não foi localizada.
• Para inserção na base de dados Totvs Agro Multicultivo o Totvs Agro Conecta recupera a fazenda disponibilizada pela solinftec e através da mesma localiza a unidade administrativa onde os apontamentos serão inseridos. Caso a Fazenda disponibilizada pela Solintec não seja encontrada no Totvs Agro Multicultivo este apontamento não será inserido no Totvs Agro Multicultivo ficando disponível para consulta apenas na base de dados do Totvs Agro Conecta.
• Caso a Solinftec disponibilize na API  de telemetria a informação da ordem de serviço de campo, Totvs Agro Conecta ira considerar o Ano Agrícola, Período de Produção e Centro de Custo da ordem para inserção no Totvs Agro Multicltivo.
• Caso a Solinftec não disponibiliza o sistema ira 

04. PARAMETRIZAÇÃO

Tabela: PARAMETERS

...

Parâmetro

...

Configuração 

...

Neste parâmetro o usuário deverá indicar o ID do funcionário padrão criado no Totvs Agro Multicultivo. Este funcionário deverá ter o mesmo código do funcionário padrão criado pela Solinftec. Para localizar o ID deste funcionário deverá efetuar uma pesquisa no banco de dados do Totvs Agro Multicultivo na tabela FUNCIONAR, para o código do funcionário criado. Caso não tenha criado o funcionário padrão no Totvs Agro Multicultivo o mesmo deverá ser criado.

...

Neste parâmetro o usuário deverá indicar que utiliza a telemetria da máquina da Solinftec. Valor validos (S?N). Quando configurado indica que utiliza a telemetria da máquina da Solinftec, caso contrário não utiliza a telemetria da máquina da Solinftec.

...

• Tipo de Apontamentos Agrícola
  • Para a funcionamento correto da integração entre o AgroData e o Totvs Agro Multicultivo criar um tipo de apontamento para receber a telemetria da máquina. O Código e Descrição fica a critério do usuário, porém os seguintes campos devem estar marcados:
    • Tipo: Mecanizado
    • Cabeçalho - Comum
      • Turno
      • Observação
      • Centro de Custo
      • Operação
      • Equipamento
    • Cabeçalho - Mecanizado
      • Operador
      • Hora Inicial (Jornada do Operador)
      • Hora Final (Jornada do Operador)
      • Jornada do Operador
    • Detalhe - Mecanizado
      • Ordem de Serviço de Campo (Obrigatório = N)
      • Ano Agrícola
      • Período de Produção
      • Fazenda (Nível 1)
      • Setor (Nível 2)
      • Talhão (Nível 3)
      • Operação
      • Implemento
      • Hr/Km Inicial
      • Hr/Km Final
      • Hr/Km Total
  • Efetuar uma consulta no Totvs Agro Multicultivo (Administração → Execução de Consulta) na tabela AU_TIPO, localizar o modelo criado e copiar o valor do campo ID_AU_TIPO
  • Entrar no banco de dados do Totvs Agro Data, localizar a tabela PARAMETERS e efetua um UPDATE no campo VALUE_PARAMETRO com o ID_AU_ATIPO para o parâmetro NAME_PARAMETER='ID_AU_TIPO_SOLINFITEC'.
• Recuperar a Unidade Administrativa no Totvs Agro Multicultivo,
  • Recupera a Fazenda (Nível1) disponibilizado pela Solinftec e efetua a busca pelo código na Totvs Agro Multicultivo, caso encontre o sistema irá considerar a unidade administrativa da fazenda e os apontamentos serão gerados nesta unidade administrativa, caso não encontre a unidade administrativa o sistema ira desconsiderar esta linha e gerar mensagem que a unidade administrativa não foi localizada, ficando disponível para consulta apenas na base de dados do Totvs Agro Conecta.
• Caso a Solinftec disponibilize na API de telemetria a informação da ordem de serviço de campo o Totvs Agro Conecta ira considerar o Ano Agrícola, Período de Produção e Centro de Custo da Ordem de Serviço de Campo para inserção no Totvs Agro Multicltivo.
• Caso a Solinftec não disponibiliza na API de telemetria da máquina a informação da ordem de serviço de campo e o parâmetro "UTILIZA_OS", esteja configurado o sistema ira efetua um busca no banco de dados do Totvs Agro Multicultivo para localizar uma ordem de serviço de campo para o Local de Produção (Fazenda (Nível 1)/Setor (Nível 2)/Talhão (Nível 3))/Operação menor igual da data do apontamento para os últimos 30 dias. Se encontrar iremos utilizar o Ano Agrícola/Período de Produção/Centro de Custo para gerar o apontamento.
• Quando a informação da ordem de serviço não foi disponibilizada ou não foi possível recuperar uma ordem de serviço de campo iremos recuperar o Ano Agrícola Período de Produção da seguinte maneira:
  • Localiza para Fazenda (nível 1), setor (nível 2) e Talhão (nível3) e verifica encontra apenas um período para a data do apontamento, neste pesquisa desconsidera os talhões que possuem data de encerramento menor igual data do apontamento.
  • Caso encontre mais de uma período de produção não será possível recuperar o Ano Agrícola/Período de Produção e será gerado o apontamento e na descrição do Ano Agrícola e Período de Produção será demonstrado inexistente.
• Quando o Operador disponibilizado pela Sonliftec não for encontrado ou não estiver disponível para unidade administrativa no Totvs Agro Multicultivo, será gerado o apontamento com o código disponibilizado pela Solinftec e na descrição será demonstrado que o funcionário esta inexistente ou indisponível. Quando o parâmetro BUSCA_FUNCIONARIO_TABELA_ERP, estiver configurado e encontrar mais de uma funcionário para o mesmo código ERP, será recuperado o código e na descrição será demonstrativo inexistente ou repetido.
• Quando o Equipamento disponibilizado pela Solinftec não for encontrado ou não estiver disponível para a unidade administrativa no Totvs Agro Multicultivo, será gerado o apontamento com o código disponibilizado pela Solinftec e na descrição será demonstrado que o equipamento esta inexistente ou indisponível.
• Quando o Ano Agrícola e Período de Produção não for possível recuperar pelo local de produção (Fazenda (nível 1), Setor (Nível 2) e Talhão (Nível 3)), na descrição do Ano Agrícola e na descrição do Período de Produção irá demonstrar inexistente.
• Quando o Talhão (nível 3) não for possível recuperar pelo código disponibilizado pela Solinftec na Totvs Agro Multicultivo, sera gerado o apontamento com o código disponibilizado, porém não será recuperado o Ano Agrícola e Período de Produção.
• Quando o Setor (Nível 2) não for possível recuperar pelo código disponibilizado pela Solinftec na Totvs Agro Multicultivo, será gerado o apontamento com o código do Setor e na descrição do setor será demonstrado inexistente.
• Quando o Fazenda (Nível 1) não for possível recuperar pelo código disponibilizado pela Solinftec na Totvs Agro Multicultivo, não será gerado o apontamento, pois o sistema não conseguira recuperar a unidade administrativa para gerar os apontamentos.
• Quando o Implemento disponibilizado pela Solinftec não for encontrado ou não estiver disponível para unidade administrativa no Totvs Agro Multicultivo, será gerado o apontamento com o código do implemento porém o apontamento ficará invalido,
• Quando não for possível recuperar o Centro de Custo pela ordem de serviço de campo o sistema ira recuperar o centro de custo da guia "Centro de Custo" do cadastro de Período de Produção para a unidade administrativa que esta sendo gerado o apontamento.

05. PARAMETRIZAÇÃO

Tabela: PARAMETERS

04. GLOSSÁRIO

...

04. GLOSSÁRIO