Reputación de vendedores

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/128885

Respuesta:

"seller_reputation": {
        "level_id": "5_green",
        "power_seller_status": "platinum",
        "real_level": "red",
        "protection_end_date": "2019-12-27T00:00:00.000-04:00",
        "transactions": {
            "canceled": 981,
            "completed": 6211,
            "period": "historic",
            "ratings": {
                "negative": 0.04,
                "neutral": 0.08,
                "positive": 0.88
            },
            "total": 7192
        },
        "metrics": {
            "sales": {
                "period": "60 days",
                "completed": 244
            },
            "claims": {
                "period": "60 days",
                "rate": 0,
                "value": 0,
                "excluded": { 
                    "real_value": 24, 
                    "real_rate": 0.0912 
                }
            },
            "delayed_handling_time": {
                "period": "60 days",
                "rate": 0,
                "value": 0,
                "excluded": { 
                    "real_value": 47, 
                    "real_rate": 0.723 
                }
            },
            "cancellations": {
                "period": "60 days",
                "rate": 0,
                "value": 0,
                "excluded": { 
                    "real_value": 6, 
                    "real_rate": 0.0228 
                }
            }
        }
    },

Campos de la respuesta

• level_id: nivel de reputación del usuario, descrita en numeración y color del termometro.
• power_seller_status: este campo indica si el vendedor es Mercado Lider, y el nombre de la medalla recibida, puede ser Silver, Gold o Platinum.
• real_level: nivel real de reputación del vendedor, durante el período de protección (aparece solo cuando el vendedor está protegido).
• protection_end_date: fecha de fin de la protección (solo cuando el vendedor está protegido).
• transactions: cantidad de ventas realizadas por el usuario en un determinado periodo.
•   canceled: cantidad de operaciones canceladas.
•   completed: cantidad de transacciones completadas.
•   period: período tenido en cuenta.
•   ratings: ratio de ventas calificadas en negativas, neutras, o positivas.
•   total: total de transacciones.

Métricas de calidad

• sales: la cantidad de ventas que tiene el vendedor.
• period: el período considerado para calcular el ratio dependerá de la cantidad de ventas concretadas que haya realizado en los últimos 60 días.
• completed: cantidad de ventas completadas. Se cuenta si la orden tiene o no reclamos, por lo que si una orden posee más de un reclamo / disputa, para que la misma no sea contabilizada todos los reclamos / disputas deben ser excluidos de la reputación (tag avoid_reputation).

Dependiendo del país y la cantidad de ventas es el período a evaluar:

México (MLM)

Brasil (MLB)

Argentina (MLA)

Colombia (MCO)

Chile (MLC)

Uruguay (MLU)

Para el resto de los países el sistema de reputación es el antiguo, para conocer más información al respecto accede a los siguientes links de ayuda:

- Perú

- Venezuela

- Ecuador

Excepciones:

Ciertas mediaciones son automáticamente ignoradas cuando cumplen reglas específicas. Para casos excepcionales un proceso se aplicará un proceso vía contacto con CX.

Reclamos (Claims)

Para realizar el cálculo se tendrá  en cuenta las ventas con reclamos iniciados por el comprador sin distinguir la modalidad de envío o pago. Es decir, no consideramos ventas de usuarios que fueron inhabilitados, ventas de usuarios fraudulentos, ventas con pagos rechazados ni ventas inválidas.

Fórmula

claims_rate = ventas con reclamos / ventas totales
Se necesita un mínimo de 3 ventas con reclamos para que empiece a afectar en la reputación. 

Una vez sabido el período que se tomará para calcular la cantidad de ventas que realizó el vendedor, se determinará el color del termómetro según el porcentaje que tenga el vendedor.
Ejemplo de termómetro de la misma forma que lo visualizará el vendedor en la cuenta:

Tiempo de entrega con retraso (Handling Time)

El Handling Time es la diferencia entre el momento que está listo para enviar (ready_to_ship) y cuando realmente el correo indica que lo colectó (shipped). Excepto para tipos de envíos Cross Docking, donde el Handling Time es la diferencia entre el momento en el que el paquete está en el HUB (in_hub) y cuando realmente el correo indica que lo colectó (shipped) El delayed handling time es el porcentaje de ventas con envíos tardíos.

• Solo contemplaremos aquellos vendedores que utilicen Mercado Envíos y tengan 10 o más ventas enviadas. El resto no se verá afectado por esta métrica y asumimos que sus ventas entregadas fuera de término es de 0%.
• El tiempo que tomamos para medir esto son los últimos 60 días en caso de que el vendedor tenga más de 50 ventas en MLA, 60 ventas en MLB, 40 ventas en MLC, 60 ventas en MCO y 40 ventas en MLM realizadas en ese período y serán los últimos 365 si no llegan a esta cantidad de ventas en sus países. 

Fórmula: delayed handling time rate = ventas con despacho tardío / ventas despachadas con me2

Período considerado: 60 o 365 dias, dependiendo la cantidad de transacciones en los últimos 60 días. Para MLU consideramos 120 o 365 días.
Para el caso en el que el carrito tenga varios pedidos con el mismo envío, si se despacha tarde, afecta tantas veces al vendedor como pedidos tenga el paquete.

• Los niveles del termómetro para esta variable para los sites MLM, MLB, MLA, MCO, MLC y MLU son:

También puedes utilizar el recurso /schedule para obtener los horarios de despacho y evitar retrasos.

Cancelaciones (Cancellations)

Esta métrica nos muestra la cantidad de cancelaciones que hace el vendedor en donde no hay un reclamo de por medio.
Es un recurso conocido por los Mercado Lideres, que ahora va a aplicar para todos los vendedores.
La fórmula que se utiliza para calcularla:
Cancellations rate = cancelaciones que hace el vendedor / ventas totales
Aplica a todos los sites donde está vigente el nuevo sistema de reputación: MLA, MLB, MLM, MCO, MLC.

Límites para cada variable

Modificamos los límites para cada variable en todos los colores, niveles y sites. Los nuevos límites son los siguientes:

MLB

MLA

MLM

MCO

MLU

MLC