AUTO BILLING · AN AGENT ON TALONIC
It decides on a live freight pipeline. A person still sends the invoice.
A freight bill is three documents that have to agree: the bill of lading, the carrier invoice, the rate confirmation. A biller finds them, matches them to one load, checks the rate, sends it. The rules that release a load were never written down. They lived in the billing team’s heads. Auto Billing is those rules, said out loud, written down, and run beside the people who said them.
- STAGE
- business rules, after matching
- READS
- the paperwork and a read only snapshot of your open loads
- WRITES
- one verdict per load, and every outcome to the run history
- WHO DECIDES
- your billers, doing the job exactly as before
- STATUS
- shadow run, beside the live process
DECIDEAuto Billing · produces a verdict
The rules a billing team only ever said out loud now decide, in writing, whether three freight documents agree.
SHADOW RUN · DECIDES BESIDE THE BILLER
THE AGENT BAND
SCOPE
2
granted things. The documents this pipeline reads and a read only snapshot of the transport system’s load table.
RULES
YOURS
each one carrying the sentence as your operator said it. Four rules decide on every load.
ARTIFACT
VERDICT
one per load, not per document. Could this have been billed without a person, and if not, which rule stopped it.
REVIEW
EVERY
load still goes to a biller. The verdict sits beside the load and changes nothing about where it goes.
LEDGER
WHAT THE BILLER CHANGED
an audit table records every field a biller changes. A load left untouched is a load the agent could have billed. That is a measurement, not an opinion.
STATUS
SHADOW RUN
on a live freight pipeline, beside the billers.
Six cells, six units. Nothing here divides into anything else.
01 / the scope
It reads the paperwork and a snapshot of the loads.
Auto Billing is granted the documents the pipeline reads and a read only snapshot of open loads from your transport system, refreshed on a schedule. That is its whole world, and every sentence on this page about safety is downstream of that one fact.
By the time the agent sees anything, the work has happened. The paperwork is read, the fields extracted, each document matched to a load. The agent judges the assembled load with the transport system’s own row beside it, so every rule reads the matched value rather than the raw column.
Capture
Structure
Matching
Business Rules
the agent runs here
Review
Delivery
The pipeline’s six stages, with the agent’s position marked. It reads after Matching, so what it judges is an assembled load rather than a document.
02 / the rules
The rules are yours, sentence for sentence.
Sit with the operator for an afternoon and have them say the rules out loud. The carrier rate matches to the penny or it is not a match. Weight always comes from the bill of lading. All three document types have to be matched to the same load before anything is decided. Two candidate load numbers in one batch is never automated. A reference that does not match is not a failure, because agents copy them and omit them.
Each rule goes on the specification as a card carrying the sentence as it was said. Four of them decide on every load, and the sentence stays on the card beside the check that runs.
A document that never carried a signature field is not an unsigned document. Treat those as the same thing and the project loses trust in its first week. It holds loads that were fine and clears loads that were not. So the outcome set has a third value, and it is never folded into the other two.
| the sentence | grain | effect |
|---|---|---|
| the carrier rate matches to the penny or it does not match | per load | FAILS THE LOAD |
| all three document types are matched to the same load before anything is decided | per load | HOLDS FOR REVIEW |
| two candidate load numbers in one batch is never automated | per load | HOLDS FOR REVIEW |
| a bill of lading signed by the consignee | per document | FLAGS VALUES |
4 run, each with the sentence still on it
An example set from a freight brokerage, paraphrased. Yours will differ. The badges and grains are the product’s own.
03 / the artifact
One verdict per load. Not one per document.
Three documents arrive at different times from different senders. None is the answer on its own. The artifact is the load: one row, one verdict, and when the verdict is no, the name of the thing that blocked it. A biller does not work a document. They work a load.
A load is auto billable only when nothing failed, nothing was indeterminate, and enough substantive checks actually ran. A load that passed every check because none applied is not clean. It is unexamined. A vacuous pass is the most dangerous output an automation system can produce, and the one a scoring model produces most easily.
Most of what stops a load in the first shadow reading is data rather than rules: stale reference data, incomplete batches where waiting was correct. Fix the data path first and the number moves on its own.
AUTO BILLABLE
nothing failed, nothing indeterminate, enough checks ran
HELD
a rule stopped it, and the row names the rule
INCOMPLETE
the batch is not whole yet. The agent waits rather than guesses
INDETERMINATE
an input a rule needed was not on the document
The verdict vocabulary. Not a distribution.
04 / the review
Every load still goes to a biller. That is not a temporary arrangement.
The agent emits its verdict. The load goes through manual billing anyway. An audit table records every field the biller changes. A load that went through untouched is a load that could have been billed automatically. That is a measurement, not an opinion.
Cohorts where billers consistently change nothing get switched to automatic, one slice at a time. Not because a number crossed a threshold. Because that cohort’s billers changed nothing. Where a biller does change something, the change is the finding. A field that always gets corrected is a rule nobody had written down.
There is no failure mode where work disappears. Anything the rules cannot settle goes to the biller who would have handled it anyway. That floor is why operations say yes.
01
verdict emitted
one row per load, with the blocker named when the answer is no
02
person bills anyway
the existing process is untouched. Every load goes to a biller
03
audit table records the difference
every field the biller changed, beside what the agent would have done
04
cohort switched
one slice at a time, where the billers consistently changed nothing
and back from 03 into the rules · a field the biller always corrects is a rule nobody had written down
05 / the ledger
The shadow is the ledger. It is also where a rule proves itself.
The run history records what the agent would have decided, which documents it read, which rule produced which part of the verdict, and what a person did instead. Those four together make the eventual switch reversible.
That log is where a rule proves itself. A real rule on real data produces a result you can read back to the expression, the field and the value it saw, one record at a time.
- rule
- bill of lading signed by consignee
- load
- masked
- field
- signature_present
- value
- not present on the document
- outcome
- indeterminate
one judgment per record per version · every surface shows the same one
06 / how to start
Start with the rules nobody has written down.
- Get the operator in a room for an afternoon. Have them say the release rules out loud. Write every one down verbatim.
- Send a month of paperwork. Bills of lading, carrier invoices, rate confirmations. Plus a read only export of the matching loads. Without the second side there is nothing to match against.
- Run in shadow. Billers keep billing. The audit table does the measuring. Switch a cohort only when its billers stop changing anything.
- Read the audit table. The field a biller always corrects is a rule nobody had written down.
next
Give us the rules nobody has written down.
Say them out loud the way your billing team says them. We will show you each one running as a check beside your billers.