- Home
- Apps
- Multichannel & PIM Tools
- ERPNext Mercado Libre Connector
Illustrative previewA build-to-order Frappe app that connects your Mercado Libre seller account to ERPNext,
syncing orders, listings, stock, Mercado Envíos shipping and Mercado Pago settlements in both directions.
ECOSIRE scopes, builds, installs and supports it for your specific ERPNext instance.
What is ERPNext Mercado Libre Connector?
A build-to-order Frappe app that connects your Mercado Libre seller account to ERPNext, syncing orders, listings, stock, Mercado Envíos shipping and Mercado Pago settlements in both directions. ECOSIRE scopes, builds, installs and supports it for your specific ERPNext instance. Built to order by ECOSIRE for ERPNext v15, v16 — indicative price from $999.00 USD; request a quote for a scoped proposal.
Key Features
Built to order, done for you
No DIY setup — a working app, built, installed and supported by ECOSIRE.
- 1
You order
Start with a one-time build price. We scope it with you at kickoff.
- 2
We build & install
ECOSIRE builds, configures and installs it on your ERPNext.
- 3
Go live + support
You go live in about one working week, with two weeks of go-live support. Defects in the code we deliver are fixed free of charge.
Technical Specifications
- ERPNext Compatibility
- —
- License
- Licence confirmation required
- Python Requirement
- Python 3.10+
- Database
- MariaDB 10.6+
About this Product
If you sell on Mercado Libre and run ERPNext, the two systems don't talk to each other out of the box. Orders sit in the Mercado Libre seller panel while your ERPNext Sales Orders, Stock and accounting live somewhere else, so someone is re-keying every order by hand, stock counts drift between the marketplace and your warehouse, and reconciling Mercado Pago payouts against invoices is a monthly spreadsheet exercise. ERPNext core has no native Mercado Libre integration — no OAuth handshake, no listing publish, no Mercado Envíos label flow — and generic connectors rarely handle LATAM specifics like MLA/MLB/MLM site IDs, catalog vs. classic listings, or the Mercado Pago money-release lifecycle. That is exactly the gap this connector fills.
ECOSIRE builds you a proper Frappe application (erpnext_mercadolibre) with its own module, DocTypes and role profiles, installed directly on your bench. It authenticates to the Mercado Libre API using the OAuth 2.0 server-side flow, stores tokens in a dedicated Mercado Libre Settings single DocType, and refreshes them automatically via a scheduler_events cron job so the connection never silently expires. Incoming orders are pulled through the Orders API (webhook notifications plus a scheduled polling fallback) and mapped into ERPNext Sales Orders — creating or matching the Customer, resolving each item_id/SKU to the right ERPNext Item, and writing back the marketplace order reference for traceability. A Mercado Libre Order DocType keeps the raw payload and sync status so nothing is lost if a mapping needs review.
Technically, the sync is driven by Frappe primitives you can read and audit: hooks.py doc_events fire on Item and Stock Ledger changes to push price and quantity revisions back to Mercado Libre; whitelisted methods (@frappe.whitelist()) expose publish, revise and re-sync actions that Client Scripts and custom buttons call from the ERPNext desk; and server-side logic uses the Frappe REST/frappe.client layer and background jobs (frappe.enqueue) so bulk operations don't block the UI. Inventory is two-way: ERPNext stock movements update the listing's available_quantity, and marketplace sales decrement ERPNext stock, with a configurable buffer to avoid overselling. Listings can be published and revised from ERPNext, mapping your Item fields to category attributes, pictures and shipping mode. Mercado Envíos shipments sync labels and tracking back onto the Sales Order/Delivery Note, and Mercado Pago settlements are mapped to Payment Entries so finance can reconcile net payouts, fees and released balances against the originating order.
Because this is build-to-order, we start from your actual requirements rather than shipping a one-size box. After a short scoping call we confirm your Mercado Libre site (Argentina, Brazil, Mexico, Chile, Colombia, etc.), listing types, tax and warehouse setup, and which flows you need on day one. We then build against Frappe/ERPNext v15 (and forward-compatible with v16), test on a staging bench with your data, run UAT with a rollback plan, deploy to production, and hand over the git repository plus documentation. Typical delivery is one working week from confirmed scope, and every install includes a post-go-live support window so real-world edge cases get resolved, not just the happy path.
What you get
- Installable source code for your version of the connector as a proper Frappe app (`erpnext_mercadolibre`), installable on your bench
- Installation and configuration on your staging and production ERPNext instances, including OAuth app registration and Mercado Libre Settings
- Technical documentation covering the DocType model, hooks, scheduler events, whitelisted methods and configuration options
- User guide plus a live training session for your marketplace and finance operators
- UAT on a staging bench with your real catalog and orders, plus a documented rollback plan before go-live
- Post-go-live support window to resolve real-world edge cases and mapping issues after launch
- Full git repository handover with commit history so your team (or any Frappe developer) can maintain and extend it
- Field-mapping worksheet documenting how your ERPNext Items, taxes and warehouses map to Mercado Libre categories, attributes and sites
Who this is for
LATAM Mercado Libre seller on ERPNext
An e-commerce brand or retailer already running ERPNext for stock and accounting that sells on Mercado Libre in one or more countries and needs orders, inventory and payouts to flow automatically instead of being re-keyed by hand.
Operations / marketplace manager
The person responsible for keeping listings live and stock accurate across ERPNext and Mercado Libre. Needs publish/revise actions and inventory sync from inside the desk, plus an audit trail when a mapping fails, rather than juggling two dashboards.
Finance / accounting lead
Owns reconciliation and needs Mercado Pago settlements — net payouts, marketplace fees and released balances — mapped to ERPNext Payment Entries against the right order, so month-end reconciliation stops being a manual spreadsheet job.
ERPNext implementation partner or in-house Frappe developer
A technical stakeholder who wants a clean, documented Frappe app with standard DocTypes, hooks and whitelisted methods plus a git handover, so the integration can be maintained and extended in-house on v15/v16 without vendor lock-in.
How ERPNext Mercado Libre Connector Compares
| Criterion | ECOSIRE | Custom Build | Competitor | ERPNext Native |
|---|---|---|---|---|
| Mercado Libre order sync | Built for your ERPNext: orders map to Sales Orders with Customer and Item resolution | Possible but you design and maintain the mapping yourself | Generic order import, often not LATAM-aware | None — no Mercado Libre integration in ERPNext core |
| Listing publish & revision | Publish/revise from the desk mapped to your Item fields and categories | Build from scratch against the Items API | Sometimes supported, limited attribute mapping | Not available |
| Inventory two-way sync | Stock Ledger ↔ listing quantity with configurable oversell buffer | You implement doc events and buffers yourself | One-way or basic quantity push | Not available |
| Mercado Pago settlements | Net payouts, fees and balances mapped to Payment Entries | Manual finance logic to build and test | Rarely handled — payouts reconciled by hand | Not available |
| Mercado Envíos shipping | Labels and tracking synced to Sales Order and Delivery Note | Requires shipping API work you scope yourself | Partial or add-on only | Not available |
| Fit to your instance | Scoped to your sites, taxes, warehouses and custom fields | Fully bespoke but you own all the effort | One-size-fits-all configuration | N/A |
| Maintenance & ownership | Full git repo handover plus a support window | You own everything, including future API changes | Vendor-controlled, subscription-locked | N/A |
| Delivery model | Build-to-order, ~one working week from confirmed scope, installed and tested | Weeks to months depending on your team's capacity | Instant install but generic and often unsupported | N/A |
Frequently Asked Questions about ERPNext Mercado Libre Connector
How long does delivery take?
This is a build-to-order product, not an instant download. Typical delivery is one working week from confirmed scope, depending on how many flows you need on day one (order import only vs. full listing, inventory, Mercado Envíos and Mercado Pago sync) and the complexity of your catalog. After the scoping call we give you a firm timeline before any build work starts.
Is this a Frappe Cloud Marketplace app I can just install?
No. ECOSIRE builds, installs and supports the connector for your specific ERPNext instance. It's delivered as a proper Frappe app that we install on your bench, configure to your Mercado Libre site and catalog, test on staging and deploy to production — not a self-service marketplace download.
Which ERPNext versions are supported?
We build against Frappe/ERPNext v15 as the primary target and keep the code forward-compatible with v16. If you're on an older version, we'll flag any upgrade considerations during scoping. Tell us your exact Frappe and ERPNext versions on the call and we'll confirm compatibility.
Which Mercado Libre countries and listing types are covered?
The connector handles Mercado Libre country sites such as Argentina (MLA), Brazil (MLB), Mexico (MLM), Chile (MLC) and Colombia (MCO), with per-site currency and category handling. Classic, premium and catalog listing types are supported. We confirm the exact sites and listing types you sell on during scoping so the build matches your operation.
How does support and updates work after go-live?
Every build includes a post-go-live support window to resolve real-world edge cases and mapping issues after launch. Because you receive the full git repository, your own team or any Frappe developer can maintain and extend the app. We also offer ongoing support and enhancement retainers if you'd prefer ECOSIRE to handle updates, new flows and Mercado Libre API changes over time.
Will syncing risk overselling or corrupting my ERPNext data?
Inventory sync uses a configurable safety buffer to guard against overselling, and every order is stored in a dedicated `Mercado Libre Order` DocType with its raw payload and mapping status so nothing is lost if a mapping needs review. We test the full flow on a staging bench with your real data and go live behind a documented rollback plan.
Can you integrate custom fields, taxes or warehouse logic specific to our setup?
Yes — that's the point of build-to-order. Because we build against your actual ERPNext instance using standard Frappe primitives (DocTypes, `hooks.py` doc events, whitelisted methods and Client Scripts), we can map your custom Item fields, tax templates and multi-warehouse logic into the sync. We confirm these mappings on a field-mapping worksheet during scoping.
Related Modules

ERPNext Magento / Adobe Commerce Connector
A bi-directional integration between Magento 2 / Adobe Commerce and ERPNext that keeps catalog, orders, customers, and MSI-aware inventory in sync. ECOSIRE builds, installs, and supports it to your exact scope — this is a build-to-order engagement, not an off-the-shelf download.

ERPNext Marketplace Settlement & Payout Reconciliation
A build-to-order Frappe app that imports each marketplace's settlement report, matches payouts to your ERPNext Sales Invoices, and books commission, ads, and reserve entries so your net margin is finally accurate. ECOSIRE scopes, builds, installs, and supports it for you.

ERPNext Mirakl Marketplace Connector
A build-to-order Frappe app that connects ERPNext to any Mirakl-powered marketplace — importing orders, publishing offers, syncing inventory and price, writing back shipments, and reconciling per-operator settlements from one operator-agnostic connector. ECOSIRE scopes, builds, installs and supports it for you.

ERPNext Multichannel Order Hub
A single ERPNext control tower that unifies orders, inventory, and pricing across every connected marketplace and store. ECOSIRE scopes, builds, installs, and supports it as a proper Frappe app — no instant download; typical delivery is one working week from confirmed scope.
ERPNext Mercado Libre Connector
A build-to-order Frappe app that connects your Mercado Libre seller account to ERPNext, syncing orders, listings, stock, Mercado Envíos shipping and Mercado Pago settlements in both directions. ECOSIRE scopes, builds, installs and supports it for your specific ERPNext instance.
- OAuth 2.0 server-side authentication to the Mercado Libre API with tokens stored in a `Mercado Libre Settings` single DocType and auto-refreshed via a `scheduler_events` cron so the connection never silently expires
- Order import mapping Mercado Libre orders into ERPNext Sales Orders, auto-creating or matching the Customer and resolving each `item_id`/SKU to the correct ERPNext Item
- Webhook-driven order notifications with a scheduled polling fallback, so orders still land if a webhook delivery is missed
- Listing publish and revision from the ERPNext desk, mapping Item fields to Mercado Libre category attributes, pictures, listing type (classic/premium/catalog) and shipping mode