Reconcile parcel carrier invoices against purchased label amounts and identify systemic overcharges using the EasyPost Billing API and shipment cost data
Download carrier invoice files from each carrier's billing portal (FedEx Invoice Management, UPS Billing Center, USPS PostalOne) as CSV or EDI 210 files on a weekly basis
Query the EasyPost Shipments API for all shipments in the invoice period using the created_at date range filter; retrieve each shipment's rate object including published_rate and carrier_account_id fields
Match carrier invoice line items to EasyPost shipments by tracking number; for each matched pair, compare the invoice charge breakdown against the EasyPost rate: base service charge, fuel surcharge, residential delivery fee, and any correction charges
Flag records where the invoiced amount exceeds the EasyPost rated amount by more than a tolerance threshold; classify the discrepancy as a dimensional weight correction (carrier remeasured the package), address correction fee (carrier corrected an invalid address), or carrier-applied accessorial not present at rating time
For DIM weight corrections, retrieve the package dimensions from the original shipment's parcel object and recompute the billed weight using each carrier's published DIM factor; if your measured dimensions match the carrier's billed dimensions, accept the correction; if dimensions differ, prepare a dispute
Submit disputes for confirmed overcharges via each carrier's claims submission portal; track dispute ID, submitted date, and outcome; measure recovery rate monthly and adjust upstream DIM measurement accuracy thresholds if correction frequency exceeds 3%
Known gotchas
EasyPost shipment rate objects reflect the rate at time of label purchase using list or account rates; if your carrier contract rates changed during the invoice period, the EasyPost rate may not match the rate the carrier should have applied, causing false dispute flags
Carrier invoice files from FedEx and UPS contain invoice-level totals and line-item charges but do not always include the original tracking number format that matches EasyPost's stored tracking code; some invoices use internal reference numbers requiring a secondary lookup to match
Address correction surcharges appear on the invoice 1-3 days after the shipment's delivery date, not on the original shipping date; invoice files pulled immediately after the billing period closes will be missing correction charges that arrive in a subsequent invoice cycle
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp