Integração com a Solinftec - Telemetria de Máquina

CONTEÚDO

Visão Geral
Premissas
Utilização
Demais Funcionalidades
Parametrização
Glossário

01. VISÃO GERAL

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 na Solinftec efetuando as 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

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

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".
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á localizar uma Ordem de Serviço de Campo criada para o Local de Produção (Fazenda (Nível1)/Setor (Nível 2)/Talhão (Nível 3)) 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 comparar 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 funcioná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 utiliza 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 quando configurado que utiliza troca de recurso no Totvs Agro Multicultivo.
GRUPOS_EQUIPTO_NAO_APONTADOS	Neste parâmetro o usuário deverá indicar o grupo operativo dos equipamentos que 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 que 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 enviada 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 de horas 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 do operador será repetido para todos os apontamentos.
UTILIZA_DESC_FAZENDA_REC_UPNIVEL1	Considerar a descrição da Fazenda disponibilizado na API da Solinftec como sendo o código da Fazenda no Totvs Agro Multicultivo. Valores validos (S/N). Caso o valor esteja como "S", indica que a "descrição" da fazenda recebida na api da Solinftec será considerado como o código da fazenda no Totvs Agro Multicultivo. Caso o valor esteja como "N", indica que o "código" da fazenda recebido da api da Solinftec será considerado como o código da fazenda no Totvs Agro Multicultivo.
UTILIZA_DESC_TALHAO_REC_UPNIVEL3	Considerar a descrição do Talhão disponibilizado na API da Solinftec como sendo o código da Talhão no Totvs Agro Multicultivo. Valores validos (S/N). Caso o valor seja igual "S", indica que a "descrição" do talhão recebida na api da Solinftec será considerado como o código do talhão no Totvs Agro Multicultivo. Caso o valor seja igual "N", indica que o "código" do talhão recebido da api da Solinftec será considerado como o código do talhão no Totvs Agro Multicultivo.
APONTAR_OPERACAO_AUXILIAR	Define se serão apontadas operações auxiliares. Valor validos (S/N). Caso o valor seja igual "S", indica que as operações recebidas da api da Solinftec e que estão classificadas no Totvs Agro Multicultivo como "auxiliar" serão utilizadas para compor o apontamento. Caso o valor seja igual "N", indica que as operações recebidas da api da Solinftec e que estão classificadas no Totvs Agro Multicultivo como "auxiliar" não serão utilizadas para compor o apontamento.
CODIGO_OPERACOES_PARA_RECUPERAR_AREA_TOTAL_DO_TALHAO	Operações produtivas para recuperar a área total do talhão se a Solinftec enviar área igual a zero. Separar códigos com "; ponto e virgula". Este parâmetro é utilizado quando tipo de apontamento definido no parâmetro "ID_AU_TIPO_SOLINFITEC", estiver configurado que ira trabalhar com a "Guia Local". Para as operações informadas neste parâmetro e que não possuem área disponibilizada pela api da Solinftec será considerado área produtiva do talhão.
MANTER_AREA_DO_TALHAO_SE_AREA_SOLINFTEC_MAIOR	Utiliza área do talhão quando área da Solinftec for maior. (S - Área do talhão. N - Área da Solinftec). Valores validos (S - Área do talhão. N - Área da Solinftec). Este parâmetro é utilizado quando tipo de apontamento definido no parâmetro "ID_AU_TIPO_SOLINFITEC", estiver configurado que irá trabalhar com a "Guia Local". Caso o valor seja igual a "S - Área do talhão", indica que se a área recebida da api da Solinftec for maior que área produtiva do talhão no Totvs Agro Multicultivo o sistema ira considerar a área do talhão. Caso o valor for igual "N - Área da Solinftec", indica que será considerado a área recebida da api da Solinftec.
UTILIZA_TALHAO_FISICO	Considerar o Talhão disponibilizado na API da Solinftec como sendo o Talhão Físico no Totvs Agro Multicultivo (Leva em consideração o parâmetro: UTILIZA_DESC_TALHAO_REC_UPNIVEL3). Valores Validos (S/N). Quando o valor for igual "S", indica que a descrição do talhão recebida na api da Solinftec será considerado como o código do talhão físico para busca do talhão no Totvs Agro Multicultivo. Caso o valor seja igual "N" indica que a descrição do talhão recebido da api da Solinftec será considerado como o código do talhão no Totvs Agro Multicultivo. Caso encontre mais de uma talhão associado ao talhão físico e possuir ordem de serviço de campo informado o sistema ira verificar se a ordem criado refere-se aos talhões associado ao físico, caso afirmativo o sistema ira efetuar o rateio da telemetria da máquina para cada talhão, utilizando a área planejada na ordem de serviço de campo. Ex. área do talhão / Soma das áreas * quantidade de horas/horimetro recebido da api da solinfetec, caso a ordem de serviço de campo não tenha planejamento para os talhões associado ao talhão físico será considerado como talhão inexistente. Caso a fazenda for "0 - zero" ou "nula" e não possuir ordem de serviço informado o sistema irá desconsiderar o apontamento recebido da api da Solinftec para compor o apontamento no Totvs Agro Multicultivo.
CONSIDERA_OPERACAO_IMPRODUTIVA_JORNADA_OPERADOR	Considera as horas de Operação Improdutiva para compor a jornada do operador quando não apontar operações improdutivas. Valores Validos (S/N). Quando o valor for igual a "S", indica que as horas recebidos da api da Solinftec que possuem operações classificadas como "improdutiva" no Totvs Agro Multicultivo serão considerada para compor a jornada do operador. Caso o valor seja igual "N", indica que as horas recebidas da api da Solinftec que possuem operações classificadas como "improdutiva" no Totvs Agro Multicultivo, não serão consideradas para compor a jornada do operador.
CONSIDERA_OPERACAO_AUXILIAR_JORNADA_OPERADOR	Considera as horas de Operação Auxiliar para compor a jornada do operador quando não apontar operações auxiliares. Valores Validos (S/N). Quando o valor for igual a "S", indica que as horas recebidos da api da Solinftec que possuem operações classificadas como "auxiliar" no Totvs Agro Multicultivo serão considerada para compor a jornada do operador. Caso o valor seja igual "N", indica que as horas recebidas da api da Solinftec que possuem operações classificadas como "auxiliar" no Totvs Agro Multicultivo não serão consideradas para compor a jornada do operador.
CONSIDERA_TELEMETRIA_QUANDO_FAZENDA_0_NULL	Considerar os dados da telemetria da máquina quando a fazenda disponibilizada pela Solinftec for 0 - zero ou nula e a ordem de serviço for informada. Valores validos (S/N). Quando valor igual a 'S', indica que os dados recebidos da Solinftec com código da fazenda "0 - zero" ou "nula" serão considerados para compor o apontamento no Totvs Agro Multicultivo, para a funcionalidade correta é necessário a configuração do DE-PARA de Unidade Administrativa (Totvs Agro Multicultivo-Solinftec) no Totvs Conecta Dados para o tenant. quando o valor o igual "N", os apontamento recebidos na api da Solinftec, não serão considerados para compor os apontamentos no Totvs Agro Multicultivo.
DESC_CALC_HR_OPERADOR_FINAL_EXPEDIENTE	Informar qual operação de FINAL DE EXPEDIENTE que será desconsiderada para o cálculo da Jornada do Operador. Quando informado indica que a operação será desconsiderado para compor o apontamento no Totvs Agro Multicultivo.

04. GLOSSÁRIO

Termo	Descrição
Totvs Agro Multicultivo	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 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é-determinada.

Páginas filhas