---
title: "Cómo integrar Mercado Libre con ERP en Argentina: guía 2026"
description: "Guía paso a paso para integrar Mercado Libre con tu ERP en Argentina en 2026: autenticación, sync de inventario, AFIP, gotchas reales y arquitectura."
slug: "como-integrar-mercado-libre-con-erp-en-argentina"
url: "https://catalizadora.ai/blog/como-integrar-mercado-libre-con-erp-en-argentina"
cluster: "datos-sistemas/integrar-mercado-libre"
author: "Pablo Estrada"
published_at: "2026-05-11T12:00:00+00:00"
updated_at: "2026-06-19T19:59:51.42746+00:00"
read_minutes: "5"
lang: "es"
---
# Cómo integrar Mercado Libre con ERP en Argentina: guía 2026

> Guía paso a paso para integrar Mercado Libre con tu ERP en Argentina en 2026: autenticación, sync de inventario, AFIP, gotchas reales y arquitectura.

Para integrar Mercado Libre con tu ERP en Argentina en 2026 necesitás cuatro piezas: **OAuth 2.0 con Refresh Token rotativo, sync bidireccional de items y stock vía Items API, webhook listener para orders, e integración AFIP para CAE al cerrar venta**. El patrón estable es ERP como fuente de verdad, sync push hacia Mercado Libre en cada movimiento de stock, y reconciliación nocturna. Una distribuidora cliente nuestra eliminó 80 por ciento de errores 429 Too Many Requests con un rate limit wrapper global de 150 ms mínimo entre llamadas, ese tipo de detalle marca la diferencia entre integración estable y fuegos.

## ¿Qué APIs de Mercado Libre necesitás conocer?

Mercado Libre expone una API REST JSON pública y documentada. Las cuatro APIs principales para integración con ERP son:

1. **Items API** (`/items` y `/items/:id`): catálogo, stock, precio, atributos. Es la API más usada, la actualizás cada vez que cambia stock en tu ERP.
2. **Orders API** (`/orders/search` y `/orders/:id`): ventas cerradas, payments, status. La consumís via webhook (eventos) o polling.
3. **Shipments API** (`/shipments/:id`): envíos, tracking, label generation. Necesaria si manejás Mercado Envíos.
4. **Notifications/Webhooks**: eventos en tiempo real. Te suscribís a topics (`orders_v2`, `items`, `payments`, etc).

Autenticación es OAuth 2.0 con Authorization Code Flow. El Access Token dura 6 horas, el Refresh Token rotativo dura 6 meses pero hay que renovarlo en cada uso. Si lo perdés, el usuario tiene que reautorizar manualmente.

## Arquitectura recomendada: ERP como fuente de verdad

El patrón estable para integración Mercado Libre - ERP en producción:

```
ERP (fuente de verdad)
  ├─ Push: cada movimiento de stock → API Mercado Libre Items
  ├─ Push: cada cambio de precio → API Mercado Libre Items
  └─ Pull diario: reconciliación stock ERP vs Mercado Libre

Mercado Libre (canal de venta)
  ├─ Webhook orders_v2 → ERP crea venta
  ├─ Webhook payments → ERP marca factura
  └─ ERP llama AFIP → CAE → PDF → expone al comprador
```

El ERP nunca consume Items API como fuente de verdad; sólo escribe. Si no tenés un ERP propio y vivís en una hoja de cálculo, primero ordenás la hoja, después integrás. Cuando los datos se unifican, los problemas se anuncian solos.

## Paso 1: OAuth flow y manejo del Refresh Token

El flujo OAuth 2.0 estándar de Mercado Libre:

1. Tu app redirige al usuario a `https://auth.mercadolibre.com.ar/authorization?response_type=code&client_id=APP_ID&redirect_uri=REDIRECT`.
2. El usuario autoriza, Mercado Libre redirige a tu `REDIRECT` con `code=ABC123`.
3. Tu servidor intercambia el code por Access Token y Refresh Token vía POST a `/oauth/token`.
4. Guardás ambos tokens cifrados en tu base.
5. Cada llamada usa Access Token en header `Authorization: Bearer TOKEN`.
6. Cuando el Access Token expira (6 horas), usás el Refresh Token para obtener nuevo par.
7. **Crítico**: el Refresh Token es de un solo uso, te devuelven uno nuevo en cada refresh. Si no lo actualizás en tu base, la próxima vez falla.

Error frecuente: race condition donde dos workers piden refresh al mismo tiempo y uno se queda con un token inválido. Solución: lock distribuido por user_id en Redis o Postgres advisory lock.

## Paso 2: Sync bidireccional de stock con throttle

Mercado Libre tiene rate limit de 1,000 requests por hora por aplicación y por usuario. En picos, una distribuidora con 5,000 SKUs activos fácilmente lo revienta.

Patrón estable: rate limit wrapper global con mínimo 150 ms entre calls, retries exponenciales (1s, 2s, 4s) respetando header `Retry-After`. Consolidación: cuando hay 5 variantes del mismo producto, una llamada `multiget` en lugar de 5 calls individuales.

En una distribuidora cliente nuestra implementamos este wrapper y eliminamos el 80 por ciento de llamadas por ciclo. 20 conversaciones activas que antes consumían 100+ calls bajaron a 20 calls. Zero 429s después del deploy. El patrón aplica casi idéntico para Mercado Libre.

## Paso 3: Webhooks para orders en tiempo real

Te suscribís a webhooks en Developer Center de Mercado Libre. Cada vez que hay un evento, Mercado Libre hace POST a tu URL con un payload minimal (`{topic, resource, user_id, application_id, sent}`).

Tu servidor:

1. Recibe el webhook (responder 200 OK en menos de 22 segundos o Mercado Libre reintenta).
2. Hace GET al `resource` para obtener el detalle completo.
3. Persiste en cola (Redis o Postgres) con idempotency key (order_id).
4. Worker asíncrono procesa: crea venta en ERP, dispara emisión de factura, dispara packing.

**Crítico**: Mercado Libre puede mandar el mismo webhook varias veces. Idempotency es no negociable. Si tu ERP procesa dos veces la misma orden, generás factura duplicada.

## Paso 4: Integración AFIP para CAE

Al recibir webhook de `payment_paid`, tu ERP arma la factura electrónica vía WSFE (Web Service Factura Electrónica) de AFIP o WSMTXCA si tu padrón es responsable inscripto con detalle de artículos.

Flujo:

1. ERP arma payload XML SOAP con detalle de factura, CUIT comprador, monto, IVA.
2. Llama a `https://wsaa.afip.gov.ar` para token de autenticación (válido 12 horas).
3. Llama a `https://wswhomo.afip.gov.ar/wsfev1` (homologación) o producción.
4. AFIP devuelve CAE (Código de Autorización Electrónico) y fecha de vencimiento.
5. ERP genera PDF de factura con CAE impreso (obligatorio).
6. Subís el PDF a Mercado Libre vía Notes API o lo enviás al comprador por email.

El flujo completo dura 5 a 15 segundos. Si AFIP devuelve error, el ERP debe reintentar con backoff y notificar al equipo si supera 3 intentos.

## Errores comunes que salen caros

1. No rotar Refresh Token: se invalida y el usuario tiene que reautorizar manualmente.
2. No manejar 429 con backoff exponencial: terminás baneado temporalmente.
3. Procesar webhooks sin idempotency: facturas duplicadas, stock negativo, descuadres contables.
4. Llamar a AFIP en línea bloqueante sin retry: cliente queda sin factura.
5. No reconciliar diariamente: descuadres entre stock ERP y Mercado Libre.

## Próximos pasos

Si tu ERP es estándar (Tango, Bejerman, Calipso) y existen conectores Mercado Libre del proveedor, probá esos primero. Si tu ERP es a medida o el conector existente no cubre tus reglas, agendá una llamada de 30 minutos sobre tu operación.

- [MAGIA Core](https://catalizadora.ai/magia/core) si querés integración Mercado Libre - ERP a medida con AFIP nativo en 12 semanas.
- [MAGIA Forge](https://catalizadora.ai/magia/forge) si necesitás motor de IA para pricing dinámico, scoring de leads o forecast con guardrails.

Sin retainers, sin licencias atadas, código a tu nombre.
## Preguntas frecuentes

### ¿Qué APIs de Mercado Libre necesito para integrar con un ERP argentino?

Las cuatro principales son: Items API (catálogo y stock), Orders API (ventas), Shipments API (envíos) y Notifications/Webhooks (eventos en tiempo real). También necesitas OAuth 2.0 para autenticación y Refresh Token rotativo. Las APIs son REST JSON, documentación pública.

### ¿Cómo sincronizo inventario sin desfases?

El patrón estable es: ERP como fuente de verdad, sync push hacia Mercado Libre cada movimiento de stock, webhook Mercado Libre hacia ERP cuando vende. Throttle de 10 requests por segundo respetando rate limit. Idempotency keys en cada update. Reconciliación nocturna que compara stock ERP vs stock Mercado Libre.

### ¿Cómo integro AFIP con factura electrónica al cerrar venta?

Mercado Libre no factura por ti, sólo cobra. Al recibir webhook de Order Paid, tu ERP debe pedir CAE a AFIP vía WSFE o WSMTXCA, generar PDF de factura, y entregárselo al comprador (Mercado Libre lo expone vía Notes en la orden o por email separado). El flujo dura 5 a 15 segundos.

### ¿Qué errores comunes salen caros?

Tres errores típicos: no rotar el Refresh Token (se invalida cada 6 horas), no manejar 429 Too Many Requests con backoff exponencial, y olvidar que cada cuenta de vendedor tiene un rate limit independiente. Una distribuidora cliente nuestra eliminó 80 por ciento de 429 con un rate limit wrapper global de 150 ms.

### ¿Cuánto cuesta implementar esta integración?

Una integración Mercado Libre - ERP seria cuesta entre 8,000 y 18,000 USD según complejidad. Incluye OAuth flow, sync bidireccional, webhook listener, idempotency, retry logic, reconciliación nocturna y AFIP integration. Si tu ERP es a medida con MAGIA Core, la integración va incluida en el blueprint.


---

Source: https://catalizadora.ai/blog/como-integrar-mercado-libre-con-erp-en-argentina
Author: Pablo Estrada — AI Catalyst, LLC (catalizadora.ai)