Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 15/03/2023

Sincroniza publicaciones (vehículos)

Una vez que tienes publicaciones activas en nuestro sitio, es probable que debas actualizarlas y modificarlas en forma periódica para sincronizar para excluir los anuncios ya vendidos, pausar publicaciones, mejorar descripciones, actualizar precios, etc. Sigue esta guía para aprender cómo hacerlo.


Consideraciones

Puedes modificar los valores para:

  • Title
  • Price
  • Video
  • Pictures
  • Description*
  • Location
  • Atributos de la publicación (array “attributes”)
  • Category

*No es posible modificar, sólo agregar un post. También recuerda que 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 una publicación. Lo único que necesitas es el item_id del producto publicado y, por supuesto, el access_token del vendedor.


Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID

Bien, el título y precio de tu publicación 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 nuestro tutorial Tipos de publicación y cómo obtener mayor exposición y aprende cómo realizar una actualización.


Cambia el estado 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.
  • pausado: pausa tu publicación. Una vez pausado, los visitantes no podrán entrar en contacto ya que los datos serán eliminados.
  • activo: reactiva un artículo previamente pausado. Si necesitas realizar cambios en el estado del artículo, debes enviar uno de estos valores para el campo "estado”.

Recuerda que el valor distingue entre mayúsculas y minúsculas y se debe enviar en minúscula. Para pausar un artículo activo, sigue el ejemplo a continuación:


Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID

Excelente! Tu publicación ha sido pausada. Ahora puedes intentar reactivarla realizando exactamente la misma llamada, pero enviando "activo" en lugar de "pausado" como valor del estado. Si actualmente tu publicación está cerrada y quieres volver a publicarla, 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 tiempo de vigencia de la publicación.


Elimina publicaciones

Después de eliminar una publicación no hay vuelta atrás, así que ten cuidado cuando llames a esta acción. También tené en cuenta que no hay necesidad de eliminar los artículos cerrados, ya que se descartarán automáticamente después de algún tiempo. Si todavía necesita eliminar un artículo, por ejemplo los artículos en estado payment_required que no responden al estado 'cerrado', haga lo siguiente.


Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}
https://api.mercadolibre.com/items/ITEM_ID
Segundo paso
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID
Nota:

En caso de que al hacer el segundo 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".


Siguiente: Gestiona contactos y visitas.