Histórico da Página
CONTEÚDO
- 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 permite informar letra no código, mas o mesmo pode ser iniciado com zero à 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
- A Esta solução funciona como intermediário entre o Solinftec e o TOTVS Agro Multicultivos, que realiza o sincronismo das informações das operações, providas telemetria de cada máquina, e a base de dados do TOTVS Agro Data.
- A rotina de inserção de apontamentos, que pode ser automática ou manual dependendo da sua configuração, realiza o tratamentos dos dados gravados nesta base de dados, para efetuar a persistência deles no TOTVS Agro Multicultivos em forma de apontamentos agrícolas.
- Após o sincronismo dos apontamentos, eles podem ser encontrados na solução TOTVS Agro Multicultivos, no menu "Apontamentos → Atividades e Recursos → Apontamento Agrícola", no botão "Importar Dados".
03. DEMAIS FUNCIONALIDADES
04. PARAMETRIZAÇÃO
- 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'.
- 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 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.
- Caso o nome da Integração cadastrado seja scdi, pode ser informado o Identificador da API de Telemetria das Máquinas na Solinftec no dash do ConectaDados quando habilitado a Integração Mecanizadas Solinftec. (Valor default 22)
- Caso o nome da Integração cadastrado seja scdi, ao efetuar a chamada da API de Telemetria das Máquinas na Solinftec o produto recupera o valor informado no Identificador da API no dash do ConectaDados da Integração Mecanizadas Solinftec.
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 |
Parâmetro
Configuração
Parâmetro
Configuração
Periodicidade da rotina de sincronismo entre Operations Center → TOTVS Agro Data em segundos.
. Documentação sobre expressões crons: https://docs.oracle.com/cd/E12058_01/doc/doc.1014/e12030/cron_expressions.htm. |
AUTOMATIC_TIMING |
Data inicial dos dados que é desejado realizar o sincronismo. Exemplo: 01/01/2000 12:00:00, neste caso o TOTVS Agro Data irá buscar dados de operações que foram realizadas desde o dia 01 de janeiro de 2000, a partir das 12 horas. O formato da data deve ser: dd/MM/yyyy HH:mm:ss.
Parâmetro que determina se o registro do horímetro será arredondado. Valores válidos S ou N.
Exemplo: hora início 1515.5 e hora fim 1519.4, com o parâmetro no S as horas ficariam da seguinte forma, início 1516 e fim 1519.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. |