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
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Inventory (stock)
• Sales (sale_management) • Discuss (mail) • Invoicing (account) |
| Lines of code | 1888 |
| Technical Name |
mp_mercadolibre_connector |
| License | OPL-1 |
| Website | https://pokutsoft.com/ |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module