Aeion Fulfillment + Shipping Carriers
Multi-carrier rate shopping, label purchase, and tracking run through Aeion's carrier-adapter registry. One real backend ships today — EasyPost, which fronts 100+ carriers (USPS, UPS, FedEx, DHL, and regional carriers) behind a single credential-gated API. Bring your own EasyPost key and the platform rate-shops every carrier at once, buys the cheapest label, and normalizes tracking. Without a key, every method is an honest no-op — never a fabricated rate or label.
What Connects
`
The Honesty Contract
Every carrier result carries a transmittedToProvider boolean and a machine-readable reason. When no real call reaches a provider, Aeion says so rather than inventing a rate, a label, or a tracking event.
Setup
Bring your own carrier account. Two environment values enable the full path:
Rate Shopping — End-to-End
`
Tracking — Normalized Status Model
Carrier-specific tracking statuses are mapped to one common model, so a branded tracking page or a notification rule reads the same shape regardless of carrier:
What This Does NOT Do (Yet)
Candid scope so you can plan around it:
FAQ
Any carrier EasyPost supports — USPS, UPS, FedEx, DHL, and 100+ regional carriers — once you connect your EasyPost account with `EASYPOST_API_KEY`. EasyPost is the single implemented adapter; it fans out to those carriers on your behalf.
No — and Aeion doesn't integrate them today anyway. The adapter seam is built to add them later, but EasyPost is the only carrier backend currently shipped.
The routes stay live but return an honest no-op — `configured: false` / `transmittedToProvider: false` with a `reason`. Aeion never fabricates a rate, a label, or a tracking event. Set `EASYPOST_API_KEY` and the same routes start returning real data.
It queries every configured provider in parallel, merges the rates, and sorts cheapest-first (ties broken by fastest estimated delivery, then carrier name). You can also buy against an explicit provider key, or select the fastest rate programmatically.
No. Label buys run under a distributed lock keyed on an idempotency key and move through explicit purchase states. A reconciliation cron reads the provider back to resolve any `outcome_unknown` dispatch, so you never pay twice or lose a label to a dropped response.
EasyPost webhooks are v2 HMAC-signed (`x-hmac-signature-v2`), verified against a per-tenant or env-configured secret, tenant-scoped by URL path plus `X-Tenant-Id` header, size-limited, and deduplicated. A `*_NEXT` secret supports zero-downtime rotation.
Multi-carrier shipping, honestly wired.
Bring your EasyPost key and rate-shop 100+ carriers, buy the cheapest label, and track it — with an honesty flag on every result so a no-op is never mistaken for a shipment.