Integración upCampo x Solinftec
¿Qué es?
La integración entre upCampo y Solinftec tiene como objetivo usar los datos generados por las máquinas (vía Solinftec) para alimentar automáticamente las órdenes de servicio dentro de la plataforma upCampo.
Solinftec es una solución enfocada principalmente en el monitoreo de máquinas agrícolas, que entrega datos precisos y automatizados sobre las actividades realizadas en el campo. Sin embargo, su mirada sobre la operación agrícola en su conjunto es más superficial.
Por otro lado, upCampo está especializada en la gestión completa de la operación agrícola, incluyendo actividades, equipos, productos y control de costos. Por eso, la integración se vuelve fundamental: permite que las hectáreas trabajadas y las máquinas utilizadas se carguen automáticamente en las órdenes de servicio, lo que facilita el control y aumenta la confiabilidad de la información.
Primeros pasos de la integración
1. Mapeo de IDs (De/Para)
Es necesario mapear los identificadores (IDs) entre las plataformas —un proceso conocido como "de/para"— para que los datos sincronizados se interpreten y se asignen correctamente dentro de upCampo.
2. Flotas
En upCampo:
Acceda a Flota > Flota / Propiedad. En el registro de cada máquina hay un campo llamado ID Fab, donde se debe informar el identificador correspondiente de Solinftec.
En Solinftec:
El mapeo se hace con base en el menú Cadastro > Grupo de Equipamentos > Equipamentos.
3. Parcelas
En upCampo:
Acceda a Agricultura > Parcela. En cada parcela hay una pestaña llamada "Integraciones", donde se debe informar el ID de la parcela correspondiente en Solinftec.
En Solinftec:
El lugar exacto puede variar; generalmente está en Cadastro > Talhões o en menús relacionados con la estructura de las áreas.
→ Es necesario consultarlo con el soporte de Solinftec, porque muchas veces el cliente no tiene acceso directo a esa pantalla: el propio equipo de Solinftec suele hacer este mapeo de las áreas.
4. Operaciones
En upCampo:
a) Acceda a Operacional > Operaciones para registrar y configurar los tipos de operación que se integrarán. Campo específico: Código.
b) En el registro del tipo de actividad hay una pestaña llamada "Operaciones": es necesario vincular allí la operación correspondiente.
En Solinftec:
El mapeo se hace con base en el menú Cadastro > Operação > Operação.
5. Empleados
En upCampo:
Acceda a Operacional > Empleado / operador para registrar y configurar. Campo específico: ID Integración.
En Solinftec:
El mapeo se hace con base en el menú Cadastro > Funcionários > Funcionários.
6. Equipo
En upCampo:
Acceda a Operacional > Equipo para registrar y configurar. Campo específico: ID Integración.
En Solinftec:
El mapeo se hace con base en el menú Cadastro > Equipe.
✅ Resumen de la integración
| Ítem | upCampo | Solinftec |
|---|---|---|
| Flotas | Flota > Flota / Propiedad (ID Fab) | Cadastro > Grupo de Equipamentos > Equipamentos |
| Parcelas | Agricultura > Parcela > Pestaña Integraciones | Cadastro > Talhões (validar con el soporte de Solinftec) |
| Operaciones | Operacional > Operaciones (Código) + Tipo de actividad > Pestaña Operaciones | Cadastro > Operação > Operação |
| Empleados | Operacional > Empleado / operador (ID Integración) | Cadastro > Funcionários > Funcionários |
| Equipo | Operacional > Equipo (ID Integración) | Cadastro > Equipe |
🔧 Parte técnica de la integración
La integración entre upCampo y Solinftec se hace de forma automática mediante un servicio que se ejecuta continuamente en el servidor.
1. Autenticación
Para consumir los datos de Solinftec es necesario obtener un Token de acceso y una Contraseña, que la propia Solinftec entrega al cliente.
2. Servicio Node.js: servicoSolinftec
En el entorno de upCampo existe un servicio Node.js llamado servicoSolinftec, responsable de ejecutar todo el proceso de recolección y preparación de los datos para la integración.
Este servicio ejecuta los siguientes pasos:
Generación del Token de acceso
- Método:
geraTokenSolinfitec - Usa las credenciales registradas para obtener un token válido de acceso a la API de Solinftec.
Llamada a la API de Solinftec
- El servicio llama a la API con filtro por fecha:
- Fecha inicial: 00:00 del día actual
- Fecha final: 23:59 del mismo día
Inserción de los datos en la tabla HISSOL
- Los datos recibidos se procesan y se transforman en comandos INSERT para la tabla HISSOL (Historial de Solicitudes).
- La inserción se realiza inmediatamente después del procesamiento.
3. Procesamiento vía procedure: INTEGRACAO_SOLINFTEC
En paralelo, existe un proceso de backend (programado para ejecutarse cada X minutos) que verifica y procesa los datos recién insertados en la tabla HISSOL.
Detalles:
- Procedure ejecutada:
[INTEGRACAO_SOLINFTEC] -
Responsabilidades de la procedure:
- Seleccionar los registros de HISSOL
-
Buscar los mapeos de IDs ya registrados en las siguientes tablas:
- Equipos (máquinas)
- Operaciones
- Empleados
- Equipo
- Parcelas
- Identificar la orden de servicio que corresponde a los datos que vienen de Solinftec
- En caso de éxito, registra la información en la orden de servicio
- En caso de falla (ej.: falta de mapeo o inconsistencia en los datos), registra el error en la tabla PROINT (Problemas de Integración)
🧩 Resumen del flujo técnico
✅ Etapas de validación de la integración
Después de configurar todos los mapeos (de/para) y hacer los ajustes técnicos en el servidor, es necesario validar si la integración está funcionando correctamente.
Siga los pasos de abajo para hacer la verificación:
1. Ejecutar el servicio manualmente
- Ejecute el servicio
servicoSolinftecmanualmente (por terminal o por el servicio PM2). - El servicio generará el token, consultará los datos del día e insertará los registros en la tabla HISSOL.
2. Verificar la tabla HISSOL
- Acceda a la base de datos y verifique si los registros se insertaron correctamente en la tabla HISSOL (Historial de Solicitudes).
- Los datos deben contener información como: fecha, equipo, operación, área trabajada, etc.
3. Esperar el procesamiento automático
- Espere a que el job automático ejecute la procedure INTEGRACAO_SOLINFTEC.
- Esto puede tardar algunos minutos, según la periodicidad configurada.
4. Verificar la tabla PROINT
- Si hay fallas de mapeo o errores en los datos recibidos, se registrarán en la tabla PROINT (Problemas de Integración).
- Verifique si hay registros en esa tabla.
- Si los hay, corrija los mapeos faltantes (Máquina, Parcela, Equipo, etc.).
- Después de la corrección, el sistema podrá reprocesar automáticamente o con una nueva ejecución del servicio.
5. Confirmar en el sistema upCampo
- Acceda al menú
Operacional > Orden de serviciodentro de la plataforma upCampo. -
Confirme si los datos que vienen de Solinftec se insertaron y vincularon correctamente a las órdenes de servicio:
- Máquinas utilizadas
- Área trabajada
- Equipo involucrado
- Tipo de operación
❓ Preguntas frecuentes
¿Para qué sirve la integración entre upCampo y Solinftec?
Para usar los datos generados por las máquinas, capturados por Solinftec, y alimentar automáticamente las órdenes de servicio de upCampo. Así, las hectáreas trabajadas y las máquinas utilizadas se cargan sin digitación, lo que aumenta la confiabilidad de la información.
¿Por qué integrar en lugar de usar solo uno de los sistemas?
Porque cubren capas diferentes: Solinftec está enfocada en el monitoreo de máquinas agrícolas, con datos precisos y automatizados del campo; upCampo está especializada en la gestión completa de la operación: actividades, equipos, productos y costos.
¿Qué es el mapeo de/para?
Es la correspondencia entre los identificadores de las dos plataformas. Sin ese "de/para" configurado, los datos sincronizados no se interpretan ni se asignan correctamente dentro de upCampo. El mapeo cubre flotas, parcelas, operaciones, empleados y equipos.