Conteúdos

→Anunciar no catálogo a partir de um anúncio existente →Sincronização das condições de vendas →Criar uma publicação de catálogo de maneira direta →Publicações de catálogo criadas automaticamente
    ↳Filtrar itens por vendedor
→Criar publicações de marketplace com optin automático
    ↳Validações antes de publicar no produto obrigatório no catálogo
    ↳Benefícios no envio dos valores
    ↳Erros de validação e soluções


Anunciar no catálogo a partir de um anúncio existente

Após conferir que seu anúncio existente é elegível para o catálogo e tiver obtido o catalog_product_id ativo que corresponde exatamente ao que você está anunciando, deve criar o anúncio de catálogo a partir de um POST no recurso /items/catalog_listings.

Variações

Nos domínios onde atualmente existe catálogo, os anúncios de catálogo não contém variações, pois elas estão associadas a um produto específico. Portanto, se seu anúncio original possuía variações, você terá um anúncio de catálogo para cada uma delas. As informações importantes de suas variações (por exemplo, a cor do item) não serão perdidas, mas estarão refletidas nos atributos do produto de catálogo. No futuro, é possível que existam domínios onde o produto nunca especifique perfeitamente o que é vendido (o tamanho em roupas, por exemplo) e é possível que as variações sejam permitidas. Vamos informar quando isso acontecer. Se seu item contém variações, você deve fazer um POST para cada uma delas, enviando o campo variation_id no corpo do POST.

Exemplo de um item com variações:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/catalog_listings
{
  "item_id":"MLB1234",
  "variation_id": 4321,
  "catalog_product_id":"MLB9876"
}

Exemplo de um item sem variações:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/catalog_listings
{
  "item_id":"MLB1234",
  "catalog_product_id":"MLB9876" 
}

Exemplo resumido de resposta para a criação de um item:

Resposta:

{
    "id": "MLB1234",
    "site_id": "MLB",
    "title": "Samsung Galaxy J7 Prime 16 Gb Negro",
    "warranty": null,
    "catalog_product_id": "MLB9876",
    "domain_id": "MLB-CELLPHONES",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-08-02T11:33:31.270Z",
    "last_updated": "2019-08-02T11:33:31.270Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": true,
    "item_relations": [
        {
            "id": "MLB123456789",
            "variation_id": null,
            "stock_relation": 1
        }
    ]
}

Além disso, lembre-se de que:

  • Se o item tiver variações, mas for enviado sem elas, o POST falhará, retornando um erro 400.
  • catalog_product_id é um campo obrigatório no POST, o item possuindo ou não variações.

Sincronização das condições de vendas

A sincronização das condições de venda (como preço, forma de entrega, estoque, garantia, SKU e PIs) das publicações associadas será automática e com as seguintes regras:
- O vendedor não poderá remover a sincronização (opt-out).
- As publicações novas serão sincronizadas desde o início.
- As publicações existentes associadas serão sincronizadas assim que o vendedor modificar qualquer uma das condições de venda da publicação original.

Notas:
- A sincronização será feita após a primeira modificação, ou seja, se o vendedor primeiro modificar a publicação do catálogo, atualizaremos automaticamente a publicação de marketplace com a de referência e vice-versa.
- As mudanças serão notificadas por meio do feed de itens.

Criar uma publicação de catálogo de maneira direta

Para realizar uma publicação direta em catálogo é necessário obter o catalog_product_id que corresponde exatamente ao produto a ser publicado, consultar o recurso de busca de produtos, você obtém uma sugestão de produtos com base em determinados parâmetros de busca.

Importante:
O conteúdo da publicação do catálogo é fornecido pelo Mercado Livre. Portanto, o vendedor é responsável por confirmar que o produto a ser associado corresponde às características específicas exibidas na plataforma.

Caso haja uma diferença entre o que o usuário compra e o produto associado, é possível que sejam geradas reclamações e / ou cancelamentos que impactarão negativamente na sua reputação e, como conseqüência, a desqualificação para publicação no catálogo, levando à suspensão da conta.
Além de criar publicações de catálogo à partir publicação original, você também pode criar itens de catálogo de forma direta, sem precisar de um item de marketplace para vincular. Lembre-se de que, para criar o item em catálogo, você deve considerar os mesmos requisitos estabelecidos em Publicar item no catálogo.
Lembre-se, no momento do POST, é necessário enviar os seguintes valores para a publicação do catálogo a ser criada.

  • "catalog_product_id": este valor deve ser confirmado com o recurso de search/product.
  • "catalog_listing": true: é necessário enviar o valor como true para gerar o item de catálogo.

Chamada:

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

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
    "site_id": "MLA",
    "title": "Item de test no ofertar",
    "category_id": "MLA1055",
    "price": 10000000,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "pictures": [],
    "attributes": [
        {
            "id": "CARRIER",
            "name": "Compañía telefónica",
            "value_id": "298335",
            "value_name": "Liberado",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "catalog_product_id": "MLA6005934",
    "catalog_listing": true
}'
https://api.mercadolibre.com/items

Resposta:

{
    "id": "MLA811894603",
    "site_id": "MLA",
    "title": "Apple iPhone iPhone 3g 8 Gb Negro 128 Mb Ram",
    "subtitle": null,
    "seller_id": 464161506,
    "category_id": "MLA1055",
    "official_store_id": null,
    "price": 10000000,
    "base_price": 10000000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "start_time": "2019-08-29T14:49:42.945Z",
    "historical_start_time": "2019-08-29T14:49:42.945Z",
    "stop_time": "2039-08-24T04:00:00.000Z",
    "end_time": "2039-08-24T04:00:00.000Z",
    "expiration_time": "2019-11-17T14:49:42.987Z",
    "condition": "new",
    "permalink": "http://articulo.mercadolibre.com.ar/MLA-811894603-apple-iphone-iphone-3g-8-gb-negro-128-mb-ram-_JM",
    "pictures": [
        {
            "id": "675782-MLA31138875214_062019",
            "url": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
            "size": "249x500",
            "max_size": "598x1200",
            "quality": ""
        },
        {
            "id": "915001-MLA31138546867_062019",
            "url": "http://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
            "size": "250x500",
            "max_size": "600x1200",
            "quality": ""
        },
        {
            "id": "881441-MLA31138332972_062019",
            "url": "http://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
            "size": "243x500",
            "max_size": "585x1200",
            "quality": ""
        },
        {
            "id": "804666-MLA31139286536_062019",
            "url": "http://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
            "size": "405x500",
            "max_size": "836x1030",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA811894603-2265773390"
        }
    ],
    "accepts_mercadopago": true,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": "not_specified",
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1061221617,
        "comment": "",
        "address_line": "Test Address 123",
        "zip_code": "1414",
        "city": {
            "id": "",
            "name": "Palermo"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": 38.11569,
        "longitude": 13.3614868,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlBBTDI1MTVa",
                "name": "Palermo"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": null,
    "location": {},
    "geolocation": {
        "latitude": 38.11569,
        "longitude": 13.3614868
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "CARRIER",
            "name": "Compañía telefónica",
            "value_id": "298335",
            "value_name": "Liberado",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "ITEM_CONDITION",
            "name": "Condición del ítem",
            "value_id": "2230284",
            "value_name": "Nuevo",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "BRAND",
            "name": "Marca",
            "value_id": "9344",
            "value_name": "Apple",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "LINE",
            "name": "Línea",
            "value_id": "58993",
            "value_name": "iPhone",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "MODEL",
            "name": "Modelo",
            "value_id": "14605",
            "value_name": "iPhone 3G",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "IS_DUAL_SIM",
            "name": "Es Dual SIM",
            "value_id": "242084",
            "value_name": "No",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "COLOR",
            "name": "Color",
            "value_id": "52049",
            "value_name": "Negro",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "INTERNAL_MEMORY",
            "name": "Memoria interna",
            "value_id": "59566",
            "value_name": "8 GB",
            "value_struct": {
                "number": 8,
                "unit": "GB"
            },
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "RAM",
            "name": "Memoria RAM",
            "value_id": "366239",
            "value_name": "128 MB",
            "value_struct": {
                "number": 128,
                "unit": "MB"
            },
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "MAIN_COLOR",
            "name": "Color principal",
            "value_id": "2450295",
            "value_name": "Negro",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "OPERATING_SYSTEM_NAME",
            "name": "Nombre del sistema operativo",
            "value_id": "7404961",
            "value_name": "iOS",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        },
        {
            "id": "WITH_IMEI",
            "name": "Con IMEI",
            "value_id": "242085",
            "value_name": "Sí",
            "value_struct": null,
            "attribute_group_id": "OTHERS",
            "attribute_group_name": "Otros"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "immediate_payment",
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": "MLA6005934",
    "domain_id": "MLA-CELLPHONES",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2019-08-29T14:49:43.099Z",
    "last_updated": "2019-08-29T14:49:43.099Z",
    "total_listing_fee": null,
    "health": null,
    "catalog_listing": true,
    "item_relations": []
}

Publicações de catálogo criadas automaticamente

Tenha em conta que a publicação original será atualizada com os attributes, variations.attributes o variations.attribute_combinations do produto ao qual foi associado para que ambas as publicações, relacionadas, sejam consistentes.

Abaixo você pode ver um item do catálogo com optin automático. Lembre-se que você pode reconhecer essas publicações com a tag catalog_boost.

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789

Resposta:

{
   "id":"MLA123456789",
   "site_id":"MLA",
   "title":"Samsung Galaxy A10 32 Gb Negro 2 Gb Ram",
   "subtitle":null,
   "seller_id":12312345,
   "category_id":"MLA1055",
   "official_store_id":null,
   "price":14498.49,
   "base_price":14498.49,
   "original_price":null,
   "currency_id":"ARS",
   "initial_quantity":1,
   "available_quantity":1,
   "sold_quantity":0,
   "sale_terms":[
      
   ],
   "buying_mode":"buy_it_now",
   "listing_type_id":"gold_special",
   "start_time":"2020-02-25T13:30:06.000Z",
   "stop_time":"2040-02-20T04:00:00.000Z",
   "condition":"new",
   "permalink":"https://articulo.mercadolibre.com.ar/MLA-840863454-samsung-galaxy-a10-32-gb-negro-2-gb-ram-_JM",
   "thumbnail":"http://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "secure_thumbnail":"https://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "pictures":[
      
   ],
   "video_id":"63vjmsBa3nw",
   "descriptions":[
      
   ],
   "accepts_mercadopago":true,
   "non_mercado_pago_payment_methods":[
      
   ],
   "shipping":{
      
   },
   "international_delivery_mode":"none",
   "seller_address":{
      
   },
   "seller_contact":null,
   "location":{
      
   },
   "geolocation":{
      
   },
   "coverage_areas":[
      
   ],
   "attributes":[
      
   ],
   "warnings":[
      
   ],
   "listing_source":"",
   "variations":[
      
   ],
   "status":"active",
   "sub_status":[
      
   ],
   "tags":[
      "extended_warranty_eligible",
      "catalog_boost",
      "good_quality_picture",
      "good_quality_thumbnail",
      "immediate_payment",
      "cart_eligible"
   ],
   "warranty":"Garantía del vendedor: 6 meses",
   "catalog_product_id":"MLA14648964",
   "domain_id":"MLA-CELLPHONES",
   "parent_item_id":null,
   "differential_pricing":null,
   "deal_ids":[
      
   ],
   "automatic_relist":false,
   "date_created":"2020-02-25T13:30:06.000Z",
   "last_updated":"2020-02-28T16:28:14.000Z",
   "health":0.9,
   "catalog_listing":true
}

Filtrar itens publicados automaticamente por vendedor

Você pode realizar uma busca por vendedor para identificar os itens marcados com a tag catalog_boost, usando o seguinte recurso.

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1234567/items/search?status=active&tags=catalog_boost

Publicações de catálogo criadas automaticamente

Considere que a publicação original será atualizada com os atributos, variations.attributes ou variations.attribute_combinations do produto que foi associado para que ambas as publicações relacionadas sejam consistentes.

Abaixo você pode ver um item do catálogo com optin automático. Essas publicações podem ser reconhecidas através da tag catalog_boost.

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789

Resposta:

{
   "id":"MLA123456789",
   "site_id":"MLA",
   "title":"Samsung Galaxy A10 32 Gb Negro 2 Gb Ram",
   "subtitle":null,
   "seller_id":12312345,
   "category_id":"MLA1055",
   "official_store_id":null,
   "price":14498.49,
   "base_price":14498.49,
   "original_price":null,
   "currency_id":"ARS",
   "initial_quantity":1,
   "available_quantity":1,
   "sold_quantity":0,
   "sale_terms":[
      
   ],
   "buying_mode":"buy_it_now",
   "listing_type_id":"gold_special",
   "start_time":"2020-02-25T13:30:06.000Z",
   "stop_time":"2040-02-20T04:00:00.000Z",
   "condition":"new",
   "permalink":"https://articulo.mercadolibre.com.ar/MLA-840863454-samsung-galaxy-a10-32-gb-negro-2-gb-ram-_JM",
   "thumbnail":"http://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "secure_thumbnail":"https://mla-s1-p.mlstatic.com/935364-MLA31838804614_082019-I.jpg",
   "pictures":[
      
   ],
   "video_id":"63vjmsBa3nw",
   "descriptions":[
      
   ],
   "accepts_mercadopago":true,
   "non_mercado_pago_payment_methods":[
      
   ],
   "shipping":{
      
   },
   "international_delivery_mode":"none",
   "seller_address":{
      
   },
   "seller_contact":null,
   "location":{
      
   },
   "geolocation":{
      
   },
   "coverage_areas":[
      
   ],
   "attributes":[
      
   ],
   "warnings":[
      
   ],
   "listing_source":"",
   "variations":[
      
   ],
   "status":"active",
   "sub_status":[
      
   ],
   "tags":[
      "extended_warranty_eligible",
      "catalog_boost",
      "good_quality_picture",
      "good_quality_thumbnail",
      "immediate_payment",
      "cart_eligible"
   ],
   "warranty":"Garantía del vendedor: 6 meses",
   "catalog_product_id":"MLA14648964",
   "domain_id":"MLA-CELLPHONES",
   "parent_item_id":null,
   "differential_pricing":null,
   "deal_ids":[
      
   ],
   "automatic_relist":false,
   "date_created":"2020-02-25T13:30:06.000Z",
   "last_updated":"2020-02-28T16:28:14.000Z",
   "health":0.9,
   "catalog_listing":true
}

Filtrar itens publicados automaticamente por vendedor

Você pode realizar uma pesquisa por vendedor para identificar os itens marcados com a tag catalog_boost, usando o seguinte recurso.

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/1234567/items/search?status=active&tags=catalog_boost

Criar publicações de marketplace com optin automático

Antes de criar novas publicações, é preciso identificar se é um produto ativo no catálogo e se está como requerido para catálogo. Para isso, execute um GET no recurso/products/search com o filtro status: active e verifique através de listing_strategy: catalog_required se o produto é requerido para gerar publicação de catálogo automaticamente.

Neste caso você poderá enviar o catalog_product_id e/ou GTIN no POST ao criar a publicação.

Nota:
Se a publicação não corresponder a um produto de catálogo, ela irá tomar o valor da funcionalidade de publicações de alta qualidade.

Resposta exemplo de produto necessário no catálogo:

{
    "keywords": " Apple iphone 3g",
    "domain_id": "MLA-CELLPHONES",
    "paging": {
        "total": 3,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA6005934",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "forced_catalog"
            },
            "name": "Apple iPhone iPhone 3G 8 GB Negro 128 MB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "9344",
                    "value_name": "Apple"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "58993",
                    "value_name": "iPhone"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "14605",
                    "value_name": "iPhone 3G"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Negro"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59566",
                    "value_name": "8 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "579543",
                    "value_name": "128 MB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450295",
                    "value_name": "Negro"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7404961",
                    "value_name": "iOS"
                }
            ],
            "pictures": [
                {
                    "id": "675782-MLA31138875214_062019",
                    "url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
                },
                {
                    "id": "915001-MLA31138546867_062019",
                    "url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
                },
                {
                    "id": "881441-MLA31138332972_062019",
                    "url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
                },
                {
                    "id": "804666-MLA31139286536_062019",
                    "url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
                }
            ]
        },
        {
            "id": "MLA6007403",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "catalog_required"
            },
            "name": "Apple iPhone iPhone 3G 16 GB Negro 128 MB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "9344",
                    "value_name": "Apple"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "58993",
                    "value_name": "iPhone"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "14605",
                    "value_name": "iPhone 3G"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Negro"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59561",
                    "value_name": "16 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "579543",
                    "value_name": "128 MB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450295",
                    "value_name": "Negro"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7404961",
                    "value_name": "iOS"
                }
            ],
            "pictures": [
                {
                    "id": "675782-MLA31138875214_062019",
                    "url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
                },
                {
                    "id": "915001-MLA31138546867_062019",
                    "url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
                },
                {
                    "id": "881441-MLA31138332972_062019",
                    "url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
                },
                {
                    "id": "804666-MLA31139286536_062019",
                    "url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
                }
            ]
        },
        {
            "id": "MLA6007404",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "catalog_required"
            },
            "name": "Apple iPhone iPhone 3G 16 GB Blanco 128 MB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "9344",
                    "value_name": "Apple"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "58993",
                    "value_name": "iPhone"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "14605",
                    "value_name": "iPhone 3G"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52055",
                    "value_name": "Blanco"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59561",
                    "value_name": "16 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "579543",
                    "value_name": "128 MB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450308",
                    "value_name": "Blanco"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7404961",
                    "value_name": "iOS"
                }
            ],
            "pictures": [
                {
                    "id": "675782-MLA31138875214_062019",
                    "url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-F.jpg"
                },
                {
                    "id": "915001-MLA31138546867_062019",
                    "url": "https://mla-s1-p.mlstatic.com/915001-MLA31138546867_062019-F.jpg"
                },
                {
                    "id": "881441-MLA31138332972_062019",
                    "url": "https://mla-s1-p.mlstatic.com/881441-MLA31138332972_062019-F.jpg"
                },
                {
                    "id": "804666-MLA31139286536_062019",
                    "url": "https://mla-s2-p.mlstatic.com/804666-MLA31139286536_062019-F.jpg"
                }
            ]
        }
    ]
}

Validação antes de publicar um produto obrigatório no catálogo

Utilize o recurso /items/validate para validar antes de realizar um POST, para ter certeza que o item cumpre com todas os critérios, para publicar corretamente.


Benefícios no envio dos valores

POST Benefício
Com catalog_product_id e GTIN Recomendado. Ambos campos são obrigatórios separadamente. Ao enviar os dois valores, você otimiza o tempo de criação da publicação automática. A publicação original é atualizada com as informações correspondentes ao produto.
Com catalog_product_id ou GTIN Substituí os valores da ficha técnica pelos do produto, exceto GTIN (não é modificado ou preenchido automaticamente).
Só com catalog_product_id Este campo tem precedência sobre PKs ou GTINs, assumindo este valor e ignorando os outros valores.
Só com GTIN O produto é buscado por GTIN, completando o catalog_product_id com o resultado da busca.
Com catalog_product_id inativo ou incorreto Retorna erro, mesmo se o POST possuir PKs e GTINs para evitar inconsistências na criação.


Erros de validação e soluções

Code_id Reason code_name code_message Solução
4400 catalog_product_id ou GTIN obrigatórios (detectamos produtos com base em PKs) body.required_fileds Missing catalog_product_id or GTIN. It’s required at least one of them. Enviar catalog_product_id ou GTIN
4402 Não conseguimos encontrar o produto ativo com base em catalog_product_id item.catalog_product_id The product $product_id is not active Enviar um catalog_product_id ativo ou GTIN correto
417 catalog_product_id não corresponde a category_id item.catalog_product_id The product $product_id does not belong to the catalog_domain of the category $category_id. Enviar um catalog_product_id correto
418 catalog_product_id de famílias diferentes entre o item e a variação item.catalog_product_id Variation catalog_product_id $variation_product_id is not a child of item catalog_product_id $item_product_id. Enviar um catalog_product_id no nível de item e variação que sejam da mesma família.

Seguinte: Publicações necessárias do catálogo.

ou registre-se para receber as últimas notícias sobre nossa API