ORDERS

Order import

Mercado Livre orders are mirrored into Odoo as sales orders, with buyer data, line items and applied discounts. Order processing stays in Base, the financial trail stays in Odoo.

Triggered on order creation

INVOICING

Invoice export to Odoo

Once payment is confirmed in Mercado Livre, Base pushes the invoice back to Odoo as draft or confirmed. Fiscal position and payment method are mapped per market.

Draft or confirmed, your call

SYNC ENGINE

Stock sync

Odoo on-hand quantity per product is pushed to Mercado Livre on the chosen interval. Multi-warehouse aggregation handled in Odoo, single value sent to ML.

Intervals: off · 8 h · 3 h · 1 h · 5 min

SYNC ENGINE

Price sync

Odoo price lists drive ML offer prices. Set the cadence in Base. Different price lists can be assigned per market, so Brazil and Argentina pricing stay independent.

Intervals: off · 24 h · 12 h · 4 h · 1 h

CATALOG

Listing management + bulk updates

Create, edit, pause and re-list ML offers from Base, in bulk. Each variant in Odoo maps to a separate offer on ML, so attribute changes stay precise.

Bulk actions across both markets

CATALOG

AI category detection

When you create a new listing, Base proposes the correct Mercado Livre category from your Odoo product data, with attribute mapping suggestions. You confirm or override.

Both melibr and meliar trees

AFTER-SALE

Return processing

Returns and claims are imported into Base with full status mapping. Refund movements flow back into Odoo against the original sales order.

Status mapping per market

AFTER-SALE

Payout import

Mercado Pago payouts are imported into Base, with per-order breakdown of net amount, fees and taxes. Reconciliation in Odoo no longer needs guesswork.

Per-payout drilldown

LOGISTICS

Shipping + courier data

Courier name, tracking number, shipment status and delivery mode (Flex, Cross Docking, Drop Off, Fulfilment) are carried into Odoo, attached to the related sales order.

Shipment events streamed in

GROWTH

Promotions + campaigns

Opt offers in or out of marketplace campaigns from Base. Discount mechanics are computed by Mercado Livre, original prices remain protected in Odoo.

Per-offer opt-in / opt-out

BRAZIL ONLY

Brazilian fiscal compliance

Custom fields on Odoo products carry every fiscal value needed for NF-e: NCM, CEST, CSOSN, FCI, EX TIPI, ANVISA registration, origin type and the relevant tax rule.

8 fiscal fields supported

ARCHITECTURE

Multi-company

Run several Odoo companies against several Base ML accounts. Catalog, pricing and fiscal data stay scoped per company. Autosell available for the Brazilian seller account.

Per-company API key + mapping

• Mercado Livre enforces 10,000 API requests per day per seller account. Sync intervals are calibrated to stay inside this budget.
• Product variants are listed as separate Mercado Livre offers – an ML API constraint, not a Base choice.
• Agendado (scheduled) shipments are partially supported and may require manual review in Base.
• Fulfilment orders require the skip-fulfilment option in Base to avoid duplicate stock movements.
• Mercado Livre moderation can block listing updates without warning. Base surfaces the rejection reason on the offer.

FROM ODOO TO BASE

Master data, outbound

• Products + variants – each variant becomes one ML offer
• Stock on-hand – every 5 min (default)
• Price lists – every 1 hour (default)
• Custom + fiscal fields – NCM, CEST, CSOSN and more

FROM BASE TO ODOO

Operational results, inbound

• Invoices – draft or confirmed
• Payment status – reconciled per order
• Order data – buyer, lines, shipping
• Fiscal positions – mapped per market

1

Install the Base Connector module in Odoo

Install from the Odoo App Store on your 17.0 instance (Community or Enterprise). Enable External API in Odoo settings and make sure the Inventory module is installed.

Where: Odoo

2

Generate an Odoo API key from this module

Open Base Mercado Livre Connector in Odoo, click Generate API key, then copy the key together with your database name and the technical user it was issued for.

Where: Odoo

3

Paste credentials into Base.com and link Mercado Livre

In Base, add the Odoo API key, database name and user. Then connect your melibr and/or meliar seller accounts via the Mercado Livre OAuth flow. One Base account holds both markets.

Where: Base.com

4

Configure sync rules and go live

Pick your stock interval (down to 5 min), your price interval (down to 1 h), choose fiscal position mapping, set invoice push to draft or confirmed, and switch the connector on. Listings start flowing the same day.

Where: Base.com · Status: Live

BASE DOES THIS FOR YOU

What Base handles, so Odoo stays clean

Once the API key is in place, none of the items below need any further setup in Odoo.

• Order centralisation across both ML markets
• Invoice export back to Odoo on payment
• Stock sync at the chosen interval
• Price sync at the chosen interval
• Returns and claims with status mapping
• Mercado Pago payout import
• Courier and shipment event data
• Brazil + Argentina, side by side

What your Odoo needs

• Odoo 17.0 (Community or Enterprise)
  Earlier versions not supported in this release
• External API enabled
  Settings → Developer mode → Enable API access
• API key from this module
  Issued by this module, scoped to one user
• Database name + technical user
  Used by Base.com to authenticate
• Inventory module installed
  Required for stock sync
• Company alignment
  One Odoo company per Base seller account
• Reachable domain
  Odoo.sh customers: use your .sh subdomain

What your Base account needs

• Active Base.com subscription
  Mercado Livre plan included or added
• Mercado Livre seller account
  melibr (Brazil) and/or meliar (Argentina)
• Mercado Livre API access
  OAuth grant from Base during onboarding
• Base Sales module enabled
  Required for order centralisation and invoice push
• Sync intervals configured
  Stock: 5 min default. Price: 1 h default.
• Fiscal position and payment mapping
  Defined per market and per company
• Invoice export mode
  Draft or confirmed, chosen per Odoo company

External service notice. Base Connector relies on Base.com to operate. The Odoo module by itself only issues the API key and exposes data through the Odoo External API – the rest of the integration logic, including the Mercado Livre connection, runs on Base.com infrastructure. An active Base.com subscription with a Mercado Livre plan is required for the connector to function. Without it, no syncing occurs and no invoices are pushed back. base.com · Privacy Policy

Do I need a Base.com account to use this module?

Yes. The Odoo module on its own only generates an API key – it does not connect to Mercado Livre directly. The actual integration runs on Base.com, so an active Base subscription with a Mercado Livre plan is required.

Does this cover both Brazil and Argentina?

Yes. One Base account, one API key from Odoo, both melibr (Brazil) and meliar (Argentina). Run a single market or both side by side with independent price lists per market.

Are Mercado Livre orders created as sales orders in Odoo?

Orders are processed in Base.com first. Base mirrors the order into Odoo as a sales order with buyer info, lines and shipping data. The invoice is then pushed back from Base into Odoo – draft or confirmed, your choice – when Mercado Livre confirms payment.

Is the stock sync close to real time?

The default cadence is every 5 minutes – the most aggressive setting that stays inside the Mercado Livre API budget of 10,000 requests per day per seller. You can dial it back to 8 h, 3 h, 1 h or turn it off entirely.

Where do I configure the Mercado Livre side?

In Base.com. After you paste the Odoo API key into Base, every Mercado Livre setting – listings, sync rules, fiscal mapping, promotions, invoice export mode – lives in the Base interface. Odoo does not need to be touched again.

Does this support Brazilian fiscal fields?

Yes. Brazil-specific fields are carried through: NCM, CEST, CSOSN, FCI, EX TIPI, ANVISA registration, origin type and the applicable tax rule. They flow from Odoo products into Base and back into the invoice on the way home.

Can I rotate the API key without breaking the integration?

Yes. Regenerate the key from the Base Connector module in Odoo and paste the new value into Base.com. There is a short pause during the swap, but listings, orders and invoices already in flight resume from the next sync cycle.

Does it work with multi-company setups?

Yes. You can run several Odoo companies against several Mercado Livre seller accounts under one Base subscription. Catalog, pricing and fiscal data stay scoped per company, and each company can hold its own API key and mapping.