Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Catalog import - Catalog - Mercado Pago Developers

Intelligent search powered by OpenAI 

Catalog import

POST

https://api.mercadopago.com/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. The catalog must have at least 60% of its items with images. It will return a 202 - Success response when all requests were sent successfully, or 206 - Partial Error if any post fails.
Request's parameters
BODY
store_ids
array
Array 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.
sections
array
Array of objects that contain information about the sections that should be imported into the catalog.
Response parameters
msg
string
Description of the operation result.
results
array
Array of publication results per store. List of publications that were sent to the processing queue.
Errors

400Description of the error.

error

Publication error caused by some inconsistency in the fields.

Request
curl -X POST \
    'https://api.mercadopago.com/proximity/integration/v1/catalog'\
    -H 'Content-Type: application/json' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    -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"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'
Sample answer
{
  "msg": "Success",
  "results": [
    {
      "store_id": "external_store_id_01",
      "catalog_id": "b2f6b992-5133-11ed-a81f-acde48001122",
      "status": "processing"
    }
  ]
}