Back to Help

Mercado Libre Global Selling integration

The Mercado Libre Global Selling integration connects your marketplace account with Base.com so you can manage orders, shipment numbers, invoices, statuses, prices, and stock from one panel. The exact options available depend on the API permissions and configuration of your Mercado Libre account.

 

Mercado Libre Global Selling is a separate integration from regional Mercado Libre accounts. If you are new to marketplace connections, first review the general guide to adding marketplace accounts.

 

Select Mercado Libre Global Selling when adding the integration. Do not select a regional Mercado Libre integration unless you want to connect a separate regional account.

What the integration supports

Depending on the options returned by the marketplace API, the integration can include the following features:

  • importing orders into Base.com;
  • assigning a starting status to new orders;
  • forwarding a shipment number to Mercado Libre;
  • forwarding an invoice and, if available, a correction invoice;
  • mapping order statuses from Base.com to the marketplace;
  • synchronising prices from Base.com to the marketplace;
  • synchronising stock from the selected Inventory or warehouse;
  • synchronising shipping time when the option is available for the account;
  • mapping couriers used in Base.com to delivery services available on Mercado Libre.

The integration uses the same general configuration model as other two-way marketplace integrations. However, not every account has the same tabs and fields.

 

The availability of offer management, productization, variants, fulfillment, returns, and other features depends on the account and the marketplace API. If a tab or field is not visible in your configuration, it is not available for that account. Do not copy settings from a regional Mercado Libre integration without checking the options shown in your panel.

 

How to connect Mercado Libre Global Selling

Before you begin, make sure that you have an active Mercado Libre Global Selling account and access to the account authorisation process. Keep the correct marketplace account open if Base.com redirects you to Mercado Libre during the connection.

  1. Go to Integrations in Base.com.
  2. Click + Add integration.
  3. Select the Marketplace category.
  4. Select Mercado Libre Global Selling.
  5. Follow the authorisation or connection form displayed by Base.com. Depending on the current connection method, you may be redirected to Mercado Libre or asked to complete the fields shown in the form.
  6. Enter an Account name. This is an internal name used to identify the connection in Base.com.
  7. Click Save.

After the account has been added, open Integrations → Mercado Libre Global Selling → Connection and click Test connection. A successful test confirms that Base.com can communicate with the connected marketplace account.

 

Review the account settings after connection

After connecting the account, review every tab that is visible in Integrations → Mercado Libre Global Selling. Depending on the account, you may see:

  • Connection – connection details and the connection test;
  • Orders – order downloading, starting status, shipment number forwarding, and invoice forwarding;
  • Listing settings – default offer settings, if enabled for the account;
  • Order statuses – status mapping from Base.com to the marketplace;
  • Prices – price synchronisation;
  • Stock – stock synchronisation and stock limits;
  • Shipping time – shipping-time synchronisation, if available;
  • Advanced settings – courier mapping and other account-specific options.

Some fields are dynamic. This means that Base.com displays them only when Mercado Libre returns the required capability for your account. A test account can also expose fewer options than a production account.

 

How to configure orders, statuses, shipments, and invoices

Orders

Before enabling order downloading, prepare the statuses used by your order workflow. You can find general guidance in the article about Order Manager configuration.

Open Integrations → Mercado Libre Global Selling → Orders. The form may include the following settings:

  • Order downloading – choose whether orders should not be downloaded, or whether Base.com should use the standard or fast downloading mode available for the integration;
  • First order download – select the initial range, such as all orders, orders from the last 24 hours, the last 7 days, or the last 30 days;
  • Order status – select the Base.com status assigned to newly imported orders;
  • Automatically accept orders – enable this option only if it is displayed and you want Base.com to accept orders automatically;
  • Download unpaid orders – decide whether unpaid orders should be imported when the option is available;
  • Use product name from Inventory – use the name saved in Base.com instead of the name returned by the marketplace;
  • Use product SKU from Inventory – use the SKU saved in the linked product in Base.com;
  • Send orders to online shop – use this option only when orders from this marketplace should also be sent to a connected online shop.

After selecting the settings, click Save. Then check whether a new order appears in the selected status in Orders → Order list.

For a detailed explanation of importing orders, see downloading orders.

 

Order status mapping

Status mapping controls which status is sent to Mercado Libre when an order changes status in Base.com.

  1. Go to Integrations → Mercado Libre Global Selling → Order statuses.
  2. Set Order status mapping to Yes.
  3. In the mapping table, select a Mercado Libre status for each relevant Base.com status.
  4. For internal statuses that should not be sent, select Do not transfer this status to the marketplace.
  5. Click Save.

The left column contains statuses from Base.com, while the right column contains statuses returned by the marketplace. The initial status used for imported orders cannot be mapped as a status sent to Mercado Libre. If you need to change it, return to Integrations → Mercado Libre Global Selling → Orders and select another starting status.

Status synchronisation works from Base.com to Mercado Libre Global Selling. A status changed directly in the marketplace does not automatically change the status in Base.com. More general information about this mechanism is available in the article about order status mapping.

 

 

Shipment numbers and courier mapping

To forward a shipment number, first configure the forwarding method in Integrations → Mercado Libre Global Selling → Orders. The available choices depend on the marketplace API and may include forwarding automatically, after marking the shipment as sent, or after moving the order to a selected status.

Next, configure the courier mapping:

  1. Go to Integrations → Mercado Libre Global Selling → Advanced settings.
  2. In Courier mapping, select the courier used in Base.com.
  3. If the field is available, select the delivery country.
  4. Select the corresponding courier or delivery service in Mercado Libre.
  5. Click Add mapping.
  6. Use Check mappings to find orders for which the courier is not mapped.
  7. Click Save if the form displays a separate save action.

A shipment must contain a valid tracking number before it can be forwarded. If the marketplace requires shipment information before a final order status, create the shipment first, verify that the tracking number is present, and only then move the order to the status that triggers forwarding.

You can find additional information about forwarding shipment numbers in the article about shipment number forwarding.

 

Invoices and correction invoices

If invoice forwarding is available for your Mercado Libre Global Selling account, configure it in Integrations → Mercado Libre Global Selling → Orders.

  • Invoice forwarding – select whether Base.com should not forward an invoice, forward an invoice, or forward an invoice and receipt when those options are available;
  • Correction invoice forwarding – enable forwarding of correction invoices if the field is displayed for your account.

The invoice must exist on the order in Base.com before it can be forwarded. If the option is not visible, the current API configuration does not expose document forwarding for that account. In that case, use the document workflow available for the marketplace and your accounting process. General information about creating sales documents is available in the article about sales documents and invoices.

 

How to configure price and stock synchronisation

Before enabling automatic synchronisation, verify the source Inventory, the linked product, and the desired behaviour for a zero price or zero stock. Set a conservative daily limit for ending offers and review the first synchronisation logs before expanding the scope.

Price synchronisation

Open Integrations → Mercado Libre Global Selling → Prices. The exact synchronisation intervals are dynamic and depend on the integration. Select the interval displayed in your account.

The price form may include the following rules:

  • Price 0 – choose whether Base.com should do nothing or end the offer when the product price is zero;
  • Lower price – choose whether Base.com should leave the marketplace price unchanged or decrease it to the price from Inventory;
  • Higher price – choose whether Base.com should leave the marketplace price unchanged or increase it to the price from Inventory;
  • Daily limit for ending offers – set the maximum number of offers that can be ended during 24 hours;
  • Rounding – select the rounding method if the option is available.

Price synchronisation works in the direction Base.com → Mercado Libre Global Selling. A price changed directly on the marketplace should not be treated as the source price for Base.com synchronisation.

For price synchronisation to work correctly, an offer must be connected to the correct product in the selected warehouse or Inventory. If you imported offers created outside Base.com, check their connections in Marketplace → Offer management → Operations → Link to products in Inventory. You can also read more about linking offers to products in Inventory.

After the first cycle, review the synchronisation logs displayed below the form. Check the number of checked offers, changed offers, ended offers, and errors. The general principles are also described in the article about price synchronisation.

 

Stock synchronisation

Open Integrations → Mercado Libre Global Selling → Stock. First select the source of the stock in the account or listing settings. The source can be the Base.com Inventory, one warehouse, several selected warehouses, an online shop, an ERP connection, or a wholesaler’s warehouse, depending on your setup.

If you use several Inventories or warehouses, verify whether the form should sum their stock and which warehouses are selected. The selected source must reflect the stock that is actually available for sale.

The Stock form may include the following settings:

  • Synchronisation – select the interval offered for the account;
  • Zero stock – do nothing, set the offer quantity to zero, set it to one, or end the offer, depending on the options returned by the marketplace;
  • Lower quantity – reduce the marketplace quantity to the stock available in Base.com;
  • Higher quantity – increase the marketplace quantity, activate an inactive offer, or resume an offer if the option is available;
  • Daily limit for ending offers – protect the account against mass ending of offers after an unexpected stock update;
  • Maximum quantity – set the maximum quantity that Base.com can send to an offer;
  • End offer at stock level – treat a selected threshold as zero stock;
  • Marketplace warehouse – select a marketplace warehouse if the account supports more than one;
  • Fulfillment offers synchronisation – configure this only if the field is displayed and your account supports fulfillment offers.

Stock synchronisation is normally an outbound process from Base.com to the marketplace. A stock reservation created during order processing is not a replacement for selecting the correct source warehouse. Check both the reservation workflow and the stock source when investigating a discrepancy.

The first stock cycle should be checked in the synchronisation logs. If you need a general explanation of the available rules, see stock synchronisation.

 

Shipping-time synchronisation

If the Shipping time tab is available, you can connect the shipping time in the offer with an additional field in the Base.com Inventory.

  1. Go to Products → Settings → Additional fields and create a product field of the type supported by the form, such as a number or a single selection field.
  2. Enter the shipping-time value for the relevant products.
  3. Open Integrations → Mercado Libre Global Selling → Shipping time.
  4. Enable shipping-time synchronisation and select the additional field.
  5. Click Save.

This function works only for offers linked to products in Base.com Inventory when the marketplace supports the relevant API operation.

 

FAQ and common issues

Why are orders not appearing in Base.com?

Check the following items:

  • the connection test in Integrations → Mercado Libre Global Selling → Connection is successful;
  • order downloading is enabled in the Orders tab;
  • the first download range includes the order;
  • unpaid orders are included if the order has not yet been paid;
  • the selected starting status is still available in Base.com;
  • the account is not a test account with restricted API data;
  • the order belongs to the connected Mercado Libre Global Selling account.

If the order was created before the first download range or is not returned by the marketplace API, Base.com cannot import it through the regular cycle.

 

Why was the shipment number not forwarded?

Verify that a shipment was created in Base.com and that it contains a tracking number. Then check the forwarding method in the Orders tab and the courier mapping in Advanced settings. If the courier is not mapped, the marketplace may reject the shipment number even when the tracking number itself is correct.

 

Why did the status not change on Mercado Libre?

Status forwarding is performed only for statuses that are mapped and only in the direction Base.com → marketplace. Check that:

  • Order status mapping is enabled;
  • the Base.com status is mapped to a marketplace status;
  • the status is not the initial status used for imported orders;
  • the order has the required shipment or invoice, if the marketplace requires it before the selected status;
  • the order belongs to the correct integration

Why are prices or stock not updating?

Start with the offer connection. An imported offer must be linked to the correct product and source warehouse. Then check whether price or stock synchronisation is enabled, whether the selected rules allow the change, and whether the logs contain an error returned by the marketplace.

An offer can remain unchanged when the selected rule is Do nothing, when the product has zero price or stock and the corresponding zero rule prevents changes, or when Mercado Libre blocks an update because of moderation, an inactive account, or another marketplace restriction. If the error is returned by the marketplace, resolve the restriction there and repeat the operation in Base.com.

 

Why do I see different tabs than another seller?

Tabs and fields are controlled by the capabilities returned for the account. The available configuration may differ between a production account, a test account, and accounts with different API permissions. Use the tabs that are shown in Integrations → Mercado Libre Global Selling; do not create unavailable settings manually.

 

Can I use the regional Mercado Libre integration for Global Selling?

No. Mercado Libre Global Selling is a separate marketplace integration. Add and configure it independently in Integrations → + Add integration → Marketplace. A regional Mercado Libre account and a Global Selling account may require separate integrations in Base.com.

 

Does Mercado Libre Global Selling always support offer management, variants, productization, returns, and fulfillment?

No single list applies to every account. These functions are available only when the corresponding tab or field is displayed and enabled for the connected marketplace account. If you do not see a feature, check the account configuration and the API permissions on Mercado Libre before contacting support.

 

When checking a problem, change one setting at a time and review the synchronisation log afterwards. This makes it easier to identify whether the cause is the source warehouse, the linked product, an unmapped courier, or a restriction returned by Mercado Libre.

Was this helpful?

Back to Help