Review and confirm a delivery order
Confirming a delivery order is the step that turns a parsed PDF into a committed order: the document on the left, the canonical fields on the right, and one Confirm button that will not fire until every required assignment resolves. After it commits, the same screen carries you through proof of delivery and the confirmation email.
10 minute read · Updated September 9, 2026
How a document reaches the confirm screen
The confirm screen always addresses two things at once: a delivery order and one specific upload of a document against it. That is why the URL carries both, as /protected/operations/<order>/delivery-order/confirm/<upload>. Nearly everything in this article follows from that pairing.
- From the Document Review queue
- Opening a row in the Needs Review queue lands you here in queue mode, with a progress badge in the header, previous/next arrows, and a Back to Document Review link.
- From an upload you just made
- After you upload a PDF, Conterminal shows a parse-wait screen and forwards you to the confirm screen the moment the parse job attaches its upload to the order.
If you open a confirm link whose upload actually belongs to a different delivery order, Conterminal does not show an error. It checks who owns the upload, checks that you can read that order, and redirects you to the right one — keeping the stage you asked for and your queue filters intact.
Opening the screen is available to admins, managers, users, and collaborators in trucker, importer, and forwarder workspaces. Actually confirming is narrower: the confirm and archive actions accept only admin, manager, and user roles in a trucker or forwarder workspace. A collaborator can read the whole review and still be rejected on submit.
Reading the split view
The header reads Confirm delivery order fields with the container number beside it. Below it, the source PDF fills the left pane and the review rail fills a fixed column on the right. On a phone the two panes collapse into a toggle labeled Document and Fields; the screen opens on Fields, because that is where the work is.
Each row in the rail has the same shape: a label, the control you actually commit, and underneath it a muted evidence line reading Document: followed by what the parser pulled off the page. When nothing was found the line reads No document value found. Click that evidence line and the left pane highlights the matching text in the PDF, which is the fastest way to check a number without reading the whole page.
How the rail is grouped
Fields are grouped into Parties, Pickup, Moved By, Shipment, and Support Details, preceded by an unlabeled block holding the document date and issuer, and a Billing customer defaults section with Freight Customer and Accessorial Customer.
Forwarder workspaces open this screen in Express review by default, and a tenant admin can switch the workspace to Traditional review under Settings → Delivery-order review. In Express mode the rail is replaced by a short panel — container, B/L, house B/L, pickup terminal, ETA, vessel, trucker carrier — with a Full review button that opens the full rail, and Back to Express to return. Everything below in this article describes full review.
The required assignments
Text fields hold what the document said. Assignments are different: they bind the document to a real record in your workspace, and eight of them must resolve before Confirm will fire. Each one blocks with its own message.
- Issuer
- “Issuer must be selected or marked as not shown before confirming.”
- Pickup terminal
- “Pickup terminal must be selected before confirming.”
- Vessel
- “Vessel must be selected before confirming.”
- Ocean carrier
- “Ocean carrier must be selected before confirming.”
- Container SSL
- “Container SSL must be resolved before confirming.”
- Local carrier
- “Local carrier must be selected before confirming.”
- Importer (BCO)
- “Importer (BCO) must be selected or marked as not shown before confirming.”
- Deliver To
- “Deliver To must be selected before confirming.”
Only two fields accept “not shown.”
Issuer and Importer (BCO) are the only assignments that can be resolved by declaring the document silent. Their pickers carry an explicit option — Issuer not shown on document and Importer (BCO) not shown on document. Every other required field needs a real record. There is no not-shown escape for vessel, terminal, ocean carrier, container SSL, or local carrier.
Broker and Freight forwarder are optional and never block a confirm. Deliver To location is conditionally required — see the next section.
Reading the state of a picker
- Needs match. The parser read a name off the document but no canonical record is selected yet. The helper text says “Parsed from the document, but no canonical match is selected yet.” Focusing the field opens the picker for you.
- An amber warning. Several active company records match the parsed name: “Multiple active company records match this parsed name. Resolve it to the canonical record.” Pick the canonical one rather than whichever sorts first.
- Auto-filled or Manual. A resolved field shows where its value came from — a suggestion from the document, a value derived from the vessel, the container BIC or the B/L prefix, a workspace default, or your own search. Auto-filled is not the same as verified; check it against the evidence line.
Resolving Deliver To: company, then site
Every delivery stop uses the same card. Choose the company first. If the delivery is handled through another company, choose that optional Care Of company next. Then choose a saved delivery site owned by either company. If the address is new, the card keeps the address fields and states that the address will be added to the Deliver To company when you confirm.
- Pick the company. An unresolved Deliver To carries the label Needs owner. If the parsed name matched nothing, the helper reads “No existing Deliver To company matches this document yet. Create it or choose an existing org instead.” If several companies matched, you get “Multiple existing companies could match this Deliver To. Pick the right one before choosing a site.” and a Choose the matching Deliver To company list where each candidate has a Use action.
- Add Care Of only when needed. Care Of is optional and does not replace Deliver To. Use it when another company receives or handles the load for the Deliver To customer. The POD prints that company as C/O directly below Deliver To.
- Choose the destination. For a saved destination, use the delivery-site picker. After you select Care Of, the picker includes active saved sites owned by either Deliver To or Care Of. For a new address, keep the street and city/state/ZIP shown in the card. The card does not ask for a second site name.
- Resolve an unclear site. The picker labels itself Choose or create site and tells you which case you are in: “Similar saved site found. Choose it or create a new site.” or “Multiple saved sites could match. Choose one or create a new site.” When nothing matches a valid parsed address, the new site is staged automatically for Confirm.
“Choose the Deliver To company first.” appears only before a company is selected. After selection, the site field shows a checking state until the saved-site review finishes. If that review fails, Confirm stays blocked and the field shows an explicit error instead of silently creating a site.
The warehouse case is the two-level one people trip on: a warehouse company can own many yards and docks, and the delivery address on the document identifies the site, not the company. Conterminal treats the company as the owner and the address as a saved site beneath it, so a second delivery order to the same warehouse at a different address is a new site under the same company — not a second company.
Adding more delivery stops
In Full Review, select Add stop for each destination. Every stop can select or add a Deliver To company, an optional Care Of company, and a delivery site. Use the arrows to move any destination, including into Stop 1. The stop in the first position is the scheduling destination. The route summary updates immediately, and the empty return stays last.
- Existing company and site
- Choose an existing Deliver To company, then a saved delivery site beneath it. Confirmation reloads the active company and site before it commits, so a renamed or retired record cannot leave a stale route snapshot.
- New company or site
- Use Add as Importer / BCO or Add as Warehouse in any stop's company picker. Enter an unsaved site's address in the same stop. Conterminal resolves or creates the site when you confirm, so the draft can move without losing its company or contact details.
A route accepts 11 delivery stops total. Stops beyond the first are available only in Full Review; remove them before switching back to Express review.
Confirm stores each destination as its own delivery leg between the first delivery and the return. If dispatch work, assignments, or execution history already exists on the operation route, Conterminal refuses the rewrite instead of replacing live work.
Enter Goods and Pieces on each stop to allocate the load across destinations. Conterminal keeps that cargo with the stop when you reorder the route and prints it on that stop's POD. On a one-stop order, the original order-level cargo remains the fallback.
Open Optional stop details on any card to add a contact, phone, email, requested service date, requested time window, or delivery instructions. Those details move with the stop when you reorder the route and appear on its operation leg.
Creating a new company or site inline, and when a reason is required
You do not have to leave the screen to add a missing record. Every stop offers the same two company actions and can stage a delivery site for creation when you confirm.
A new company
Type the missing name in any Deliver To company picker, then chooseAdd as Importer / BCO or Add as Warehouse. Conterminal saves and selects the company on that stop. To use another saved company instead, keep typing in the same picker and choose its result.
A new site
Choose the company, then enter the street and city/state/ZIP. When no saved site matches, the card states that the address will be added to the selected company when you confirm. Exact matches are reused. Contact and service details stay collapsed underOptional stop details until you need them.
A reason is required only when you are creating a probable duplicate.
If the document-assisted stop uses Create new site while the resolver found a similar or ambiguous existing site, a Create reason box appears and Confirm blocks with “Enter a reason before creating a new Deliver To site.” until it has content. When there was no similar site at all, no reason is asked for. The reason is stored with the site: the helper text says “Confirm will create a new Deliver To site and save your reason with it.” That review stays attached to the same stop when you reorder the route.
The other role pickers use the same creation seam. The shipment Importer (BCO) picker, for example, carries a Create new importer (BCO) action that uses whatever you typed as the name.
Confirming
Keep reviewing while Conterminal checks tracking.
When routing details are blank, the Moved By section offers Find from tracking. Conterminal checks the selected pickup terminal adapter and the steamship-line adapter when either is available. The bottom action bar stays visible with live status, so you can keep comparing the document while the lookup runs. When it finishes, the inline Review tracking results section opens at the top of the field rail. The tracking action stays above that collapsible comparison, so Check again remains available when you collapse the results.
Lookup results can include vessel, ocean carrier, pickup terminal, voyage, container size and type, B/L, and ETA. Every candidate names its provider, whether the evidence came from a terminal or SSL, and when it was observed. Nothing is applied automatically. Choose Use tracking or Keep current for an individual result. Use N blank fields is available only for blank fields with exactly one canonical result; conflicts and values that still need a canonical match stay for manual review. The panel also names every field the lookup did not find.
The Tracking evidence panel shows the ready vessel, voyage, pickup terminal, Last Free Day, source, and freshness. All document-versus-tracking decisions appear in the same expanded review section, and required differences still need an explicit choice before Confirm.
The primary button reads Confirm DO normally, and Confirm & Continue when you came in from the review queue. On a multi-container document the action first reads Save container. Use it after checking the active container's pieces, weights, seal, PO, and other container-specific values. Conterminal advances through the selected containers; after all of them are saved, the action reads Confirm N orders. A batch confirm is all-or-nothing: if any selected order fails, none are confirmed.
- Watch the action bar. While fields are outstanding it summarizes them as, for example, “3 fields need attention.”
- Press Save container or Confirm. If anything is unresolved the screen does not submit; it shows a red banner reading “Fix 3 fields before confirming.” listing up to five issues. Each listed issue is a button that scrolls to and focuses the field.
- Fix and press Confirm again. The server re-validates independently, so a value that drifted since the page loaded is caught here rather than committed.
Confirm writes the reviewed values back onto the delivery order — container, B/L, house bill, broker reference, PO, ETA, vessel, seal, container size and type, package count, contents, and the consignee name, address, and phone. It also stores the full confirmed payload so the confirmed screen can show exactly what was committed.
Find from tracking, Check again, and the batch grid's Refresh enrichment action follow the exact LongShorty work item they start. When that work finishes, Conterminal loads the materialized tracking candidates into the same review panel. If you reload while the work is still running, the page resumes that exact refresh instead of starting a second one. The server still binds Confirm to the exact ready review shown on screen; if that review was replaced or is no longer ready, the stale submission is refused so you can review the current evidence instead.
Where you land afterwards depends on what is left to do: the proof of delivery stage if it is available, then the confirmation email stage, then the next delivery order from the same document, then the next item in your review queue, and finally the order's detail page.
Preparing tracking means Confirm succeeded.
If the order's canonical tracking timeline is still being assembled, the detail page briefly shows Preparing tracking. Leave that page open. It checks again and opens the shipment automatically when tracking is ready; you do not need to confirm the order again.
The POD stage
The proof-of-delivery stage replaces the PDF pane with the POD document itself, while the right rail switches to a read-only Confirmed DO summary — document date, issuer, container, BOL, broker reference, ETA — plus the delivery address and the route legs. When a stop has Care Of, the POD prints aC/O row directly below its Deliver To customer. The confirmed values stay in view while you print and reply.
- Check the sheet. The desktop preview shows a letter page with two identical copies of the POD stacked on it — one for the driver, one for the file.
- Select Print POD. After confirming several containers from one source document, the action reads Print N PODs and loads one merged PDF for that confirmed set. Conterminal opens a new tab that reads “Opening POD PDF...” and then loads the generated PDF.
- Select Finish to leave, or Email Update to move to the email stage. Both are also in the Actions menu, along with Open source document and Open operations detail.
Finish is the primary button here even when an email draft exists. That is deliberate: for documents that arrived by email the sender already received an automatic acknowledgment, so the update email is one click away rather than on the main path.
After confirmation, each delivery leg has its own POD controls in the shipment route. Print, upload, email routing, and Electronic POD actions target that exact stop, and the printed Goods and Pieces come from that stop. When an order has several stops, the print action becomes Print N PODs and generates one POD per stop. A POD on an earlier stop records its receipt without marking the order delivered; the final active delivery stop controls the delivered milestone.
The confirmation-email stage: draft, send, or skip
This stage only exists when the document arrived as an email attachment — there has to be a thread to reply to. If there is no draft, the email stage is unavailable and asking for it sends you back to POD.
The compose is a reply-all against the reconstructed thread: From, To and Cc as removable recipient chips, Subject, and a rich text Message. Typing pauses briefly and the draft saves itself; you will see Saving draft… in the toolbar while it does. Recipients are validated as you add them — anything that is not an email address is dropped rather than rejected loudly.
- Review the recipients. If the thread reconstruction was uncertain the stage says “Review recipients before sending.” Sending with an empty To list is refused with “Add at least one recipient before sending.”
- Send or skip. Send is the primary button; Skip sits beside it and is also available as Skip email in the Actions menu. Both close out the stage and move you along.
- Check the history. The right rail lists Emails for this document with each message's kind, status, timestamp, and recipients, or “Nothing has been emailed for this document yet.” Sent and failed messages each carry a Resend button.
When your review changed facts the sender was already told about, the draft is prefilled with the difference and the rail says: “The draft is prefilled with what changed since the confirmation email. Edit freely before sending.” The prefill never overwrites a draft you already saved or sent.
An already-sent email opens read-only with a green summary — “This confirmation email was already sent.”, or “The received confirmation was already sent.” when it was the automatic acknowledgment — and the buttons change to Back to POD and Continue to Next DO or Finish. A failed send exposes a Delivery diagnostics disclosure with the provider response.
Archiving instead of confirming
Some uploads should not be confirmed at all — a duplicate, a scan of the wrong document, a PDF that turned out to be unrelated. Open the Actions menu and choose Archive document. The item shows Archiving... while it runs, then returns you to the next item in the queue, or to the order's detail page if you were not in queue mode.
Archiving is only offered while the upload is still pending review. Attempting it later is refused in plain terms: “Confirmed DO uploads cannot be archived from this review screen.”, “This DO upload has already been superseded.”, or “This document has already been archived.”
Archiving is reversible. Reopening an archived upload gives you Unarchive document in the Actions menu, which shows Restoring... and puts the upload back into review. Confirmed and superseded uploads cannot be unarchived.
Troubleshooting
Confirm keeps blocking on a new reason each time
That is the design, not a loop. The server runs its checks in order and returns the first blocking reason it hits — availability, then container collision, then Deliver To resolution, then billing, and so on. Fixing one can expose the next. The client-side banner is more generous: it lists up to five outstanding fields at once, so work from that list before submitting.
“This PDF is for MSDU1234567, but this order is TRLU7654321. Attach it to the matching order instead.”
The document names a different container than the order you have open, usually because a multi-container PDF was split across several orders. Confirm is disabled and the banner offers a recovery button reading “Create/open matching sibling order for MSDU1234567”, which takes you to the order that PDF actually belongs to. Do not edit the container number to make the message go away.
The screen redirected before I could review it
The upload was already confirmed. Confirmed uploads do not reopen for editing; the route forwards you to the POD stage, then the email stage, then the next delivery order or back to your queue. To review what was committed, use the confirmed summary in the right rail, or open the order's detail page.
I cleared a field but the old value is still there
Blanking a field does not clear it. The write-back only carries non-empty values onto the delivery order, so an emptied field leaves whatever was already stored untouched. To change a value, type the correct one; to remove one, edit it on the order itself rather than through the confirm screen.
Nothing is editable and there is no Confirm button
The banner tells you which case it is: “This DO is already confirmed. Review the stored values here, then return to the detail page to replace it with a newer upload if needed.” or “This DO upload is no longer editable.” for a superseded or archived upload. A newer upload replaces an older one from the order's detail page, not from here.
“Saved delivery sites are still being checked.”
Wait for the site field to stop showing “Checking saved delivery sites under…” before confirming. If the check fails, use “Retry site check”; you do not need to reload the page.
I can open the screen but my confirm is rejected
Viewing and confirming have different gates. Reading is open to collaborators and to importer workspaces; confirming and archiving accept only the admin, manager, and user roles inside a trucker or forwarder workspace. Ask a workspace admin to confirm it, or to change your role.
The pickup terminal picker will not let me skip it
It is required and has no not-shown option, because the terminal decides which source LongShorty signs into to track the container. The Express review panel says so directly: “Select a terminal so LongShorty can target the right source.” If the document truly names no terminal, find it from the booking or the steamship line before confirming.