Request documents and prepare the SI and draft B/L¶
Guide information
Requirements
This tutorial requires the installation of the following applications/modules:
Freight Project & Operations Tasks (installed automatically once Freight Sale, Project Customization and Sales Timesheet are installed)
Freight & Document Integration (installed automatically once the two modules above are both installed). If Freight Air Management or Freight Consolidation is also installed, Freight Air - Document Integration or Freight Consolidation - Document Integration installs with it and adds its own wizards; this guide’s plain FCL export needs neither.
A shipment lives or dies on paperwork the carrier and the customer actually accept. The Shipping Instruction (SI) tells the carrier exactly how to issue the Master Bill of Lading; the draft Bill of Lading (draft B/L) is your last chance to catch a wrong container number or a misspelled consignee before it becomes a document you pay to amend. Viindoo tracks both as dated requests, each with one person responsible and a visible Approved tag, and creates the Documents workspace and the Project task behind them for you. It does not replace the checklist you keep with the customer, or the reading you still do by eye. If a term below is new to you, see the Freight forwarding glossary.
Running scenario: on the export shipment for Nhat Long Footwear (HBL
HLLHPHLAX2611-001, 2 x Container 40FT HC of footwear, Hai Phong Port to Port of Los
Angeles, carrier ONE Line, Incoterm CFR (Port of Los Angeles), Freight Prepaid, SI Cutoff
2026-11-02 17:00), Hoa (Documentation) prepares the SI and the draft B/L; Duc (Operations Manager,
Administrator group) approves both before Hoa sends anything to ONE Line.
Before you start¶
The shipment is already Confirmed - the Required Documents tab stays hidden while the shipment is still Draft.
Check container numbers (
ONEU4567895,ONEU4568124), seals and cargo particulars with the shipper before submitting the SI. You do not need to wait for Gate-in to prepare the request. If details are still provisional, confirm the carrier’s submission and amendment deadlines instead of presenting planned details as final; recheck them when stuffing is complete - see Container Execution Milestones.Hoa is in the User: All Shipments and Project: User groups - preparing a request creates a Project task, so Project access is needed too (see the user’s Freight access in Settings > Users & Companies > Users).
Duc is in the Administrator group of Logistics - the group the Freight Documents workspace gives write access to, which the Approve action needs.
Step 1: Build the checklist and request documents from the customer¶
Late paperwork from the customer is a common reason an SI misses its cutoff. Use Required Documents to keep an internal checklist of items and follow-up owners; customer requests still need to be sent through your usual external channel.
Work out what you still need from Nhat Long Footwear: the commercial invoice, the packing list, buyer information, and whether the shipment needs an Original B/L or a Telex Release (this one is released by Telex - logged in the Chatter, since there is no field for it). Email the list to Nhat Long Footwear as soon as the booking is confirmed, and chase anything still missing as the cutoff approaches. In Required Documents, add a line for each item you need to track (for example, Commercial Invoice or Packing List), then fill in Summary, Request To (an internal user), Due Date and Note. Use the specialized SI and Draft B/L actions in Step 2 for those documents.
Tip
To send a form instead of a plain email, use on the shipment to generate a blank SI template. Whatever Nhat Long Footwear sends back can later be read into the shipment with Fill a booking or shipment from a document with AI.
When the invoice and packing list arrive, check them by eye against the real container and seal numbers and the cargo description on the shipment - nothing in Viindoo compares them for you. If anything does not match, ask Nhat Long Footwear to correct it; do not silently fix it yourself.
Decide who is asked to prepare it¶
Both wizards (Step 2 and Step 5) have a Request To field. Who you put there decides who gets a reminder and whose name shows on the task.
Request To |
Use when |
What changes |
|---|---|---|
A named colleague |
Someone else has to prepare or chase this document |
The Project task is assigned to that person, and they get an upload activity with the due date |
Yourself |
You are doing it, but still want the deadline on your own task list |
The task and the activity are assigned to you instead |
Left blank |
You only want a record, with no one to remind |
The task is created with no one assigned and no activity reminds anyone |
Assign Request To to the person responsible for preparing or chasing the document. Leave it blank only when the request is a record with no follow-up owner; if ownership has not been agreed, confirm it with the Operations lead instead of assigning the task to yourself by default.
See also
the user’s Freight access in Settings > Users & Companies > Users - the groups behind Request To and Approve.
Step 2: Prepare the Shipping Instruction¶
The SI turns the checklist you just reconciled into one dated request instead of loose information in an email thread.
Open the shipment for Nhat Long Footwear (SHP/26xx/000nn), go to the Required Documents tab, and click Prepare SI. Fill in:
Summary: SI cho 2x40HC giày, VNHPH-USLAX, ONE - a one-line note for whoever opens the request; it also becomes the task’s name.
Document Name: keep the proposed Shipping Instruction - SHP/26xx/000nn.
SI Due Date: 02/11/2026 (proposed from the shipment’s SI Cutoff).
Request To: Hoa (per the decision above).
Goods Description for SI: already filled in from the shipment’s cargo lines - review it, it is not checked against the containers and seals for you.
Marks & Numbers: NHAT LONG / LAX / 2026-L1.
Click Prepare SI. Viindoo opens the new request; go back to the shipment through the breadcrumb.
Warning
SI Due Date only accepts a date - the real cutoff hour is lost. Clicking Prepare SI overwrites the shipment’s SI Cutoff (also shown on the booking) with SI Due Date at 00:00:00 UTC - for a user in Vietnam that shows as 02/11/2026 07:00:00, not the 17:00 ONE Line actually gave. Note the real 17:00 cutoff in the Chatter right away, so no one mistakes 07:00 for the carrier’s deadline. Always enter the carrier’s own cutoff date here, never an internal buffer date. An SI that reaches the carrier after its real cutoff can miss the sailing, and an amendment after the MBL is issued may incur a fee or delay release. Confirm the process, fee and timing with the carrier before sending the SI.
Tip
Step 2 is done when: the Required Documents tab shows one row tagged Shipping Instruction (SI), Request To = Hoa, Due Date = 02/11/2026, and the Chatter carries a note with the real SI Cutoff, 02/11/2026 17:00.
Step 3: Get the SI approved before it leaves the company¶
This is the last internal check before a document leaves the company - correcting a mistake here costs minutes; correcting it after ONE Line has issued the MBL costs an amendment fee and days of delay.
Hoa attaches the SI she drafted outside Viindoo to the request from . Duc then opens the same document from and clicks Approve in the Actions panel.
After Duc clicks Approve, the document gets the Approved tag (replacing any earlier status tag such as To Review), Hoa’s upload activity is marked done, and the SI’s task badge changes from Docs Missing to Docs Approved.
Note
Clicking Approve only sets the tag - nothing in Viindoo stops Hoa from emailing the SI to ONE Line before Duc has approved it (see Known limitations).
Tip
Step 3 is done when: the Shipping Instruction document reads Approved, and this is confirmed before Hoa sends anything to ONE Line in Step 4.
Step 4: Send the SI to the carrier before the cutoff¶
ONE Line’s SI Cutoff is a hard deadline for this sailing - an SI that arrives late can keep the containers off the vessel.
There is no button for this in Viindoo: Hoa emails the approved SI (or submits it through ONE Line’s own portal) before the real 17:00 cutoff on 02/11/2026, then posts “SI sent to ONE Line, [date/time]” in the shipment’s Chatter. If ONE later rolls the booking to another sailing (see Rollover and Not Loaded (Container Exception)), confirm with ONE that the SI carries over to the new voyage.
Step 5: Prepare and track the draft B/L¶
The draft B/L lets you check the details before the final MBL is issued. Amendment fees and deadlines depend on the carrier and the applicable local tariff; a correction can incur a fee even while the B/L is still a draft. Confirm the conditions with ONE Line before requesting a change.
In the same Required Documents tab, click Prepare Draft B/L. Fill in:
Summary and Document Name: keep the proposed Draft B/L and Draft B/L - SHP/26xx/000nn.
Draft B/L Due Date: 04/11/2026 - after the SI Cutoff, before the 05/11/2026 sailing.
Request To: Hoa.
B/L Remarks: FREIGHT PREPAID. NOTIFY: SAME AS CONSIGNEE.
Click Prepare Draft B/L. Unlike Prepare SI, this wizard does not overwrite any field on the shipment - it only creates the request, tagged Draft B/L, with its own task.
Tip
Step 5 is done when: the Required Documents tab includes both Shipping Instruction (SI) due 02/11/2026 and Draft B/L due 04/11/2026 - each with Request To = Hoa.
Step 6: Reconcile and approve the draft B/L¶
Complete this check before moving on to Issue an HBL or send an Arrival Notice and printing the final HBL. Catch container and spelling errors before the document is issued, and confirm any amendment fee with the carrier.
When ONE Line emails the draft B/L, Hoa uploads it to the Draft B/L request from My Documents and checks it by eye against the SI: shipper, consignee, cargo description, container and seal numbers, sailing date. If anything is wrong, she confirms the amendment deadline and any fee with ONE Line, requests the correction, and checks the revised draft. Once it matches, Duc opens the document from Shipment Documents and clicks Approve a second time.
Tip
Step 6 is done when: both rows in Required Documents carry the Approved tag, both tasks show Docs Approved, and the approved Draft B/L file is the version ONE Line confirmed, not Hoa’s earlier draft.
Known limitations¶
Step |
What Viindoo does today |
What you do instead |
|---|---|---|
Build the checklist and check documents (Step 1) |
Required Documents can track generic requests, but does not automatically send a customer-facing checklist or match returned files to the invoice/packing list; Goods Description for SI is copied from the cargo lines but never checked against the invoice, packing list, containers or seals |
Add internal request lines for invoice and packing list; send the actual request to the customer by email, and check returned documents by eye. Record the Original/Telex decision in the Chatter because there is no dedicated field. |
Request from the customer (Step 1) |
Request To only accepts an internal Viindoo user |
Send the request to the customer or shipper by email |
Prepare the SI (Step 2) |
SI Due Date only accepts a date; the SI Cutoff hour is overwritten to 00:00:00 UTC |
Write the carrier’s real cutoff hour in the Chatter and treat that note as the deadline |
Approve before sending (Step 3) |
The Approved tag is a signal - nothing stops the SI from being emailed before it is set, and no rule keeps the person who prepared a document from approving it |
Agree as a team never to send an SI before its tag reads Approved, and that only the Team lead clicks Approve |
Send / receive with the carrier (Steps 4, 6) |
Sending the SI and receiving the draft B/L are not tracked |
Log “sent” and “received” in the Chatter, with the date and time |
Compare draft B/L with the SI (Step 6) |
No tool compares the two documents |
Read both by eye |
Final approval does not block printing (Step 6) |
Docs Approved is a visible signal, not a lock on printing the HBL in Issue an HBL or send an Arrival Notice |
Agree as a team not to print the final HBL while a task still shows Docs Missing |
Troubleshooting¶
Prepare SI or Prepare Draft B/L stops immediately¶
Symptom: “Please configure a document workspace for shipment ‘…’.” appears the moment you click Prepare SI or Prepare Draft B/L, and nothing is created.
Cause: the rule that generates a Documents workspace for shipments has no active entry for this shipment’s company.
Fix: in the Documents app, check the auto-generate rule for Shipment, confirm its Company field is either blank or matches Hai Long Logistics, then run the wizard again.
The wizard will not let you continue¶
Symptom: “Please fill in SI Due Date.” (or “Please fill in Summary.” / “Please fill in Document Name.”) appears when clicking Prepare SI.
Cause: one of these three required fields was left empty.
Fix: fill in the missing field; if the real SI Cutoff is not known yet, ask the Booking Officer rather than guessing a date.
Prepare SI is rejected with an ETD error¶
Symptom: “SI Cutoff of Shipment SHP/26xx/000nn must be before ETD.”
Cause: the SI Due Date entered lands after the ETD of the shipment’s Main Carriage leg.
Fix: enter a date before ETD; if the carrier genuinely gave a cutoff after the recorded ETD, the ETD on the shipment is wrong and the Booking Officer needs to fix that first.
Duc cannot find the Approve action on the document¶
Symptom: Duc opens the Shipping Instruction or Draft B/L document, but the Actions panel has no Approve entry.
Cause: the Freight workspace only grants write access to the Administrator group of Logistics - a user outside that group sees the document read-only.
Fix: add Duc to the Administrator group of Logistics ().
See also
Related articles
Issue an HBL or send an Arrival Notice - printing the final HBL once both documents are Approved
Fill a booking or shipment from a document with AI - reading a completed SI back into the shipment
Container Execution Milestones - the Gate-in step this page checks the documents against
Optional modules