AI shipment exception summaries.

Exceptions arrive as tracking codes, forwarder emails and driver notes in three different places. This workflow reads them all and gives the operations desk one short, ranked summary per consignment, with the clock that matters.

Workflow5 min readUpdated 19 October 2026

Short answer

AI shipment exception summaries are short, structured notes on every delayed, damaged, held or misrouted consignment, written by reading carrier tracking events, forwarder and broker emails and driver notes together. For New Zealand freight and 3PL teams the value is the ranking: each note shows customer impact, cost exposure such as storage on a Customs-held import, and claim deadlines, while a coordinator makes every decision.

  • One summary per consignment, built from tracking events, emails and driver notes together.
  • Every summary names an owner, a next action and the deadline that applies.
  • Most NZ import storage locations give three to four free days before fees start.
  • Carrier damage claims need written notice within 30 days of the carrier’s responsibility ending.
  • Coordinators decide re-delivery, customer messages and claims; the AI only drafts.

What an exception summary is for

A shipment exception summary replaces the morning trawl through carrier portals and inboxes with one short note per problem consignment. It fixes nothing itself. It tells the duty coordinator which 12 of today’s 75 exceptions need a decision before 10am, and why. It covers late or failed deliveries, damage notes, short shipments, misroutes and imports waiting on Customs clearance.

The workflow at a glance

Inputs
Carrier tracking events, forwarder and customs broker emails, driver notes and photos, and the booking record (customer, promised date, declared value, carriage terms).
Systems
Your TMS or WMS (or Cin7 for distributors), the shared operations inbox, carrier tracking APIs, and the team channel where the board is posted.
Steps
Group events and messages by consignment number; classify the exception; pull the promise date and value; work out the applicable clock; write a three-line summary with a suggested next action; rank by deadline and impact.
Human review
The duty coordinator works the ranked list at fixed times (say 7.30am and 1pm), accepts or edits each next action, and owns every customer message, re-delivery and claim.
Outputs
A ranked exception board, one summary per consignment written back to the TMS, and draft customer updates awaiting approval.
Measures
Minutes from first event to summary, exceptions with a named owner by 10am, storage charges on held imports, claims lodged inside the notice period, and edits per summary.
Risks
Two consignments merged into one summary, emails that never reach the shared inbox, an unsupported cause, and stale tracking data shown as current.

Illustrative worked example

Illustrative example: an Auckland 3PL moving 1,800 consignments a week through three domestic carriers. Assumptions: 4% raise an exception (72), plus three held imports, so 75 a week. A coordinator spends about 9 minutes on each, opening portals and threads and writing an update. All figures are synthetic.

Measure Current process With summaries (assumed)
Exceptions per week 75 75
Minutes to understand and record each one 9 3 (read, check, accept or edit)
Coordinator hours per week 11.3 3.8
Weekly spot check of 10 summaries against source None 0.5 hours
Model tokens per week None 600,000 input, 37,500 output

The net saving is about 7 coordinator hours a week. Tokens at Claude Sonnet 5.5 list prices of US$2 per million input and US$10 per million output (as listed on 19 October 2026) come to roughly US$1.60 a week. The money that matters is elsewhere: one held import noticed a day earlier, or one damage claim lodged in time, is worth more than a year of tokens.

Which New Zealand rules set the clocks

Two sets of deadlines drive the ranking, and each summary states the relevant one in plain words.

Imports waiting on clearance. New Zealand Customs says an import entry must be completed within 20 days of arrival, goods sit in freight or postal storage until cleared, and most locations give three to four free days before charging. Customs is not responsible for storage (demurrage) fees caused by delayed clearance, and couriers often return goods after 20 days. Each held import carries a day count since arrival.

Damage and partial loss in domestic carriage. Under the Contract and Commercial Law Act 2017, a claim against a contracting carrier for damage or partial loss needs written notice within 30 days after the carrier’s responsibility ends (section 274). A contracting carrier that subcontracted the job must notify the actual carrier within 10 days of receiving that notice (section 275), which matters for 3PLs and forwarders. A contract that does not state its type is at limited carrier’s risk (section 249), capped at $2,000 per unit of goods (section 259). When a unit’s declared value exceeds the cap, the summary says so, because recovery may need cargo insurance. Contract terms can change some of this; take advice on large claims.

What the coordinator still decides

The AI drafts; the coordinator decides:

  • Whether to re-deliver, return to sender, hold or re-route.
  • What the customer is told and when, using the approval path in our customer delivery enquiry handling workflow.
  • Whether to lodge a claim, against which carrier, and for how much.
  • Any statement of cause. “Depot scan at 14:02 says damaged” is a fact the summary can quote; “the carrier was careless” is a judgement it must not make.
  • Anything that costs money: expedited freight, storage, re-delivery fees.

Where exception summaries go wrong

Most failures come from grouping and freshness, not from the model’s writing.

Failure What it looks like Control
Wrong grouping A reused customer PO merges two consignments Match on consignment number plus carrier; list source event IDs
Missing source A broker’s hold email went to a personal mailbox Route broker mail to the shared inbox; reconcile daily against the broker’s held list
Invented cause “Delayed by weather” with no evidence Require a quoted source line per cause; see structured outputs and validation
Stale data A failed overnight feed makes everything look on time Show “last event received” per carrier; alert on silence
Code drift A renamed status code maps to “in transit” Unknown codes go to review, never a default

How to start, and what drives cost

  1. Collect four weeks of history. Exceptions, the emails behind them and what the team actually did.
  2. Agree types and clocks. Exception categories, customer service levels, the Customs storage window and the 30-day notice period.
  3. Run in shadow for two weeks. Summaries sit beside the current process; log edits and misses in a human review queue.
  4. Go live narrowly. One carrier or one key customer first.

Cost is driven by the number of carrier integrations, whether your TMS or Cin7 account has an API, inbox routing, and review time. Damage exceptions are only as good as their evidence, so pair this with proof of delivery extraction. See AI for logistics in New Zealand for the sector view and AI workflow automation for build options.

Sources

  1. Lodge your import entry, New Zealand Customs Service, accessed 19 October 2026
  2. Contract and Commercial Law Act 2017 (Part 5, subpart 1: carriage of goods), New Zealand Legislation, 2017
  3. Claude API pricing, Anthropic, accessed 19 October 2026

Written by the Levy Street team in Wellington. Last updated 19 October 2026.

Questions people ask

Can AI decide who is at fault when a shipment arrives damaged?

It should not. An exception summary can report what the evidence says, such as a depot scan marked damaged or a driver photo of a crushed carton, and quote the source. Attributing fault affects claims, insurance and customer relationships, so a coordinator or claims officer makes that call after reading the proof of delivery, the consignment note and the contract terms.

How quickly should a held import be flagged in New Zealand?

On the day the hold is known. New Zealand Customs says most storage locations allow three to four free days before charging, that it is not responsible for storage fees caused by delayed clearance, and that couriers often return goods after 20 days. A summary that shows days since arrival against those limits lets the team act before fees start.

Does this work if our carriers only send emails rather than API data?

Yes, but expect more review at first. Email updates are less consistent than status codes, so the system has to identify the consignment from free text and will sometimes ask a person to confirm the match. Many teams start with the one or two carriers that offer tracking feeds and add email-only partners once matching accuracy is measured.

What does it cost to run AI exception summaries?

Model usage is usually the smallest line. At list prices on 19 October 2026, summarising 75 exceptions a week costs a few US dollars in tokens. The real costs are connecting carrier feeds, the shared inbox and your TMS, maintaining status code mappings when carriers change them, and the coordinator time spent reviewing summaries during the first months.

Have something to build?

Tell us about the workflow. We will map where AI can change speed, margin or decision quality, and what it would take to run it in production.