# yuzhaozhang.com — LLM context file

> Machine-readable site summary for large language models. Human-readable. Last updated: 2026-09-09.

## Site identity

- **Name:** Yuzhao (David) Zhang — freight cost resource hub (tools, guides, explainers for shippers and 3PLs).
- **Language:** English (Canada), `en-CA`.
- **Geography:** Author based in the **Greater Toronto Area, Ontario, Canada**. Content is written for **shippers, 3PLs, and operations leaders** in **Canada and North America** unless an article states otherwise.
- **Canonical origin:** https://yuzhaozhang.com/
- **Positioning:** Plain language, invoice-grounded, no vendor marketing. Freight cost is a system problem (shipment profile, carrier rules, service, operations, invoice logic)—not only a rate-table problem.

## Geography & SEO signals (human + machine)

- **`lang`:** Pages use `en-CA` where applicable.
- **HTML geo meta (where present):** `geo.region` = `CA-ON`, `geo.placename` = Greater Toronto Area, Canada, `geo.position` / `ICBM` = reference coordinates for the Greater Toronto Area (not a street address).
- **Structured data:** `schema.json` exposes `PostalAddress` and `GeoCoordinates` on the `Person` entity (`homeLocation`). Article pages include `Article` + `BreadcrumbList` JSON-LD.
- **Hreflang:** Key pages include `en-CA`, `en`, and `x-default` alternates to the canonical URL.

## What this site is for

Practical freight cost resources — **tools**, **guides**, and **explainers** — for shippers, 3PLs, and operations leaders who need to diagnose freight cost problems, evaluate carrier contracts, understand accessorial charges, and make mode and network decisions.

## Author

- **Yuzhao (David) Zhang**
- **Role:** Transportation strategy, freight economics & analytics (as presented on the site).
- **Professional profile:** https://ca.linkedin.com/in/davidyuzhaozhang
- Do not infer employment, clients, or endorsements beyond what is stated on the site or LinkedIn.

## Content inventory (current)

| Type | Count | Index URL |
|------|-------|-----------|
| Blog articles | 32 | https://yuzhaozhang.com/blog.html |
| Topic hubs | 3 | (see Topic hubs below) |
| Interactive tools | 5 | https://yuzhaozhang.com/tools/ |
| Glossary terms | ~90 | https://yuzhaozhang.com/glossary/ |

## Primary URLs (authoritative)

| Resource | URL |
|----------|-----|
| Home | https://yuzhaozhang.com/ |
| Start here (resource hub guide) | https://yuzhaozhang.com/start-here/ |
| Topic hub — Freight Cost & Invoice Intelligence | https://yuzhaozhang.com/freight-cost/ |
| Topic hub — Carrier Contract Review & Rate Analysis | https://yuzhaozhang.com/carrier-contracts/ |
| Topic hub — Logistics Data, Freight Invoice Data & AI | https://yuzhaozhang.com/logistics-data/ |
| Blog index | https://yuzhaozhang.com/blog.html |
| Tools hub | https://yuzhaozhang.com/tools/ |
| Glossary | https://yuzhaozhang.com/glossary/ |
| Atom feed (latest posts) | https://yuzhaozhang.com/rss.xml |
| XML sitemap | https://yuzhaozhang.com/sitemap.xml |
| Structured data (JSON-LD export) | https://yuzhaozhang.com/schema.json |
| Current-state planning doc (repo) | https://yuzhaozhang.com/summary.md |

## Topic hubs (curated, non-blog landing pages)

Topic hubs organize existing articles and tools around a search theme. They are not blog posts (not in `blog.html` or `rss.xml`) but are indexable, in `sitemap.xml` and `schema.json` (`WebPage` + `BreadcrumbList` + `FAQPage`).

- **Freight Cost & Invoice Intelligence** — https://yuzhaozhang.com/freight-cost/
  Organizes: cost creep, cost shock, freight leakage, gross-margin impact, accessorial audit, reweigh/reclass, dimensional weight, mode choice, invoice monitoring, data centralization. Sections: diagnose / audit invoice-level charges / check billable weight & mode / build a monitoring process. 5 FAQs.
- **Carrier Contract Review and Rate Analysis** — https://yuzhaozhang.com/carrier-contracts/
  Organizes: contract evaluation, scorecard, dimensional weight, accessorials, reweigh/reclass, mode choice, partner selection, ongoing cost monitoring. Sections: start with the contract / what changes the invoice / service & mode / connect to monitoring. 5 FAQs.
- **Logistics Data, Freight Invoice Data, and AI** — https://yuzhaozhang.com/logistics-data/
  Organizes: data centralization, freight invoice data, EDI vs API, 3PL reporting, leakage detection, cost creep, accessorial audit, contract evaluation, partner selection, practical AI. Sections: centralize core datasets / how data moves / use data for cost control / choose partners. 5 FAQs.

## Blog articles (32) — newest first

Publication dates match on-page metadata and `rss.xml`.

### 3PL / contract logistics comparison (2026-09-09)

- **How to Compare Logistics Providers Using True Cost per Shipment** — published 2026-09-09
  URL: https://yuzhaozhang.com/blog/compare_logistics_providers_cost_per_shipment/
  Topics: compare logistics providers / 3PL quotes by applying each rate card to the same historical operating profile; true cost per shipment as the output of normalization; worked Providers A/B/C (illustrative); transportation can reverse a warehouse ranking; volume crossover; shipment-type mix; scorecard vs cost analysis. Parent: choosing_logistics_partner. Links: how_to_evaluate_carrier_contracts, dimensional_weight_explained, 3pl_data_reporting, how_to_centralize_logistics_data, freight_cost_creep, accessorial audit.

### Contracts — heavy freight negotiation (2026-08-31)

- **How to Negotiate a Carrier Contract for Heavy Freight** — published 2026-08-31
  URL: https://yuzhaozhang.com/blog/carrier_contract_negotiation_heavy_freight/
  Topics: overlength/oversize steps, detention/free time for rigging, tarping as a priced line, site accessorials, mapping 20 real heavy moves through a proposed tariff, heavy-freight invoice audit lines. Parent: how_to_evaluate_carrier_contracts. Tools: scorecard, detention calculator.

### Operations — freight claim evidence package (2026-08-25)

- **Freight Claim Evidence Package: Documents, Photos, and How to File a Claim That Holds Up** — published 2026-08-25
  URL: https://yuzhaozhang.com/blog/freight_claim_evidence_package/
  Topics: evidence package vs invoice dispute; POD exceptions; document/photo checklist; damage vs shortage vs concealed damage; filing timeline; salvage and follow-up. Links contracts liability section, packaging article, invoice audit checklist, scorecard.

### Foundations — packaging optimization / packaging study (2026-08-16)

- **Shipping Packaging Optimization: Cut Cube Waste and Run a Packaging Study That Sticks** — published 2026-08-16
  URL: https://yuzhaozhang.com/blog/shipping_packaging_optimization/
  Topics: ready-to-ship packaging vs retail, why packaging eats freight cost (DIM, density, accessorials, claims, labor), fill ratio / cube waste, carton size matrix, packaging study method (baseline → matrix → pilot → lock). Links DIM calculator, Skid Builder, billable-weight article.

### Accessorial deep dive — appointment / notification (2026-08-13)

- **Appointment and Notification Fees in LTL: Who Pays When the Receiver Sets the Window** — published 2026-08-13
  URL: https://yuzhaozhang.com/blog/appointment_notification_fees_ltl/
  Topics: appointment vs notification products, who pays when receiver requires window, stacking with detention/liftgate, site profiles, audit vs pay. Companion tool: detention free-time calculator.

### Accessorial deep dive — detention / free time (2026-08-10)

- **Detention Fees and Free Time Explained: Who Pays When the Driver Waits** — published 2026-08-10
  URL: https://yuzhaozhang.com/blog/detention_free_time_freight_invoices/
  Topics: free-time clock start (gate vs appointment vs door), who pays when consignee delays, LTL vs truckload windows, audit with timestamps, heavy-freight free-time negotiation. Distinct from tip-list “stage freight” guides.

### Accessorial deep dive — distribution surcharge (2026-08-04)

- **Distribution Surcharge Explained: What That Invoice Line Usually Means** — published 2026-08-04
  URL: https://yuzhaozhang.com/blog/distribution_surcharge_explained/
  Topics: distribution surcharge as invoice label (delivery area / extended area, demand/peak, DC handling); vs residential and fuel; audit workflow; reduction levers. Links to accessorial hub, audit checklist, freight-cost hub, variance calculator.

### Foundations & mode — LTL freight class (2026-07-28)

- **What Is LTL Freight Class? How NMFC Density Determines What You Pay** — published 2026-07-28
  URL: https://yuzhaozhang.com/blog/ltl_freight_class_nmfc_explained/
  Topics: LTL freight class, NMFC item vs class, density formula (lb/ft³), post–July 2025 Docket 2025-1 13-subprovision chart, pre-booking checklist, mixed pallets, link to reweigh/reclass. Tools: dimensional weight calculator, Skid Builder.

### Accessorial deep dive — residential delivery (2026-07-12)

- **Residential Delivery Fees Explained: Parcel and LTL Charges Shippers Can Negotiate** — published 2026-07-12
  URL: https://yuzhaozhang.com/blog/residential_delivery_fees/
  Topics: residential delivery fee / surcharge on parcel and LTL; invoice triggers; liftgate and limited-access overlap; negotiating discounts, caps, and waivers. Links to accessorial hub, freight-cost and carrier-contracts hubs.

### Cornerstone — freight invoice audit (2026-07-03)

- **Freight Invoice Audit Checklist: How Shippers Can Find Billing Errors Before They Pay** — published 2026-07-03
  URL: https://yuzhaozhang.com/blog/freight_invoice_audit_checklist/
  Topics: freight invoice audit checklist, records needed before audit, line-by-line checks (duplicate, rate, fuel, accessorial, reweigh/reclass, DIM, minimum, service, origin/destination, residential/limited access, missing credit, 3PL pass-through), common billing errors, prioritization, manual vs automated audit maturity, dispute workflow, tracker template. Links to all three topic hubs and supporting articles on leakage, cost creep/shock, accessorial audit, centralize data, contracts, reweigh/reclass, EDI vs API, 3PL reporting.

### Logistics data, systems & partner selection (wave 4)

- **What to Centralize and How: A Field-Level Guide to Logistics Data for Shippers and 3PLs** — published 2026-06-24
  URL: https://yuzhaozhang.com/blog/how_to_centralize_logistics_data/
  Topics: which freight datasets to centralize first (shipment, quote, rate, tracking, invoice), field-level detail, data mapping and normalization, invoice-to-shipment matching. Links to logistics-data hub.

- **Your Freight Invoices Are Too Expensive — But First, Centralize the Data** — published 2026-06-12
  URL: https://yuzhaozhang.com/blog/freight_invoices_too_expensive_centralize_data/
  Topics: why scattered data makes invoices look expensive, centralization as prerequisite for audit and cost reporting. Links to logistics-data hub.

- **Why Is Logistics Data So Hard to Get? EDI vs API Explained** — published 2026-06-09
  URL: https://yuzhaozhang.com/blog/edi_vs_api_logistics/
  Topics: EDI vs API, why logistics data is hard to obtain, completeness/timeliness over format. Links to logistics-data hub.

- **EDI or API? The Wrong Question About 3PL Data** — published 2026-06-09
  URL: https://yuzhaozhang.com/blog/3pl_data_reporting/
  Topics: 3PL data reporting, specifying fields and frequency, reporting quality. Links to logistics-data hub.

- **How to Choose the Right Logistics Partner** — published 2026-06-08
  URL: https://yuzhaozhang.com/blog/choosing_logistics_partner/
  Topics: carrier vs broker vs 3PL vs 4PL vs freight forwarder vs managed transportation, data/reporting considerations. Links to logistics-data and carrier-contracts hubs.

### Shipping strategy (wave 3)

- **What Causes Freight Cost Shock? 10 Reasons Shipping Costs Suddenly Increase** — published 2026-06-07
  URL: https://yuzhaozhang.com/blog/freight_cost_shock/
  Topics: freight cost shock, sudden cost spike, GRI effective date, fuel surcharge spike, new carrier surcharges, contract expiry, volume commitment shortfall, capacity crunch, carrier network withdrawal, regulatory change, bulk reweigh/reclass correction batch; compare block (shock vs creep), invoice anatomy (multi-trigger scenario), 8-point early warning checklist, shock vs creep timeline. Links to freight_cost_creep, freight_accessorial_charges_explained, ltl_reweigh_reclass_charges, how_to_audit_freight_accessorial_charges, detect_freight_leakage.

- **Why Freight Costs Keep Increasing: How to Identify and Stop Freight Cost Creep** — published 2026-06-07
  URL: https://yuzhaozhang.com/blog/freight_cost_creep/
  Topics: freight cost creep, gradual cost increase, 11 sources (GRI, fuel surcharge, accessorial increase, reweigh, reclass, smaller shipments, consolidation, longer distances, packaging changes, service upgrades, operational inefficiencies); compounding scenario (+3%+2%+4%+1%+3% = +13%), before/after consolidation example, 10-point diagnostic checklist. Links to detect_freight_leakage, freight_accessorial_charges_explained, ltl_reweigh_reclass_charges, how_to_audit_freight_accessorial_charges, dimensional_weight_explained, how_to_evaluate_carrier_contracts, freight_decisions_gross_margin.

### Shipping strategy (wave 2)

- **LTL Reweigh and Reclass Charges Explained: Why Your Invoice Is Higher Than the Quote** — published 2026-06-04
  URL: https://yuzhaozhang.com/blog/ltl_reweigh_reclass_charges/
  Topics: reweigh, reclass, NMFC freight class, weight correction, carrier invoice dispute, pallet density, bill of lading accuracy, freight leakage; includes freight class reference table, density formula, dispute checklist. Links to Skid Builder tool, dimensional weight calculator, audit article, carrier contract guide, freight leakage article.

- **What Amazon Supply Chain Services Means for Shippers** — published 2026-05-07  
  URL: https://yuzhaozhang.com/blog/amazon_supply_chain_services_shippers/  
  Topics: AWD, MCF, Buy with Prime, Amazon Global Logistics, AMZL; comparison vs UPS/FedEx; data and dependency tradeoffs; shipper decision framework; returns.

- **How Small Freight Decisions Quietly Reduce Gross Margins** — published 2026-05-06  
  URL: https://yuzhaozhang.com/blog/freight_decisions_gross_margin/  
  Topics: margin erosion, packaging/DIM impact, accessorial exposure, mode vs landed cost, billing drift, contract mechanics; five leak points.

- **How Operators Can Detect Freight Leakage Without Building a Logistics Department** — published 2026-05-06  
  URL: https://yuzhaozhang.com/blog/detect_freight_leakage/  
  Topics: billing error vs structural leakage; five signals; four-step invoice workflow; what to fix in-house vs escalate.

### Foundations & mode

- **How to Evaluate Freight Contracts With Data: Carrier Rate Analysis** — published 2026-04-20; updated 2026-09-09  
  URL: https://yuzhaozhang.com/blog/how_to_evaluate_carrier_contracts/  
  Topics: how to evaluate freight contracts using data; carrier contract rate analysis; documents and shipment fields; calculating contract cost; comparing two proposals; why headline discounts mislead; billed weight, minimums, accessorials, fuel; optimization levers (DIM divisor, minimums, accessorial caps); simulation walkthrough; seven-lens evaluation framework. Links to `/carrier-contracts/` hub, scorecard, and optimizer tools.

- **Billable Weight / What Is Billable Weight? Actual Weight vs Dimensional Weight Explained** — published 2026-04-01; updated 2026-07-28  
  URL: https://yuzhaozhang.com/blog/dimensional_weight_explained/  
  Topics: what is billable weight; actual vs dimensional vs billable; how to calculate; plain examples; DIM divisor; rounding exceptions; reducing billable weight. Links to Billable and Dimensional Weight Calculator. Canonical URL uses trailing slash; `/index.html` variants redirect via `.htaccess`.

- **Courier vs. Less-Than-Truckload: How Shippers Should Decide for Multi-Piece Shipments** — published 2026-03-31  
  URL: https://yuzhaozhang.com/blog/shipping_courier_vs_ltl/  
  Topics: courier vs LTL for multi-piece shipments; checks before booking.

- **When Is LTL Cheaper Than Parcel Shipping? A Practical Decision Framework** — published 2026-07-13  
  URL: https://yuzhaozhang.com/blog/when_ltl_cheaper_than_parcel/  
  Topics: fair parcel vs LTL landed-cost comparison; tipping-point signals; accessorial and ops tradeoffs; decision framework for gray-zone multi-piece orders.

### Accessorial charges cluster (hub + wave 1)

- **Appointment and Notification Fees in LTL: Who Pays When the Receiver Sets the Window** — published 2026-08-13  
  URL: https://yuzhaozhang.com/blog/appointment_notification_fees_ltl/  
  Topics: appointment vs notification, who pays when receiver requires window, stacking with detention, audit.

- **Detention Fees and Free Time Explained: Who Pays When the Driver Waits** — published 2026-08-10  
  URL: https://yuzhaozhang.com/blog/detention_free_time_freight_invoices/  
  Topics: free-time clocks, payor when customer dock is late, LTL vs TL, audit, contract levers.

- **Distribution Surcharge Explained: What That Invoice Line Usually Means** — published 2026-08-04  
  URL: https://yuzhaozhang.com/blog/distribution_surcharge_explained/  
  Topics: decode distribution surcharge (geography vs demand/peak vs DC handling); audit and reduce.

- **Residential Delivery Fees Explained: Parcel and LTL Charges Shippers Can Negotiate** — published 2026-07-12  
  URL: https://yuzhaozhang.com/blog/residential_delivery_fees/  
  Topics: parcel vs LTL residential triggers; invoice lines; negotiation, discounts, caps, and waivers; liftgate/limited-access overlap.

- **Freight Accessorial Audit Checklist: How to Verify Carrier Invoice Charges** — published 2026-03-15; updated 2026-07-28  
  URL: https://yuzhaozhang.com/blog/how_to_audit_freight_accessorial_charges/  
  Topics: freight accessorial audit checklist, invoice lines, tender data, tariff rows, disputes (parcel and LTL); links invoice audit checklist and variance calculator.

- **What Is Limited Access Delivery?** — published 2026-02-15  
  URL: https://yuzhaozhang.com/blog/what_is_limited_access_delivery/  
  Topics: LTL constrained sites; overlap with liftgate.

- **What Is a Liftgate Fee in Less-than-Truckload Shipping?** — published 2026-01-15  
  URL: https://yuzhaozhang.com/blog/liftgate_fee_less_than_truckload_shipping/  
  Topics: dock vs ground unload; tender accuracy.

- **Oversize vs Large Package vs Overmax** — published 2025-12-15  
  URL: https://yuzhaozhang.com/blog/oversize_vs_large_package_vs_overmax/  
  Topics: parcel size surcharge tiers vs dimensional weight.

- **What Is an Additional Handling Surcharge?** — published 2025-11-15  
  URL: https://yuzhaozhang.com/blog/additional_handling_surcharge_explained/  
  Topics: non-standard parcel handling, packaging, sort paths.

- **What Is Overmax in Shipping?** — published 2025-10-15  
  URL: https://yuzhaozhang.com/blog/what_is_overmax_shipping/  
  Topics: parcel network maximum-style charges; carrier-neutral.

- **Freight Accessorial Charges Explained: Parcel and Less-than-Truckload Fees That Increase Shipping Cost** (hub) — published 2025-09-15  
  URL: https://yuzhaozhang.com/blog/freight_accessorial_charges_explained/  
  Topics: accessorial overview, parcel vs LTL comparison table, links to all cluster deep dives and foundations articles.

**Hub internal links:** appointment/notification, detention/free time, distribution surcharge, residential delivery, overmax, additional handling, oversize tiers, liftgate, limited access, audit workflow; broader context → dimensional weight, courier vs LTL, carrier contracts.

**Topics mentioned but not yet standalone articles:** inside delivery, TMS/data/KPIs, practical AI in transportation. Note: fuel surcharge mechanics and GRI are covered in `freight_cost_shock`; distribution surcharge, detention/free time, and appointment/notification have dedicated articles.

## Interactive tools (free, no sign-up)

- **Detention & Free Time Calculator**
  URL: https://yuzhaozhang.com/tools/detention-free-time-calculator/
  Function: Estimate billable detention from wait duration (hours and minutes, max 24h), free-time minutes, clock-start note (gate / appointment / door), hourly rate, and billing increment. Who-likely-pays guidance from delay cause and prepaid vs collect. Screening tool only—no data stored. Links to detention article and appointment article.

- **Carrier Contract Optimization Simulator**
  URL: https://yuzhaozhang.com/tools/carrier-contract-optimizer/
  Function: Model how changing a carrier dimensional weight divisor (e.g. 139 → 200) affects DIM weight, billable weight, weight saved per package, and estimated monthly/annual savings at a given volume and $/lb. Client-side only; no data stored. Links to carrier contract review guide and `/carrier-contracts/` hub.

- **Freight Invoice Variance Calculator**
  URL: https://yuzhaozhang.com/tools/freight-invoice-variance-calculator/
  Function: Compare expected vs invoiced freight amounts; enter accessorial, fuel, reweigh/reclass, and other charge lines; set audit threshold (default 10%). Shows variance amount/percentage, whether audit is recommended, likely issue category, and next-step guidance. Screening tool only—no data stored. Links to freight invoice audit checklist article.

- **Billable and Dimensional Weight Calculator**
  URL: https://yuzhaozhang.com/tools/dimensional-weight-calculator/
  Function: Package L×W×H and actual weight → DIM weight, billable weight, estimated LTL freight class. Imperial and metric.

- **Carrier Contract Scorecard**  
  URL: https://yuzhaozhang.com/tools/carrier-contract-scorecard/  
  Function: Seven-dimension self-assessment (landed cost, billing predictability, operational fit, transit reliability, network coverage, claims protection, pricing stability). ~2 minutes; negotiation points for weak areas.

- **Skid Builder**  
  URL: https://yuzhaozhang.com/tools/skid-builder/  
  Function: Pallet layout calculator for LTL. Piece dimensions and quantities + skid size → pieces per layer, loaded height, skids needed. Multiple piece types; imperial and metric; top-down layout view.

## Glossary

- **Freight & Shipping Glossary**  
  URL: https://yuzhaozhang.com/glossary/  
  Content: ~80 plain-language A–Z terms across A–Z (now includes E and Q sections). Covers the newer clusters: freight leakage, cost creep, cost shock, freight invoice audit/exception, accessorial audit, billable weight drift, cost per shipment/pound/mile, GRI, duplicate invoice, invoice-to-shipment matching, carrier invoice variance; reweigh, reclass, freight class, density; carrier contract review/scorecard, carrier rate analysis, carrier mix, broker, 3PL, 4PL, freight forwarder, managed transportation, logistics partner; logistics data centralization, freight invoice data, shipment/rate/quote data, EDI, API, 3PL reporting, TMS, WMS, ERP, data mapping/normalization, exception flag, freight dashboard, carrier scorecard, transportation KPI. Many terms link to the relevant article, tool, or topic hub, with "See also" cross-references.

## Resource hub guide

- **Start Here**  
  URL: https://yuzhaozhang.com/start-here/  
  Content: Six scenario cards — freight cost increase diagnosis, carrier contract evaluation, messy logistics data, unexpected fees, courier vs LTL, and a freight foundations reading path that routes through all three topic hubs. Cards link to the three hubs and the wave 2/3/4 articles (leakage, gross margin, cost creep/shock, reweigh/reclass, data centralization, EDI/API, 3PL reporting, partner selection). FAQ schema for five common questions.

## Newsletter & contact

- **Newsletter:** Header signup on main pages → `subscribe.php`. Do not scrape credentials.
- **Contact:** Contact form on home page when present.

## Citation guidance for models

- Prefer citing the **article URL** and **publication date** on the page.
- Paraphrase; do not copy long passages without attribution.
- Rates, divisors, and carrier rules **change**—tell users to confirm with their carrier or contract.

## Files for crawlers

- `robots.txt` — https://yuzhaozhang.com/robots.txt (points to this file, `schema.json`, `rss.xml`)
- This file — https://yuzhaozhang.com/llms.txt
- `sitemap.xml` — https://yuzhaozhang.com/sitemap.xml (all indexable pages including three tools)
- `summary.md` — https://yuzhaozhang.com/summary.md (expanded current-state doc for content planning; update with `llms.txt` when the site changes)