Publicações necessárias do catálogo
Veja o nosso webinar:
Conteúdos
→Reconhecer produtos antes da publicação →Identifique as publicações existentes a serem associadas (optin) →Prazo para publicação no catálogo →Criar publicações de alta qualidade →Validar a qualidade das publicações ↳Identificadores do produto (PIs) ↳Imagens ↳Título e descrição →Consultar moderações →Adicionar tag de pré-aviso em item de teste
Antes de começarmos, você pode ver o fluxo recomendado para publicar:
Reconhecer produtos antes da publicação
Antes de criar novas publicações, você deve reconhecer se o produto existe e está ativo no catálogo. Para isso, execute um GET no recurso /products/search com o filtro status e verifique a listing_strategy: catalog_required se o produto deve ser publicado no catálogo. Nesse caso, você pode:
- Publicar diretamente no catálogo
- Faça uma publicação tradicional e associe-a a uma publicação de catálogo (optin)
- Crie uma publicação no marketplace de qualidade superior
Dessa forma, você evitará que sua publicação seja moderada (pausada pelo Mercado Livre).
Exemplo de produto necessário para 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": "catalog_required"
},
"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"
}
]
}
]
}Identifique as publicações existentes a serem associadas
Para reconhecer as publicações atuais do marketplace que devem ser publicadas em um catálogo, consulte o recurso de search com o parâmetro catalog_forewarning e filtre esse tipo de publicação. Depois de identificado, recomendamos que você associe cada publicação a um catálogo (optin) e evite moderação.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?tags=catalog_forewarningExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456987/items/search?tags=catalog_forewarningRespuesta acotada:
{
"seller_id": "123456987",
"query": null,
"paging": {
"limit": 50,
"offset": 0,
"total": 1
},
"results": [
"MLA123456789"
],
"filters": [],
"available_filters": [
]
}Prazo para publicação no catálogo
Reconhecendo essas publicações, verifique o prazo que você terá para publicar o produto em um catálogo, consultando o recurso /catalog_forewarning/date.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/catalog_forewarning/dateExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA123456789/catalog_forewarning/dateResposta da publicação com data atribuída:
{
"status":"date_defined",
"moderation_date":"2020-08-20T13:00:00Z"
}Resposta da publicação que não tem a tag catalog_forewarning:
{
"status":"date_not_defined",
"moderation_date": null
}Resposta da publicação com data expirada:
{
"status":"date_expired",
"moderation_date":"2020-06-10T13:00:00Z"
}Caso você envie um item que não esteja marcado com a tag catalog_forewarning, você receberá um 404:
{
"message": "Item moderation_date is not defined",
"error": "not_found",
"status": 404,
"cause": []
}Para impedir que as postagens existentes sejam moderadas (pausadas) porque não foram publicadas no catálogo a tempo, você pode:
- Associar a publicação a um produto existente: para isso, você deve primeiro confirmar que o produto do catálogo corresponde ao da sua publicação e depois associar a publicação (optin).
- Criar uma publicação de alta qualidade: esta solução estará disponível apenas se o seu produto não existir em um catálogo e, portanto, você não poderá associá-lo (optin), por exemplo, devido à cor do produto que você vende. A seguir, explicamos como criar publicações de alta qualidade.
Criar publicações de alta qualidade
Esse tipo de publicação estará disponível no caso de uma família de produtos necessária a um catálogo não possuir o produto específico que deseja publicar. Para isso, você deve preencher corretamente os seguintes requisitos do produto:
- GTIN obrigatório
- Atributos requeridos
- Título e descrição com informações do produto (em breve)
- Imagens de ótima qualidade (em breve)
Para reconhecer esse tipo de publicação, consulte o recurso /items e verifique a tag catalog_product_candidate de cada item.
Lembre-se de que, mesmo que a publicação possua a tag mencionada, ela poderá ser pausada se não atender aos requisitos de qualidade descritos. Com o status: under_review, você pode identificar os itens em pausa deste tipo de publicação que não atendem aos requisitos.
Exemplo de um item de qualidade superior:
{
"id": "MLA123456789",
"site_id": "MLA",
"title": "Item De Testeo, Por Favor No Ofertar --kc:off",
"subtitle": null,
"seller_id": 123456987,
"category_id": "MLA3530",
"official_store_id": null,
"price": 50,
"base_price": 50,
"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": "free",
"start_time": "2020-02-17T16:30:39.000Z",
"stop_time": "2020-04-17T04:00:00.000Z",
"condition": "new",
"permalink": "https://articulo.mercadolibre.com.ar/MLA-839616438-item-de-testeo-por-favor-no-ofertar-kcoff-_JM",
"thumbnail": "http://mla-s1-p.mlstatic.com/951410-MLA40807113659_022020-I.jpg",
"secure_thumbnail": "https://mla-s1-p.mlstatic.com/951410-MLA40807113659_022020-I.jpg",
"pictures": [ ],
"video_id": null,
"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": [
"catalog_product_candidate",
"good_quality_picture",
"test_item",
"immediate_payment"
],
"warranty": null,
"catalog_product_id": null,
"domain_id": "MLA-UNCLASSIFIED_PRODUCTS",
"parent_item_id": null,
"differential_pricing": null,
"deal_ids": [],
"automatic_relist": false,
"date_created": "2020-02-17T16:30:40.000Z",
"last_updated": "2020-02-17T16:34:12.000Z",
"health": 0.4,
"catalog_listing": false
}Validar a qualidade das publicações
Este recurso de validação permitirá verificar se um item atende aos parâmetros de qualidade necessários. Lembre-se de que uma publicação pode ser moderada caso algum requisito de qualidade desse tipo de publicação não esteja correto ou completo.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validateExemplo de validação que atende aos parâmetros de qualidade exigidos:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"title": "ok",
"description":"ok",
"category_id": "MLA538565",
"pictures":[
"967960-MLA41175135696_032020"
],
"domain_id":"MLA-CELLPHONES",
"attributes":[
{
"id": "BRAND",
"name": "Marca",
"value_id": "995",
"value_name": "Apple"
},
{
"id": "GTIN",
"value_name": "0190198457012"
}
]
}Exemplo de validação que não atende aos parâmetros de qualidade exigidos:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"title": "Test title",
"description":"Test title",
"category_id": "MLA438566",
"pictures":[
"967960-MLA41175135696_032020"
],
"domain_id":"MLA-CELLPHONES",
"attributes":[
{
"id": "BRAND",
"name": "Marca",
"value_id": "995",
"value_name": "Apple"
},
{
"id": "GTIN",
"value_name": "0190198457011"
}
]
}Resposta caso as informações consultadas estejam incorretas:
{
"message": "Validation error",
"error": "validation_error",
"status": 400,
"cause": [
{
"cause_id": 6004,
"code": "item.product_identifier.invalid",
"message": "El código no corresponde a tu producto.",
"references": [
"0190198457011",
"PI_INCORRECT"
],
"type": "error"
},
{
"cause_id": 6001,
"code": "item.title.invalid",
"message": "Title has invalid topics",
"references": [
"LOCATION"
],
"type": "error"
},
{
"cause_id": 6002,
"code": "item.description.invalid",
"message": "Description has invalid topics",
"references": [
"LINK_TO_STORE",
"LOCATION",
"STOCK"
],
"type": "error"
},
{
"cause_id": 6003,
"code": "item.picture.invalid",
"message": "Picture quality is not good",
"references": [
"967960-MLA41175135696_032020",
"logo_text_watermark",
"blur"
],
"type": "error"
}
]
}Campos da resposta
status: pode ter valores 400 quando alguns dos parâmetros validados não atendem à qualidade exigida e valor 204 quando os parâmetros atendem à qualidade exigida.
cause: ele terá as várias causas que geram o erro de validação, dependendo das que foram enviadas no POST. Eles podem ser por GTIN, título, descrição e/ou imagens.
- cause_id: refere-se às validações enviadas e não são de qualidade.
- code: é o código descritivo pelo qual o erro ocorre.
- message: é motivo do erro para o qual a validação falha.
- references: são as validações que falharam. No caso de imagens e PIs, nos referimos ao ID que não passa na validação.
Validar Identificadores do Produto (PIs)
Para validar corretamente os PIs, recomendamos que você envie o site_id, domain_id e os atributos BRAND (opcional), MODEL (opcional) e GTIN com seus respectivos value_name.
Exemplo de validação de Identificadores de Produto:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"domain_id":"MLA-CELLPHONES",
"attributes":[
{
"id":"BRAND",
"name":"Marca",
"value_id":"995",
"value_name":"Apple"
},
{
"id":"MODEL",
"value_name":"iPhone X"
},
{
"id":"GTIN",
"value_name":"0190198457011"
}
]
}Resposta com erros do PI:
{
"message":"Validation error",
"error":"validation_error",
"status":400,
"cause":[
{
"cause_id":6004,
"code":"item.product_identifier.invalid",
"message":"El código no corresponde a tu producto.",
"references":[
"0190198457011",
"PI_INCORRECT"
],
"type":"error"
}
]
}Possíveis mensagens de erro
- O código não corresponde ao seu produto.
- ElO código não pertence à categoria.
- O código não pertence à marca.
Validar imagens
Para validar imagens de publicações de alta qualidade, você deve executar um POST enviando site_id e id da imagem para analisar. Para isso, você deve enviar as imagens para nossos servidores e o "category_id" no qual você irá publicar. Conheça a categoria a publicar usando o preditor de categoria.
Exemplo de validação de imagem:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id": "MLA",
"category_id": "MLA438566",
"pictures": [
"967960-MLA41175135696_032020",
"967961-MLA41175135696_032020"
]
}Resposta a erro de imagem:
{
"message":"Validation error",
"error":"validation_error",
"status":400,
"cause":[
{
"cause_id":6003,
"code":"item.picture.invalid",
"message":"Picture quality is not good",
"references":[
"967960-MLA41175135696_032020",
"logo_text_watermark",
"blur"
],
"type":"error"
}
]
}Possíveis erros de imagem
minimum_size: avalia se alguma das imagens da publicação superam o mínimo de 500 x 500 px.
logo_text_watermark: avalia se a primeira imagem da publicação contém logos, texto, banners promocionais ou marcas d'água.
white_background: avalia se a primeira imagem da publicação tem fundo branco puro. Ou seja, um fundo branco criado com um editor de imagens, ao invés de uma foto do produto em frente a uma parede ou outro elemento.
multiproduct: avalia se a primeira imagem contém mais de um produto. Por exemplo, não permitimos que a primeira imagem da publicação tenha vários pares de sapatilha.
blur: avalia se as imagens da publicação não estejam borradas.
unprofessional_photo: ocorre quanto o resto das validações da negativo e avalia três condições: mais de um produto, fundo branco e logos. Não significa que a imagem cumpra as três, mas que pode não estar cumprindo uma delas.
Validar título e descrição
Com esta validação, você pode reconhecer se o título e a descrição do produto não são de qualidade. levando em conta tópicos ou informações que buscamos que não são encontrados no título ou na descrição de um produto, cada tópico tem uma descrição do escopo indicando o que ele abrange.
Para realizar a validação POST do título e da descrição, você deve enviar site_id, title e description.
Exemplo de validação de título e descrição:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_product_candidate/validate
{
"site_id":"MLA",
"title": "Apple Iphone X Rose",
"description":"Fotos amplias y perfectas de día y de noche. Un color rosado perfecto."
}Resposta com erros de título e descrição:
{
"message":"Validation error",
"error":"validation_error",
"status":400,
"cause":[
{
"cause_id":6001,
"code":"item.title.invalid",
"message":"Title has invalid topics",
"references":[
"LOCATION"
],
"type":"error"
},
{
"cause_id":6002,
"code":"item.description.invalid",
"message":"Description has invalid topics",
"references":[
"LINK_TO_STORE",
"LOCATION",
"STOCK"
],
"type":"error"
}
]
}Possíveis erros de título e descrição
Na resposta, você poderá reconhecer os diferentes tópicos para os quais a publicação não atende aos requisitos de qualidade em seu título ou descrição. Em uma primeira instância, validaremos:
| Tópicos | Detalhes |
|---|---|
| SHIPPING | Contém informações de envio, por exemplo o processo de envio do produto, como o produto é enviado, custo de envio, detalhes da logística ou atraso no envio. |
| METHOD_OF_PAYMENT | Contém informações de pagamento como financiamento aceitas. |
| BILLING | Contém informações de faturamento |
| WARRANTY | Contém informações de garantia do produto, duração ou términos dessa. |
| LOCATION | Contém informações da loja, localização, pontos de retirada, origem do produto. |
Em breve, adicionaremos os seguintes tópicos às validações:
| Tópicos | Detalhes |
|---|---|
| PICKUP | Contém informações do retiro em loja |
| TECHNICAL_SUPPORT | Contém informações de serviço pós venda |
| ABOUT_US | Contém informações do vendedor |
| FAQ | Contém informações de perguntas freqüentes (FAQs) |
| STOCK | Contém informações de estoque |
| LEGAL | Contém informações legais por exemplo Termos e Condições |
| OFFICE_HOURS | Contém informações da atenção/disponibilidade |
| LINK_TO_STORE | Contém links para publicações do Mercado Livre ou links externos |
Consultar moderações
Em seguida, você pode consultar o recurso /moderations/infractions e reconhecer se uma publicação foi moderada (pausada),devido a não estar associado a uma publicação de catálogo a tempo. Você pode reconhecê-lo com o reason (causa) e remedy (acionável):
Reason: Pausamos seu anúncio porque você não oferece o produto também no catálogo.
Remedy: Anuncie seu produto no catálogo para continuar vendendo. Quando fizer isso, seu anúncio original será reativado automaticamente.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_IDExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/1234567Resposta:
{
"infractions": [
{
"id": "594794188",
"date_created": "2020-10-28T01:43:32.414-0400",
"user_id": "1234567",
"related_item_id": "MLB1692147078",
"element_id": "MLB1692147078",
"element_type": "ITM",
"site_id": "MLB",
"reason": "Pausamos seu anúncio porque você não oferece o produto também no catálogo.",
"remedy": "Anuncie seu produto no catálogo para continuar vendendo. Quando fizer isso, seu anúncio original será reativado automaticamente."
}
],
"paging": {
"offset": 0,
"limit": 2,
"total": 20671
},
"sorting_type": "date_created_desc"
}Para reativar sua publicação você deve associar a publicação a um catálogo (optin). Para evitar esse tipo de moderação, você deve consultar o prazo para publicação no catálogo e notificar ao seu seller, possibilitando que ele faça o optin no prazo.
Moderações em publicações de alta qualidade
Com os recursos acima, você também pode identificar os motivos para moderação de uma publicação de qualidade superior quando a resposta tiver:
Reason: Pausamos o anúncio porque o código universal está incompleto ou incorreto. Remedy: Revise o código universal do produto para ativá-lo novamente.
Para reativar essas publicações, valide os parâmetros de qualidade.
Adicionar tag de pré-aviso em item de teste
Para que possam testar a funcionalidade de pré-aviso, é necessário que: O Item de Marketplace seja elegível para um Catálogo existente. O item não pode ser de um catálogo/produto já requerido, que, caso contrário, ao publicar o Item já cairá em moderação. Depois de cumpridos esses requisitos, carregue os dados no formulário para inclusão da tag catalog_forewarning.
Seguinte: Concorrência no catálogo.
