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?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.