Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 01/02/2024

Experiência de compra

Importante:
Experiência de compra está disponível na Argentina, Brasil, Uruguai, México, Colômbia e Chile.

Reputação por item é um algoritmo que aplica regras novas para posicionar cada item conforme o seu rendimento, com base em distintos indicadores de atenção ao cliente. A iniciativa busca ajudar o vendedor a detectar problemas em seus itens para melhorar a qualidade de sua atenção com base em suas reclamações e cancelamentos.

O impacto será no front do Mercado Livre, alterando as vistas das listas de publicações, métricas, editor massivo online (EMON) e modificações individuais, cada uma com um com experiências visuais diferentes.
O objetivo desta documentação é oferecer uma origem única, devolvendo os conteúdos de experiência de compra em um contrato específico para integradores. Desta maneira facilitando a manutenção dos textos e otimizando a qualidade do serviço.

Nota:
Será incluída na experiência já conhecida do recurso /health , a nova experiência de compras que conta com distintos níveis e soluções.
Permite mostrar aos vendedores a experiência de compra que oferecem em suas publicações, a fim de entender como o item está performando com relação às reclamações e cancelamentos gerados. Desta forma, pode identificar o tipo de problema que está gerando, como fazer para melhorar esta situação e quais são as consequências de sua performance.

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/integrators

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/reputation/items/MLA1391786841/purchase_experience/integrators?locale=es_AR

Resposta:

{
    "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

Campos e 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": [
        "",
        ""
    ]
}

Freeze

A primeira parte do wording de freeze muda conforme o tipo de freeze aplicado.


  • Req_commercial
   "freeze": {
    "text": "Debido a un Acuerdo comercial, {0}esta publicación no perderá exposición, ni será pausada o anulada por tener experiencia de compra mala o media.{1} Ten en cuenta que es importante solucionar los problemas para mejorar la experiencia que brindas.",
    "placeholders": [
        "",
        ""
    ]
},
  • Internal_recovery_grntee
  "freeze": {
    "text": "Debido al Beneficio de reputación, {0}esta publicación no perderá exposición, ni será pausada o anulada por tener experiencia de compra mala o media.{1} Ten en cuenta que es importante solucionar los problemas para mejorar la experiencia que brindas.",
    "placeholders": [
        "",
        ""
    ]
},
  • Internal_recovery
    "freeze": {
    "text": "Debido al Beneficio Verde claro, {0}esta publicación no perderá exposición, ni será pausada o anulada por tener experiencia de compra mala o media.{1} Ten en cuenta que es importante solucionar los problemas para mejorar la experiencia que brindas.",
    "placeholders": [
        "",
        ""
    ]
},
  • Internal_newbie_grntee
 "freeze": {
    "text": "Debido al Beneficio de reputación, {0}esta publicación no perderá exposición, ni será pausada o anulada por tener experiencia de compra mala o media.{1} Ten en cuenta que es importante solucionar los problemas para mejorar la experiencia que brindas.",
    "placeholders": [
        "",
        ""
    ]
},
  • Resto de freezados

Os demais tipos de freezados são: grace_time, internal_reputation, req_legal, frozen..

   "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": [
        "",
        ""
    ]
},

Status

{
    "id": enum (active | paused | moderated),
    "assigned_by": enum (reputation | other),
    "text": string
}

Subtitle

Foi adicionada uma alteração para obter a quantidade de vendas de um item nos últimos 180 dias e mostrá-lo nos fronts.

Nota:
Esta mudança é gradual portanto deveriam poder reconhecer a resposta atual (sem placeholders) e a resposta nova (com placeholders).
Considere os exemplos de itens com score 100 (com ou sem problemas).

Resposta atual

"subtitles": [
    {
        "order": 0,
        "text": "Tienes 9 problemas 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 anularla."
    }
],

Resposta nova

"subtitles": [
    {
        "order": 0,
        "text": "En los últimos 180 días hiciste {0}12 ventas{1} y tuviste {0}9 problemas.{1} Revisa los consejos sobre cómo mejorar.",
        "placeholders": [
            "",
            ""
        ]
    },
    {
        "order": 1,
        "text": "La experiencia que brinda tu publicación afecta tu exposición y podríamos anularla."
    }
],

Action

{
    "order": uint,
    "text": string,
 }

Conforme as condições que o item apresente, os acionáveis possíveis serão os seguintes.


Itens ativos

  • Se o item tem score 100 e não tem problemas: Ver publicação.
  • Se o item tem escore 100 com problemas ou score menor (excluindo score -1, que é quando o item não tem vendas): Modificar publicação e Pausar pelo listado.

Itens pausados

  • Pausado pelo vendedor: Modificar publicação e Ver publicação.
  • Pausado por Experiência de Compra: Modificar publicação e Reativar pelo listado.

Item anulado

  • Anulado por experiência de compra: Como oferecer uma boa experiência.
  • Anulado por outra moderação: Ver publicação.

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)
Importante:
Não devolvemos o detalhe mas devolvemos em central_tag: Continue assim! Não há vendas com problemas nos últimos 180 dias.
Foi adicionada uma melhora onde permite reconhecer a quantidade de vendas de um item nos últimos 180 dias para poder mostrá-lo, isto nos permite mostrar com mais precisão.

Exemplo item tradicional (sem problemas):

{
    "item_id": "MLA1391786841",
    "freeze": {
        "text": ""
    },
    "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": []
        }
    }
 }

Exemplo de resposta de item tradicional com Score 100 (com problemas):

{
     "item_id": "MLA1391786841",
     "freeze": {
         "text": ""
     },
     "title": {
         "text": "Experiencia de compra"
     },
     "subtitles": [
         {
             "order": 0,
             "text": "En los últimos 180 días hiciste {0}12 ventas{1} y tuviste {0}9 problemas.{1}",
             "placeholders": [
                 "",
                 ""
             ]
         },
         {
             "order": 1,
             "text": "Estás brindando una buena experiencia de compra, pero si continúas con problemas, podría impactar tu exposición."
         }
     ],
     "actions": [
         {
             "order": 0,
             "text": "Modificar publicación"
         },
         {
             "order": 1,
             "text": "Pausar desde el listado"
         }
     ],
     "reputation": {
         "color": "green",
         "text": "Buena",
         "value": 100
     },
     "status": {
         "id": "active"
     },
     "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": {
                         "order": 0,
                         "text": "Dificultades para preparar el pedido"
                     }
                 },
                 "level_three": {
                     "key": "PRODUCT_NOT_PREPARED",
                     "title": {
                         "order": 0,
                         "text": "El producto no terminó de prepararse"
                     },
                     "remedy": {
                         "order": 0,
                         "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,
                 "tag": "",
                 "level_two": {
                     "key": "PACK_OFF",
                     "title": {
                         "order": 0,
                         "text": "Dificultades para preparar el pedido"
                     }
                 },
                 "level_three": {
                     "key": "LABEL_PRINTING_PROBLEMS",
                     "title": {
                         "order": 0,
                         "text": "Dificultades para imprimir la etiqueta"
                     },
                     "remedy": {
                         "order": 0,
                         "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,
                 "tag": "",
                 "level_two": {
                     "key": "PACK_OFF",
                     "title": {
                         "order": 0,
                         "text": "Dificultades para preparar el pedido"
                     }
                 },
                 "level_three": {
                     "key": "WITHOUT_STOCK",
                     "title": {
                         "order": 0,
                         "text": "No tenías stock disponible"
                     },
                     "remedy": {
                         "order": 0,
                         "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,
                 "tag": "",
                 "level_two": {
                     "key": "PACK_OFF",
                     "title": {
                         "order": 0,
                         "text": "Dificultades para preparar el pedido"
                     }
                 },
                 "level_three": {
                     "key": "STOP_DUE_HOLIDAY",
                     "title": {
                         "order": 0,
                         "text": "No estabas operando o parecías inactivo"
                     },
                     "remedy": {
                         "order": 0,
                         "text": "Si por algún motivo, no estarás disponible te sugerimos pausar tus publicaciones."
                     }
                 }
             }
         ],
         "distribution": {
             "from": "2023-04-13T20:08:26Z",
             "to": "2023-10-10T20:08:26Z",
             "level_one": [
                 {
                     "key": "OPERATION",
                     "title": {
                         "order": 0,
                         "text": "Al gestionar o preparar la venta"
                     },
                     "color": "#EC79BC",
                     "percentage": 100.0,
                     "quantities_level_two": [
                         {
                             "key": "PACK_OFF",
                             "title": {
                                 "order": 0,
                                 "text": "Dificultades para preparar el pedido"
                             },
                             "quantity": 9
                         }
                     ]
                 }
             ]
         }
     }
  }

Exemplo de resposta para item de catálogo (sem problemas):

{
    "item_id": "MLA1391786841",
    "freeze": {
        "text": ""
    },
    "title": {
        "text": "Experiencia de compra"
    },
    "subtitles": [
        {
            "order": 0,
            "text": "No tuviste problemas con este producto."
        },
        {
            "order": 1,
            "text": "Brindar buena experiencia te ayuda a competir en catálogo."
        }
    ],
    "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": []
        }
    }
 }

Exemplo de resposta de item de catálogo (com problemas):

{
    "item_id": "MLA1391786841",
    "freeze": {
        "text": ""
    },
    "title": {
        "text": "Experiencia de compra"
    },
    "subtitles": [
        {
            "order": 0,
            "text": "En los últimos 180 días hiciste {0}12 ventas{1} y tuviste {0}9 problemas.{1}",
            "placeholders": [
                "",
                ""
            ]
        },
        {
            "order": 1,
            "text": "Estás brindando una buena experiencia de compra, pero si continúas con problemas, podría afectarte en la competencia en catálogo."
        }
    ],
    "actions": [
        {
            "order": 0,
            "text": "Modificar publicación"
        },
        {
            "order": 1,
            "text": "Pausar desde el listado"
        }
    ],
    "reputation": {
        "color": "green",
        "text": "Buena",
        "value": 100
    },
    "status": {
        "id": "active"
    },
    "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": {
                        "order": 0,
                        "text": "Dificultades para preparar el pedido"
                    }
                },
                "level_three": {
                    "key": "PRODUCT_NOT_PREPARED",
                    "title": {
                        "order": 0,
                        "text": "El producto no terminó de prepararse"
                    },
                    "remedy": {
                        "order": 0,
                        "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,
                "tag": "",
                "level_two": {
                    "key": "PACK_OFF",
                    "title": {
                        "order": 0,
                        "text": "Dificultades para preparar el pedido"
                    }
                },
                "level_three": {
                    "key": "LABEL_PRINTING_PROBLEMS",
                    "title": {
                        "order": 0,
                        "text": "Dificultades para imprimir la etiqueta"
                    },
                    "remedy": {
                        "order": 0,
                        "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,
                "tag": "",
                "level_two": {
                    "key": "PACK_OFF",
                    "title": {
                        "order": 0,
                        "text": "Dificultades para preparar el pedido"
                    }
                },
                "level_three": {
                    "key": "WITHOUT_STOCK",
                    "title": {
                        "order": 0,
                        "text": "No tenías stock disponible"
                    },
                    "remedy": {
                        "order": 0,
                        "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,
                "tag": "",
                "level_two": {
                    "key": "PACK_OFF",
                    "title": {
                        "order": 0,
                        "text": "Dificultades para preparar el pedido"
                    }
                },
                "level_three": {
                    "key": "STOP_DUE_HOLIDAY",
                    "title": {
                        "order": 0,
                        "text": "No estabas operando o parecías inactivo"
                    },
                    "remedy": {
                        "order": 0,
                        "text": "Si por algún motivo, no estarás disponible te sugerimos pausar tus publicaciones."
                    }
                }
            }
        ],
        "distribution": {
            "from": "2023-04-13T20:08:26Z",
            "to": "2023-10-10T20:08:26Z",
            "level_one": [
                {
                    "key": "OPERATION",
                    "title": {
                        "order": 0,
                        "text": "Al gestionar o preparar la venta"
                    },
                    "color": "#EC79BC",
                    "percentage": 100.0,
                    "quantities_level_two": [
                        {
                            "key": "PACK_OFF",
                            "title": {
                                "order": 0,
                                "text": "Dificultades para preparar el pedido"
                            },
                            "quantity": 9
                        }
                    ]
                }
            ]
        }
    }
 }


  • 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

Importante:
Não devolvemos o detalhe mas devolvemos em empty_state_title: Não há vendas com problemas nos últimos 180 dias.

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
            }
        ]
    }
}