Gestionar Cambios

El flujo de cambios permite a los compradores realizar el cambio de sus compras en Mercado Libre. Esta documentación presenta la solución desarrollada para integrar este proceso, detallando los endpoints disponibles, el modelo de datos y las validaciones necesarias para una implementación eficiente.

En los próximos temas, exploraremos la estructura del servicio, los requisitos técnicos y las mejores prácticas para garantizar una integración fluida, permitiendo que los sellers gestionen los cambios de forma automatizada y sin fricciones.

Changes

El recurso /changes garantiza que los integradores puedan acceder a la información de intercambios relacionada con sus ventas, disponible actualmente solo para consulta y para pedidos del full. Incluye acceso a datos generales de las Orders correspondientes y la verificación de la existencia de intercambios en las reclamaciones asociadas, asegurando una gestión más precisa y automatizada.

Flujo de Cambio

¿Cómo identificar un intercambio?

Inscríbase en el feed de claims, así será notificado de todas las reclamaciones generadas para la cuenta del vendedor. Consulte el recurso /claims/$CLAIM_ID y verifique el campo "related_entities". Si el valor "changes" está presente, hay un intercambio asociado. Utilice el recurso /changes para obtener los detalles.

Consultar un intercambio:

Para consultar un intercambio, utilice el recurso /post-purchase/v1/claims/$CLAIM_ID/changes como en el siguiente ejemplo:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/post-purchase/v1/claims/$CLAIM_ID/changes

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' \
https://api.mercadolibre.com/post-purchase/v1/claims/5255498215/changes

Respuesta:

{
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 1
   },
   "data": [
       {
           "claim_id": 1234567890,
           "resource": "order",
           "resource_id": 2000001234567890,
           "items": [
               {
                   "id": "MLM1965897079",
                   "quantity": 1,
                   "price": 900.61,
                   "price_at_creation": 0,
                   "variation_id": 179014252922,
                   "currency_id": "MXN"
               }
           ],
           "seller_id": 10000000,
           "buyer_id": 2000000,
           "return": {
               "id": 37350682
           },
           "new_orders_ids": [1000000],
           "new_orders_shipments": [
               {
                   "id": 43176542122
               }
           ],
           "site_id": "ABC",
           "status": "changed",
           "status_detail": null,
           "type": "change",
           "estimated_exchange_date": {
               "from": "2024-03-11T00:00:00.000-04:00",
               "to": "2024-03-19T00:00:00.000-04:00"
           },
           "date_created": "2024-03-08T12:52:45.161-04:00",
           "last_updated": "2024-03-08T13:15:37.095-04:00"
       }
   ]
}

Campos de la Respuesta

• claim_id: Id de la reclamación.
• resource: Indica el recurso sobre el cual se inició el intercambio. En este caso, order.
• resource_id: Id referente al recurso.
• items: Array que indica el artículo que el cliente eligió para el intercambio.
• id: Id del artículo.
• quantity: Cantidad del artículo.
• price: Nuevo precio del artículo en la nueva compra.
• price_at_creation: Precio original del artículo al momento del intercambio.
• currency_id: Identificación de la moneda.
• variation_id: Id de la variación del artículo, si existe.
• seller_id: Id del vendedor.
• buyer_id: Id del comprador.
• return: Identificación de la devolución.
• id: Id de la devolución de la mercancía que no permanecerá con el comprador.
• new_orders_ids: Id del pedido generado para el envío del nuevo producto al comprador.
• new_orders_shipments: Identificación del envío del nuevo pedido.
• id: Id del envío.
• site_id: Sitio de la compra.
• status: Estado del intercambio, que puede ser:
• pending | generated | purchase_shipped | ready | changed | return_shipped | change_return_delivered | change_failed
• status_detail: Detalle del estado, que puede contener la siguiente información:
• null | return_pending | return_created | payment_required | money_granted | purchase_payment_done | qr_generated
• type: Por ahora, solo change.
• estimated_exchange_date: Período previsto para la realización del intercambio del producto.
• from: Fecha inicial para la recogida del producto por parte del comprador.
• to: Fecha final para la recogida del producto por parte del comprador.
• date_created: Fecha de creación del intercambio.
• last_updated: Fecha de la última actualización.