Skip to main content

​
Mercado Libre Integration

Connect your Mercado Libre seller account with ZenFlow to automatically import orders, sync inventory, and update order statuses.
This integration supports Mercado Libre accounts in Argentina, Brazil, Mexico, Colombia, Chile, Uruguay, and Peru. Includes support for MercadoShops as an additional channel.

​
Supported Channels

This integration includes support for:
  • Mercado Libre - Main marketplace
  • MercadoShops - Your own online store within the Mercado Libre ecosystem
Both channels are managed from the same integration. MercadoShops orders are automatically imported alongside Mercado Libre orders.

​
Features

Order Import

Import orders from Mercado Libre and MercadoShops

Status Updates

Push fulfillment status back to Mercado Libre

Inventory Sync

Keep stock levels synchronized in real-time

Multi-account

Connect multiple Mercado Libre accounts

​
Setup Guide

​
Step 1: Connect Your Account

  1. Go to Settings > Integrations in ZenFlow
  2. Click Connect Mercado Libre
  3. Log in with your Mercado Libre seller account
  4. Authorize ZenFlow to access your account
Make sure you’re logged in with a seller account that has active listings. Buyer-only accounts cannot be integrated.

​
Step 2: Configure Sync Settings

After connecting, configure your sync preferences: 
Order Settings:
- Import orders automatically: Yes
- Order status to import: All / Paid only
- Assign to warehouse: [Select warehouse]

Inventory Settings:
- Sync inventory: Yes
- Sync frequency: Real-time / Every 15 min / Hourly
- Stock buffer: 0 (optional safety stock to hold back)

​
Step 3: Map Products (Optional)

If your products have different SKUs in Mercado Libre vs ZenFlow, set up product mapping:
Mercado Libre SKUZenFlow SKU
MLB-12345PROD-001
MLB-67890PROD-002

​
Order Flow

​
API Reference

​
Get Connected Accounts

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

​
Sync Orders Manually

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

​
Update Inventory

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

​
Webhooks

ZenFlow automatically listens for these Mercado Libre events:
EventDescription
orders_v2New order created or order updated
shipmentsShipment status changed
itemsProduct listing updated
questionsNew question received (optional)

​
Troubleshooting

​
Orders Not Importing

Go to Settings > Integrations and verify your Mercado Libre account shows as “Connected”. If disconnected, re-authorize the connection.
Mercado Libre webhooks should be automatically configured. If orders are missing, try manually syncing orders for the affected date range.

​
Inventory Not Updating

Ensure your products are correctly mapped between ZenFlow and Mercado Libre SKUs.
Check that inventory sync is enabled in your integration settings.

​
Rate Limits

Mercado Libre enforces API rate limits:
Endpoint TypeLimit
Orders10,000 requests/hour
Items10,000 requests/hour
Inventory3,000 requests/hour
ZenFlow automatically handles rate limiting and retries.

​
Support