Descripción de artículos

La descripción de una publicación contiene información sobre el producto y sirve para complementar lo detallado en la ficha técnica. Recuerda que esta le permitirá al comprador encontrar, de una forma rápida, todas las especificaciones que caracterizan a los productos.

Contenidos

→Consejos para describir una publicación
→Cargar la descripción en un ítem
→¿Cómo publicar?
→Beneficios de utilizar texto plano
→Agrega o reemplaza una descripción existente
→Error al cargar descripción

Consejos para describir una publicación

Primero carga los datos importantes en la ficha técnica, es decir todas las especificaciones sin olvidar el código universal de producto.
Verifica que los datos que vas a escribir en la descripción sean los detalles que no están en la ficha técnica.
Jerarquiza la información para que quede bien organizada. Utiliza mayúsculas, guiones, espaciado, etc.
Sé breve y realiza una lectura de tu propia descripción para comprobar su longitud.

Puedes consultar todos los detalles sobre cómo describir un producto.

Cargar la descripción en un ítem

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

Nota:

- Cuando crees un nuevo item, dentro del campo "description" debes agregar "plain_text".
- Ten en cuenta que solo se pueden realizar saltos de línea de la siguiente forma: \n y no está permitido cambiar las fuentes, tamaños ni marcar textos en negrita.

¿Cómo publicar?

curl -X POST -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?access_token=$ACCESS_TOKEN

Beneficios de utilizar texto plano

Tendrán un mejor resultado en las búsquedas.
Las descripciones se descargarán 5 veces más rápido.
Se verán correctamente en todos los dispositivos (móviles, computadoras, tablets).
Además, podrás cargar hasta 10 fotos del producto y/o un link con un video de Youtube.

A continuación te mostraremos un ejemplo sobre la mejor práctica para a armar la descripción:

Producto: “Raqueta Babolat Pure Control 3” [su_custom_gallery source="media: 10252" limit="1" link="lightbox" width="870" height="890"]

Notas:

- Ten en cuenta que tanto los medios de pago como medios de envíos que se deseen utilizar podrán ser añadidos en la VIP.
- Si en una publicación deseas mostrar todas las variantes del ítem, manteniendo incluso stock diferencial por cada una, te alentamos a que utilices características personalizadas.

Agrega o reemplaza una descripción existente

Si no enviaste nada en la descripción cuando publicaste un producto, puedes agregarla más tarde. Lo mismo, si deseas modificar la preexistente.

Ejemplo:

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

¿Ves? ¡Es fácil! La descripción se puede agregar o reemplazar cuando desees, aun cuando el artículo ya tenga ofertas; por eso, manos a la obra y prepara una descripción excelente para tus artículos.

Error al cargar descripción

Publicando un producto

En caso que realices un POST a ítems creando una publicación con una descripción que contenga algún carácter no aceptado, la respuesta contendrá más información acerca del error, como la posición del carácter equivocado.

Ejemplo:

curl -X POST -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?access_token=$ACCESS_TOKEN

En la respuesta puedes identificar que los errores se encuentran en la posición 6 y 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"
        }
    ]
}

Agregando o modificando una descripción existente

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

Para que la respuesta devuelva la posición del carácter que genera error, debes agregar el parámetro api_version=2.

El error será así:

{
    "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"
        }
    ]
}

En el nodo references puedes obtener la ubicación exacta del caracter que genera el error. En este caso 0 y 5.