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.

Actualización con atributo WITH_FINANCING_OPTIONS (Opciones de financiamiento)

El envío del campo WITH_FINANCING_OPTIONS posibilita al vendedor señalar en sus publicaciones la disposición para negociar condiciones alternativas de pago (financiamiento) con el comprador.

Para actualizar (agregar o modificar) el atributo de financiamiento en una publicación existente, debes enviar el array sale_terms mediante una llamada PUT al endpoint /items/{ItemID}. Este atributo es de tipo booleano, donde el value_id define si el producto es financiable o no.

Ejemplo de llamada:

curl -L -X PUT 'https://api.mercadolibre.com/items/MLA1568702067' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "sale_terms": [
    {
      "id": "WITH_FINANCING_OPTIONS",
      "value_id": "242085",
      "value_name": "Sí"    
    }
  ]
}'

Identificación del atributo en la respuesta:

{
  "id": "MLA1568702067",
  "site_id": "MLA",
  "title": "Citroën C4 Picasso 1.6 Origine Hdi 115cv",
  ...
  "sale_terms": [
    ...
    {
      "id": "WITH_FINANCING_OPTIONS",
      "name": "Con opciones de financiamiento",
      "value_id": "242085",
      "value_name": "Sí",
      ...
    }
  ]
}

Actualización con el atributo INITIAL_PAYMENT_AMOUNT (financiación con anticipo)

El atributo INITIAL_PAYMENT_AMOUNT permite al vendedor informar el valor inicial (anticipo) que el comprador debe pagar al cerrar la operación. Este campo es una excelente forma de dar transparencia a la negociación. Al activar esta opción, enviando el atributo, el anuncio exhibirá el valor del anticipo.

Para actualizar (agregar o modificar) el atributo de valor del anticipo en una publicación existente, debes enviar el array sale_terms mediante una llamada PUT al endpoint /items/$ITEM_ID. Donde el campo value_name informa el valor del anticipo del producto.

El valor informado en el campo "value_name" debe corresponder a la misma moneda (currency_id) que el ítem. En caso de que el valor de "INITIAL_PAYMENT_AMOUNT" sea enviado en una moneda distinta, el sistema realizará automáticamente la conversión a la moneda del ítem.

Ejemplo de llamada:

curl -L -X PUT 'https://api.mercadolibre.com/items/MLA2736093652' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "sale_terms": [
    {
      "id": "INITIAL_PAYMENT_AMOUNT",
      "value_name": "7500000 ARS",
      "value_struct": {
        "unit": "ARS"
      }
    }
  ]
}'

Identificación del atributo en la respuesta:

"sale_terms": [
  {
    "id": "INITIAL_PAYMENT_AMOUNT",
    "name": "Valor del anticipo",
    "value_id": null,
    "value_name": "7500000 ARS",
    "value_struct": {
      "number": 7500000,
      "unit": "ARS"
    }
  }
]

¿Cómo remover el valor de entrada?

Para remover el valor del anticipo del anuncio, actualiza el ítem enviando en el array sale_terms el objeto con id igual a INITIAL_PAYMENT_AMOUNT y el campo value_name vacío ("").

Llamada de ejemplo:

curl -L -X PUT 'https://api.mercadolibre.com/items/MLA2736093652' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
  "sale_terms": [
    {
      "id": "INITIAL_PAYMENT_AMOUNT",
      "value_name": ""
    }
  ]
}'

Si el atributo se elimina correctamente, la API devolverá un 200 OK con la representación completa del ítem actualizado, sin el atributo INITIAL_PAYMENT_AMOUNT que fue eliminado.

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

Siguiente: Gestiona contactos y visitas.