Como validar os atributos obrigatórios para o Mercado Livre

Este artigo interno explica como validar os atributos obrigatórios de uma categoria do Mercado Livre.

Essa validação pode ser utilizada quando o cliente reporta que alguns atributos estão retornando como obrigatórios no anúncio. Com esse procedimento, é possível consultar diretamente na API do Mercado Livre quais atributos são exigidos para a categoria vinculada ao produto.

Neste artigo:

• Pré-requisitos
• Como funciona a validação de atributos obrigatórios
• Como consultar os atributos obrigatórios
• Boas práticas
• Dúvidas comuns

Pré-requisitos

Antes de iniciar a consulta, tenha em mãos:

• MLB do anúncio analisado;
• Acesso ao Kibana, no índice OUTPUT;
• Acesso ao Postman;
• Authorization do cliente, coletada pela ferramenta de suporte;
• ID da categoria do Mercado Livre, quando já conhecido.

Como funciona a validação de atributos obrigatórios

Para consultar os atributos obrigatórios, primeiro é necessário identificar a categoria do Mercado Livre vinculada ao anúncio.

Essa categoria pode ser localizada no retorno da consulta do item, no campo:

category_id

Depois de identificar a categoria, a consulta dos atributos obrigatórios é feita pelo endpoint:

https://api.mercadolibre.com/categories/{CATEGORY_ID}/technical_specs/input

Essa chamada retorna as especificações técnicas da categoria, incluindo os atributos exigidos para cadastro ou atualização do anúncio.

Como consultar os atributos obrigatórios

1. Identificar o MLB do anúncio

Primeiro, identifique o MLB do anúncio que será utilizado na análise.

Neste exemplo, será utilizado o MLB abaixo:

MLB1691922972

2. Consultar o item no OUTPUT

Acesse o Kibana e, no índice OUTPUT, pesquise pela URL abaixo junto com o MLB do anúncio:

https://api.mercadolibre.com/items/

Exemplo de busca:

"https://api.mercadolibre.com/items/" AND "MLB1691922972"

3. Localizar o category_id no responseBody

No responseBody, localize o campo category_id.

Exemplo:

"category_id": "MLB193945"

Com essa informação, será possível consultar os atributos obrigatórios da categoria.

4. Montar a consulta no Postman

Abra o Postman e acesse:

Import > Raw text

Em seguida, informe o curl abaixo:

curl -X GET \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/categories/$CATEGORY_ID/technical_specs/input

Na URL, substitua $CATEGORY_ID pela categoria coletada no passo anterior.

Exemplo:

https://api.mercadolibre.com/categories/MLB193945/technical_specs/input

No header Authorization, informe o token coletado na ferramenta de suporte, filtrando pelo cliente analisado.

5. Validar a requisição no Postman

No Postman, confira se a URL e o header de autorização foram preenchidos corretamente.

6. Enviar a consulta

Após preencher os dados, clique em Send.

O Mercado Livre retornará os atributos obrigatórios e demais informações técnicas da categoria.

Exemplo de retorno:

7. Consultar documentação de apoio

Para mais informações sobre atributos do Mercado Livre, consulte:

https://developers.mercadolivre.com.br/pt_br/atributos

Boas práticas

• Confirme o MLB do anúncio antes de iniciar a análise.
• Use o OUTPUT para localizar o retorno da consulta do item.
• Valide o campo category_id no responseBody.
• Substitua corretamente o $CATEGORY_ID no endpoint de especificações técnicas.
• Utilize o token de autorização correto, coletado pela ferramenta de suporte para o cliente analisado.
• Use o retorno da API para orientar o cliente sobre quais atributos são obrigatórios para a categoria.
• Consulte a documentação oficial do Mercado Livre quando precisar validar comportamento de atributos.

Dúvidas comuns

Quando devo usar essa validação?
Quando o cliente reportar que alguns atributos estão retornando como obrigatórios no anúncio e for necessário confirmar quais atributos são exigidos para a categoria no Mercado Livre.

Qual é o primeiro passo da análise?
Identificar o MLB do anúncio e consultar o item no OUTPUT.

Como encontro a categoria do anúncio?
No retorno da consulta do item, localize o campo category_id no responseBody.

Qual endpoint consulta os atributos obrigatórios?
O endpoint https://api.mercadolibre.com/categories/{CATEGORY_ID}/technical_specs/input.

Preciso usar Authorization?
Sim. A chamada deve ser feita com Authorization: Bearer $ACCESS_TOKEN.

Onde consigo o token de autorização?
Na ferramenta de suporte, filtrando pelo cliente analisado.

O que devo substituir no curl?
Substitua $CATEGORY_ID pelo ID da categoria coletado no retorno da consulta do item e informe o token no header de autorização.

O que o Mercado Livre retorna nessa consulta?
O Mercado Livre retorna as especificações técnicas da categoria, incluindo atributos obrigatórios e demais regras da categoria.

Qual exemplo de MLB foi usado no procedimento?
O exemplo utilizado foi MLB1691922972.

Qual exemplo de category_id foi demonstrado?
O exemplo demonstrado foi MLB193945.