Settings
Open Add-ons > Manage add-ons > Mercado Libre Marketplace Connector > Settings for the general settings, and Orders > Mercado Libre channel for the working pages (Listings, Categories, Attributes, Rules, Orders, Returns, Connection, Log, Jobs).
General
Section titled “General”| Setting | Default | Description |
|---|---|---|
| Enable | On | When off, no new work is started. Jobs and notifications of work that is already under way are still processed. |
| Marketplace owner mode | On | On: every order is processed with the marketplace owner’s account and vendors have no connection page. Off: each vendor connects their own account. |
| Debug log | Off | Also stores every HTTP call with masked request and response. Secrets and tokens are never stored. |
| Log retention (days) | 90 | Older log entries are removed by the cron run. |
| Sync interval (minutes) | 15 | How often products are synchronized and orders imported (notifications are processed as soon as the queue runs). |
| Status of imported orders | O (Open) | Status of a new Mercado Libre order in CS-Cart (the “Created” row of the status mapping). |
| Payment method ID for imported orders | empty | Empty = the first active payment method. |
Connection
Section titled “Connection”Credentials are not ordinary settings: they are entered on the Connection page and stored encrypted (AES-256-GCM, key derived from your store’s own secret). They are never shown again; leave the secret field empty to keep the saved value. Saving other fields keeps the Mercado Libre authorization; a new client ID or secret removes it and you connect again.
| Field | Description |
|---|---|
| Mode | Mercado Libre has no sandbox. Test = the credentials you use with a Mercado Libre test user, Live = the real seller account. Both use the production API; each needs its own authorization. |
| Client ID / Client secret | The App ID and Secret Key of your own application (one set per mode). |
| Site | MLM Mexico (MXN), MLB Brazil (BRL), MLA Argentina (ARS), MLC Chile (CLP), MCO Colombia (COP), MLU Uruguay (UYU), MPE Peru (PEN). Sets the currency of prices, the category tree and the language of the category names (Spanish or Portuguese, as Mercado Libre returns them). It must be the site of the seller account; the connection test reports a mismatch. |
| Listing type | gold_special (Clasica), gold_pro (Premium) or free. The types you may use and their fees depend on the site, category and account. |
| Shipping | Mercado Envios 2 (the item is offered with Mercado Libre shipping; the seller account must be enabled for it) or not specified (arranged with the buyer). |
| Free shipping, Local pick-up | Sent with every new item. |
| Seller warranty (days) | 0 = no warranty term. Otherwise the warranty type “seller warranty” and the days are sent in the language of the site. |
The page also shows the redirect address to register in your application and the notification address (with the private key) to enter as the notifications callback URL.
Tokens: the access token lives 6 hours and is refreshed automatically; the refresh token is valid for 6 months, can be used once and a new one comes with every refresh, so it stays valid as long as the cron runs. Mercado Libre also invalidates the authorization when the user changes the password, when the application’s client secret is renewed, when access is revoked and after 4 months without any API call. If that happens the Connection page asks you to connect again.
Rules page
Section titled “Rules page”| Group | Setting | Description |
|---|---|---|
| Prices | Markup %, fixed amount | Added to the CS-Cart price. A category mapping overrides it for its products, a product markup (Listings page) overrides both. |
| Prices | Price endings | Keep, whole numbers, always x.99 or x.90. Prices in Chilean and Colombian pesos are sent as whole numbers. |
| Prices | Exchange rate | Amount in the site currency per 1 unit of the store’s primary currency. 1 = use the rate of the CS-Cart currency with the same code when it exists, else prices go unchanged. |
| Stock | Stock buffer, show zero at or below, maximum | Mercado Libre sees stock minus the buffer; 0 at or below the minimum. Stock 0 pauses the item at Mercado Libre; stock above 0 reactivates an item that was paused for lack of stock. |
| New listings | Create items automatically | Mapped products that are not on Mercado Libre yet are sent by the sync. |
| New listings | Default brand name, brand feature | The brand is sent as the BRAND attribute (free text). |
| Orders | Customers | Guest orders, or attach to the customer account with the same e-mail (Mercado Libre gives no buyer e-mail; orders get a placeholder address). |
| Orders | Status mapping | CS-Cart status for each state (Created, Picking, Shipped, Delivered, Cancelled, Returned). Picking = the shipment is being handled or is ready to ship, Shipped, Delivered, Not delivered, Cancelled follow the Mercado Libre shipment status. Empty = leave unchanged. |
| Shipping | I ship with my own carrier | Reports the tracking number and the status shipped for shipments with custom shipping. Mercado Envios 2 shipments report themselves: nothing is sent. |
The queue runs from cron. Use either the command line or the secret web address shown in the Cron section of the settings:
php /path/to/store/admin.php --dispatch=kv_mercadolibre.cronor call index.php?dispatch=kv_mercadolibre.cron&key=<your key> every minute.
Notification address
Section titled “Notification address”index.php?dispatch=kv_mercadolibre.webhook&c=<account>&k=<key>: Mercado Libre posts a small JSON message (topic, resource, user id) to it. The add-on checks the key, the topic (orders_v2, items, shipments), the resource format and the seller, answers 200 at once and puts the message in the job queue, where the named resource is read with your token. Mercado Libre asks for an answer within 500 ms and drops a topic that keeps failing, so the address must be reachable and fast; if notifications are lost, the polling imports the orders anyway.