> For the complete documentation index, see [llms.txt](https://docs.partner.aboutyou.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.partner.aboutyou.com/how-to-boost-your-performance/merchant-performance-scorecard-mps.md).

# Merchant Performance Scorecard (MPS)

### 1. Understanding the Core Logic

The MPS is designed to measure Operational Reliability and Consistency. We prioritize these over simple averages to ensure a stable and trustworthy customer promise.

* KPI 1: On-Time Shipping Rate: The percentage of items shipped on or before the "Target Date."
* KPI 2: Order Completion Rate: The percentage of items successfully fulfilled. This is the inverse of the merchant-led cancellation rate (Stock-outs).
* Note: Customer-requested cancellations are excluded from this calculation.

#### Determining the Current Score:

Your overall performance is defined by your "weakest link." Your daily tier is determined by whichever KPI is currently performing at the lower level. For example, if your On-Time Shipping Rate is "Elite" but your Order Completion Rate is "Poor," your overall status will be Poor.

### 2. Navigating the Dashboard UI

#### **The Performance Meter**

The central meter displays your current standing across our four tiers.

<br>

<figure><img src="/files/DDlKNoaeS7AfF6K4gVVx" alt=""><figcaption></figcaption></figure>

You can hover over the different tier segments to see the exact requirements for each:

<br>

| Tier         | Status         | On-Time Shipping Rate | Order Completion Rate |
| ------------ | -------------- | --------------------- | --------------------- |
| Elite        | 🟢 Dark Green  | ≥ 98.0%               | ≥ 99.5%               |
| Standard     | 🟢 Light Green | ≥ 95.0%               | ≥ 99.0%               |
| Concerning   | 🟡 Yellow      | ≥ 90.0%               | < 99.0%               |
| Critical     | 🔴 Red         | < 90%                 | <= 98.5%              |
| Insufficient | ⚪ Grey         | < 30 Orders           | < 30 Orders           |

#### **Score Prediction & Leveling**

\
Your dashboard shows a Predicted Rating for your next evaluation cycle:

<figure><img src="/files/TPV8PXj0OVkAFHHeYSLf" alt=""><figcaption></figcaption></figure>

* This simulates what your score would be if the 28-day cycle ended today.
* The UI indicates if you are currently "Leveling Up" or at risk of a downgrade based on your current performance trend.

#### **Deep Dive: Daily Rolling Averages**

By clicking on the Score Prediction, you can access a detailed view of your metrics.

<figure><img src="/files/RS0o7hz1Fmr309PxXLDB" alt=""><figcaption></figcaption></figure>

This includes:

* **On-Time Shipping Rate**: Your rolling average for dispatch punctuality.
* **Order Completion Rate**: Your rolling average for successfully fulfilled orders (non-cancelled items).

### **3. How is your On-Time Shipping Rate calculated?**

We calculate your target dispatch date fairly, accounting for business hours and data latency.

* **Lead Time**: 2 Business Days.
* **Cut-off Time**: 15:00 (3 PM) local merchant time. Orders placed after this time start their "Day 1" the following business day.
* **Business Days**: Monday - Saturday. Sundays and Public Holidays are excluded.
* **Anchor Date**: We use an "Effective Anchor Date" to allow for a data latency buffer (waiting for dispatch signals and late cancellation confirmations).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.partner.aboutyou.com/how-to-boost-your-performance/merchant-performance-scorecard-mps.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
