La telemetría vale poco si las lecturas viven en una isla. La integración por API conecta la plataforma de medición con el sistema que factura, el ERP que contabiliza o el CRM que atiende al cliente. Sin ella, alguien termina exportando Excel cada mes, y ahí es donde se cuelan los errores que después nadie puede explicar.
Los dos patrones de integración
La mayoría de los proyectos usa ambos combinados.
- 1Pull: el sistema comercial consultaCada noche pide a la API las lecturas del periodo. Simple, predecible y fácil de auditar.
- 2Push: la plataforma notificaWebhooks que avisan al instante de eventos: alarma de fuga, lectura de cierre, medidor sin reportar.
- 3Combinación recomendadaPull para el ciclo de facturación, push para lo que requiere reacción inmediata.
- 4Exportación programada de respaldoCSV o similar para sistemas legados que no consumen APIs modernas.
El contrato de datos: lo que evita el 80% de los problemas
Definir esto el primer mes ahorra semanas de depuración al final.
| Elemento | Por qué importa |
|---|---|
| Identificador único de toma | Debe ser el mismo en ambos sistemas o nada cuadra |
| Sello de tiempo en UTC | Evita líos con horario de verano y zonas |
| Unidades explícitas | Litros o metros cúbicos: nunca asumir |
| Catálogo de alarmas versionado | Que un cambio de firmware no rompa la integración |
| Manejo de lecturas faltantes | Regla clara para estimar y marcar como estimado |
La causa raíz más frecuente: el 80% de los problemas de integración que hemos visto nacen de no definir estos cinco puntos por escrito antes de programar la primera línea.
Seguridad de la integración
Una API mal protegida expone los datos de consumo de todos tus usuarios.
- •Tokens por sistema con permisos mínimos: quien solo lee no debería poder escribir.
- •Rotación programada de credenciales, no la misma llave durante cinco años.
- •Bitácora de cada consulta: quién pidió qué dato y cuándo, lista para auditoría.
- •HTTPS obligatorio y validación de firma en los webhooks entrantes.
- •Límites de tasa para que un error de programación no tumbe el servicio.
Preguntas frecuentes
¿Qué formato entregan?
JSON sobre HTTPS como estándar, y CSV programado para sistemas legados que no consumen APIs.
¿Pueden integrar con nuestro sistema hecho en casa?
Sí, es el caso más común. Documentamos la API y acompañamos a tu equipo de TI durante la integración.
¿Y si no tenemos sistema comercial?
INTEGRA incluye facturación por consumo lista para operar, sin necesidad de un sistema externo.
¿Cuánto tarda una integración típica?
Con el contrato de datos definido, entre 2 y 6 semanas según la complejidad del sistema receptor.
¿Los datos históricos también se exportan?
Sí, sin costo y en cualquier momento. Es una condición que recomendamos exigir a cualquier proveedor de plataforma.
¿Lo aplicamos a tu proyecto?
CJ-Intellia (Zapopan / Guadalajara, Jalisco) entrega la solución completa en todo México: diagnóstico sin costo, equipo, conectividad y la plataforma INTEGRA.
