MercadoLibre LATAM Connector for Odoo
Sync items, orders, shipments and claims with MercadoLibre across Chile, Colombia, Peru, Uruguay and Ecuador
Connect Odoo straight to your MercadoLibre seller account. Publish products as listings, pull marketplace orders into Odoo sales with buyer and tracking data, keep price and stock in sync, follow shipment status, and read and answer post-sale claims — all driven by your own MercadoLibre OAuth application.
Key Features
Order Sync (pull)
A scheduled job and an on-demand button search your MercadoLibre orders by status and date window, page by page. Each order becomes an Odoo sale order with the buyer, currency, total and order lines resolved to your products.
Product Lines Matching
Order items are matched to your catalog by Internal Reference, barcode or MercadoLibre item id, so quantities and unit prices land on the correct Odoo products automatically.
Item Publishing
Publish Odoo products as MercadoLibre listings with title, category, price, currency, available quantity, listing type, condition, description and seller SKU — from the product form or in bulk from the product list.
Price & Stock Sync (push)
Push the Odoo sales price and on-hand quantity onto your live listings — per product, in bulk, or on an hourly cron that keeps every published item up to date.
Shipment Tracking
Each order's shipment is pulled from MercadoLibre with status, tracking number and tracking method, mapped to a clear Odoo delivery state (handling, ready, shipped, delivered, exception).
Post-Sale Claims
Read claims raised against your account into Odoo, see type, stage, status and the related order, and reply to the buyer or mediator directly from Odoo through the post-sale API.
Multi-Account, Multi-Site
Run several seller accounts side by side, each bound to its MercadoLibre site (CL/CO/PE/UY/EC) and company. Orders, claims and listings carry the account they belong to.
OAuth with Auto-Refresh
Built-in OAuth 2.0 flow: get the authorization URL, paste the redirect code, and the connector stores and silently refreshes the short-lived access token using your refresh token — including on-the-fly retry when a token expires mid-call.
API Log & Resilience
Every call is logged with operation, status, duration and error excerpt. The HTTP layer retries idempotent calls on 5xx with exponential backoff and a 30-second timeout.
BYOK — Bring Your Own Keys
This is a seller-API connector. You register your own application in the MercadoLibre developer console and authorise it against your seller account. The connector stores and uses your Client ID, Client Secret and tokens — we never ship our own credentials and your data is sent only to the MercadoLibre API endpoint you configure (the base URL is editable for proxies). We are not a MercadoLibre partner or reseller.
Resource Coverage
| Area | MercadoLibre Resource | Direction |
|---|---|---|
| Identity | /users/me | read |
| Orders | /orders/search, /orders/{id} | pull |
| Shipments | /shipments/{id} | pull |
| Items | /items, /items/{id} | publish / update |
| Seller items | /users/{id}/items/search | read |
| Claims | /post-sale/v1/claims/search | pull |
| Claim reply | /post-sale/v1/claims/{id}/actions/send-message | push |
| OAuth | /oauth/token | auth |
Requirements
- Odoo 18.0 or 19.0 (Community or Enterprise).
- A MercadoLibre seller account on one of CL/CO/PE/UY/EC.
- Your own MercadoLibre application (Client ID / Client Secret) and a registered redirect URI.
- The Python
requestslibrary (standard in most Odoo deployments).
Screenshots
Accounts
Api Log
Claims
Settings
Update date: 2026-07-02