¿Este registro ya existe?
Conserva el identificador externo y el sistema que lo creó. Reenviar la misma información no debería crear otro trabajo.
Conecta una vez. Conserva el significado.
La API mueve datos. Un buen contrato conserva de dónde vienen, qué significan y qué se puede hacer con ellos. Ese es el punto de partida para integrar Drometra.
Drometra / interfaz de datosEjemplo
La conexión empieza en el contrato.
GET / /observations01 — 07
{
"asset_id": "veh_demo",
"kind": "position",
"origin": { "channel": "gateway" },
"occurred_at": "2026-09-26T09:00:00Z",
"received_at": "2026-09-26T09:00:03Z"
}Origen y recepción son tiempos distintos. Ejemplo explicativo; no envía solicitudes.
Cuatro preguntas antes de escribir el primer conector
Una integración útil resuelve también la segunda sincronización, el dato corregido y el proveedor que tarda en responder.
¿Quién puede cambiar este dato?
Define el maestro por dominio y, cuando haga falta, por campo. Catálogo, stock, trabajo y evidencia no necesitan pertenecer al mismo sistema.
¿Cuándo ocurrió y cuándo llegó?
Separa tiempo de origen y recepción. Una actualización atrasada no debe parecer un evento que acaba de ocurrir.
¿Qué pasa si se corta la conexión?
Acordar cursor, deduplicación, estados desconocidos y reconciliación evita convertir un reintento en un segundo efecto.
Menos pegamento. Más lógica de tu negocio.
La capa cliente debe ayudar con tipos, autenticación y tratamiento de errores. El adaptador traduce el sistema de origen sin llevar sus particularidades al resto de Drometra.
- Un mapeo explícito para cada campo y su unidad.
- Lectura inicial y actualizaciones con una posición de avance recuperable.
- Capacidades declaradas: lo que el proveedor no ofrece no se simula.
El lenguaje, las librerías y el acceso al entorno se acuerdan según el conector. La referencia no supone que exista un paquete público para cada lenguaje.
Un adaptador, tres responsabilidades
Entrada
Leer el origen con sus permisos y límites.
Traducción
Mapear campos sin borrar procedencia.
Resultado
Registrar qué se procesó y qué necesita revisión.
El pedido sale del ERP. El resultado vuelve con su referencia.
Recibir el pedido
El ERP conserva catálogo y pedido. Se relacionan su identificador, dirección, cantidades y condiciones con el trabajo operativo.
Resolver en terreno
Drometra conserva visita, intento, recepción y evidencia. Una entrega parcial mantiene cantidades y siguiente acción.
Devolver el resultado
Se informa el resultado permitido por el contrato, con identificadores y versión. Un fallo de envío queda pendiente para reconciliar, sin duplicar el efecto.
Trae un flujo, no una lista de logos.
Una muestra anonimizada y una excepción frecuente permiten diseñar un contrato que realmente cubra tu operación.
- Sistema y versión; documentación de la API a la que tienes acceso.
- Campos necesarios y quién mantiene cada uno.
- Ejemplo anonimizado de entrada, cambio y resultado esperado.
- Permisos, frecuencia, volumen y modo de recuperar un fallo.
Preguntas frecuentes
Construyamos una conexión con propósito
Muéstranos el sistema, el trabajo que debe cruzar y la excepción que hoy te cuesta resolver.