> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vortexiq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# USPS audit profile, Vortex IQ

> What the Vortex IQ USPS health audit checks: USPS: Priority Mail OTD, Zone Performance & SCAN-Form Integrity

**[Nerve Centre KPIs](/nerve-centre/kpi-cards/usps) · [Audit Profile](/nerve-centre/kpi-cards/usps/audit) · [Sentiment Settings](/nerve-centre/kpi-cards/usps/sentiment)**

USPS is the cheapest US domestic carrier - almost every US merchant has a USPS integration as a fallback for First-Class Package, Priority Mail, Media Mail, etc. CloudHub probe shows 1 active merchant with stub-date (1901-06-08), suggesting the integration was created but never refreshed. Findings either lose a customer (Priority Mail OTD breach, SCAN-form gap = invisible parcel) or signal rate fraud (Service-Type-Code mismatch).

## What this audit checks

### Authentication & access

* USPS UserID + Password still authenticate (no 'Authorization Failure')
* CRID + MID values map to active business records
* Production base URL reachable (CloudHub stub references staging)

### Service-day promises

* Priority Mail OTD \< 92% rolling 30D
* Priority Express overnight OTD \< 95%
* First-Class Package multi-day OTD \< 88%
* Ground Advantage multi-day OTD \< 85%

### ZIP zone performance

* Any ZIP zone OTD \< 85% (regional weakness)
* Alaska / Hawaii / US territories transit > 7 days
* Rural-zone (Zone 8+) OTD \< 80%

### SCAN-form & label integrity

* SCAN-form gap > 2% (label printed but no acceptance event)
* Service-Type-Code mismatch > 0.5% (label paid Priority but mailed First Class)
* Tracking-number reuse rate > 0.1%
* Address-correction surcharge rate > 1% (data-quality signal)

### Insurance, claims & cost

* Lost-parcel rate > 0.5% on insured shipments
* Insurance-claim resolution time > 60 days median
* Damaged-parcel claim rate > 0.5%
* Avg cost / shipment up >10% vs prior period (USPS rate adjustment signal)
* Claim value as % of USPS revenue > 1% rolling 90D

### Cross-channel: revenue at risk (the kill-shot area)

* Cross-channel: late shipments joined to commerce\_sibling orders -> revenue at risk per channel
* Cross-channel: SCAN-form gaps correlated with order\_ref - which channels have the most invisible parcels
* Cross-channel: open claims with no Jira tracker\_item -> CS coverage gap
* Cross-channel: Priority Mail upsell ROI vs First-Class (when used as alternatives on same order\_ref)

## Severity thresholds

| Signal                               | Warn | Critical |
| ------------------------------------ | ---- | -------- |
| `on_time_delivery_rate`              | 92   | 88       |
| `priority_mail_sla_pct`              | 92   | 88       |
| `priority_express_sla_pct`           | 95   | 92       |
| `first_class_sla_pct`                | 88   | 85       |
| `ground_advantage_sla_pct`           | 85   | 80       |
| `zip_zone_otd_pct`                   | 88   | 85       |
| `scan_form_gap_pct`                  | 1    | 2        |
| `service_type_mismatch_pct`          | 0.3  | 0.5      |
| `exception_rate`                     | 2    | 3        |
| `open_claims_age_days`               | 30   | 60       |
| `lost_parcel_pct`                    | 0.3  | 0.5      |
| `damaged_parcel_pct`                 | 0.3  | 0.5      |
| `shipping_cost_per_order_change_pct` | 5    | 10       |
| `claim_value_pct_of_revenue`         | 0.5  | 1        |
| `auth_token_failures_24h`            | 1    | 5        |

## Data sources

* `GET TBD - pending CloudHub C# backend URL extraction (USPS Web Tools XML API)` - Auth probe + tracking lookup
* `GET TBD - pending CloudHub C# backend URL extraction` - Shipment list + status
