Histórico da Página

...

Visão Geral
Premissas
Utilização
Demais Funcionalidades
Parametrização
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.

...

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

03. DEMAIS FUNCIONALIDADES

...

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.

...

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'.

...

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.

...

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.

...

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'.

...

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.

...

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.

...

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.

...

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.

...

04. DEMAIS FUNCIONALIDADES

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 AgrodataTotvs Agro Data, 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 parâmetro NAME_PARAMETER='ID_AU_TIPO_SOLINFITEC'.
Recuperar a Unidade Administrativa no Totvs Agro Multicultivo,
- Recupera a Fazenda (Nível1) disponibilizado pela solinftec 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 importados 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 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 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 sistema ira

...

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/Setor/Talhão)/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 possuém 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.
Quando o Operador disponibilizado pela Sonlifec 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 "Funcionário 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), 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,

05. PARAMETRIZAÇÃO

Tabela: PARAMETERS

Parâmetro	Configuração
ID_AU_TIPO_SOLINFITEC	Neste parâmetro o usuário deverá indicar o ID do tipo de apontamento agrícola criado para receber os apontamentos de telemetria da Solinftec. Para criar o tipo de apontamento seguir as instruções informadas em "demais funcionalidades".
FUNCIONARIO_PADRAO	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.
UTILIZA_OS	Neste parâmetro o usuário deverá indicar se utiliza Ordem de Serviço de campo. Valores válidos (S/N). Quando configurado e não possuir ordem de serviço disponibilizado pela telemetria da máquina o sistema irá procurar uma Ordem de Serviço de Campo criada para o Local de Produção (Fazenda/Setor/Talhão) e operação no Totvs Agro Multicultivo, caso encontre, será utilizado o Ano Agrícola, Período de Produção e Centro de Custo. caso não esteja configurado não irá procurar uma ordem de serviço de campo.
CRON_CLIENT_SCHEDULE	Neste parâmetro o usuário deverá indicar a expressão cron que determina um horário fixo para baixar as telemetrias da máquina. Valor padrão "0 0 22 * * ?", que indica que a integração será realizadas as 22:00 e após baixar os dados da Solinftec e o parâmetro AUTOMATIC_TIMING estiver configurado os dados serão enviados para o Totvs Agro Multicultivo. Documentação sobre expressões crons: https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm.
AUTOMATIC_TIMING	Neste parâmetro o usuário deverá definir se os dados baixados da Solinftec será enviados para o Totvs Agro Multicultivo. Valor validos (S/N). Quando configurado indica que os apontamentos serão enviado para o Totvs Agro Multicultivos, caso contrário os dados ficarão apenas disponibilizados no Totvs Agro Data.
MODULO_SOLINFTEC	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.
QUANTIDADE_DIAS_DATA_INICIAL	Neste parâmetro o usuário deverá indicar a quantidade de dias anterior da data inicial para importar a telemetria da máquina da Solinftec. Valor padrão 7. Exemplo: Supondo que estamos baixando apontamento para o dia 31/08, e estiver configurado 7 dias, o sistema irá buscar apontamento a partir do dia 25/08. Os apontamentos que foram baixados serão desconsiderados baixando apenas os novos apontamentos disponibilizados.
REMOVER_REGISTROS_APOS_X_DIAS	Neste parâmetro o usuário deverá indicar a quantidade de dias anterior a data inicial para remover os apontamentos baixados da Solinftec. Valor padrão 365. Neste exemplo o sistema ira remover os apontamentos baixados da Solinftec anterior a 365 dias a partir da data atual. Ex. Se estiver baixando os apontamentos do dia 31/08/2021. serão removidos os apontamentos com data menor igual a 31/08/2020.
APONTAR_OPERACAO_IMPRODUTIVA	Neste parâmetro o usuário devera indicar se considera as operações improdutivas para integrar com o Totvs Agro Multcultivo. Valores validos (S/N). Caso configurado serão consideradas as horas das operações improdutivas para integrar com o Totvs Agro Multicultivo, caso contrário as horas das operações improdutivas serão desconsideradas.
BUSCA_FUNCIONARIO_TABELA_ERP	Neste parâmetro o usuário deverá indicar se buscar o código do funcionário ERP no Totvs Agro Multoultico para compara com o código disponibilizado pela Solinftec. Valores validos (S/N). Caso configurado indica que Totvs Agro Data irá utilizar o Código ERP informado no cadastro de funcionário do Totvs Agro Multicultivo para comparar com o código disponibilizado pela Sonliftec, caso contrário o Totvs Agro Data, irá utilizar o código do funcinário do Totvs Agro Multiciltivo para comparar com o código disponibilizado pela Solinftec, Quando configurado que utiliza o código ERP do funcionário, deverá atentar se no ERP o código não se repete entre as filiais, pois se isto ocorrer o Totvs Agro Data não irá conseguir recuperar o funcionário.
GRUPOS_EQUIPTO_NAO_APONTADOS	Neste parâmetro o usuário deverá indicar o grupo operativo dos equipamento serão desconsiderados na integração com a Solintec. Caso possua mais de uma grupo operativo o mesmo deverá ser informado separado por ";" ponto e virgula; Ex: 10;20. Quando informado grupo operativos todos os equipamento deste grupo será desconsiderados na integração com a solinftec.
AGRUPAR_SEQUENCIAL_OPERACOES_NAO_PRODUTIVAS	Neste parâmetro o usuário deverá indicar se agrupa os apontamentos quando forem sequenciais. Valores validos (S/N). Quando configurado indica serão agrupadas os apontamentos quando as linhas forem sequências para dia/equipamento/operador/centro de custo/Operação Produtiva/jornada do operador, caso contrário serão somadas as horas para dia/equipamento/operador/Centro de Custo/Operação/Jornada do operador. A hora inicial para as operações improdutivas poderão serem iniciadas em 00:00 quando o parâmetro "MOSTRAR_HORA_REAL_OPERADOR" não estiver configurado, caso esteja configurado será iniciado com a hora enciada na telemetria.
UTILIZA_PARAMETRO_DT_HR_INI_REGNAJORNADA	Neste parâmetro o usuário deverá indicar se considera a hora real do operador ou a hora calculada pelas operações realizadas pela telemetria da máquina. Valores validos (S/N). Quando configurado indica que a jornada do operador será a hora real do operador, caso contrário será pela total das operações realizadas pela telemetria. Quando este parâmetro esta configurado e for necessário gerar mais de um boletim para o dia/equipamento/operador o horário será repetido para todos os apontamentos.

04. GLOSSÁRIO

Termo	Descrição

TOTVS

Totvs Agro

Multicultivos

Multicultivo

Solução TOTVS para o setor de agronegócio focado em vários tipos de cultivos, como soja, milho, etc...SolinftecSincronismo Solinftec → TOTVS Agro DataSincronismo TOTVS Agro Data → TOTVS Agro MulticultivosRotina onde o TOTVS Agro Data trata os dados de sua base, e os transforma em apontamentos agrícolas para exportá-los ao TOTVS Agro Multicultivos

TOTVS Agro Multicultivo é um software que atende todas as demandas de gestão da cadeia produtiva de culturas anuais como: milho, soja, trigo e algodão além dos subsegmentos de biocombustíveis, citros, fruticultura e floresta.
Solinftec	Solução que disponibilizas as informações da telemetria da máquina.
Totvs Agro Data	Solução Totvs responsável em baixar os apontamentos disponibilizadas pela pela Solinttec, efetuar as tratativas inicias e gerar os apontamentos no Totvs Agro Multicultivo.
Expressão Cron	É uma expressão que determina um agendamento, um tempo que deverá executar o processo, pode ser um intervalo de tempo como uma hora pré deteminada.

Páginas filhas

Versões comparadas

Versão antiga 8

Nova versão 9

Chave