Amazon SP-API Now Tracks On-Time Delivery at the Unit Level
Amazon SP-API now returns a new field `unitOnTimeDeliveryRate` in the GET_V2_SELLER_PERFORMANCE_REPORT for the US marketplace (code ATVPDKIKX0DER). The metric shows the percentage of shipped units delivered on time, e.g., 12,340 of 13,500 units = 91.4%. It replaces order‑level only tracking with unit‑level granularity.
Overview
Amazon’s Selling Partner API now includes a unitOnTimeDeliveryRate field in the Seller Performance Report. The metric moves delivery tracking from the order level to each individual unit, giving sellers a more precise view of fulfillment reliability. The change is live for the United States marketplace, and it matters because on‑time delivery remains a key component of Amazon’s account health score.
Key Points
- Unit‑level on‑time rate added — The
GET_V2_SELLER_PERFORMANCE_REPORTendpoint now returns a percentage calledunitOnTimeDeliveryRatethat reflects each shipped unit’s timeliness. - More realistic performance picture — In a five‑item order where four items arrive on schedule and one is late, the new metric records an 80 % on‑time rate instead of flagging the whole order as a miss.
- US‑only rollout — The field appears only in responses for the United States marketplace; no public timeline exists for Europe, Japan, or other regions.
- Backward compatible — Existing report responses keep all previous fields; developers only need to add parsing logic for the new attribute.
- Impact on multi‑item sellers — Merchants that frequently ship bundles or mixed‑SKU orders gain a clearer signal of which specific items are causing delays.
- Enables targeted operational fixes — The granularity helps identify problematic warehouses, carriers, or product categories without over‑hauling the entire fulfillment network.
How Unit‑On‑Time Delivery Rate Works
- Report request — When a seller calls
GET_V2_SELLER_PERFORMANCE_REPORTfor the US marketplace, the JSON payload now contains aunitOnTimeDeliveryRatekey alongside the traditionalorderOnTimeDeliveryRate. - Percentage calculation — Amazon divides the total number of units delivered on or before the promised delivery date by the total units shipped in the reporting period, then multiplies by 100. For example, if 12,340 out of 13,500 units arrived on time, the field returns .
Analysis & Recommendations
Why This Matters
Sellers gain a precise view of fulfillment reliability, allowing them to pinpoint late SKUs, carriers, or fulfillment centers. For multi‑item orders, a 5‑item order with one late item now shows 80% unit‑level on‑time rate instead of a 0% order‑level rate, reducing false health warnings.
Key Takeaways
- GET_V2_SELLER_PERFORMANCE_REPORT now includes `unitOnTimeDeliveryRate` alongside `orderOnTimeDeliveryRate`.
- The field reports a percentage calculated as (on‑time units ÷ total shipped units) × 100, e.g., 12,340/13,500 = 91.4.
- The metric is only returned for the US marketplace (ID ATVPDKIKX0DER); other regions do not receive it yet.
- Unit‑level tracking changes a 5‑item order with one late item from 0% order‑level to 80% unit‑level on‑time rate.
Recommended Actions
- →Update your API client to check for `unitOnTimeDeliveryRate` when marketplace = 'ATVPDKIKX0DER' (Seller Central > Reports > Performance).
- →Add a `unit_on_time_delivery_rate` column to your performance ETL jobs and historical tables.
- →Create a monitoring rule (e.g., in CloudWatch or Seller Central alerts) that triggers when the rate falls below 85%.
Comments
Join the discussion
Log in or create an account to share your thoughts on this update.
No comments yet. Be the first to share your thoughts!