Publication flow

Important:
As of July 1, it will be mandatory that all PUT requests to items be: https://api.mercadolibre.com/global/items. Please, start updating your endpoints.

In the Global Selling API, publications have items (products) with attributes to be sold and are visible when the user selects the product from the results list. The items are created in Global Selling (CBT site) and then can be listed in the marketplaces of Mercado Libre that the seller has enabled. Once an item is published on a marketplace, it begins to be visible to buyers who visit the site. Learn with this guide how to list products.

Contents

→List products flow
→Listing type
→Product status
→List an Official Store item



List products flow

In this way, the seller will be able to see the Global Selling item that it represents, to the physical product that it has in its deposit related to local items found in the Marketplaces that he published.
For example, a seller from China with the product "cereal bars" should create the item on the Global Selling site: "Cereal Bar - Sapphire - Test Bar" which will have the content in english and the price in US dollars (USD). Then, you can list it in the enabled marketplaces, such as Mexico and Brazil using the APIs corresponding to items/marketplace, in two local items:
- https://api.mercadolibre.com/items/MLM722109336
- https://api.mercadolibre.com/items/MLB1421316520
The item will have its translated content and the price according to the marketplace of the country. If the seller has 10 (ten) units in stock, they must be detailed in the Global Selling item and this amount will be in all sites where the item is listed, as well as when a sale is made, the subtraction will be reflected in the Global Selling site.
In relation to the price of the product, the seller can put a specific price for each marketplace and, if not defined, the price of the Global Selling item will be replicated. Remember that the item may have affected properties and should be modified in the Global Selling item, while others may be made directly on each item per marketplace.
Learn more with the following flow:

Listing type

This is another case of a mandatory attribute that only accepts pre-defined values and is very important for you to understand about it. To Global Site Item, this value is always "gold_pro".


Product status

The available status to parent and child items are active or paused. You can see how to change the status:

Parent item (CBTXXX) Children item
- active
- paused
- active
- paused
- deleted

Example to pause a CBT item:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/global/items/$ITEM_ID
{
    "status":"paused"
}
Note:
Request the /global/items resource with the parent id (CBT item id), and put the status to modify the status.

Response:

{
    "id": "CBT927817181",
    "site_id": "CBT",
    "title": "Test Item - For Loadtest Tests",
    "subtitle": null,
    "seller_id": 526124693,
    "category_id": "CBT11796",
    "official_store_id": null,
    "price": 15.1,
    "base_price": 15.1,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "USD",
    "initial_quantity": 9999,
    "available_quantity": 9999,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_pro",
    "start_time": "2020-05-13T21:35:34.000Z",
    "stop_time": "2040-05-08T04:00:00.000Z",
    "end_time": "2040-05-08T04:00:00.000Z",
    "expiration_time": "2020-08-24T19:36:37.958Z",
    "condition": "new",
    "permalink": "",
    "pictures": [],
    "video_id": null,
    "descriptions": [],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {...},
    "international_delivery_mode": "none",
    "seller_address": {...},
    "seller_contact": null,
    "location": {},
    "geolocation": {...},
    "coverage_areas": [],
    "attributes": [...],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "status": "paused",
    "sub_status": [],
    "tags": [
        "immediate_payment"
    ],
    "warranty": "Factory warranty: 90 days",
    "catalog_product_id": null,
    "domain_id": "CBT-BABIES_FOOTWEAR",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-05-13T21:35:34.000Z",
    "last_updated": "2020-06-05T19:36:37.989Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Example to pause a marketplace item:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/$ITEM_ID
{
    "site_id": "MLM",
    "logistic_type": "remote",
    "status":"paused"
}
Note:
Request the /marketplace/items resource with the parent id (CBT item id), and put the site and logistic type to modify the child status.

Response:

{
    "item_id": "CBT935763550",
    "parent_id": "CBT935763550",
    "logistic_type": "remote",
    "site_id": "MLM",
    "errors": null
}

List an Official Store item

Important:
The limited listing brands may only be offered by Official Stores and sellers certified by the brands. This measure applies in the following countries:
- In Brasil, for Adidas and Reebok
- In Colombia, for Adidas and Reebok
- In México, for Adidas, Reebok and Nike

To list an item from an Official Store, you must add the "official_store_id" attribute in the JSON when listing the Marketplace Item.

The official_store_id is applied per user, in the event that in a marketplace there is only one enabled store and it is not added in the request, when publishing it will be added by default. In case you have more than one store, you must specify which one should be used.

Request:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST http://api.mercadolibre.com/marketplace/items/$ITEM_ID

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST http://api.mercadolibre.com/marketplace/items/CBT923149287
  -H 'Content-Type: application/json'
  -d '{
    "config": [
        {
            "site_id": "MLM",
            "logistic_type": "remote",
            "official_store_id":123
        },
        {
            "site_id": "MLB",
            "logistic_type": "remote"
        }
    ]
}'
Note:
If your store is multi-brand you need to specify the official_store_id of the brand where you want to list that item. Check our Official Stores guide to know more about this topic.

Next: Listing limits.