Warehouse Fulfillment Score: methodology
The Fulfillment Score is computed automatically from system events only; rules, weights and thresholds are public. Neither warehouses nor platform staff can edit a score.
Current version: v2 · Published (UTC) 2026-11-11
Data sources
- On-time shipping is measured with the carrier's first scan (from the tracking provider), not with a ship time entered by the warehouse.
- The ship-by deadline is recorded by the system: snapshotted when an order is confirmed in this WMS, or uploaded (CSV) / pushed (API) with the tracking number by warehouses that use another WMS (e.g. Lingxing, ECCANG).
- Warehouses that do not use this WMS can join: they only send tracking number, carrier and the order's ship-by deadline.
- Only carrier scans obtained through the platform tracking account count. Scans from the warehouse's own tracking account, test keys, typed tracking numbers without a label and numbers scanned before they were recorded are not platform-tracked and not scored (their number is public).
- A deadline cannot be changed after the carrier's first scan. The first recorded deadline is always kept and the score always uses the earliest of the original and the corrected deadline. A deadline can only be moved later within 2 hours of the first upload while the original is still at least 12 hours away; corrections are counted publicly.
- Deadlines that only come from the warehouse's own scheduled date are not counted in the on-time rate.
- A deadline recorded after the first scan is retroactive and not counted; orders with a hand-over record but no carrier scan are not counted in the on-time rate.
- Tracking numbers also used at another warehouse (for the warehouse that recorded them later), or flagged by the carrier as postage due / suspicious, are not counted as platform-tracked and not scored.
- Parcels that cannot be tracked (e.g. tracker registration failed) are not counted in the lost rate.
Components, weights and minimum samples
| Component | Weight | Min. samples | How it is measured |
|---|---|---|---|
| On-time ship rate | 50 | 50 | Share of orders whose first carrier scan happened before the ship-by deadline. The deadline must have been recorded before the scan; hand-over-only orders without a carrier scan are not counted. |
| Lost / never scanned | 20 | 50 | Share of tracked parcels with no carrier scan, or no new scan, for the lost-parcel period after their deadline / last scan (delivered and returned parcels excluded). |
| Delivery exceptions | 10 | 50 | Share of scanned parcels for which the carrier reported an exception. |
| Return processing time | 10 | 20 | Share of received returns inspected within the time limit (only when the returns module is used). |
| Photo evidence coverage | 10 | 50 | Share of shipped WMS orders with packing or hand-over photos (only when the evidence module is used). |
| Inventory accuracyNot yet available | 0 | 50 | Cycle-count accuracy. Not yet available: counts without a difference are not recorded reliably yet, so this component is shown but never scored. |
Formula
- On-time, return processing and photo evidence: component score = good samples ÷ samples × 100.
- Lost: component score = 100 − 10.0 × lost rate (%), minimum 0; delivery exceptions: 100 − 5.0 × exception rate (%), minimum 0.
- Lost / never scanned: no carrier scan 7 days after the deadline (or the last scan) and neither delivered nor returned.
- Return processing: inspected within 48 hours of receipt.
- Overall score = weighted mean of the components that have enough samples (weights renormalized among them), one decimal.
- While the on-time component is below its minimum sample size, no overall score is shown: "Building history". Other components below their minimum are left out.
- Rolling window of the last 90 days, recomputed every night.
Commitments
- The score cannot be bought: paid plans, subscriptions or any paid service never affect it, and no plan data is read by the computation.
- Publishing a score requires the warehouse's own consent (by the warehouse owner); it can be withdrawn at any time and the score is removed from public pages immediately. Platform administrators cannot publish on a warehouse's behalf.
- Any change to the algorithm is published as a new version, older versions stay visible, and every score records the version it was computed with.
Appeals process
- A warehouse can appeal specific shipments, e.g. a missed or wrong carrier scan or a wrong tracking number, with evidence (pickup receipt, photos, emails...).
- A platform administrator decides and writes the reason. Nobody decides their own appeal.
- An accepted appeal excludes the shipment from scoring with the recorded reason; the public profile shows the number of accepted appeals.
- Appeals and decisions are kept in an append-only log.
Who gets which score
- Public score: computed only from carrier scans of the platform tracking account. For every warehouse listed in the directory or with a public score, the platform tracks a random sample of up to 300 shipments per month at its own cost; the warehouse does not know in advance which shipments are sampled. Other shipments are not counted.
- Listed warehouses may keep their score private. The directory then shows "Not public" and lists them after the warehouses with a public score; their sampled history keeps building, so the score can be published later.
- Private preview: every warehouse using the software sees a preview computed from its own carrier tracking, including its own tracking account. It has a lower trust level, is visible to that warehouse only, is never published and is never used for the public score or the directory order.
- Private sharing: a warehouse can let one named seller see its score through a personal link that expires, can be revoked at any time, and whose every view is logged.
Version history
| Algorithm version | Published (UTC) | Window | Changes |
|---|---|---|---|
| v2 | 2026-11-11 | 90 days | Same components, weights and thresholds as v1. Data: for every warehouse listed in the directory or with a public score, the platform tracks a random sample of up to 300 shipments per month (configurable) with its own tracking account; only these sampled scans count, and the warehouse does not know in advance which shipments are sampled. Listed warehouses may keep their score private (the directory lists them after the warehouses with a public score). Warehouses using only the software get a private preview from their own carrier tracking: lower trust, visible to them only, never public. A warehouse can share its score with one named seller through an expiring, revocable, logged link. |
| v1 | 2026-11-10 | 90 days | First published version: on-time ship rate by carrier first scan (main component), lost / never scanned, delivery exceptions, return processing time and photo evidence coverage. Inventory accuracy is listed but not yet scored. |
Calculated automatically from the carrier tracking data visible to the platform. It reflects shipping performance only and is not an assessment of the warehouse's creditworthiness, financial condition or legal compliance.