Instancia de retrocompatibilidad y nuevas notificaciones

Una vez que se empiece a trabajar en la primera etapa de implementación de la nueva funcionalidad de Carrito de Compras, se contará con una instancia de retrocompatibilidad que permitirá utilizar tanto los nuevos recursos como los ya existentes. Esto permitirá implementar los cambios progresivamente sin generar interrupciones o afectar la disponibilidad de la integración. Ten en cuenta que los nuevos recursos no sólo aplican para Carrito de Compras sino que serán la nueva modalidad para orders y shipments a nivel general. Esto quiere decir que si trabajas con otros sitios que no estén bajo esta modalidad también verás el impacto.

Contenido

→Funcionamiento de retrocompatibilidad
→Nuevas notificaciones
→Accede a los detalles
    ↳Orders_v2
    ↳Shipments


Funcionamiento de retrocompatibilidad

Debido a que en la etapa de Beta Testing se tendrá la posibilidad de trabajar en simultáneo con todos los recursos disponibles, deberás implementar el siguiente header cada vez que hagas un request a la API para poder consumir los nuevos recursos adaptados al Carrito de Compras:

curl -H "x-format-new:true" https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN
Nota:
Si deseas obtener el formato anterior no deberás enviar la línea “x-format-new: true”.


Nuevas notificaciones

Con la nueva funcionalidad de Carrito de Compras será posible trabajar con dos notificaciones nuevas que deberás activar dentro del Application Manager:
orders_v2: Recibirás la novedad cuando se crea una nueva orden o cuando se modifica el json en una ya existente.
shipments: Recibirás la novedad cuando se crea un nuevo envío o hay una actualización en uno ya existente.

Nota:
Si decides trabajar con “orders_v2” sin anular los anteriores “created_orders” y/u “orders”, comenzarás a recibir la misma novedad de una orden replicada en cada uno de ellos. Sugerimos que al comenzar a escuchar los nuevos topics, descartes los viejos referidos a órdenes para simplificar el proceso. Si quieres saber más sobre el funcionamiento de todos los topics disponibles puedes consultar la guía de Recibe notificaciones.


Accede a los detalles

Después de recibir una notificación sobre un topic, deberás realizar el request al recurso correspondiente para acceder a los detalles y comprobar si se trata de una operación nueva o si deberás actualizar una ya existente en tu sistema.


Orders_v2

Notification response:

{
    "resource": "/orders/139876",
    "user_id": 1234,
    "topic": "orders_v2",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Con esta información podrás realizar un GET al recurso de orders:

curl -H "x-format-new:true" ’https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN

Shipments

Notification response:

{
    "resource": "/shipments/139876",
    "user_id": 1234,
    "topic": "shipments",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Con esta información podrás realizar un GET al recurso de shipments:

curl -H "x-format-new:true" https://api.mercadolibre.com/shipments/{shipment_id}?access_token=ACCESS_TOKEN
Nota:
Para trabajar con las nuevas notificaciones deberás desactivar las que usabas anteriormente para orders. Si deseas escuchar todas las notificaciones en algunos casos las recibirás más de una vez.

Siguiente: Manejo de Órdenes.

Forma parte de nuestra comunidad