Skip to main content
ERPNext Mercado Libre Connector — A build-to-order Frappe app that connects your Mercado Libre seller account to ERPNext, syn — 1/1Illustrative preview

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.

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

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
Two-way inventory sync: ERPNext Stock Ledger changes push `available_quantity` updates to Mercado Libre, and marketplace sales decrement ERPNext stock, with a configurable safety buffer against overselling
Two-way price sync driven by `hooks.py` `doc_events` on the Item DocType, pushing price-list changes to the corresponding listing
Mercado Envíos shipping integration syncing shipment status, labels and tracking numbers back onto the Sales Order and Delivery Note
Mercado Pago settlement mapping that reconciles net payouts, marketplace fees and released balances into ERPNext Payment Entries against the originating order
Dedicated `Mercado Libre Order` DocType that stores the raw API payload, mapping status and error log for full traceability and safe re-sync
Whitelisted methods (`@frappe.whitelist()`) exposing publish, revise, and re-sync actions invoked from Client Scripts and custom desk buttons
Background processing via `frappe.enqueue` for bulk order and listing operations so long-running syncs never block the ERPNext UI
Multi-site support for Mercado Libre country sites (MLA/MLB/MLM/MLC/MCO) with per-site currency and category handling
Role profile and permission setup so marketplace operators see only the connector DocTypes and actions relevant to them
Structured error handling with ret/backoff on API rate limits and an Error Log surface in the desk for failed syncs, built for Frappe/ERPNext v15 and forward-compatible with v16

Built to order, done for you

No DIY setup — a working app, built, installed and supported by ECOSIRE.

  1. 1

    You order

    Start with a one-time build price. We scope it with you at kickoff.

  2. 2

    We build & install

    ECOSIRE builds, configures and installs it on your ERPNext.

  3. 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

CriterionECOSIRECustom BuildCompetitorERPNext Native
Mercado Libre order syncBuilt for your ERPNext: orders map to Sales Orders with Customer and Item resolutionPossible but you design and maintain the mapping yourselfGeneric order import, often not LATAM-awareNone — no Mercado Libre integration in ERPNext core
Listing publish & revisionPublish/revise from the desk mapped to your Item fields and categoriesBuild from scratch against the Items APISometimes supported, limited attribute mappingNot available
Inventory two-way syncStock Ledger ↔ listing quantity with configurable oversell bufferYou implement doc events and buffers yourselfOne-way or basic quantity pushNot available
Mercado Pago settlementsNet payouts, fees and balances mapped to Payment EntriesManual finance logic to build and testRarely handled — payouts reconciled by handNot available
Mercado Envíos shippingLabels and tracking synced to Sales Order and Delivery NoteRequires shipping API work you scope yourselfPartial or add-on onlyNot available
Fit to your instanceScoped to your sites, taxes, warehouses and custom fieldsFully bespoke but you own all the effortOne-size-fits-all configurationN/A
Maintenance & ownershipFull git repo handover plus a support windowYou own everything, including future API changesVendor-controlled, subscription-lockedN/A
Delivery modelBuild-to-order, ~one working week from confirmed scope, installed and testedWeeks to months depending on your team's capacityInstant install but generic and often unsupportedN/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.

Request a quote

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

Request a Quotation

Tell us about your ERPNext Mercado Libre Connector requirements and we'll send pricing, licensing options and a tailored proposal — usually within one business day.

No payment now. This sends a quote request to our team — we'll follow up by email with pricing and next steps.