Integração upCampo x Solinftec

O que é?

A integração entre a upCampo e a Solinftec tem como objetivo utilizar os dados gerados pelas máquinas (via Solinftec) para alimentar automaticamente as ordens de serviço dentro da plataforma da upCampo.

A Solinftec é uma solução com foco principal no monitoramento de máquinas agrícolas, fornecendo dados precisos e automatizados sobre as atividades realizadas em campo. No entanto, seu olhar para a operação agrícola como um todo é mais superficial.

Por outro lado, a upCampo é especializada no gerenciamento completo da operação agrícola, incluindo atividades, equipes, produtos e controle de custos. Por isso, a integração torna-se fundamental: ela permite que as hectares trabalhadas e as máquinas utilizadas sejam lançadas automaticamente nas ordens de serviço, facilitando o controle e aumentando a confiabilidade das informações.

Primeiros passos da integração

1. Mapeamento de IDs (De/Para)

É necessário realizar o mapeamento dos identificadores (IDs) entre as plataformas — um processo conhecido como "de/para" — para que os dados sincronizados sejam corretamente interpretados e atribuídos dentro da upCampo.

2. Frotas

Na upCampo:

Acesse Frota > Frota / Benfeitoria. No cadastro de cada máquina, há um campo chamado ID Fab, onde deve ser informado o identificador correspondente da Solinftec.

Na Solinftec:

O mapeamento deve ser feito com base no menu Cadastro > Grupo de Equipamentos > Equipamentos.

3. Talhões

Na upCampo:

Acesse Lavoura > Talhão. Em cada talhão, há uma guia chamada "Integrações", onde deve ser informado o ID do talhão correspondente na Solinftec.

Na Solinftec:

O local exato pode variar, geralmente está em Cadastro > Talhões ou em menus relacionados à estrutura das áreas.

→ É necessário verificar com o suporte da Solinftec, pois muitas vezes o cliente não tem acesso direto a essa tela — o próprio time da Solinftec costuma realizar esse mapeamento das áreas.

4. Operações

Na upCampo:

a) Acesse Operacional > Operações para cadastrar e configurar os tipos de operação que serão integrados. Campo específico: Código.

b) No cadastro do tipo de atividade, há uma guia chamada "Operações" — é necessário vincular a operação correspondente nessa guia.

Na Solinftec:

O mapeamento deve ser feito com base no menu Cadastro > Operação > Operação.

5. Funcionários

Na upCampo:

Acesse Operacional > Funcionário para cadastrar e configurar. Campo específico: ID Integração.

Na Solinftec:

O mapeamento deve ser feito com base no menu Cadastro > Funcionários > Funcionários.

6. Equipe

Na upCampo:

Acesse Operacional > Equipe para cadastrar e configurar. Campo específico: ID Integração.

Na Solinftec:

O mapeamento deve ser feito com base no menu Cadastro > Equipe.

✅ Resumo da Integração

Item	upCampo	Solinftec
Frotas	Frota > Frota / Benfeitoria (ID Fab)	Cadastro > Grupo de Equipamentos > Equipamentos
Talhões	Lavoura > Talhão > Guia Integrações	Cadastro > Talhões (validar com suporte Solinftec)
Operações	Operacional > Operações (Código) + Tipo Atividade > Guia Operações	Cadastro > Operação > Operação
Funcionários	Operacional > Funcionário (ID Integração)	Cadastro > Funcionários > Funcionários
Equipe	Operacional > Equipe (ID Integração)	Cadastro > Equipe

🔧 Parte Técnica da Integração

A integração entre a upCampo e a Solinftec é feita de forma automática por meio de um serviço que roda continuamente no servidor.

1. Autenticação

Para consumir os dados da Solinftec, é necessário obter um Token de Acesso e uma Senha, que são fornecidos pela própria Solinftec ao cliente.

2. Serviço Node.js: servicoSolinftec

No ambiente da upCampo, existe um serviço Node.js chamado servicoSolinftec, responsável por executar todo o processo de coleta e preparação dos dados para integração.

Esse serviço executa os seguintes passos:

Geração do Token de Acesso

Método: geraTokenSolinfitec
Utiliza as credenciais cadastradas para obter um token válido de acesso à API da Solinftec.

Chamada da API da Solinftec

O serviço realiza a chamada da API com filtro por data:
Data inicial: 00:00 do dia atual
Data final: 23:59 do mesmo dia

Inserção dos dados na tabela HISSOL

Os dados recebidos são processados e transformados em comandos INSERT para a tabela HISSOL (Histórico de Solicitações).
A inserção é realizada imediatamente após o processamento.

3. Processamento via Procedure: INTEGRACAO_SOLINFTEC

Paralelamente, existe um processo de backend (agendado para rodar a cada X minutos) que verifica e processa os dados recém-inseridos na tabela HISSOL.

Detalhes:

Procedure executada: [INTEGRACAO_SOLINFTEC]
Responsabilidades da procedure:
- Selecionar os registros da HISSOL
- Procurar os mapeamentos de IDs já cadastrados nas seguintes tabelas:
  - Equipamentos
  - Operações
  - Funcionários
  - Equipe
  - Talhões
- Identificar a ordem de serviço correspondente aos dados vindos da Solinftec
- Em caso de sucesso, registra a informação na ordem de serviço
- Em caso de falha (ex: falta de mapeamento ou inconsistência nos dados), registra o erro na tabela PROINT (Problemas de Integração)

🧩 Resumo do Fluxo Técnico

[servicoSolinftec - Node.js] ↓ geraTokenSolinfitec ↓ Chamada à API (00:00 - 23:59 do dia) ↓ Inserção dos dados na tabela HISSOL [Job agendado] ↓ Executa procedure INTEGRACAO_SOLINFTEC ↓ Valida mapeamentos ↓ Atualiza Ordens de Serviço (ou) ↓ Registra falhas na tabela PROINT

✅ Etapas de Validação da Integração

Após configurar todos os mapeamentos (de/para) e realizar os ajustes técnicos no servidor, é necessário validar se a integração está funcionando corretamente.

Siga os passos abaixo para realizar a conferência:

1. Executar o serviço manualmente

Rode o serviço servicoSolinftec manualmente (via terminal ou serviço PM2).
O serviço irá gerar o token, consultar os dados do dia e inserir os registros na tabela HISSOL.

2. Verificar a tabela HISSOL

Acesse o banco de dados e confira se os registros foram inseridos corretamente na tabela HISSOL (Histórico de Solicitações).
Os dados devem conter informações como: data, equipamento, operação, área trabalhada, etc.

3. Aguardar o processamento automático

Aguarde o job automático executar a procedure INTEGRACAO_SOLINFTEC.
Isso pode levar alguns minutos, dependendo da periodicidade configurada.

4. Verificar a tabela PROINT

Caso haja falhas de mapeamento ou erros nos dados recebidos, eles serão registrados na tabela PROINT (Problemas de Integração).
Verifique se há registros nessa tabela.
Se houver, corrija os mapeamentos faltantes (Equipamento, Talhão, Equipe, etc).
Após correção, o sistema poderá reprocessar automaticamente ou mediante nova execução do serviço.

5. Confirmar no sistema upCampo

Acesse o menu Operacional > Ordem de Serviço dentro da plataforma upCampo.
Confirme se os dados vindos da Solinftec foram corretamente inseridos e vinculados às ordens de serviço:
- Máquinas utilizadas
- Área trabalhada
- Equipe envolvida
- Tipo de operação

📝 Nota: checklist para implantação disponível em outro artigo.

❓ Perguntas frequentes

Para que serve a integração entre upCampo e Solinftec?

Para usar os dados gerados pelas máquinas, capturados pela Solinftec, alimentando automaticamente as ordens de serviço da upCampo. Assim, os hectares trabalhados e as máquinas utilizadas são lançados sem digitação, o que aumenta a confiabilidade da informação.

Por que integrar em vez de usar só um dos sistemas?

Porque eles cobrem camadas diferentes: a Solinftec é focada em monitoramento de máquinas agrícolas, com dados precisos e automatizados do campo; a upCampo é especializada na gestão completa da operação — atividades, equipes, produtos e custos.

O que é o mapeamento de/para?

É a correspondência entre os identificadores das duas plataformas. Sem esse "de/para" configurado, os dados sincronizados não são interpretados nem atribuídos corretamente dentro da upCampo. O mapeamento cobre frotas, talhões, operações, funcionários e equipes.