Cómo integrar un ERP con Mercado Libre sin perder trazabilidad
Ver contenido del artículo
Integrar un ERP con Mercado Libre sin perder trazabilidad exige definir quién puede modificar cada dato, conservar la relación entre los identificadores de ambos sistemas y registrar qué ocurrió en cada intento. Los webhooks aceleran la detección de cambios, pero la recuperación depende de idempotencia y reconciliación.
Una integración puede mover stock, precio y órdenes y aun así dejar a la operación sin respuestas. Si un pedido no aparece, ¿Mercado Libre nunca lo notificó, la integración no lo procesó o el ERP lo rechazó? Si un precio difiere, ¿cuál era el valor esperado y cuál quedó aplicado?
La respuesta no está en prometer sincronización perfecta. Está en diseñar un circuito que muestre identidad, autoridad, intentos, resultados y diferencias.
Qué significa trazabilidad en una integración
En este contexto, trazabilidad es la capacidad de reconstruir el recorrido de un dato o una orden entre Mercado Libre, la capa de integración y el ERP. No alcanza con guardar el último estado. Hay que poder responder de dónde vino, qué identificadores llevaba, qué transformación recibió y dónde terminó.
El valor que el sistema autorizado quiso publicar, registrar o actualizar.
El valor que la API o el sistema de destino devuelve después del intento.
Esa diferencia evita una confusión frecuente: enviar una actualización no significa que haya quedado aplicada. Puede existir una validación, una automatización activa, un estado de publicación incompatible o una falla temporal.
Una notificación rápida reduce latencia. La trazabilidad aparece cuando, además, el sistema puede detectar un evento faltante, repetir una operación de forma segura y comprobar el estado final.
Qué datos conviene mapear entre el ERP y Mercado Libre
El alcance debe declararse antes de programar. Mercado Libre documenta recursos de publicaciones y órdenes, además de notificaciones sobre cambios. Pero no todos los ERP representan esos objetos de la misma manera.
| Dato | Identidad que conviene conservar | Control necesario |
|---|---|---|
| Publicación | ID externo, cuenta vendedora y referencia interna. | Estado, canal y última lectura confirmada. |
| Producto o variante | SKU interno, publicación y variación correspondiente. | Evitar mapear solo el producto padre si se vende por talle, color u otra variante. |
| Stock publicable | SKU, depósito o regla de disponibilidad y cuenta. | Distinguir existencia física, reservado y cantidad ofrecida. |
| Precio | Lista, moneda, publicación, cuenta y vigencia. | Registrar valor esperado, intento y respuesta del canal. |
| Orden | ID de venta, cuenta, pack y referencias internas. | Impedir altas duplicadas y conservar cambios posteriores. |
| Envío | ID logístico, orden o pack y bultos asociados. | No tratar orden, paquete y envío como si fueran el mismo objeto. |
Si operás varias cuentas o canales, la cuenta de origen forma parte de la identidad. El artículo sobre varias cuentas de Mercado Libre y Tiendanube desarrolla ese problema desde la operación multicanal.
Definir quién manda para cada dato
No existe una regla universal que convierta al ERP en fuente de verdad de todo. Un ERP puede definir el precio deseado, mientras Mercado Libre confirma el precio efectivamente aplicado. El inventario físico puede vivir en un sistema y la disponibilidad comercial surgir de una regla que descuenta reservas, seguridad o stock destinado a otro canal.
Para cada dato conviene documentar cuatro funciones:
- Quién lo origina: crea el dato o la decisión.
- Quién puede modificarlo: tiene autoridad para cambiarlo.
- Quién lo distribuye: transmite el cambio entre sistemas.
- Quién confirma el resultado: permite comprobar qué quedó aplicado.
Esta separación evita los ciclos. Si dos sistemas corrigen el mismo campo en sentidos opuestos, el dato puede oscilar sin que ninguno sea claramente responsable.
También aclara la convivencia entre capas. En ERP, OMS, WMS y TMS explicamos que sus límites pueden superponerse. La decisión útil no es quién debería mandar por su sigla, sino qué producto controla realmente cada proceso.
La identidad se conserva de extremo a extremo
Una venta necesita conservar su ID de Mercado Libre y la referencia que recibe dentro del ERP. La capa intermedia no debería reemplazar una por otra. Debe relacionarlas.
Recorrido mínimo de una orden
Mercado Libre recomienda el tópico orders_v2 para cambios de ventas confirmadas. La notificación incluye la referencia al recurso. Luego la integración consulta ese recurso con autorización válida. Esa secuencia permite tratar el aviso como una señal y la API como la fuente del estado observado.
Un log útil no necesita guardar credenciales ni datos innecesarios. Sí debería conservar fecha y hora, cuenta, entidad, identificadores, acción, intento, resultado y una referencia de diagnóstico. Los tokens y secretos se protegen fuera del registro operativo.
Webhooks, idempotencia y estados inciertos
Los eventos pueden repetirse, llegar fuera de orden o procesarse después de una demora. La integración debe asumir esa posibilidad en lugar de tratar cada aviso como una orden nueva.
Idempotencia significa que repetir una solicitud no produce un segundo efecto no deseado. RFC 9110 define qué métodos HTTP son idempotentes, pero el proceso de negocio también necesita su propia protección. Crear dos veces una orden interna porque llegó dos veces el mismo aviso sigue siendo un error, aunque las consultas previas hayan usado métodos seguros.
Reconocer la misma identidad y devolver el resultado ya obtenido o continuar desde el punto seguro.
Registrar código, motivo y dato afectado antes de decidir si corresponde corregir o repetir.
Tratarlo como estado incierto. Primero consultar qué ocurrió; después decidir si se reintenta.
Comparar versión, fecha y estado actual para no pisar un cambio más reciente.
El reintento automático necesita límites, espera creciente y una salida visible para los casos que requieren intervención. Reintentar para siempre es ocultar una falla, no resolverla.
Las reglas de Mercado Libre pueden cambiar según el recurso. Por eso esta guía no congela tiempos, cantidad de reintentos ni límites de llamadas. Esos parámetros deben leerse en la documentación vigente al implementar y monitorearse en producción.
La reconciliación encuentra lo que el tiempo real no mostró
Reconciliar es comparar el universo que debería existir con el que cada sistema observa. Si el ERP tiene 418 órdenes del período y Mercado Libre expone 419, la diferencia debe transformarse en una excepción identificable.
La comparación puede trabajar por ventanas, cuentas y entidades. No tiene que corregir todo de forma automática. Primero necesita clasificar la divergencia:
- Existe en Mercado Libre y falta en el ERP.
- Existe en ambos, pero tiene distinto estado.
- La identidad no pudo mapearse.
- El cambio fue rechazado y sigue pendiente.
- El dato fue corregido después por otro actor autorizado.
La reconciliación tampoco sustituye los webhooks. Cumple otra función. Los avisos reducen demora; la comparación periódica detecta ausencias y confirma convergencia.
“Error de sincronización” obliga a investigar desde cero. “La orden X de la cuenta Y no tiene referencia ERP después de tres intentos; última respuesta Z” indica qué revisar.
Cómo probar la integración antes de depender de ella
Una prueba feliz demuestra que el recorrido básico funciona. Una prueba útil también fuerza duplicados, demoras, rechazos y recuperación.
| Prueba | Qué hacer | Qué debería poder comprobarse |
|---|---|---|
| Notificación duplicada | Procesar dos veces el mismo evento. | Una sola orden o efecto de negocio. |
| ERP temporalmente caído | Interrumpir el destino y restablecerlo. | Evento pendiente, reintento controlado y resultado final. |
| Respuesta perdida | Simular timeout después de enviar. | Consulta del estado antes de repetir la escritura. |
| SKU sin mapeo | Enviar una variante desconocida. | Excepción visible sin inventar una equivalencia. |
| Cambio conflictivo | Modificar el mismo dato desde dos sistemas. | Regla de autoridad y evidencia del resultado. |
| Evento faltante | Omitir una notificación. | La reconciliación encuentra la ausencia. |
La salida a producción debe incluir un responsable para las excepciones, un tablero de pendientes y una forma de reconstruir el recorrido sin entrar a varias bases de datos. Si vas a cambiar de arquitectura, la guía sobre implementar un WMS sin frenar la operación aporta criterios para cutover y convivencia.
Qué cambia al actualizar stock, precio o estado
Mercado Libre documenta que las publicaciones pueden sincronizar stock y precio y cambiar de estado. Las posibilidades concretas dependen del estado del ítem, sus ventas, variaciones, ofertas y automatizaciones activas.
Esto obliga a guardar dos resultados: que la solicitud fue enviada y que el valor quedó aplicado. También obliga a fechar las reglas. Una condición vigente hoy puede cambiar y convertir una integración silenciosamente en una cola de rechazos.
Por eso el contrato técnico debe definir qué campos cubre, qué restricciones conoce, cómo expone una negativa y cómo se actualiza cuando cambia la API. “Integra Mercado Libre” es una descripción demasiado amplia si no está acompañada por ese alcance.
Dónde encaja Conectodo Integra
Conectodo Integra puede conectar un ERP con Mercado Libre para transmitir o actualizar stock, precio y estado activo o pausado de publicaciones, según la integración configurada.
Conectodo Packing cumple otra función. Es el WMS para ecommerce orientado a la salida que organiza y valida el trabajo físico desde la preparación hasta el despacho. Integra mueve los datos comerciales configurados; Packing controla la ejecución dentro del depósito.
Preguntas frecuentes
¿Qué datos se pueden integrar entre un ERP y Mercado Libre?
El alcance puede incluir órdenes, publicaciones, SKU, variantes, stock, precio y estado. Debe definirse campo por campo según las capacidades del ERP, la API y la configuración elegida.
¿El ERP siempre debe ser la fuente de verdad?
No. La autoridad se define por dato. El ERP puede originar un precio deseado, mientras Mercado Libre confirma el valor aplicado y otro sistema controla la existencia física.
¿Un webhook garantiza que la orden llegó al ERP?
No. El webhook avisa que un recurso cambió. La integración todavía debe consultar el recurso, mapearlo, aplicarlo en el ERP y registrar el resultado.
¿Cómo se evitan órdenes duplicadas?
Conservando la identidad externa, verificando si el evento ya fue procesado y diseñando el alta o actualización para que un reintento no produzca un segundo efecto.
¿Qué es reconciliar una integración?
Es comparar periódicamente el estado esperado con el observado para detectar órdenes faltantes, estados divergentes, mapeos incompletos o cambios rechazados.
¿Conectodo Packing sincroniza stock y precio?
No. Esa función corresponde a Conectodo Integra según la integración configurada. Packing organiza y valida la salida física del depósito.
Conectá los sistemas sin perder la historia del dato
En una demo revisamos qué información necesitás intercambiar, qué sistema controla cada dato y dónde hoy quedan excepciones sin explicación.
Pedir demo por WhatsApp