Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentación
¿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.
![](https://http2.mlstatic.com/storage/developers-site-cms-admin/187513228568-Copia-de-Diagrama-Reclamos.png)
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/5281510459
Respuesta:
{
"id": 5281510459,
"resource_id": 2000008659553306,
"status": "opened",
"type": "mediations",
"stage": "claim",
"parent_id": null,
"resource": "order",
"reason_id": "PDD9949",
"fulfilled": true,
"quantity_type": "total",
"players": [
{
"role": "complainant",
"type": "buyer",
"user_id": 1550979062,
"available_actions": []
},
{
"role": "respondent",
"type": "seller",
"user_id": 1632279809,
"available_actions": [
{
"action": "send_message_to_complainant",
"mandatory": false,
"due_date": null
},
{
"action": "open_dispute",
"mandatory": false,
"due_date": null
},
{
"action": "return_review_fail",
"mandatory": false,
"due_date": null
},
{
"action": "return_review_ok",
"mandatory": false,
"due_date": null
},
{
"action": "refund",
"mandatory": false,
"due_date": null
}
]
},
{
"role": "mediator",
"type": "internal",
"user_id": 46622406,
"available_actions": []
}
],
"resolution": null,
"site_id": "MLA",
"date_created": "2024-07-01T15:19:11.000-04:00",
"last_updated": "2024-07-01T15:22:26.000-04:00",
"related_entities": [
"return"
]
}
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:
- meditations: reclamo entre comprador y vendedor.
- return: devolución del producto. En este caso, no hay mensajes. Para trabar devoluciones, siga la documentación de 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.
- 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 ordenes 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 Diferente o Defectuoso
- CS: Compra Cancelada
- fulfilled: Indica si el reclamo se inicia por un producto entregado o no. Puede tomar dos valores: false | true.
- quantity_type: informa si el claim es una reclamo parcial o no
- partial: indica que es un reclamo parcial
- total: indica que es un reclamo completo
- 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 resource.
- 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 comprador.
- open_dispute: iniciar una mediación.
- send_potential_shipping: enviar una promesa de envío, 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 : devolver parte del dinero del comprador para reclamos del tipo PDD.
- send_tracking_number: enviar el número de rastreo de envío (tracking number).
- return_review_fail: realizar una revisión fallida de una devolución. (tracking number).
- return_review_ok: realizar una revisión ok de una devolución.
- mandatory: campo de tipo true donde la acción es obligatoria y debe ser cumplida antes del tiempo límite.
- due_date: tiempo límite para realizar la acción.
- action: acciones posibles de realizarse. Para el vendedor serán:
- role: rol dentro del reclamo. Puede ser:
- 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
- partial_refunded: Reembolso parcial del pago otorgado al comprador
- payment_refunded: Pago devuelto al comprador
- prefered_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_canceled: 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 la ayuda del vendedor
- seller_explained_functions: Vendedor explicó cómo funcionaba el ítem
- seller_sent_product: Vendedor envió el producto
- timeout: Cierre por timeout de acción al comprador
- warehouse_decision: Cierre por demora en revisión de producto en Warehouse
- warehouse_timeout: Cierre por demora en revisión de producto en Warehouse
- worked_out_with_seller: Comprador lo solucionó 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 de la resolución (complainant**|**respondent**|**)
- closed_by: Actor que cerró el reclamo (mediator | buyer)
- applied_coverage: Cubre el reclamo (false | true)
- site_id: ID del site donde se desarrolla el reclamo
- created_date: 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 cuenten con devoluciones, los ids tendrán vda.
- return: Indica que el reclamo cuenta con una devolución asignada
- reason: forma de resolución del reclamo
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 |
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"
}
…
]
}
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.
- not_affected: No afecta la reputación.
- not_applies: Pagos no vinculados a pedidos del marketplace o Shops.
- 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