Match every carrier invoice to a shipment, recheck the line math and fuel surcharge against your schedule, and flag duplicates and accessorials nobody approved. Get approve, dispute and review lists plus the dollars you can claim back.
| Situation | Code | Level |
|---|---|---|
| Same carrier + PRO billed again | duplicate_pro | dispute |
| Same BOL billed on another invoice/carrier | duplicate_bol | dispute |
| Linehaul + fuel + accessorials != total | math_error | dispute |
| Linehaul over quote (default 2%) | linehaul_over_quote | dispute |
| Fuel over the carrier's weekly % of the quoted linehaul | fuel_over_rate | dispute |
| Accessorial not approved on the BOL | unapproved_accessorial | dispute |
| Billed weight over BOL by 10%+ (reweigh) | weight_over_bol | review |
| Billed class differs from BOL | class_changed | review |
| Invoice from a carrier the BOL wasn't tendered to | carrier_mismatch | review |
| BOL not in your shipment file | no_quote | review |
examples/cedar-supply-oct/ is a fictional distributor's October LTL: 8 BOLs with quotes, two carriers' weekly fuel schedules and 11 invoices with planted problems (a re-billed PRO, Ridgeway's shipment billed by Bluegrass, a 10.00 math error, a linehaul 30 over quote with fuel charged on the overage, an unapproved notify fee, a 13% reweigh, a reclass from 70 to 85, a BOL the TMS doesn't have). expected.json labels each invoice and the recoverable total (1,014.20); the tests assert that in any row order.
Outputs in out/: audit.csv (approve/review/dispute, recoverable, approved to pay), findings.csv, disputes/<carrier>.md (draft lists, not sent), report.md, summary.json. Exit 0 = all approve; 1 = something to review or dispute; 2 = an input problem.
./run_tests.sh
python3 -m freightaudit --invoices examples/cedar-supply-oct/carrier_invoices.csv --shipments examples/cedar-supply-oct/shipments.csv \
--fuel examples/cedar-supply-oct/fuel_schedule.csv --name "Cedar Supply" --out out/Python 3.9+ (tested on 3.10 and 3.13), no dependencies.
Zip, 16 KB, v1.0, 15 files. Use and modify it for yourself and for clients you serve; no resale or redistribution of the kit itself. Full terms in LICENSE.txt.
Audit carrier freight invoices against shipments and your fuel schedule: duplicates, math errors, wrong fuel surcharge, unapproved accessorials. $29 once.
Reconcile Stripe, Shopify Payments and PayPal payouts to bank deposits: fees, refunds, disputes, holds and a balanced journal entry. 3 kits, $49 ($77 separately).
View Payment Reconciliation Skills BundleCommercial property accounting on your own exports: rent roll checks (GPR, vacancy, loss-to-lease, delinquency) and year-end CAM reconciliation with gross-up and caps. $45 ($58 separately).
View Commercial Property Accounting Skills BundleFree robots.txt tester and validator: test URLs with Google's matching rules, catch typos and dropped * rules, check GPTBot/ClaudeBot access, diff before deploy.
View robots.txt Tester (Free)