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