Build notes
Build notes: what actually breaks
The parts of a trucking automation that quietly fail when they get skipped. These are the details that decide whether the thing still works in week six.
- The POD photo is the whole build, and it is the flakiest part. Drivers photograph paper BOLs in bad light, at an angle, folded. OCR that works on a clean scan fails on that constantly. The build has to accept a low-confidence read, flag it for a human, and still attach the image to the load rather than silently dropping it.
- Detention starts at arrival, not at the appointment time. This is the single most common billing error we see. If the clock is keyed to the scheduled appointment, every load that arrives early loses free time it was entitled to. Key it to the actual geofence arrival and log both timestamps.
- ELD webhooks lag, sometimes by hours. Samsara and Motive can deliver arrival events well after the fact. Anything that fires immediately on the first event will be wrong. Build a reconciliation pass that re-checks the trip record before anything invoices or bills detention.
- Every factoring company wants a different bundle. One wants invoice, rate con, and POD as a single merged PDF. The next wants them as separate attachments with a specific filename convention. Get the actual submission spec in writing before scoping, because it changes the build.
- Multi-stop loads break single-stop assumptions. A build that assumes one pickup and one delivery will mis-handle every multi-stop, partial, and LTL run. Model stops as a list from day one even if the carrier only runs single-stop today.
- Idempotency key on every invoice write. Retries, redeploys, and a driver uploading the POD twice will all create duplicate invoices without a key on the load-and-invoice pair. Duplicate invoices to a broker are worse than a late one.
- Drivers change phone numbers constantly. Any SMS workflow keyed to a phone number rather than a driver record will quietly start texting a stranger. Key to the driver, treat the number as a mutable attribute, and honor STOP replies.
- Broker portals mostly have no API. DAT, Truckstop, and most broker portals will not give a small carrier programmatic access. Realistic builds parse email or use a human-in-the-loop step. Anyone promising a clean portal integration should be asked exactly how.
Comparing who should build it? Our provider-type comparison applies to freight as much as to the trades: answering services, TMS add-ons, retainer agencies, fixed-price builds, and DIY all cost very different amounts by year three.