Sellers reputation

A seller's reputation in Mercado Libre is his/her image in the platform to build trust when making transactions with buyers and sellers. To have leverage in the site, it is important to take care of it. Look at the time with which we measure the sellers reputation.

Request:

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

Example:

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

Response:

"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
                }
            }
        }
    },

Resource fields

• level_id: user reputation level described in thermometer numbering and color.
• power_seller_status: this field shows if the seller is Mercado Lider, and the name of medal received, whether Silver, Gold or Platinum.
• real_level: actual level of reputation of the seller, during the protection period (appears only when the seller is protected).
• protection_end_date: end date of protection (only when the seller is protected).
• transactions: number of sales made by user in certain period.

•   canceled: number of transactions cancelled.
•   completed: number of transactions completed.
•   period: period considered.
•   ratings: ratio of sales rated as negative, neutral or positive.
•   total: total transactions.

Quality metrics

• sales: the number of sales with mediations (claims and/or disputes) a seller has.
• period: the period for ratio calculation will depend on the number of sales fulfilled in the past 60 days.
• completed: number of sales completed. Whether an order has claims or not matters. So if an order has more than one claim / dispute, to avoid counting it, all the claims / disputes must be excluded from his/her reputation (tag avoid_reputation).

Period to evaluate, depending on country and number of sales:

México (MLM)

Brazil (MLB)

Argentina (MLA)

Colombia (MCO)

Chile (MLC)

Uruguay (MLU)

For the rest of the countries, the old reputation system is used. For more information, visit the following help links:
-Perú: Help link
-Uruguay: Help link
-Venezuela: Help link
-Ecuador: Help link
For the rest of the countries, go to Help > Selling > Qualifications, reputation and opinions > What is and how does the seller reputation work.

Exceptions:

Certain measurements are automatically ignored when specific rules are met. For exceptional cases, a process for order exception via contact with CX will be provided.

Claims

For calculation, sales with claims made by buyer regardless of payment or shipping method will be considered. That is, sales from disqualified users, fraudulent user sales, sales with payment rejected and invalid sales were not considered.

Formula:

claims_rate = sales with claims / total sales
To start impacting on reputation, at least, 3 sales with claims are needed.

Once the period to calculate number of sales made by seller is known, thermometer color will be determined by seller percentage.
Thermometer example in the same way as it will be viewed by seller in account:

Delayed Handling Time

Handling Time is the difference between the ready to ship time (ready_to_ship) and when it was actually collected by mail (shipped). Except for Cross Docking types of shipping, where Handling Time is the difference between the time a package is in the HUB (in_hub) and when it was actually collected by mail (shipped), delayed handling time is the sales percentage with late shipping.

• Sellers using Mercado Envíos with 10 or more sales shipped will be considered. This metric will not affect the rest, and we assume that 0% sales was delivered out of time.
• The time we take to measure this is the last 60 days in case the seller has more than 50 sales in MLA, 60 sales in MLB, 40 sales in MLC, 60 sales in MCO and 40 sales in MLM made in that period and they will be the last 365 if they do not reach this amount of sales in their countries.

Fórmula:
delayed handling time rate = late shipping sales / sales shipped with me2
Period considered: 60 or 365 days, depending on number of transactions in the past 60 days. To MLU we consider 120 or 365 days. When several orders for the same shipment are in the cart, late shipping will affect the seller as many times as orders in the package.

Cancellations

This metric shows the number of seller cancellations without any claim.
This is a known resource for Mercado Lideres that will now apply to all sellers.
Formula used for calculation:
Cancellations rate = seller cancellations / total sales.
Applicable to all sites where the new reputation system is effective: 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

Refund account money due to cancelled sales

Starting today, sales cancellations made by sellers whose payment was made by credit card or debit by good reputation buyers will be automatically refunded in cash to Mercado Pago account. Learn more about the flow of refund account money due to cancelled sales.