Global items

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.

Create Global item

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. Make the next request POST with an access_token. Also, you can learn more Items specifications. The listing quota per site is 10.000 per day.

Request:

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

Example:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' -X POST http://api.mercadolibre.com/items 
{
   "listing_type_id":"gold_pro",
   "title":"Test Item - for LoadTest tests",
   "available_quantity":100,
   "category_id":"CBT11796",
   "buying_mode":"buy_it_now",
   "currency_id":"USD",
   "condition":"new",
   "site_id":"CBT",
   "price":15.1,
   "accepts_mercadopago":true,
   "non_mercado_pago_payment_methods":[
      
   ],
   "warranty":"1 year",
   "sale_terms":[
      {
         "id":"WARRANTY_TIME",
         "value_name":"90 days"
      },
      {
         "id":"WARRANTY_TYPE",
         "value_id":"2230279"
      }
   ],
   "attributes":[
      {
         "id":"PACKAGE_HEIGHT",
         "value_name":"10 cm"
      },
      {
         "id":"FOOTWEAR_TYPE",
         "value_name":"Zapatilla"
      },
      {
         "id":"PACKAGE_WIDTH",
         "value_name":"10 cm"
      },
      {
         "id":"PACKAGE_LENGTH",
         "value_name":"10 cm"
      },
      {
         "id":"PACKAGE_WEIGHT",
         "value_name":"0.7 lb"
      },
      {
         "id":"BRAND",
         "name":"Brand",
         "value_id":null,
         "value_name":"DOMINIQ",
         "value_struct":null,
         "values":[
            {
               "id":null,
               "name":"DOMINIQ",
               "struct":null,
               "source":1054850885297509
            }
         ],
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Otros",
         "source":1054850885297509
      },
      {
         "id":"GENDER",
         "name":"Gender",
         "value_id":"371795",
         "value_name":"Babies",
         "value_struct":null,
         "values":[
            {
               "id":"371795",
               "name":"Bebés",
               "struct":null,
               "source":1
            }
         ],
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Otros",
         "source":1
      },
      {
         "id":"ITEM_CONDITION",
         "name":"Item condition",
         "value_id":"2230284",
         "value_name":"New",
         "value_struct":null,
         "values":[
            {
               "id":"2230284",
               "name":"New",
               "struct":null,
               "source":1054850885297509
            }
         ],
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Otros",
         "source":1054850885297509
      },
      {
         "id":"MODEL",
         "name":"Model",
         "value_id":null,
         "value_name":"A-59081-6",
         "value_struct":null,
         "values":[
            {
               "id":null,
               "name":"A-59081-6",
               "struct":null,
               "source":1054850885297509
            }
         ],
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Otros",
         "source":1054850885297509
      },
      {
         "id":"COLOR",
         "name":"Color",
         "tags":{
            "allow_variations":true,
            "defines_picture":true,
            "required":true
         },
         "hierarchy":"CHILD_PK",
         "relevance":1,
         "value_type":"string",
         "value_max_length":255,
         "values":[
            {
               "id":"52010"
            }
         ],
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Others"
      },
      {
         "id":"SIZE",
         "name":"Size",
         "value_id":null,
         "value_name":"7 M US Women / 5.5 M US Men",
         "tags":{
            "allow_variations":true,
            "required":true
         },
         "hierarchy":"CHILD_PK",
         "relevance":1,
         "value_type":"string",
         "value_max_length":255,
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Others"
      },
      {
         "id":"GTIN",
         "name":"Universal product code",
         "value_name":"9102110000",
         "tags":{
            "multivalued":true,
            "required":true,
            "variation_attribute":true,
            "used_hidden":true,
            "validate":true
         },
         "hierarchy":"PRODUCT_IDENTIFIER",
         "relevance":1,
         "type":"product_identifier",
         "value_type":"string",
         "value_max_length":255,
         "tooltip":"How do I recognize it? It is an 8 to 14 digit number next to the barcode, on the product box or on its label.\n\n![Universal product code](https://http2.mlstatic.com/static/org-img/sd-landings/assets/pi-tooltip.png)",
         "attribute_group_id":"OTHERS",
         "attribute_group_name":"Others",
         "hint":"It may be an EAN, UPC or another GTIN."
      }
   ],
   "pictures":[
      {
         "source":"http://www.mercadolibre.com/jm/img?s=STC&v=O&f=proccesing_image_es.jpg"
      }
   ]
}
Note:
For the Global Selling items, the site_id must be “CBT”. The currency_id must be USD and the content must be in English.

Modify Global item details

With this resource you may modify Global Selling items on the site where the user requires it.

Parameters

id: It is the Global Selling item identifier, which is created through a call to the local API.

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/items/CBT1234 
  -H 'Cache-Control: no-cache' \
  -H 'Content-Type: application/json' \
  -d '{
    "site_id": "MLM",
    "logistic_type": "remote",
    "price": 1,
}

Response:

{
        "action": "POST",
        "item_id": "MLM111111",
        "parent_id": "CBT1234",
        "logistic_type": "remote",
        "site_id": "MLM",
        "errors": null
}

Errors

Error Error message Description Possible solution
item.start_time.invalid Start time $startTime is only updateable in NOT_YET_ACTIVE ítems. Field start time cannot be updated. The parameter start_time can only be updated if the item status is NOT_YET_ACTIVE
item.category_id.invalid Category $categoryId does not exist. Category not found. To see the available categories check the page/sites/$siteId (Check $sideId).
item.category_id.invalid Is not allowed to post in category $categoryId. Make sure you’re posting in a leaf category. $category.listing_allowed false. Before post an item, make sure it is allowed to post in the chosen category, see the parameter listing_allowed on /categories/$categoryId.
item.buying_mode.invalid Category $categoryId only supports listing modes: $category.buyingModes. $item.buying_modes is invalid. To see the available listing modes in category check the page /categories/$categoryId in parameter settings:{buying_modes:[…]}.
item.attributes.
missing_required
The attributes $requiredAttributeIds are required for category $item.categoryId. Check the attribute is present in the attributes list or in all variation attributes combination. Category is required atribute. To see the attributes mandatory on this category check the page /categories/$categoryId/attributes in parameter {tags:{required:{true}}}.
item.listing_type_id.invalid Invalid listing_type_id. $item.listing_type_id is invalid. To see the available listing types in category check the page /categories/$categoryId/listing_types.
item.listing_type_id.
requiresPictures
Pictures are mandatory for listing type $item.listingTypeId. Pictures is required. To see if the pictures is mandatory in category check the page /categories/$categoryId/
listing_types/silver in parameter requires_picture:{}.
item.site_id.invalid Site $item.siteId doesn’t exist. $item.site_id is invalid. To the available sites, see the page /sites.
item.description.max The description field is too long. More than $maxSize characters is not allowed. Number of characters exceeded. The number of characters in description must be less then 50000 characters.
item.pictures.max Items in category $item.categoryId cannot exceeds $maxPicturesPerItem pictures. Number of images exceeded. To see the quantity of pictures per item in category check the page /categories/$categoryId in parametermax_pictures_per_item:{}.
item.attributes.
invalid_length
Invalid value length for attribute $it.attributeId. Maximum length is ${attribute.value_max_length}. To see the attributes max_length on this attribute check the page /categories/$categoryId/attributes in parameter value_max_length for attributes with .value_type string or number.
seller.unable_to_list The seller cannot post. The seller cannot post for certain cause. Identify the “cause” field in the response. - Find out the meaning of “cause” under /users#options, set the status to list, and you will see the meaning.
- Try to make the first manual posting from My Account in Mercado Libre to see the warnings in the flow.

Next: Marketplace items.