Accessorial Charge Validator: Catch the Freight Fees You Never Authorized

The problem this kills

Carrier invoices are where margin quietly leaks out the door. A driver waited, so detention shows up. Someone "needed" a liftgate. A reattempt fee, a redelivery, a residential surcharge, a fuel-and-misc line nobody can explain — and most of these were never authorized on the shipment in the first place. But the invoice still has to get paid, the volume is enormous, and nobody has time to line up every accessorial against what was actually agreed.

So the fees get rubber-stamped. Multiply a few wrongly-billed accessorials across thousands of shipments and you're handing carriers real money for services you never asked for. Worse, accessorial codes are a mess — every carrier names and codes them differently, "DET" means one thing here and something else there, and proving a detention charge is wrong means matching it back to in/out timestamps you have to dig for. You don't need to be a developer to fix this. You need a tool that does the line-up for you and keeps a human in charge of the dispute.

What you'll build

A simple internal web tool. You import two things: your carrier invoices (the accessorial line items) and a record of the services that were actually authorized on each shipment (from your TMS, the rate confirmation, or a spreadsheet). The tool extracts every invoiced accessorial, maps each carrier's quirky codes to a standard set, and compares each one to the authorized list for that shipment. Anything billed but not authorized gets flagged for dispute — with the proof requirement attached (e.g. "detention needs in/out timestamps"). Your auditor opens a worklist, reviews each flagged charge, and clicks Accept (it was legit) or Dispute. Only on approval does the tool generate a dispute letter per carrier and add the recovered amount to a running savings log.

What's inside the Implementation Plan

The downloadable plan is a step-by-step file you paste into an AI coding agent. It opens by interviewing you about your business — which carriers you use and how their accessorial codes are named, where your invoices and your authorized-services records live, the exact columns in each, the proof each accessorial type requires, your typical and peak invoice volumes, and the messy edge cases — and then it tailors the code map, the validation rules, and every later step to your answers. This is not a generic template; the agent reflects a short spec back to you and waits for your thumbs-up before it builds anything. From there it walks the agent through importing invoices and authorizations, the per-carrier code mapping, the match-and-flag logic, the auditor review-and-approve worklist, the dispute-letter generation, and the savings log — each step with a ready-to-copy prompt. There's also a fallback so you can build the whole thing today even with no API to your TMS or carriers.

The governance it includes (this is the point)

This is real money moving against carriers, so it ships with the controls a freight-audit team needs: login so only your team can use it, row-level security so you only ever see your own organization's invoices, a complete audit trail of who flagged, reviewed, and approved which disputes and when, a hard human-approval gate so no dispute letter goes out until your auditor signs off, and duplicate guards keyed on invoice number + accessorial code so the same charge can't be processed or disputed twice. Every disputed charge carries its proof requirement, so you never fire off a detention claim without the timestamps to back it.

Who it's for

Freight-audit analysts, traffic and transportation managers, and anyone who owns carrier invoice approval and is tired of paying for accessorials nobody authorized. If you can describe how your shop decides a charge is legit, you can build this.

You've got this — start with the plan, paste the first prompt, answer the interview, and you'll see your first batch of unauthorized accessorials light up the same afternoon.