Did you find this information useful?
Yes
No
Catalog import/proximity/integration/v1/catalogThis 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.
POST
Products that use it:
Request's parameters
sections
Localization: bodyArray of objects that contain information about the sections that should be imported into the catalog.array
store_ids
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.array
Response parameters
msg
Localization: bodyDescription of the operation result.string
results
Localization: bodyArray of publication results per store. List of publications that were sent to the processing queue.array
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