Why Documentation Debt Is the New Technical Debt in Logistics
- Danyul Gleeson
- 2 hours ago
- 7 min read
Every organisation has a junk drawer.
You know the one. Important things are technically in there somewhere. Old keys. Half-used batteries. Mystery cables you’re convinced you’ll need one day.
Every logistics team has one too.
It usually shows up during a handover that wasn’t really a handover. A few notes. A shared folder. A casual “you’ll figure it out.” Freight keeps moving, so it feels safe. Decisions keep working, so no one opens the drawer properly.
Documentation debt is what happens when supply chain decisions get shoved into emails, spreadsheets, and people’s heads instead of being clearly written down. Classification logic. Valuation assumptions. Origin calls. All still there. Just not where anyone can calmly explain them.
The problem isn’t that the information is missing.
It’s that when someone finally asks for it, you can’t prove what belongs there.
Logistics might keep moving.
Audits don’t care.
And “it made sense at the time” isn’t documentation.
Why documentation debt is the new technical debt
Technical debt slows systems down.
Documentation debt shuts businesses down.
Documentation debt forms when decisions are made quickly, recorded loosely, and never fully explained.
Product classifications.
Valuation logic.
Origin assumptions.
Incoterms choices.
Broker instructions.
All accurate enough to move freight today, but not structured enough to defend tomorrow.
Just like technical debt, it’s born from speed.
Just like technical debt, it feels efficient at the time.
And just like technical debt, the bill arrives later - with interest.
The difference is this: technical debt usually causes outages. Documentation debt causes audits, cash calls, and uncomfortable board meetings.
The cost curve no one models
Documentation debt feels abstract until you put numbers next to it.
Here’s a simple, directional example.
A business imports $20 million of goods over three years. Nothing exotic. Nothing reckless. Just steady growth.
A post-clearance review finds a 5–10 percent duty adjustment tied to undocumented classification or valuation logic.
That’s:
$1–2 million in reassessed duties
Plus interest
Plus advisory, legal, and internal response costs
All payable now, not forecasted, not smoothed, not optional
That’s not an ops problem.
That’s a balance-sheet moment.
This is why documentation debt doesn’t stay operational for long. It escalates.
Documentation debt hides because logistics keeps moving
One reason documentation debt is so dangerous is that logistics systems are built to flow.
Shipments clear.
Containers arrive.
Customers stay happy.
Nothing fails loudly.
In software, broken code crashes. In logistics, broken logic often passes silently.
Each shipment cleared using undocumented reasoning becomes another data point reinforcing a fragile assumption. Over time, the pattern becomes visible to regulators, even if it never was internally.
That’s why customs authorities increasingly focus on post-clearance audits. Real-time checks catch errors. Audits catch systems.
And systems hate undocumented decisions.
A micro-case you’ll recognise
Imagine a fast-growing apparel brand.
Early on, one senior operator defines the HS classification logic. It makes sense. It works. It clears.
The business scales. New fabrics. New blends. New suppliers. Same logic, because it’s “basically the same product.” No formal review. No documented rationale. Just continuity.
Three years later, a customs audit asks for the basis of those decisions.
The person who made them left. The logic lives in inboxes. The supporting material is scattered. What once felt efficient now has to be reconstructed under time pressure, with penalties already on the table.
Nothing illegal happened.
Documentation debt just matured.
Documentation debt isn’t missing paperwork. It’s missing reasoning.
This is where many teams misdiagnose the problem.
Documentation debt doesn’t usually look like missing documents.
It looks like:
Classification logic that lives in someone’s head
Valuation methods justified once, then copied forward
Origin decisions applied inconsistently by supplier
Email threads standing in for policy
Broker instructions repeated without context
Each decision is defensible on its own.
Together, they form a system no one can explain calmly, consistently, and under scrutiny.
A
uditors don’t just ask what you did.
They ask why.
And “that’s how we’ve always done it” is not a defensible answer.
You likely have documentation debt if…
Most leadership teams don’t realise they have documentation debt until it’s being priced.
A few diagnostic signals:
There is no single owner for classification, valuation, or origin decisions
No one knows when those decisions were last formally reviewed
Audit preparation means searching inboxes, not opening a system
Key compliance knowledge sits with individuals, not processes
Growth happened faster than documentation standards evolved
If any of those feel familiar, documentation debt already exists. The only variable is how visible it is.
Growth multiplies documentation debt faster than volume
Documentation debt scales faster than freight.
Every new SKU, supplier, market, or channel adds decision points. If those decisions aren’t documented in a structured, repeatable way, risk compounds non-linearly.
Global trade research consistently links decentralised, fast-scaling supply chains to higher compliance exposure. Not because businesses are careless, but because governance struggles to keep pace with velocity.
Growth introduces entropy.
Documentation is what keeps entropy from turning into liability.
Brokers don’t create documentation debt. But they don’t own it either.
This distinction matters more than most teams realise.
Brokers and freight partners execute filings. They file what they’re given. They move information through the system efficiently.
They do not design your documentation architecture. They do not own your historical decision-making logic. And they do not carry the long-tail risk when assumptions are challenged years later.
Execution is not ownership.
Filing is not governance.
Documentation debt lives upstream.
Why documentation debt waits for the worst possible moment
Documentation debt doesn’t surface when you’re busy.
It surfaces when:
An audit begins
A transaction or exit is underway
Expansion triggers regulatory review
Rules change and past decisions are re-tested
Suddenly, decisions made years ago need to be explained clearly, quickly, and convincingly.
And fixing documentation debt under pressure is exactly like refactoring a legacy system in production.
Possible. Painful. Expensive.
Why documentation debt is now a leadership issue
Documentation used to be operational.
Now it’s strategic.
Regulators are more coordinated. Data analysis is stronger. Enforcement is retrospective by design. And supply chains are judged not just on cost and speed, but on accuracy, transparency, and control.
Documentation debt sits across logistics, finance, legal, and risk. Which means once it surfaces, it doesn’t stay buried.
The organisations that manage it well don’t eliminate it entirely.
They make it visible, owned, and defensible.
FAQs: Why Compliance Failures Rarely Show Up in Freight Quotes
What is documentation debt in logistics and supply chains?
Documentation debt refers to the accumulation of undocumented or poorly documented decisions across logistics and trade processes. This includes product classification logic, valuation methods, country-of-origin determinations, and broker instructions that work operationally but lack clear, defensible reasoning. Over time, this debt increases audit risk, financial exposure, and governance pressure.
How is documentation debt different from technical debt?
Technical debt slows systems down. Documentation debt creates regulatory, financial, and legal risk. While technical debt often causes visible failures, documentation debt stays hidden until triggered by audits, expansion, or due diligence. When it surfaces, the cost is usually retrospective, immediate, and far harder to control.
Why does documentation debt become a problem as businesses scale?
As supply chains grow, decisions multiply. New SKUs, suppliers, markets, and Incoterms add complexity. If documentation standards don’t scale at the same pace, assumptions get copied forward without review. This creates systemic risk that compounds quietly and is often only discovered years later during post-clearance audits.
What are the real financial risks of documentation debt?
Even small documentation gaps can lead to large financial impacts. A 5–10 percent duty reassessment applied across several years of imports can result in seven-figure cash calls once backdated duties, interest, and advisory costs are included. These costs are rarely budgeted and often hit during periods of strategic change or scrutiny.
How can companies identify if they already have documentation debt?
Most organisations already have documentation debt if:
There is no clear owner for classification, valuation, or origin decisions
The rationale behind key decisions isn’t documented in a central system
Audit preparation relies on searching emails or individual inboxes
Compliance knowledge sits with people, not processes
Decisions haven’t been formally reviewed since the business scaled
Recognising documentation debt early allows it to be managed deliberately, rather than discovered under pressure.
The part nobody writes down
No one gets caught because they moved too slowly.
They get caught because they moved fast and never wrote down why.
Documentation debt isn’t a failure of effort.
It’s a failure of memory. And regulators have very long ones.
If your supply chain only works because the right people still remember how it’s supposed to, it’s already fragile.
Eventually, every fast-moving business is asked to explain itself.
The prepared ones answer calmly.
The rest start digging through inboxes.
Transport Works. Because Your Supply Chain Won’t Fix Itself.
Insights from Danyul Gleeson, Founder & Logistics Chaos Tamer-in-Chief at Transport Works
Danyul has been in the trenches - warehouses where pick paths were sketched on pizza boxes and boardrooms where the “supply chain strategy” was a shrug. He built Transport Works to flip that script: a 4PL that turns broken systems into competitive advantage. His mission? Always Delivering - without the chaos.
Sources & References
World Customs Organization (WCO) Post-Clearance Audit Guidelines & Customs Risk Management Frameworks Used for: prevalence of classification and valuation errors, retrospective audit focus, documentation requirements
U.S. Customs and Border Protection (CBP) Informed Compliance Publications, Reasonable Care & Penalties GuidanceUsed for: importer responsibility, documentation expectations, post-clearance enforcement
Australian Border Force Customs Compliance, Assurance & Audit ProgramsUsed for: multi-year reassessments, documentation standards, importer liability
OECD Global Trade, Supply Chain Complexity & Risk Management Reports Used for: link between globalised supply chains, decentralisation, and compliance risk
International Chamber of Commerce (ICC) Incoterms® Rules & Trade Documentation Guidance Used for: valuation risk, transfer of responsibility, documentation clarity
DeloitteGlobal Trade Advisory & Customs Audit Insights Used for: governance vs execution distinction, documentation ownership, audit defence
PwC Trade Compliance, Customs Risk & Historical Exposure Analysis Used for: retrospective liability, documentation gaps, financial impact of audits
KPMG Trade & Customs Risk Management Frameworks Used for: compliance debt analogy, audit preparedness, governance models
Comments