CarrierAudit CLI
Local carrier invoice auditor — catch overcharges, file disputes, keep 100% of refunds.
🔍 What the tool flags
CRITICAL
Duplicate billing — same tracking number billed twice on one statement
CRITICAL
Unauthorized origin zip — labels from zips that don't match your warehouse
HIGH
DIM weight inflation — billed weight ≥1.5× actual weight
MEDIUM
Commercial misclassification — dock addresses billed at residential rates
🧪 Sample invoice results: 7 packages, $196.95 invoiced → $157.28 recoverable (79.86%). 9 flagged anomalies across all four categories.
📦 What's in the kit
📄 carrier_audit.py12.6 KB
📄 verify_kit.py4.5 KB
📄 README.md4.1 KB
📁 samples/sample_carrier_invoice.csv1.0 KB
📁 reports/dispute_report.md2.9 KB
📁 reports/carrier_dispute_bulk_upload.csv0.8 KB
▶️ Quick start
python3 carrier_audit.py samples/sample_carrier_invoice.csv \
--origins 90210 \
--out-dir reports/my-audit
✅ Two deliverables per run: a Markdown dispute dossier with numbered claim tickets (UPS + FedEx dispute codes, copy-paste ready) + a bulk-upload CSV formatted for carrier dispute portals.
📊 Sample findings from the test invoice
| Category | Count | Recoverable |
|---|
| Duplicate billing | 1 | $38.50 |
| Unauthorized origin zip | 1 | $26.00 |
| DIM weight +590% (2.1→14.5 lbs) | 2 | $45.88 |
| DIM weight +350% (4.0→18.0 lbs) | 1 | $25.90 |
| Commercial→residential | 4 | $21.00 |
🔒 Privacy
Everything runs locally. The tool reads only tracking number, invoice number, weights, charges, origin zip, and address type. No customer names, addresses, or item-level data. No data is sent anywhere.
🛠 Requirements
- Python 3.8+ (stdlib only — no pip installs)
- Carrier billing CSV export (UPS Billing Center or FedEx Billing Online)
- A terminal
No checkout. No payment. No SaaS. No revenue share.
This is a free local audit tool — the kit is the deliverable. Run it on your machine, file the disputes, keep 100% of refunds.