Sincroniza y modifica publicaciones

Una vez que tienes publicaciones activas en nuestro marketplace, es probable que debas actualizarlas y modificarlas en forma periódica para sincronizar el stock con otras plataformas con las que trabajas, pausar publicaciones, mejorar descripciones, actualizar precios, etc.
Sigue esta guía para aprender cómo hacerlo.

Contenidos:

Consideraciones

No todos los campos se pueden actualizar y esto cambiará si el artículo tiene ventas o no. Además, recuerda que tu artículo debe estar activo para poder modificarlo. Puedes modificar los valores para:

  • Título
  • Available_quantity
  • Precio
  • Video
  • Imágenes
  • Descripción*
  • Envío

*No es posible modificar, sólo agregar un post.
Cuando el artículo tiene ventas, no podrás cambiar ninguno de los siguientes campos del mismo:

  • Estado
  • Modo de compra
  • Métodos de Pago distintos de MercadoPago
  • Garantía

También recuerda que:

  • La categoría no se puede modificar a través de la API.
  • El tipo de publicación se puede modificar solo una vez.

Actualiza tu artículo

Veamos un ejemplo básico de actualización del título y el precio de un artículo. Lo único que necesitas es el item_id del producto publicado y, por supuesto, el access_token del vendedor.

Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Bien: el título y precio de tu artículo fueron actualizados y deberías recibir un estado de respuesta con código 200 OK para confirmar que no hubo inconvenientes.
Recuerda que puede tardar un momento hasta ver la información actualizada.

Descripciones

Es muy fácil actualizar una descripción y lo puedes hacer independientemente de que el artículo tenga o no ofertas. Pero como existen ciertas consideraciones que debes recordar al agregar o reemplazar descripciones, consulta nuestro artículo sobre descripciones para asegurarte de entenderlo bien.

Imágenes

Siempre puedes agregar o reemplazar imágenes de artículos; consulta nuestro tutorial Trabajar con imágenes para conocer la mejor forma de hacerlo.

Tipos de publicación

Cuando quieres más exposición para tu artículo, debes actualizar el tipo de publicación. Conoce los detalles y consideraciones y aprende cómo realizar una actualización en nuestro tutorial Tipos y actualización de publicaciones.

Cambiar los estados de las publicaciones

Cualquier artículo publicado en nuestro marketplace puede tener diferentes estados; analiza la descripción de cada uno a continuación:


cerrado: Finaliza tu publicación. Una vez cerrado, no se puede volver a activar, pero se puede volver a publicar.
Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"closed"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN



pausado: Pausa tu publicación. Una vez pausado, no será visible para otros usuarios de MercadoLibre, pero no se cerrará y se podrá reactivar más tarde.
Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN



activo: Reactiva un artículo previamente pausado.
Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"active"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Nota: Recuerda que el valor distingue entre mayúsculas y minúsculas y se debe enviar en minúscula.

Si actualmente tu artículo está cerrado y quieres volver a publicarlo, consulta nuestro artículo sobre volver a publicar para hacerlo rápido.
Para más información sobre el estado del artículo, por favor consulta el artículo sobre el ciclo de vida de las publicaciones.

Flujo de estados de las publicaciones

Active: La publicación se encuentra activa y tiene la posibilidad de recibir ofertas o preguntas. Puede cambiar la exposición de la publicación (upgrade de listing type).

Payment required: Este caso se da cuando un usuario con deuda o baja política de crédito realiza una publicación y se reactiva automáticamente una vez que el usuario realiza el pago.

Under Review: El ítem se encuentra bajo revisión por Mercado Libre por los siguientes motivos:

  • warning: ítem que sigue activo, pero tiene una corrección pendiente por parte del usuario. Si no se corrige en 2 días pasa a waiting_for_patch.
  • waiting_for_patch: ítem oculto hasta que el usuario corrija la infracción reportada.
  • held: ítem oculto a la espera de una moderación manual por parte de Mercado Libre.
  • pending_documentation: ítem oculto hasta que el usuario presente la documentación solicitada.
  • forbidden: ítem dado de baja por moderación.

Nota: Si tienes dudas con respecto a este estado te sugerimos que lo revises con tu asesor comercial o en MyML.

Paused: Ser puede dar de forma automática (out of stock) o por decisión del usuario.

  • out of stock: el ítem fue pausado por falta de stock y será activado automáticamente cuando sea repuesto.

Nota: El ítem se verá pausado en la VIP y no podrá recibir ofertas.

Closed: Este es el estado final del ítem y se puede dar por las siguientes causas:

  • waiting for patch
  • held
  • expired: se alcanzó la fecha de finalización de la publicación (end_time) y aún tiene stock.
  • deleted: se agrega cuando el ítem está cerrado y el seller decide eliminarlo. O cuando el ítem expira y se republica automaticamente.
  • suspended
  • freezed

Nota: Ten en cuenta que luego de un periodo de tiempo, los ítems finalizados dejaran de mostrarse para ser consultados.

Inactive: Si no se realiza la corrección necesaria para salir del estado under review el ítem pasa a inactive. La corrección se puede encontrar en la cuenta del usuario en la sección de ventas en la solapa de publicaciones “revisar”.

Elimina publicaciones

Después de eliminar una publicación no hay vuelta atrás; por eso, ten cuidado cuando realizas esta acción. Además, recuerda que no es necesario eliminar los artículos cerrados porque serán descartados automáticamente después de cierto tiempo.
Si aún necesitas eliminar un artículo, por ejemplo artículos en estado: payment_required que no responderán al estado ‘cerrado’, deberás realizar los siguientes PUTs:

Ejemplo:
Primer paso

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Segundo paso

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Notas:

  • En caso que al hacer el segunda PUT obtengas el error:
  • message: item optimistic locking
    error: conflict
    status: 409
    cause: array(0)
    Se debe a que deberás esperar unos segundos hasta que se actualice la información.

  • Una vez eliminada la publicación se continuará viendo en la VIP por un período de tiempo corto bajo la leyenda “publicación finalizada”.

¡Eso es! Tu artículo será eliminado.

Actualiza el stock

Actualizar el stock de un artículo es muy fácil. Solo debes agregar el valor en el campo “available_quantity” teniendo en cuenta los siguientes puntos:

  • Al hacer PUT del available_quantity con 0 cambiará el estado a “paused” con sub estado out_of_stock.
  • Al hacer PUT del available_quantity mayor a 0 y el sub estado es out_of_stock cambiará el estado a activo sin sub estado out_of_stock.
  • Sólo se puede pausar un item enviando available_quantity = 0 cuando sean del tipo condition = new y no sean listing_type = free.

Nota: Este cambio es posible hacerlo tanto en ítems como en variaciones de un ítem.

¿Dónde está posible esta funcionalidad?

Los sites que soportan pausado automático con stock 0 son MLB, MLA, MLM, MLC, MPE, MLV.
Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 6
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Fácil. Puedes consultar tu publicación y ver el stock actualizado.



Siguiente:
Gestiona contactos y visitas.

Please rate this