Catalog import - Catalog - Mercado Pago Developers
Catalog import

POST

/proximity/integration/v1/catalog
This endpoint sends a catalog to be imported asynchronously to one or more stores. Each store generates an import identifier that can be used to check the process status afterwards. It will return a 202 - Success response when all requests were sent successfully, or 206 - Partial Error if any post fails.
Request's parameters
sections
array
Localization: bodyArray of objects that contain information about the sections that should be imported into the catalog.
store_ids
array
Localization: bodyArray that receives external_ids of the stores that should receive the catalog. The external_ids of each store can be configured using the Mercado Pago Delivery API.
Response parameters
msg
string
Localization: bodyDescription of the operation result.
results
array
Localization: bodyArray of publication results per store. List of publications that were sent to the processing queue.
Request
curl
curl -X POST \
      'https://api.mercadopago.com/proximity/integration/v1/catalog' \
       -H 'Authorization: Bearer YOUR_ACCESS_TOKEN \
       -H 'Content-Type: application/json' \ 
      -d '{
  "store_ids": [
    {}
  ],
  "sections": [
    {
      "description": "The most delicious burgers in town",
      "name": "Hamburguers",
      "items": [
        {
          "description": "Item Description",
          "external_id": "M147",
          "image": "https://",
          "name": "Cheese Burger",
          "price": 25.5,
          "discount_price": 20.5,
          "status": "active",
          "options": [
            {
              "name": "Desserts",
              "group_min": 1,
              "group_max": 5,
              "complements": [
                {
                  "description": "Complement description",
                  "external_id": "D184",
                  "image": "https://",
                  "min": 1,
                  "max": 5,
                  "name": "Chocolate ice cream",
                  "price": 7.25,
                  "status": "active"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'
Answer
json
{
  "msg": "Success",
  "results": [
    {
      "store_id": "external_store_id_01",
      "catalog_id": "b2f6b992-5133-11ed-a81f-acde48001122",
      "status": "processing"
    }
  ]
}
Errors
400bad_request
error Publication error caused by some inconsistency in the fields.