Ocean Booking Confirmation OCR Parser
Extract the routing, equipment and deadline data inside ocean booking confirmations. Capture booking numbers, carrier, vessel and voyage, ports, container requirements, cut-offs and sailing dates for downstream shipping instructions.
The booking confirmation is the first document in every ocean shipment's paper trail — and the source of truth for cut-offs, equipment and routing. GainingDocx extracts its fields so your team stops copying vessel names and cut-off dates by hand.
Parsed bookings flow straight into the rest of the pipeline: generate a Shipping Instructions draft from the booking data, then cross-check the resulting B/L against it when the carrier issues it.
No sign-up for your first document · 15–30 seconds per page
Short answer
What a booking confirmation parser extracts
A booking confirmation carries the deadlines that decide whether a container makes its vessel. Extraction captures the booking number, carrier, vessel and voyage, all routing points, the equipment committed, and every cut-off — documentation, VGM, cargo gate-in and customs — as structured dates rather than as text buried in a PDF.
- Every cut-off as a separate date field
- Equipment type and quantity committed
- Empty pickup location and validity
- Routing that later documents must match
Booking Confirmation Fields Extracted
- Booking number and carrier
- Vessel, voyage and routing
- Ports of loading and discharge
- Equipment type and quantity
- Cut-off and sailing dates printed on the confirmation
Routing and Date Validation Checks
Computed in code — the AI never does the math.
- Port names vs UN/LOCODE
- Date plausibility
- Cross-document consistency once the B/L arrives
How to Extract Ocean Booking Data
- 01
Upload or photograph the document — pages are compressed on your device.
- 02
Review the extracted fields; deterministic checks flag anything suspicious.
- 03
Export to Excel, CSV or JSON, or generate the counterpart document.
The booking confirmation is a deadline document
Everything else about a booking — the rate, the space, the equipment — is agreed before the confirmation arrives. What the confirmation adds is a set of hard deadlines, each owned by a different process, each capable of rolling the container on its own.
Missing any one of them produces the same outcome: the container does not load. And because the deadlines fall on different days and belong to different teams — documentation, warehouse, customs — the failure mode is almost always that one of them was nobody's job.
| Cut-off | What is due | Usually owned by |
|---|---|---|
| Documentation / SI cut-off | Complete shipping instructions submitted | Documentation or customer service |
| VGM cut-off | Verified Gross Mass declared per container | Warehouse or the shipper's operations |
| Cargo / gate-in cut-off | Full container physically inside the terminal | Transport and warehouse |
| Customs cut-off | Export declaration accepted | Broker or in-house customs |
| Advance manifest cut-off | Filings such as AMS or ENS where required | Carrier or forwarder, on shipper data |
| Reefer or hazardous cut-off | Special-cargo approvals and documentation | Specialist operations |
Cut-offs are per sailing, not per lane. Take them from the specific confirmation rather than from a remembered rule of thumb.
Fields extracted
- Booking number, carrier, SCAC and any service contract or quotation reference
- Vessel name, voyage number and the service or string where named
- Place of receipt, port of loading, port of discharge, place of delivery and any transhipment port, with UN/LOCODEs
- ETD, ETA and the intended sailing schedule as printed
- Every cut-off date and time, with its label as printed and the timezone where stated
- Equipment committed: quantity, size and type codes
- Empty container pickup depot, release reference and validity period
- Commodity description, expected weight and any special-cargo notation
- Freight terms and any charges quoted on the confirmation
- Contact details for the booking desk and the equipment control desk
Checks applied
- Routing points matched against the bundled UN/LOCODE dataset
- Cut-off dates checked for a plausible ordering against each other and against ETD
- A cut-off already in the past flagged prominently rather than recorded silently
- Equipment quantity and type compared against the shipping instructions when those are prepared
- Booking reference matched to any existing shipment record
- Routing compared against the Bill of Lading once issued, so a silent change is visible
The booking is the baseline for everything after it
Once the booking is a structured record, every later document can be compared against it. A Bill of Lading whose vessel, voyage or discharge port differs from the booking is either an amendment somebody agreed or a change nobody noticed — and telling those apart is the entire value of keeping the baseline.
Working from an extracted booking
- 1Confirm the routing and equipment match what you actually requested before doing anything else.
- 2Put every cut-off into the shipment record and work backwards from the earliest, not from the sailing date.
- 3Confirm who owns each cut-off, because they belong to different teams and an unowned deadline is a missed one.
- 4Arrange empty pickup inside the release validity — a lapsed release means a new one and a lost day.
- 5Prepare shipping instructions from the booking data rather than from a previous shipment.
- 6Reconcile the Bill of Lading draft against the booking when it arrives, field by field.
Common problems on booking confirmations
- Cut-off times stated without a timezone, on a booking that spans several
- A vessel or voyage change issued as an amended confirmation that reads almost identically to the original
- Equipment type confirmed as standard when a high cube was requested, or the reverse
- Empty release validity shorter than the loading schedule allows
- Transhipment introduced or removed without the routing being flagged as changed
- Cut-offs brought forward at short notice around holidays and blank sailings
- Commodity description on the booking that will not support the goods description on the B/L
Try it on your own document — free, no sign-up
Start parsingBooking Confirmation OCR FAQ
What teams ask most often before putting booking confirmation parser output into a customs filing, a payment run or a downstream system.
What is a booking confirmation?
The carrier's confirmation that space and equipment have been allocated for a shipment on a specific sailing. It carries the booking number, vessel and voyage, routing, equipment committed, empty pickup details and — most importantly — the cut-off deadlines for documentation, VGM, cargo gate-in and customs.
Which cut-offs matter and how do they differ?
The documentation or SI cut-off is when complete shipping instructions must reach the carrier. The VGM cut-off is when the Verified Gross Mass declaration is due. The cargo or gate-in cut-off is when the full container must be inside the terminal. There is usually a separate customs cut-off, and on some trades an advance manifest cut-off. They fall on different days, belong to different teams, and any one of them can roll the container.
Why extract cut-offs rather than just reading them?
Because a date in a PDF is not a deadline anyone can see. As structured fields on the shipment record, cut-offs become visible to whoever is working the shipment and can be surfaced before they pass. The common failure is not that someone read the deadline wrong — it is that the deadline belonged to nobody.
Does the parser handle amended booking confirmations?
Yes, and this is one of the more valuable cases. Amended confirmations frequently look almost identical to the original, with a changed vessel, voyage or cut-off buried in an otherwise unchanged document. Extracting both and comparing them makes the change explicit rather than leaving it to be spotted by eye.
What is extracted about equipment?
The quantity, size and type codes committed, the empty pickup depot, the release reference and its validity period. The type code matters: a booking confirming standard 40ft equipment against a request for high cubes is a problem that surfaces at loading if it is not caught on the confirmation.
Can the booking be compared against the Bill of Lading?
Yes, and it should be. Grouping both into one shipment record compares vessel, voyage, all four routing points, equipment and references. A discharge port or vessel that differs between the two is either an amendment somebody agreed or a change nobody noticed, and distinguishing those is exactly why the baseline is worth keeping.
Are cut-off timezones captured?
Where they are stated, yes. Where they are not — which is common — the time is recorded as printed and the ambiguity is left visible rather than resolved by assumption. A cut-off stated as '18:00' on a booking involving three timezones is a genuine risk, and inventing a timezone would hide it.
Does the parser work with forwarder booking notes as well as carrier confirmations?
Yes. Forwarder and NVOCC booking notes carry the same information in more variable layouts, frequently as formatted email rather than a structured document. They extract into the same field model, with unlabelled or ambiguous references surfaced for review rather than assigned by guesswork.
What happens if a cut-off has already passed when the document is extracted?
It is flagged prominently rather than recorded as an ordinary date. A booking confirmation that arrives after one of its own cut-offs has passed is not unusual — amended confirmations and late releases both produce it — and it needs immediate attention rather than filing.
Can I use the booking data to prepare shipping instructions?
Yes, and it is the right place to start. Preparing instructions from the booking rather than from a previous shipment is what prevents stale vessel names, old container numbers and superseded consignees reaching a live transport document. Reviewed booking data can be reused directly into an instruction draft.
Does it capture the transhipment port?
Where the confirmation states one, yes. Transhipment materially affects transit time and risk, and a routing that gains or loses a transhipment between the booking and the Bill of Lading is a change worth noticing — particularly on lanes where the transhipment port has its own congestion or documentary requirements.
How does this help with blank sailings and schedule changes?
It does not predict them, but it makes them visible faster. When an amended confirmation arrives, comparing it against the stored original shows exactly what moved — vessel, voyage, ETD, or a cut-off brought forward — instead of requiring someone to read two near-identical PDFs side by side under time pressure.
Can I turn a booking into Shipping Instructions?
Yes — the generator maps parties, routing and equipment into an SI draft you edit and download as PDF.
Will it read cut-off dates?
Dates are extracted exactly as printed and checked for plausibility. Ambiguous formats are parsed day-first, the dominant convention on ocean documents.
What if my confirmation is an email screenshot?
Screenshots parse fine — compress happens automatically and the parser reads rendered text from images.
How much does it cost?
Start with 20 documents each month on Free. Pro includes 500 documents for one operator, while Team includes a five-seat shared workspace and 2,000 pooled documents. Both paid plans are monthly and managed through Paddle.
Related tools, templates and guides
- Shipping instructions templatePrepare instructions from the booking rather than from last month's file.
- Bill of Lading parserCompare the issued transport document back against the booking baseline.
- UN/LOCODE port lookupConfirm the routing points named on the confirmation.
- Shipment document matchingTrack routing and equipment changes across the whole document set.