Histórico da Página

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 - 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í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 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 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".
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á 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.

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

Versões comparadas

Versão antiga 11

Nova versão 12

Chave