Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Última actualización 14/11/2023
Experiencia de compra
El recurso /purchase_experience/integrators te permite identificar el estado de tus publicaciones, con el nivel alcanzado y sus correspondientes accionables para el caso de que necesiten mejorar con respecto a la experiencia de compra ofrecida.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reputation/items/$ITEM_ID/purchase_experience/integratorsEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reputation/items/MLA1391786841/purchase_experience/integrators?locale=es_ARRespuesta:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tienes un problema con este producto. Revisa los consejos sobre cómo mejorar."
},
{
"order": 1,
"text": "La experiencia que brinda tu publicación afecta tu exposición y podríamos pausarla."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Pausar desde el listado"
}
],
"reputation": {
"color": "orange",
"text": "Media",
"value": 50
},
"status": {
"id": "active"
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "1 problema",
"cancellations": 1,
"claims": 0,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "BROKEN_PRODUCT",
"title": {
"text": "El producto llegó abierto y/o dañado"
},
"remedy": {
"text": "Revisa que los productos que vendes y su embalaje estén en buenas condiciones antes de enviarlos o despacharlos. "
}
}
}
],
"distribution": {
"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
"level_one": [
{
"key": "PRODUCT",
"title": {
"text": "Con el producto entregado"
},
"color": "#7267E4",
"percentage": 100.0,
"quantities_level_two": [
{
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
},
"quantity": 11
}
]
}
]
}
}
}Parámetro requeridos
El único parámetro requerido es el de locale, con el fin de obtener los textos correspondientes para cada idioma, logrando brindar información detallada y clara.
| Query params | Type | Mandatory | Values | Only one |
|---|---|---|---|---|
| locale | string | YES | es_MX, es_UY, es_CO, es_CL, es_AR, pt_BR, en_US. |
YES |
Campos de la respuesta
item_id: identificación del ítem que se está consultando.
freeze: aviso de freezado de experiencia por el cual no se generan acciones sobre el ítem.
status: información del estado de la publicación. (active | paused | moderated).
title: motivo principal por el que el ítem se encuentra en el estado actual.
subtitles: detalles por los cuales el ítem se encuentra en el estado actual.
actions: accionables posibles para modificar la situación actual del ítem.
reputation: color, detalle y valor actual de la reputación según la experiencia de compra.
metrics_details: detalle de los problemas, niveles, posibles soluciones, accionables y la distribución para dar detalles de la experiencia de compra del ítem.
- Status -> paused
- Status -> active
Componentes de la respuesta
Text
{
"order": uint,
"text": string,
"placeholders": []string,
}Ejemplo: asdasd {0} asdasd {1}. [0]
- Los {} deberán ser reemplazados por los placeholders.
- Los [] deberán ser reemplazados por los action.
{
"text": "Por el momento {0}esta publicación no perderá exposición ni será pausada o anulada por brindar experiencia mala o media.{1} Es importante solucionar sus problemas para mejorar la experiencia que brindas.",
"placeholders": [
"",
""
]
}Status
{
"id": enum (active | paused | moderated),
"assigned_by": enum (reputation | other),
"text": string
}Action
{
"order": uint,
"text": string,
}Reputation
{
"color": string,
"text": string,
"value": int
}Metrics details
{
"empty_state_title": string,
"problems": []problem,
"distribution": distribution
}Problem
{
"order": unit,
"key": string, // key de L1
"color": string, // de L1
"quantity": text, // de L3
"cancellations": unit, // de l3
"claims": unit, // de l3
"tag": string,
"level_2": level_2,
"level_3": level_3
}Level 2
{
"key": string, // key de L2
"title": text,
}Level 3
{
"key": string, // key de L3
"title": text,
"remedy": text,
}Distribution
{
"from": date,
"to": date,
"level_1": []level_1
}Formato date
{"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
}Level 1
{
"key": string, // key de L1
"title": text,
"color": string,
"percentage": float,
"quantities_level_2": [
{
"key": string, // L2 key
"title": text,
"quantity": uint
}
]
}Posibles errores
| Error_code | Mensaje de error | Descripción |
|---|---|---|
| 400 | Bad Request | La solicitud es inválida o no se puede entender por el servidor. |
| 404 | Resource not found | El recurso no está funcionando o que se realizó mal la llamada. |
| 500 | Internal Server Error | El servidor ha tenido un error inesperado y no puede completar la solicitud. |
Ejemplos de casos de uso
- Ítem activo con score 100 (sin problemas)
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "No tuviste problemas con este producto."
},
{
"order": 1,
"text": "Estás brindando una buena experiencia de compra. ¡Sigue así!"
}
],
"actions": [
{
"order": 0,
"text": "Ver publicación"
}
],
"reputation": {
"color": "green",
"text": "Buena",
"value": 100
},
"status": {
"id": "active"
},
"metrics_details": {
"empty_state_title": "No tuviste ventas con problemas en los últimos 180 días.",
"distribution": {
"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
"level_one": []
}
}
}- Ítem activo con score 50
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tienes un problema con este producto. Revisa los consejos sobre cómo mejorar."
},
{
"order": 1,
"text": "La experiencia que brinda tu publicación afecta tu exposición y podríamos pausarla."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Pausar desde el listado"
}
],
"reputation": {
"color": "orange",
"text": "Media",
"value": 50
},
"status": {
"id": "active"
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "1 problema",
"cancellations": 1,
"claims": 0,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "BROKEN_PRODUCT",
"title": {
"text": "El producto llegó abierto y/o dañado"
},
"remedy": {
"text": "Revisa que los productos que vendes y su embalaje estén en buenas condiciones antes de enviarlos o despacharlos. "
}
}
}
],
"distribution": {
"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
"level_one": [
{
"key": "PRODUCT",
"title": {
"text": "Con el producto entregado"
},
"color": "#7267E4",
"percentage": 100,
"quantities_level_two": [
{
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
},
"quantity": 11
}
]
}
]
}
}
}- Ítems inactivos por experiencia de compra
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tuviste un problema con este producto. Revisa los consejos sobre cómo mejorar."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Reactivar desde el listado"
}
],
"reputation": {
"color": "red",
"text": "Mala",
"value": 30
},
"status": {
"id": "paused",
"assigned_by": "reputation",
"text": "Tu publicación está inactiva. La pausamos porque está brindando una mala experiencia de compra."
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "1 problema",
"cancellations": 0,
"claims": 1,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "PRODUCT_IN_BAD_CONDITION",
"title": {
"text": "El producto llegó en mal estado"
},
"remedy": {
"text": "Revisa que los productos que vendes estén en buenas condiciones antes de enviarlos o despacharlos. "
}
}
}
],
"distribution": {
"from": "2023-04-21T18:41:45Z",
"to": "2023-10-18T18:41:45Z",
"level_one": [
{
"key": "PRODUCT",
"title": {
"text": "Con el producto entregado"
},
"color": "#7267E4",
"percentage": 100.0,
"quantities_level_two": [
{
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
},
"quantity": 1
}
]
}
]
}
}
}- Ítem inactivo por moderaciones, se puede reactivar
Ejemplo:
{
"item_id": "MLU1234",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tuviste 9 problemas con este producto. Revisa los consejos sobre cómo mejorar."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Reactivar desde el listado"
}
],
"reputation": {
"color": "red",
"text": "Mala",
"value": 30
},
"status": {
"id": "paused",
"assigned_by": "reputation",
"text": "Tu publicación está inactiva. La pausamos porque está brindando una mala experiencia de compra."
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "OPERATION",
"color": "#EC79BC",
"quantity": "3 problemas",
"cancellations": 2,
"claims": 1,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "PACK_OFF",
"title": {
"text": "Dificultades para preparar el pedido"
}
},
"level_three": {
"key": "PRODUCT_NOT_PREPARED",
"title": {
"text": "El producto no terminó de prepararse"
},
"remedy": {
"text": "Valida el stock disponible de tu publicación y revisa los tiempos que tienes para preparar tu envío. Si por algún motivo, no estarás o no tienes stock suficiente, pausa tu publicación."
}
}
},
{
"order": 1,
"key": "OPERATION",
"color": "#EC79BC",
"quantity": "2 problemas",
"cancellations": 2,
"claims": 0,
"level_two": {
"key": "PACK_OFF",
"title": {
"text": "Dificultades para preparar el pedido"
}
},
"level_three": {
"key": "LABEL_PRINTING_PROBLEMS",
"title": {
"text": "Dificultades para imprimir la etiqueta"
},
"remedy": {
"text": "Verifica que la impresión sea de buena calidad, no cambies el tamaño de la etiqueta y al pegar la etiqueta en el paquete, no la rayes ni la tapes con la cinta adhesiva."
}
}
},
{
"order": 2,
"key": "OPERATION",
"color": "#EC79BC",
"quantity": "2 problemas",
"cancellations": 2,
"claims": 0,
"level_two": {
"key": "PACK_OFF",
"title": {
"text": "Dificultades para preparar el pedido"
}
},
"level_three": {
"key": "WITHOUT_STOCK",
"title": {
"text": "No tenías stock disponible"
},
"remedy": {
"text": "Valida el stock disponible de tu publicación y revisa los tiempos que tienes para preparar tu envío. Si por algún motivo, no estarás o no tienes stock suficiente, pausa tu publicación."
}
}
},
{
"order": 3,
"key": "OPERATION",
"color": "#EC79BC",
"quantity": "2 problemas",
"cancellations": 0,
"claims": 2,
"level_two": {
"key": "PACK_OFF",
"title": {
"text": "Dificultades para preparar el pedido"
}
},
"level_three": {
"key": "STOP_DUE_HOLIDAY",
"title": {
"text": "No estabas operando o parecías inactivo"
},
"remedy": {
"text": "Si por algún motivo, no estarás disponible te sugerimos pausar tus publicaciones."
}
}
}
],
"distribution": {
"from": "2023-04-03T00:51:39Z",
"to": "2023-09-30T00:51:39Z",
"level_one": [
{
"key": "OPERATION",
"title": {
"text": "Al gestionar o preparar la venta"
},
"color": "#EC79BC",
"percentage": 100.0,
"quantities_level_two": [
{
"key": "PACK_OFF",
"title": {
"text": "Dificultades para preparar el pedido"
},
"quantity": 9
}
]
}
]
}
}
}- Ítem pausado por experiencia de compra
Cae a 30 el nivel de experiencia de compra.
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tuviste 15 problemas con este producto."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Ver publicación"
}
],
"reputation": {
"color": "red",
"text": "Mala",
"value": 30
},
"status": {
"id": "paused",
"assigned_by": "other",
"text": "Tu publicación está inactiva."
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "15 problemas",
"cancellations": 3,
"claims": 7,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "DEFECTS_AFTER_USE",
"title": {
"text": "Aparecieron defectos después del uso del producto"
},
"remedy": {
"text": "Asegúrate de vender productos de buena calidad. Si tu producto tiene defectos de fábrica, reemplázalos lo antes posible."
}
}
}
],
"distribution": {
"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
"level_one": [
{
"key": "PRODUCT",
"title": {
"text": "Con el producto entregado"
},
"color": "#7267E4",
"percentage": 100.0,
"quantities_level_two": [
{
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
},
"quantity": 15
}
]
}
]
}
}
}- Ítem inactivo por el vendedor
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Estás brindando una buena experiencia de compra. ¡Sigue así!"
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Ver publicación"
}
],
"reputation": {
"color": "green",
"text": "Buena",
"value": 100
},
"status": {
"id": "paused",
"assigned_by": "other",
"text": "Tu publicación está inactiva."
},
"metrics_details": {
"empty_state_title": "No tuviste ventas con problemas en los últimos 180 días.",
"distribution": {
"from": "2023-04-21T18:39:20Z",
"to": "2023-10-18T18:39:20Z",
"level_one": []
}
}
}- Ítem sin experiencia de compra
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Aún no podemos medir tu experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "La calcularemos con las ventas de los últimos 180 días."
}
],
"actions": [],
"reputation": {
"color": "gray",
"value": -1
},
"status": {
"id": "active"
},
"metrics_details": {
"empty_state_title": "No tuviste ventas con problemas en los últimos 180 días.",
"distribution": {
"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
"level_one": []
}
}
}- Ítem freezado
Ejemplo:
{
"item_id": "MLA1391786841",
"freeze": {
"text": "Por el momento {0}esta publicación no perderá exposición ni será pausada o anulada por brindar experiencia mala o media.{1} Es importante solucionar sus problemas para mejorar la experiencia que brindas.",
"placeholders": [
"",
""
]
},
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tienes 22 problemas con este producto. Revisa los consejos sobre cómo mejorar."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Pausar desde el listado"
}
],
"reputation": {
"color": "orange",
"text": "Media",
"value": 65
},
"status": {
"id": "active"
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "10 problemas",
"cancellations": 3,
"claims": 7,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "PRODUCT_IN_BAD_CONDITION",
"title": {
"text": "El producto llegó en mal estado"
},
"remedy": {
"text": "Revisa que los productos que vendes estén en buenas condiciones antes de enviarlos o despacharlos. "
}
}
},
{
"order": 1,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "12 problemas",
"cancellations": 3,
"claims": 7,
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "NEXT_TO_EXPIRE",
"title": {
"text": "El producto había expirado o iba a expirar pronto"
},
"remedy": {
"text": "Verifica la fecha de expiración de los productos que vendes antes de despacharlos o enviarlos."
}
}
}
],
"distribution": {
"from": "2023-07-04T19:08:56Z",
"to": "2023-11-04T19:08:56Z",
"level_one": [
{
"key": "PRODUCT",
"title": {
"text": "Con el producto entregado"
},
"color": "#7267E4",
"percentage": 100.0,
"quantities_level_two": [
{
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
},
"quantity": 22
}
]
}
]
}
}
}- Nivel de experiencia de compra 30 - Reactivado
Ejemplo:
{
"item_id": "MLA1391786841",
"title": {
"text": "Experiencia de compra"
},
"subtitles": [
{
"order": 0,
"text": "Tienes un problema con este producto. Revisa los consejos sobre cómo mejorar."
},
{
"order": 1,
"text": "Podríamos anular tu publicación si continúa brindando mala experiencia."
}
],
"actions": [
{
"order": 0,
"text": "Modificar publicación"
},
{
"order": 1,
"text": "Pausar desde el listado"
}
],
"reputation": {
"color": "red",
"text": "Mala",
"value": 30
},
"status": {
"id": "active"
},
"metrics_details": {
"problems": [
{
"order": 0,
"key": "PRODUCT",
"color": "#7267E4",
"quantity": "1 problema",
"cancellations": 0,
"claims": 1,
"tag": "PROBLEMA PRINCIPAL",
"level_two": {
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
}
},
"level_three": {
"key": "PRODUCT_IN_BAD_CONDITION",
"title": {
"text": "El producto llegó en mal estado"
},
"remedy": {
"text": "Revisa que los productos que vendes estén en buenas condiciones antes de enviarlos o despacharlos. "
}
}
}
],
"distribution": {
"from": "2023-04-21T09:06:05Z",
"to": "2023-10-18T09:06:05Z",
"level_one": [
{
"key": "PRODUCT",
"title": {
"text": "Con el producto entregado"
},
"color": "#7267E4",
"percentage": 100.0,
"quantities_level_two": [
{
"key": "POOR_CONDITION",
"title": {
"text": "Estaban en mal estado"
},
"quantity": 1
}
]
}
]
}
}
}Detalle de problemas
Distribución con tooltip
Ejemplo:
{
"distribution": {
"from": "2023-02-01T00:00:00-03:00",
"to": "2023-08-11T00:00:00-03:00",
"level_1": [
{
"key": "OPERATION",
"title": {
"text": "Con el producto entregado"
},
"color": "#102012",
"percentage": 80,
"quantities_level_2": [
{
"key": "X",
"title": {
"text": "Tenia fallas"
},
"quantity": 70
},
{
"key": "X",
"title": {
"text": "Es diferente a lo pedido"
},
"quantity": 16
}
]
},
{
"key": "X",
"title": {
"text": "Al despachar o entregar el producto"
},
"color": "#103012",
"percentage": 15
},
{
"key": "PRODUCT_NOT_PREPARED",
"title": {
"text": "Al preparar o gestionar la venta"
},
"color": "#103012",
"percentage": 5
}
]
}
}