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 28/06/2024

¿Qué es un reclamo?

Un reclamo es una solicitud formal que los usuarios pueden presentar para expresar insatisfacción o problemas relacionados con un proceso específico. Estos reclamos son esenciales para resolver problemas, garantizar una experiencia positiva para los usuarios y mantener la integridad del servicio. Solo cuatro tipos de recursos pueden generar reclamos, cada uno asociado a un aspecto diferente de la transacción en la plataforma. A continuación, se detallan los recursos posibles:

  • Order (Orden): Este tipo de reclamo se genera a partir de una orden de compra realizada en la plataforma de Mercado Libre. Los usuarios pueden presentar un reclamo si experimentan problemas con la orden, como discrepancias en el producto recibido, errores en la cantidad, o cualquier otro inconveniente relacionado con la orden. Esto asegura que los usuarios puedan comunicar cualquier insatisfacción y recibir una solución adecuada, manteniendo así la confianza y la integridad del servicio.
  • Shipment (Envío): Los reclamos de tipo Shipment se originan a partir del proceso de envío de una compra en la plataforma de Mercado Libre. Los usuarios pueden generar un reclamo si enfrentan problemas con la entrega del producto, como retrasos, productos dañados durante el envío o problemas logísticos. Estos reclamos permiten resolver rápidamente las incidencias, mejorando la experiencia del cliente.
  • Payment (Pago): Este tipo de reclamo se crea en relación con un pago realizado a través de la plataforma de Mercado Libre. Los usuarios pueden presentar un reclamo tanto por pagos asociados a compras en la plataforma como por cualquier otro tipo de transacción realizada mediante el sistema de pagos de Mercado Libre. Los problemas que pueden motivar estos reclamos incluyen cargos incorrectos, fallos en el procesamiento del pago, o disputas relacionadas con la transacción. Este mecanismo no solo permite a los usuarios resolver rápidamente sus problemas, sino que también ayuda a la plataforma a identificar y corregir posibles fallas en su sistema de pagos, mejorando la confiabilidad y la satisfacción del cliente.
  • Purchase (Compra): Los reclamos de tipo Purchase se originan a partir de una compra realizada en la plataforma de Mercado Libre. Estos reclamos se centran en la transacción de compra y abordan problemas como productos defectuosos, discrepancias entre la descripción del producto y lo recibido, entre otros inconvenientes. Al permitir que los usuarios presenten estos reclamos, se mejora la transparencia y se facilita una rápida resolución, lo que no solo refuerza la confianza del cliente en la plataforma, sino que también ayuda a identificar y solucionar fallas en el proceso de compra.

Notificaciones de reclamos

En la sección "Mis aplicaciones", edita tu aplicación y habilita el tópico "Claims" en nuestro feed. Esto te permitirá recibir notificaciones inmediatas siempre que se inicie un reclamo o se produzca alguna interacción relacionada. Mantente informado y al tanto de todas las actualizaciones importantes sobre los reclamos. Para más detalles, consulta la información completa sobre las notificaciones de reclamos.

Posibles filtros por Tópicos

Filtro Type Value Detalle value
fulfilled Boolean true - false Indica básicamente si el reclamo es PDD (true) o PNR (false)
event_type String insert, update Tipo de operación realizada en el reclamo
stage String claim, dispute, recontact, stale, none Etapa del reclamo
resource String payment, order, shipment, purchase Recurso sobre el que se crea el reclamo
site_id String mlb, mlm, mla, mlu, mco, mlc, mpe, mlv, mec, mcr, mbo, mrd, mpa, mgt, mpy, msv Sitio de procedencia
type String mediations, returns, ml_case, cancel_sale, fulfillment, cancel_purchase Tipo de reclamo
parent_id
test_claim Boolean true - false Indica si el claim es de test (true) o no (false)
status Boolean opened - closed Indica el estado del reclamo bien sea (opened) o (closed)

Consultar un reclamo

Para consultar la información sobre un reclamo, incluyendo su estado actual, es necesario consultar el recurso /claims/$CLAIMS

Llamada:

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

Ejemplo:

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

Respuesta:

{
   "id": 5187110991,
   "resource_id": 2000005489080336,
   "status": "opened",
   "type": "mediations",
   "stage": "dispute",
   "parent_id": null,
   "resource": "order",
   "reason_id": "PDD9528",
   "fulfilled": true,
   "quantity_type": null,
   "players": [
       {
           "role": "complainant",
           "type": "buyer",
           "user_id": 1354382565,
           "available_actions": []
       },
       {
           "role": "respondent",
           "type": "seller",
           "user_id": 1295357671,
           "available_actions": [
               {
                   "action": "send_message_to_mediator",
                   "mandatory": false,
                   "due_date": null
               }
           ]
       },
       {
           "role": "mediator",
           "type": "internal",
           "user_id": 46622406,
           "available_actions": []
       }
   ],
   "resolution": null,
   "site_id": "MLM",
   "date_created": "2023-04-18T12:06:48.000-04:00",
   "last_updated": "2023-04-18T12:07:25.000-04:00",
   "related_entities": []
}

Campos de la respuesta:

La respuesta de un GET al recurso /claims/detail proporcionará los siguientes parámetros

  • id: ID del reclamo.
  • resource_id: ID del recurso sobre el que se crea el reclamo. Depende del "resource".
  • status: estado del reclamo. Puede tomar dos valores: opened y closed.
  • type: Tipo de reclamo. puede tomar alguno de los siguientes valores:
    • mediations: reclamo entre comprador y vendedor.
    • return: devolución del producto. En este caso, no hay mensajes. Para trabar devoluciones, siga la documentación de Trabajar con devoluciones.
    • fulfillment: Reclamo entre comprador y Mercado Libre con origen de compra con envío full.
    • ml_case: Cancelación de la compra por parte del comprador debido a envío demorado.
    • cancel_sale: cancelación de compra por parte del vendedor.
      • El status siempre va a ser closed.
      • El stage siempre va a ser none.
      • El rol complainant siempre va a ser el type seller, collector o sender dependiendo del resource.
    • cancel_purchase: cancelación de compra por parte del comprador.
    • change: cambios de producto. Indica que se va a realizar un cambio del producto.
    • service: Cancelación de un servicio órdenes bundle.
  • stage: Etapa del reclamo. Puede tomar alguno de los siguientes valores:
    • claim: etapa del reclamo donde intervienen el comprador y el vendedor.
    • dispute: Etapa de mediación donde interviene un representante de Mercado Libre.
    • recontact: etapa en la que alguna de las partes se contacta luego de cerrado el reclamo/disputa.
    • none: no aplica.
    • stale: Etapa de reclamo donde intervienen el comprador y Mercado Libre para reclamos de tipo ml_case.
  • parent_id: ID de otro reclamo del que depende.
  • resource: identificador del recurso sobre el que se crea el reclamo. Puede ser:
    • payment
    • order
    • shipment
    • purchase
  • reason_id: Razón/motivo por el cual fue creado el reclamo. Interfiere directamente con las soluciones que se pueden proponer
    • %PNR: Producto No Recibido
    • PDD: Producto Defectuoso o Defectuoso
    • CS: Compra Cancelada
  • fulfilled: Indica si el reclamo se inició por un producto que fue enviado a través de Mercado Libre.
  • quantity_type: Indica la forma en que se realizó el reclamo por cantidad.
    • partial: indica una entrega parcial.
    • unreceived: indica una entrega que no se recibió.
    • wrong: indica si el producto recibido no es el solicitado.
  • players: lista de los actores que participan del reclamo con sus respectivas acciones y tiempos disponibles.
    • role: rol dentro del reclamo. Puede ser:
      • complainant: persona que reclama.
      • respondent: persona a quién le reclaman.
      • mediator: persona que interviene para ayudar a solucionar el problema.
      • purchase: comprador - Mercado Libre.
    • type: rol que ocupa la persona sobre la operación que se está reclamando. Puede variar de acuerdo al recurso.
      • Payment: comprador o collector.
      • Order: comprador o vendedor.
      • Shipment: receptor o remitente.
    • user_id: ID del usuario en ML que cumple el rol.
    • available_actions: lista de acciones que pueden ejecutar cada una de las partes intervinientes:
      • action: acciones posibles de realizarse. Para el vendedor serán:
        • send_message_to_complainant: enviar mensaje para el comprador (con o sin anexos).
        • send_message_to_mediator: enviar mensaje para el mediador (con o sin anexos).
        • recontact (no disponible aún): reabrir un reclamo ya cerrado, por medio de una interacción, como un mensaje.
        • refund: devolver el dinero del comprado. Debe ser realizado por el front de Mercado Libre o Mercado Pago.
        • open_dispute: iniciar una mediación.
        • send_potential_shipping: enviar una promesa de post, una fecha.
        • add_shipping_evidence: publicar una evidencia de que el producto fue enviado.
        • send_attachments: enviar mensaje con adjuntos.
        • allow_return: generar etiqueta de devolución.
        • allow_return_label: generar etiqueta de devolución.
        • allow_partial_refund: Ofrecer devolución parcial del dinero al comprador. Debe ser realizado por el front de Mercado Libre.
        • send_tracking_number: enviar el número de rastreo (tracking number).
    • mandatory: este campo en true indica que la acción es obligatoria y debe ser realizada dentro del tiempo informado.
    • due_date: tiempo límite para realizar la acción.

resolution: forma de resolución del reclamo

  • reason: forma de resolución del reclamo
    • already_shipped: Producto en camino
    • buyer_claim_opened: Cierre de devolución por apertura de otro reclamo
    • buyer_dispute_opened: Cierre de devolución por apertura de otro reclamo en disputa (con mediación de Mercado Libre)
    • charged_back: Cierre por contracargo
    • coverage_decision: Disputa cerrada con cobertura por ML
    • found_missing_parts: Comprador encontró las partes faltantes
    • item_returned: Producto devuelto
    • no_bpp: Cierre sin cobertura por parte de ML
    • not_delivered: Producto no entregado
    • opened_claim_by_mistake: Comprador creó el reclamo por error
    • other: Otro caso
    • partial_refunded: Reembolso parcial del pago otorgado al comprador
    • payment_refunded: Pago devuelto al comprador
    • preferred_to_keep_product: Comprador prefirió quedarse con el producto
    • product_delivered: Fallo de un representante de MercadoLibre
    • reimbursed: Reembolso
    • rep_resolution: Fallo de un representante de MercadoLibre
    • respondent_timeout: Vendedor no contesta
    • return_cancelled: Devolución cancelada por el comprador
    • return_expired: Devolución vencida sin cambio de estado en el envío
    • seller_asked_to_close_claim: Vendedor pidió al comprador que cierre el reclamo
    • seller_did_not_help: Comprador pudo solucionar el inconveniente sin ayuda del vendedor
    • seller_explained_functions: Vendedor explicó cómo funcionaba el item
    • seller_sent_product: Vendedor envió el producto
    • timeout: Cierre por timeout de acción al comprador
    • warehouse_decision: Cierre por revisión de producto en Warehouse
    • warehouse_timeout: Cierre por demora en revisión de producto en Warehouse
    • worked_out_with_seller: Comprador lo soluciona con el vendedor por fuera de ML
    • low_cost: Cierre porque el costo del envío es mayor que el del producto
    • item_changed: Cierre porque el cambio se hizo de forma exitosa
    • change_expired: No se realizó el cambio y se cumplió el tiempo permitido
    • change_cancelled_buyer: Cierre proactivo de un cambio por parte del buyer
    • change_cancelled_seller: Cierre proactivo de un cambio por parte del seller
    • change_cancelled_meli: Cierre de un cambio por parte de Meli
    • shipment_not_stopped: Cierre porque el envío no se logró detener
    • cancel_installation: Cancelación de servicio de instalación

data_created: Fecha de la resolución/cierre del reclamo

benefited: Beneficiarios

appeal: Aplicar una apelación

  • site_id: ID del site donde se desarrolla el reclamo
  • date_created: Fecha de creación/apertura del reclamo
  • last_updated: Fecha de la última actualización sobre el reclamo
  • related_entities: Contiene una lista de entidades relacionadas al reclamo. En caso que no cuente con devoluciones, la lista vendrá vacía.
    • return: Indica que el reclamo cuenta con una devolución asignada

Detalles de un reclamo

Para acceder a información detallada sobre un reclamo, incluyendo su estado actual, es necesario consultar el recurso /claims/$CLAIMS/detail

Llamada:

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

Ejemplo:

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

Respuesta:

{
    "due_date": "2023-07-19T22:33:00.000-04:00",
    "action_responsible": "mediator",
    "title": "Devolución en mediación con Mercado Libre",
    "description": "Intervinimos para ayudar. Te escribiremos antes del miércoles 19 de julio.",
    "problem": "Nos dijiste que el producto llegó dañado"
}

Campos de la respuesta

La respuesta de un GET al recurso /claims/detail proporcionará los siguientes parámetros:

  • due_date: Fecha límite para solucionar el reclamo
  • action_responsible: Responsable de la acción. Puede tomar dos valores: seller | buyer | mediator
  • title: Título que detalla el estado del reclamo
  • description: Descripción detallada del estado en el que se encuentra el reclamo
  • problem: Problema por el cual se generó el reclamo

Buscar reclamos

La búsqueda de reclamos te proporciona una visión completa de todos los reclamos asociados a un vendedor específico. Esta herramienta es esencial para monitorear y gestionar eficientemente las incidencias reportadas.

Parámetros:

Se puede recuperar un reclamo realizando una búsqueda en el sistema de claims utilizando diversos parámetros. Los parámetros de búsqueda disponibles son los siguientes:

Query params Type Values Detalle value
date_created date (yyyy-MM-dd'T'HH:mm:ss.SS SZ) Fecha de creación del reclamo. Ej.: 2018-05-01T00:00:00.000-0400
id Long {claimId} ID del reclamo
last_updated date (yyyy-MM-dd'T'HH:mm:ss.SS SZ) Fecha de la última actualización del reclamo. Ej.: 2018-05-01T00:00:00.000-0400
order_id Long {orderId} Reclamo cuyo recurso puede o no ser una orden, pero dicho recurso está relacionado con la order del order_id ingresado
player_role String {userId} ID del usuario interviniente en el reclamo
player_user_id String {userId} ID del usuario interviniente en el reclamo
reason_id Long {reasonId} Razón/motivo por el cual se creó el reclamo
resource String shipment, payment, order, purchase Recurso sobre el que se creó el reclamo
resource_id Long {ID del recurso} ID del recurso sobre el que se creó el reclamo
site_id String {enabledSites} ID del site donde se desarrolla el reclamo
stage String claim, dispute, recontact, stale, none Etapa del reclamo
status String mediations, returns, ml_case, cancel_sale, cancel_purchase, fulfillment, change Tipo de reclamo
labels.name String test_claim, claim_version, reason_flow, reputation, forward_label, etc... Este es el nombre del label que forma parte de un reclamo, según corresponda. Por ejemplo, si el label tiene como name test_claim, entonces correspondería a un reclamo específicamente designado como test. Otros valores pueden también utilizarse aquí para identificar diferentes labels en los reclamos según se necesite.
Nota:
Con el recurso de buscar reclamos, podrás considerar ciertos filtros para poder obtener resultados más específicos según lo requerido.

Al buscar por pack_id y order_id, obtendrás todos los reclamos relacionados de manera indirecta con el ID ingresado. Por ejemplo, al ingresar un pack_id, la búsqueda devolverá todos los reclamos vinculados a ese pack a través de sus orders, shipments y payments. De la misma manera, al buscar por order_id, se mostrarán todos los reclamos asociados a esa orden en particular. Esta capacidad te permite gestionar y resolver incidencias de manera más efectiva.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 
https://api.mercadolibre.com/post-purchase/v1/claims/search?status=opened

Respuesta:

{
   "paging": {
       "total": 316,
       "offset": 0,
       "limit": 30
   },
   "data": [
       {
           "id": 5187110991,
           "resource_id": 2000005489080336,
           "status": "opened",
           "type": "mediations",
           "stage": "dispute",
           "parent_id": null,
           "resource": "order",
           "reason_id": "PDD9528",
           "fulfilled": true,
           "quantity_type": null,
           "players": [
               {
                   "role": "complainant",
                   "type": "buyer",
                   "user_id": 1354382565,
                   "available_actions": []
               },
               {
                   "role": "respondent",
                   "type": "seller",
                   "user_id": 1295357671,
                   "available_actions": [
                       {
                           "action": "send_message_to_mediator",
                           "mandatory": false,
                           "due_date": null
                       }
                   ]
               }
           ],
           "resolution": null,
           "site_id": "MLM",
           "date_created": "2023-04-18T12:06:48.000-04:00",
           "last_updated": "2023-04-18T12:07:25.000-04:00"
       },
       {
           "id": 5173473377,
           "resource_id": 2000005051445424,
           "status": "opened",
           "type": "returns",
           "stage": "dispute",
           "parent_id": null,
           "resource": "order",
           "reason_id": "PDD9502",
           "fulfilled": true,
           "quantity_type": null,
           "players": [
               {
                   "role": "complainant",
                   "type": "buyer",
                   "user_id": 1299347553,
                   "available_actions": []
               },
               {
                   "role": "respondent",
                   "type": "seller",
                   "user_id": 1295357671,
                   "available_actions": [
                       {
                           "action": "send_message_to_mediator",
                           "mandatory": false,
                           "due_date": null
                       }
                   ]
               }
           ],
           "resolution": null,
           "site_id": "MLM",
           "date_created": "2023-02-03T16:25:40.000-04:00",
           "last_updated": "2023-03-13T22:41:49.000-04:00"
       }
…
    ]
}
Nota:
1. Tipificación de reclamos: Cada tipificación de reclamos está asociada a un conjunto específico de razones. Para obtener detalles sobre el motivo de inicio de un reclamo, es necesario consultar la API de reasons.

2. Tipos de roles dentro del reclamo: Los roles de los players están estrictamente definidos y no pueden ser otros. El player mediator interviene en el claim únicamente cuando se encuentra en las etapas de disputa o recontact. Cada player puede tener una lista de acciones, pero en el reclamo, solo un player tiene la acción mandatoria en todo el proceso.

Personalizar la búsqueda de reclamos

La búsqueda de reclamos a través del servicio de búsquedas puede generar una amplia variedad de resultados, dependiendo de los parámetros utilizados. Para optimizar este proceso, se ofrecen diversas opciones que mejoran la eficiencia de la búsqueda.

Parámetros:

Query params Type Values Detalle value
offset Integer Nivel de desplazamiento en el conjunto de datos resultado de la búsqueda
limit Integer Cantidad límite de resultados que desea que retorne la búsqueda. Por defecto son 30 resultados y cómo máximo son 100 resultados
sort String field: date_asc, date_desc, cualquier campo del reclamo Ordenamiento de los resultados de la búsqueda
range (field) :after: "yyyy-MM-dd'T'HH:mm:ss.SSZ" before: "yyyy-MM-dd'T'HH:mm:ss.SSZ" String field: Cualquier fecha del reclamo Búsqueda entre/por rango de fechas

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/post-purchase/v1/claims/search?status=opened&stage=dispute&sort=last_updated:asc

Respuesta:

{
   "paging": {
       "total": 125,
       "offset": 0,
       "limit": 30
   },
   "data": [
       {
           "id": 5172740586,
           "resource_id": 2000005028386014,
           "status": "opened",
           "type": "returns",
           "stage": "dispute",
           "parent_id": null,
           "resource": "order",
           "reason_id": "PDD9502",
           "fulfilled": true,
           "quantity_type": null,
           "players": [
               {
                   "role": "complainant",
                   "type": "buyer",
                   "user_id": 1298667949,
                   "available_actions": []
               },
               {
                   "role": "respondent",
                   "type": "seller",
                   "user_id": 1295357671,
                   "available_actions": [
                       {
                           "action": "send_message_to_mediator",
                           "mandatory": false,
                           "due_date": null
                       }
                   ]
               }
           ],
           "resolution": null,
           "site_id": "MLM",
           "date_created": "2023-01-31T09:18:01.000-04:00",
           "last_updated": "2023-02-13T23:57:02.000-04:00",
           "return": null
       },
       {
           "id": 5175655066,
           "resource_id": 2000005121967322,
           "status": "opened",
           "type": "mediations",
           "stage": "dispute",
           "parent_id": null,
           "resource": "order",
           "reason_id": "PDD9553",
           "fulfilled": true,
           "quantity_type": null,
           "players": [
               {
                   "role": "complainant",
                   "type": "buyer",
                   "user_id": 1310908303,
                   "available_actions": []
               },
               {
                   "role": "respondent",
                   "type": "seller",
                   "user_id": 1295357671,
                   "available_actions": [
                       {
                           "action": "send_message_to_mediator",
                           "mandatory": false,
                           "due_date": null
                       }
                   ]
               }
           ],
           "resolution": null,
           "site_id": "MLM",
           "date_created": "2023-02-15T08:59:41.000-04:00",
           "last_updated": "2023-02-15T09:00:21.000-04:00",
           "return": null
       }
   ]
}

Obtener detalle del motivo por el que se inició el reclamo

Para obtener detalles sobre el motivo de inicio de un reclamo, se debe consultar el recurso /claims/reasons/$REASON_ID. Este acceso proporciona información detallada y permite el uso de parámetros específicos para realizar búsquedas más efectivas.

Parámetros:

Query params Type Values Detalle value
flow string cancel_sale, distant_agencies, fulfillment_delivered, fulfillment_undelivered, label_unavailable, mediations, mediations_delivered, mediations_undelivered, no_shipping_options, reservation, returns, unification_delivered Permite obtener reasons PDD o PNR
delivered string true, false Permite obtener reasons PDD o PNR
deep boolean true, false Permite obtener el árbol de dependencias de la reason consultada
name string wrong_shipment_cost, wrong_seller_address, wrong_buyer_address, unavailable_pick_up, unknown_buyer, unknown_seller, unknown_shipment_policy, unavailable_incorrect_shipping, shipment_type_not_allowed_daft, unavailable_correct_shipping, unavailable_product, unavailable_payment_method, unavailable_buyer_item_report, alignment_prices_taxes, alignment_discounts, safe_review, safety_notifications, seller_rate_modification, unauthorized_transference, seller_address_not_allowed, return_request_return, represent_buyer_claim, represent_buyer_dispute, alignment_packaging, improper_tracking, improper_package_weight, payment_method_fraud, no_agreed_delivery, not_expected_quality_offer, not_expected_quality_item, wrong_warranty, misleading_promotion, returned_service, finished_return_automatic, finished_return_with_request, return_claim_not_accept, return_claim_accept, return_claim_cancel, return_claim_item_restock, return_claim_item_refurbished, return_claim_item_lost, wrong_pack_service, wrong_pack_service_transport, buyer_return_pack_service, seller_return_pack_service, wrong_pack_service_provider, wrong_pack_service_time, wrong_pack_service_repack, wrong_pack_service_delivery, buyer_dispute_delivery, buyer_dispute_delivery_not_show, buyer_dispute_delivery_not_contact, buyer_dispute_delivery_not_receive, buyer_dispute_delivery_no_show, buyer_dispute_delivery_no_call, wrong_pack_service_failed, buyer_dispute_buyer_claim_delivery, delivery_wrong_seller, delivery_wrong_buyer, delivery_same_state, delivery_same_city, delivery_same_zip_code, delivery_wrong_shipping, delivery_lost, delivery_damaged, delivery_delayed, delivery_wrong_address, delivery_wrong_city, delivery_wrong_state, delivery_wrong_zip_code, delivery_wrong_country, delivery_wrong_date, delivery_wrong_time, delivery_wrong_shipping_service, delivery_wrong_pack_service, wrong_pack_service_full, wrong_pack_service_partial, wrong_pack_service_product_wrong, wrong_pack_service_product_changed, wrong_pack_service_restock, wrong_pack_service_no_restock, wrong_pack_service_refurbished, wrong_pack_service_lost, wrong_pack_service_failed, wrong_pack_service_provider, wrong_pack_service_time, wrong_pack_service_repack, buyer_dispute_buyer_claim_delivery

Llamada:

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

Ejemplo:

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

Respuesta:

{
    "id": "PDD9939",
    "flow": "post_purchase_delivered",
    "name": "repentant_buyer",
    "detail": "Llegó lo que compré en buenas condiciones pero no lo quiero",
    "position": 10,
    "filter": {
        "group": [
            "generic",
            "fashion",
            "installable_autoparts",
            "expiring_food",
            "expiring_health"
        ],
        "site_id": [
            "MLC",
            "MCO",
            "MLU",
            "MPE",
            "MLM",
            "MLA",
            "MLB",
            "MEC",
            "CBT"
        ]
    },
    "settings": {
        "allowed_flows": [
            "returns"
        ],
        "expected_resolutions": [
            "change_product",
            "return_product"
        ],
        "rules_engine_triage": [
            "repentant"
        ]
    },
    "parent_id": null,
    "children_title": null,
    "status": "active",
    "date_created": "2024-01-15T18:07:42.632-04:00",
    "last_updated": "2024-03-12T20:20:21.795-04:00"
}

Campos de la respuesta

La respuesta de un GET al recurso /claims/reasons/$REASON_ID proporcionará los siguientes parámetros:

  • id: ID del reclamo
  • flow: Flujo del reclamo
  • name: Nombre de la reason
  • detail: Detalle de la reason
  • position: Funciona como sort_by, pero de forma predeterminada. Sin sort_by, el sistema ordena las razones por posición ascendente.
  • group: El group indica la vertical del ítem. Puede tomar alguno de los siguientes valores:
    • generic
    • fashion
    • installable_autoparts
    • expiring_food
    • expiring_health
  • site_id: ID del site donde se desarrolla el reclamo
  • settings: Puede tomar alguno de los siguientes valores:
    • allowed_flows: Indica en qué flujos podemos visualizar esta reason
    • expected_resolutions: Posibles resoluciones esperadas por quien reclama
      • product
      • refund
      • other
    • rules_engine_triage: Este ítem define el tag para la categorización de triage, con valores como:
      • repentant
      • defective
      • incomplete
      • different
      • not_working
  • parent_id: Reason padre
  • children_title: Este valor se usa para tipificar en post-compra, asignando el título a razones hijas de aquellas que contienen este atributo. Solo las razones tienen este atributo.
  • status: Estado de la reason
  • date_created: Fecha de creación de la reason
  • last_updated: Fecha de la última actualización de la reason

Historial de acciones del reclamo

El historial de acciones de un reclamo detalla las acciones realizadas, quién las ejecuta y cuándo, permitiendo un seguimiento preciso y estratégico del proceso

Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/post-purchase/v1/claims/5175748308/actions-history

Respuesta:

[
    {
        "action_name": "send_message_to_mediator",
        "player_role": "complainant",
        "action_reason_id": "",
        "claim_stage": "dispute",
        "claim_status": "opened",
        "date_created": "2023-02-15T15:44:42.000-04:00"
    },
    {
        "action_name": "open_dispute",
        "player_role": "complainant",
        "action_reason_id": "",
        "claim_stage": "claim",
        "claim_status": "opened",
        "date_created": "2023-02-15T15:44:42.000-04:00"
    },
    {
        "action_name": "generate_return",
        "player_role": "complainant",
        "action_reason_id": null,
        "claim_stage": "claim",
        "claim_status": "opened",
        "date_created": "2023-02-15T15:43:15.000-04:00"
    },
    {
        "action_name": "allow_return",
        "player_role": "respondent",
        "action_reason_id": null,
        "claim_stage": "claim",
        "claim_status": "opened",
        "date_created": "2023-02-15T15:40:15.000-04:00"
    },
    {
        "action_name": "open_claim",
        "player_role": "complainant",
        "action_reason_id": null,
        "claim_stage": null,
        "claim_status": null,
        "date_created": "2023-02-15T15:35:04.000-04:00"
    }
]

Campos de la respuesta

La respuesta de un GET al recurso /claims/actions-history proporcionará los siguientes parámetros:

  • action_name: Nombre de la acción realizada
  • player_role: Player que realiza la acción
  • action_reason_id: ID de acción realizada
  • claim_stage: Etapa de la etapa en la que la acción fue realizada
  • claim_status: Estatus de la etapa en la que la acción fue realizada
  • date_created: Fecha en la que la acción fue realizada

Historial de estados del reclamo

El historial de estados de un reclamo, proporciona información sobre la etapa y el estado del reclamo en el momento de cada acción, permitiendo un seguimiento preciso y estratégico del proceso

Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/post-purchase/v1/claims/5175748308/status-history

Respuesta:

[
    {
        "stage": "dispute",
        "status": "opened",
        "date": "2023-02-15T15:44:42.000-04:00",
        "change_by": "complainant"
    },
    {
        "stage": "claim",
        "status": "opened",
        "date": "2023-02-15T15:35:04.000-04:00",
        "change_by": "complainant"
    }
]

Cómo identificar si un reclamo afecta la reputación

El recurso /affects-reputation facilita a los integradores la capacidad de determinar si un reclamo específico impacta la reputación del vendedor, mediante la ejecución de la llamada correspondiente

Llamada:

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

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/post-purchase/v1/claims/5224172034/affects-reputation

Respuesta:

{
    "affects_reputation": "not_applies",
    "has_incentive": false,
    "due_date": null
}

Campos de la respuesta

La respuesta de un GET al recurso /claims/affects-reputation proporcionará los siguientes parámetros:

  • affects_reputation: Informa si el reclamo afecta la reputación del vendedor. Puede tomar alguno de los siguientes valores:
    • affected: Afecta reputación (Solo consideramos que afectó cuando el reclamo está cerrado)
    • not_affected: No afecta la reputación
    • not_applies: No aplica
  • has_incentive: Cuando este campo devuelve true, si el vendedor responde satisfactoriamente dentro de las primeras 48 horas, no afectará su reputación. Si es false, el vendedor aún tiene las mismas 48 horas, pero no garantizamos que la reputación del vendedor no se vea afectada
  • due_date: Fecha límite para solucionar el reclamo

Siguiente: Gestionar mensajes de un reclamo