Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação
Última atualização em 14/11/2023
Experiência de compra
O 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.
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reputation/items/$ITEM_ID/purchase_experience/integratorsExemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reputation/items/MLA1391786841/purchase_experience/integrators?locale=es_ARResposta:
{
"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âmetros requeridos
O único parámetro requerido es el de locale, para obter os textos correspondentes para cada idioma, conseguindo oferecer informação detalhada e 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 da resposta
item_id: identificação do item que está sendo consultado.
freeze: aviso de freezado de experiência pelo qual não gera ações sobre o item.
status: informação do estado da publicação. (active | paused | moderated).
title: motivo principal pelo qual o item está no estado atual.
subtitles: detalhes pelos quais o item está no estado atual.
actions: acionáveis possíveis para modificar a situação atual do item.
reputation: cor, detalhe e valor atual da reputação segundo a experiência de compra.
metrics_details: detalhe dos problemas, níveis, possíveis soluções, acionáveis e a distribuição para dar detalhes da reputação do item.
- Status -> paused
- Status -> active
Componentes da resposta
Text
{
"order": uint,
"text": string,
"placeholders": []string,
}Exemplo: asdasd {0} asdasd {1}. [0]
- Os {} deverão ser substituídos pelos placeholders.
- Os [] deverão ser substituídos pelos 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
}
]
}Possíveis erros
| Error_code | Mensagem de erro | Descrição |
|---|---|---|
| 400 | Bad Request | A solicitação é inválida ou não pode ser entendida pelo servidor. |
| 404 | Resource not found | O recurso não está funcionando ou a chamada foi mal realizada. |
| 500 | Internal Server Error | O servidor teve um erro inesperado e não pode completar a solicitação. |
Exemplos de casos de uso
- Item ativo com score 100 (sem problemas)
Exemplo:
{
"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": []
}
}
}- Item ativo com score 50
Exemplo:
{
"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
}
]
}
]
}
}
}- Itens inativos por experiência de compra
Exemplo:
{
"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
}
]
}
]
}
}
}- Item inativo por moderação, pode ser reativado
Exemplo:
{
"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
}
]
}
]
}
}
}- Pausado por experiência de compra
Cai a 30 o nível de experiência de compra.
Exemplo:
{
"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
}
]
}
]
}
}
}- Item inativado pelo vendedor
Exemplo:
{
"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": []
}
}
}- Item sem experiência de compra
Exemplo:
{
"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": []
}
}
}- Item freezado
Exemplo:
{
"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
}
]
}
]
}
}
}- Nível de experiência de compra 30 - Reativado
Exemplo:
{
"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
}
]
}
]
}
}
}Detalhe dos problemas
Distribuição com tooltip
Exemplo:
{
"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
}
]
}
}