Recursos para IA
Importação de catálogo

Esse endpoint importa um catálogo de forma assíncrona para uma ou mais lojas. Cada loja gera um identificador de importação que pode ser usado para verificar o status do processo posteriormente. O catálogo deve ter pelo menos 60% dos itens com imagens. Retornará uma resposta 202 - Success quando todas as requisições forem enviadas corretamente ou 206 - Partial error caso alguma requisição falhe.

POST

https://api.mercadopago.com/proximity/integration/v1/catalog
Request parameters
Header
Authorization
string

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
Body
store_ids
array
Array que recebe os external_ids das loja que deverão receber o catálogo. Os external_ids de cada loja podem ser configurados usando a API do Mercado Pago Delivery.
sections
array
Array de objetos que contém informações das seções que deverão ser importados para o catálogo.
Response parameters
msg
string
Descrição do resultado da operação.
results
array
Array de resultados de publicações por loja. Lista de publicações que foram enviadas para a fila de processamento.
Erros

400Descrição do erro.

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 APP_USR-1*********685765-12*********1b4332e5c*********e077d7679*********664' \
    -d '{
  "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"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}'
Response
{
  "msg": "Success",
  "results": [
    {
      "store_id": "external_store_id_01",
      "catalog_id": "b2f6b992-5133-11ed-a81f-acde48001122",
      "status": "processing"
    }
  ]
}