Skip to main content

Integracion con Mercado Libre

Conecta tu cuenta de vendedor de Mercado Libre con ZenFlow para importar pedidos automaticamente, sincronizar inventario y actualizar estados de pedidos.
Esta integracion soporta cuentas de Mercado Libre en Argentina, Brasil, Mexico, Colombia, Chile, Uruguay y Peru. Incluye soporte para MercadoShops como canal adicional.

Canales Soportados

Esta integracion incluye soporte para:
  • Mercado Libre - Marketplace principal
  • MercadoShops - Tu tienda online propia dentro del ecosistema de Mercado Libre
Ambos canales se gestionan desde la misma integracion. Los pedidos de MercadoShops se importan automaticamente junto con los de Mercado Libre.

Caracteristicas

Importar Pedidos

Importa pedidos de Mercado Libre y MercadoShops

Actualizar Estados

Envia el estado de fulfillment de vuelta a Mercado Libre

Sync Inventario

Mantiene los niveles de stock sincronizados en tiempo real

Multi-cuenta

Conecta multiples cuentas de Mercado Libre

Guia de Configuracion

Paso 1: Conectar tu Cuenta

  1. Ve a Configuracion > Integraciones en ZenFlow
  2. Haz clic en Conectar Mercado Libre
  3. Inicia sesion con tu cuenta de vendedor de Mercado Libre
  4. Autoriza a ZenFlow para acceder a tu cuenta
Asegurate de iniciar sesion con una cuenta de vendedor que tenga publicaciones activas. Las cuentas solo de comprador no pueden integrarse.

Paso 2: Configurar Sincronizacion

Despues de conectar, configura tus preferencias:
Configuracion de Pedidos:
- Importar pedidos automaticamente: Si
- Estado de pedidos a importar: Todos / Solo pagados
- Asignar a almacen: [Seleccionar almacen]

Configuracion de Inventario:
- Sincronizar inventario: Si
- Frecuencia de sync: Tiempo real / Cada 15 min / Cada hora
- Buffer de stock: 0 (stock de seguridad opcional)

Paso 3: Mapear Productos (Opcional)

Si tus productos tienen SKUs diferentes en Mercado Libre vs ZenFlow, configura el mapeo de productos:
SKU Mercado LibreSKU ZenFlow
MLB-12345PROD-001
MLB-67890PROD-002

Flujo de Pedidos

Referencia API

Obtener Cuentas Conectadas

GET /api/v1/integrations/mercadolibre/accounts
Respuesta:
{
  "success": true,
  "data": {
    "accounts": [
      {
        "id": "123456789",
        "nickname": "MITIENDA",
        "site_id": "MLA",
        "connected_at": "2024-01-15T10:30:00Z",
        "status": "active"
      }
    ]
  }
}

Sincronizar Pedidos Manualmente

POST /api/v1/integrations/mercadolibre/sync/orders
Request:
{
  "account_id": "123456789",
  "date_from": "2024-01-01",
  "date_to": "2024-01-15"
}

Actualizar Inventario

POST /api/v1/integrations/mercadolibre/inventory/sync
Request:
{
  "account_id": "123456789",
  "items": [
    {
      "item_id": "MLA1234567890",
      "available_quantity": 50
    }
  ]
}

Webhooks

ZenFlow escucha automaticamente estos eventos de Mercado Libre:
EventoDescripcion
orders_v2Pedido nuevo creado o actualizado
shipmentsEstado de envio cambiado
itemsPublicacion de producto actualizada
questionsNueva pregunta recibida (opcional)

Solucion de Problemas

Pedidos No Se Importan

Ve a Configuracion > Integraciones y verifica que tu cuenta de Mercado Libre muestre “Conectada”. Si esta desconectada, re-autoriza la conexion.
Los webhooks de Mercado Libre deberian configurarse automaticamente. Si faltan pedidos, intenta sincronizar manualmente los pedidos del rango de fechas afectado.

Inventario No Se Actualiza

Asegurate de que tus productos esten correctamente mapeados entre los SKUs de ZenFlow y Mercado Libre.
Verifica que la sincronizacion de inventario este habilitada en tu configuracion de integracion.

Limites de Tasa

Mercado Libre impone limites de tasa en la API:
Tipo de EndpointLimite
Pedidos10,000 requests/hora
Items10,000 requests/hora
Inventario3,000 requests/hora
ZenFlow maneja automaticamente los limites de tasa y reintentos.

Soporte