Descrição de produtos

A descrição de um anuncio contem informação sobre o produto e serve para complementar o detalhado na ficha técnica. Lembre-se que a ficha técnica permite ao comprador encontrar de um jeito rápido todas as especificações que caracterizam aos produtos.

Conteúdos

→Conselhos para descrever um anuncio
→Carregar a descrição em um item
→Como realizar uma publicação?
→Benefícios de utilizar texto sem formato
→Adicionar ou substituir uma descrição existente
→Erro ao carregar a descrição

Conselhos para descrever um anuncio

Primeiro carregue os dados importantes na ficha técnica, todas as especificações sem esquecer o código universal do produto.
Verifique que os dados que que estarão na descrição não estejam na ficha técnica.
Hierarquize a informação para que esteja bem organizada. Utilize maiúsculas, hífen, espaços, etc.
Seja breve e realize uma leitura da própria descrição para comprovar a longitude.

Você pode verificar todos os detalhes sobre como descrever um produto.

Carregar a descrição em um item

A través de la API, podrás trabajar con descripciones que contienen texto simple.

Notas:

- Quando criar um item novo, dentro do campo “descrição” deve adicionar “plain_text”.
- Lembre que só podem ser realizados saltos de linha da seguinte maneira: \n e não é permitido mudar as fontes, tamanhos nem marcar textos em negrito.

Como realizar uma publicação?

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
    "title": "Item de test - No Ofertar",
    "category_id": "MLA47392",
    "price": 10,
    "currency_id": "ARS",
    "available_quantity": 1,
    "buying_mode": "buy_it_now",
    "listing_type_id": "gold_special",
    "condition": "new",
    "description":{
                    "plain_text":"Descripción con Texto Plano  \n"},
    "video_id": "YOUTUBE_ID_HERE",
    "tags": [
        "immediate_payment"
    ],
    "warranty": "12 months by Ray Ban",
    "pictures": [
        {
            "source": "https://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
        },
        {
            "source": "https://en.wikipedia.org/wiki/File:Teashades.gif"
        }
    ]
}'
https://api.mercadolibre.com/items

Benefícios de utilizar texto sem formato

Terão um melhor resultado nas pesquisas.
As descrições serão descarregadas 5 vezes mais rápido.
Serão visualizadas em todos os dispositivos (móveis, tablets, computadores).
Além disso, você poderá carregar até 10 imagens do produto e/ou um link com um vídeo do Youtube.

A seguir apresentamos um exemplo sobre a melhor prática para criar a descrição:

Produto: “Raquete Babolat Pure Control 3” [su_custom_gallery source="media: 10396" limit="1" link="lightbox" width="870" height="890"]

Notas:

- Leve em conta que tanto os métodos de pagamento quanto os meios de envio desejados, poderão ser adicionados na VIP.
- Se você quiser exibir todas as variantes do item em uma publicação, mantendo o estoque diferencial por cada uma delas, recomendamos utilizar as características personalizadas.

Adicionar ou substituir uma descrição existente

Se você não forneceu uma descrição ao publicar um produto, poderá adicioná-la mais tarde. O mesmo acontece se você desejar modificar a existente.

Exemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"plain_text":"Los mejores Rayban Wayfarer. Test."
}'
https://api.mercadolibre.com/items/$ITEM_ID/description?api_version=2

Você percebe como é fácil? A descrição pode ser adicionada ou substituída quando você quiser, mesmo quando o artigo já tenha ofertas; por isso, mãos à obra, crie uma descrição para seus artigos.

Erro ao carregar a descrição

Publicando um produto

No caso de você faça um POST ao itens criando uma publicação com uma descrição que contenha algum caractere inaceitável, a resposta conterá mais informações sobre o erro, como a posição do caractere errado.

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
   "title":"Item de testeo",
   "category_id":"MLA47781",
   "price":10.01,
   "currency_id":"ARS",
   "available_quantity":1,
   "buying_mode":"buy_it_now",
   "listing_type_id":"gold_special",
   "condition":"new",
   "description":{
      "plain_text":"Texto < br > 😃"
   },
   "pictures":[
      {
         "source":"https://http2.mlstatic.com/item-de-testeo-por-favor-no-ofertar-kcoff-D_NQ_NP_521015-MCO25103941466_102016-F.jpg"
      }
   ]
}
https://api.mercadolibre.com/items

Na resposta, você pode identificar que os erros estão nas posições 6 e 16:

{
    "message": "Validation error",
    "error": "validation_error",
    "status": 400,
    "cause": [
        {
            "department": "items",
            "cause_id": 398,
            "type": "error",
            "code": "item.description.type.invalid",
            "references": [
                "plain_text[6]",
                "plain_text[16]"
            ],
            "message": "The description must be in plain text"
        }
    ]
}

Adicionando ou modificando uma descrição existente

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"plain_text':'< br >,😃"
}'
https://api.mercadolibre.com/items/$ITEM_ID/description?api_version=2

Para que a resposta retorne a posição do caractere que gera o erro, você deve adicionar o parâmetro api_version=2.

O erro será assim:

{
    "message": "Validation error",
    "error": "validation_error",
    "status": 400,
    "cause": [
        {
            "department": "items",
            "cause_id": 398,
            "type": "error",
            "code": "item.description.type.invalid",
            "references": [
                "plain_text[0]",
                "plain_text[5]"
            ],
            "message": "The description must be in plain text"
        }
    ]
}

No nó de referências, você pode obter a localização exata do caractere que gera o erro. Nesse caso, 0 e 5.