Skip to content
Documentation sections

Adding shipments

Safecube tracks a shipment from one of three references: a container number, a bill of lading number (master or house, MBL or HBL) or a booking number. Safecube detects the type of reference from the number, there is no type to choose. Shipments are added from the Home page of a workspace that has none yet, then from the Track a new shipment page, one at a time, by pasting a list or by importing a CSV file.

Who can add shipments

GestureMinimum role
Add shipments from the Track a new shipment pageEditor
Create a custom field from the Teams and custom properties panelAdmin

A Viewer who opens the Track a new shipment page is redirected to a page stating that access is forbidden. Each new shipment uses one of the workspace's shipment credits: when none is left, the creation is refused, as described in "When creation fails" on this page.

Track your first shipment

When a workspace has no shipment yet, as right after creating an account, the Home page of the Safecube platform shows a Track your first shipment card with two tabs:

  • Tracking number, to add a single shipment;
  • Upload CSV, to import several shipments from a CSV file, in the format described in "Import a CSV file" on this page.

On the Tracking number tab, the Shipment number field is required. It accepts a container number, a bill of lading (BL) number or a booking number. The Sealine field below it is labelled optional, except for leased containers, for which a carrier is required (see "Carrier detection and leased containers" on this page). The Track shipment & build my dashboard button submits the shipment.

The Home page stays available until the first shipment of the workspace is created, from any page of the platform. From then on, the Safecube home address opens the shipment list.

A user who followed a container on the Safecube public tracking tool before signing up is offered, on the Home page, the dialog Continue tracking your container?: Track it here adds that container to the workspace, Not now dismisses it.

Accept or dismiss the carrier suggestion

When Safecube recognises the carrier from the shipment number entered on the Home page, a suggestion appears under the Sealine field. It shows the carrier name, its code and the reason for the suggestion, for example "Prefix MSCU" for a container number starting with MSCU. Two buttons answer it:

  • Use fills the Sealine field with the suggested carrier;
  • Dismiss ignores the suggestion and leaves the Sealine field empty.

As long as the suggestion is neither used nor dismissed, the Track shipment & build my dashboard button is disabled and the message "Accept or dismiss the carrier suggestion to continue" is displayed under it.

Find the new shipment in the shipment list

Once the first shipment is submitted from the Home page, Safecube displays the message "Shipment created successfully." and opens the shipment list, not the shipment details. The new shipment appears there with the status Identification, followed by a counter of the seconds elapsed: Safecube is retrieving the shipment status from the carrier. The statuses a shipment takes afterwards are described in Shipping statuses, and what to do when the identification takes long or is blocked, for example after a wrong number or carrier, in Tracking issues.

Add one shipment

  1. Open the Track a new shipment page, from the New shipment button of the top bar. The Single tab is open.
  2. Enter the reference in Shipment number. Spaces cannot be typed. A warning under the field flags a container number whose length or check digit looks wrong; it does not block the creation, and it can be ignored for a bill of lading or a booking number.
  3. Optionally, choose the carrier in Sealine, by its name or its SCAC code. Safecube may suggest one, as described in "Carrier detection and leased containers" on this page.
  4. Optionally, open Teams and custom properties to assign teams, a Kanban column and custom property values to the shipment.
  5. Select Track shipment.

Safecube displays "Shipment created successfully." and opens the shipment list.

The info icon next to Shipment number opens the special formats required by a few carriers. The info icon next to Sealine opens Shipping line SCAC code, a searchable list of carriers and their SCAC codes.

Add several shipments by pasting

  1. On the Track a new shipment page, open the Multiple tab. It starts with three empty rows.
  2. Paste a list of numbers, one per line, into a row: the rows fill themselves. One paste adds up to 100 numbers; beyond that, the extra numbers are dropped and Safecube suggests the CSV import. Add shipment adds an empty row.
  3. Optionally, set the teams and custom properties of the batch. They apply to every row without its own settings; a row's own settings, under Teams and properties for this row, replace those of the batch.
  4. Answer the carrier suggestions row by row, or all at once with Accept all or Dismiss all.
  5. Select Track N shipments, where N is the number of filled rows.

When every shipment is created, Safecube opens the shipment list. Otherwise, it shows the creation report described in "Read the creation report" on this page.

Import a CSV file

  1. On the Track a new shipment page, open the Import CSV tab, or the Upload CSV tab of the Home page.
  2. Select Download template to get the file Safecube_Sample_Import_Shipments.csv.
  3. Fill one shipment per row, then drop the file or browse to it. Safecube displays the number of shipments detected.
  4. Select Upload file.

Safecube displays Creation succeeded: the file is received and Safecube gathers the shipments' data. View containers opens the shipment list.

RuleValue
File type.csv only
EncodingUTF-8
SeparatorSemicolon (;)
RowsUp to 500
HeadersshipmentNumber (container, BL or booking number), sealineCode (carrier SCAC code, such as ONEY or MAEU), groups (existing team names, several between brackets separated by |, such as [Team_1 | Team_2]). Headers are not case-sensitive.

When rows contain leased containers without a carrier, the dialog Some lines need a carrier lists them before the upload. Import N valid lines imports the other rows, Download N error lines downloads the rejected rows, and Cancel everything stops the import. To import them, add the SCAC code in the sealineCode column and import the file again.

Carrier detection and leased containers

When the Sealine field is empty, Safecube tries to recognise the carrier from the shipment number:

  • Suggestion: the carrier is shown with Use and Dismiss. The submit button stays disabled until one of them is selected. When two or three carriers are possible, Safecube lists them.
  • Conflict: when the carrier chosen does not match the number, Safecube shows "The number looks like a" followed by the detected carrier, with Keep (the carrier entered) and Replace.
  • Unknown prefix: the field can stay empty and Safecube tries an automatic detection, but filling in the carrier improves the chances of tracking.

A leased container is the exception. Its four-letter prefix names the leasing company that owns it, not the carrier operating it, so Safecube cannot track it without a carrier. The Sealine field shows Leased container — carrier unknown, with the carriers most often seen on that prefix when Safecube knows them. Submitting without a carrier opens the dialog This container needs a carrier: Add the carrier returns to the field. Once the dialog is closed, the field also shows Carrier required for this leased-fleet container. The carrier is written on the bill of lading, in the header or in the Carrier box, and on the booking confirmation sent by the freight forwarder. No credit is used until the shipment is created.

On the Multiple tab, a leased row without a carrier shows "This container needs a carrier to be tracked." and nothing is sent until every such row has a carrier.

The list of carriers and their SCAC codes is in Supported sealines.

Duplicate shipments

On the Single and Multiple tabs, Safecube warns before creating a shipment whose number is already tracked in the workspace:

  • for one shipment, This Shipment Is Already Tracked shows since when it is tracked, with View existing shipment and Track anyway;
  • for several, Duplicates Detected lists them, each with a link to the existing shipment, with Close and Track anyway.

Tracking the same number again is useless: when Track anyway is selected, Safecube normally refuses the creation and displays "Container … is already tracked in your workspace." with View shipment. The same refusal applies to the Home page, where no warning is shown before submitting.

Read the creation report

When a batch from the Multiple tab is not fully created, the Creation report dialog counts the shipments created, with warnings and failed, and lists each row with its number, its carrier code and, for a failed row, the reason. A shipment with warnings is created, but "Some custom fields could not be added." Contact us opens the support form when at least one row failed. Closing the report resets the tab to three empty rows.

When creation fails

The Creation failed dialog explains why Safecube refused a creation:

MessageCauseWhat to do
"Your free trial has ended. Subscribe now to continue creating shipments and tracking your containers."The workspace has no shipment credit leftSubscribe opens the plans page
"The container number you entered is invalid. Please ensure it follows the format: ABCD1234567."The container number is invalidCorrect the number
"Container … is already tracked in your workspace."The shipment is already trackedView shipment opens the existing shipment
"Oops! We couldn't process your file because it doesn't adhere to the required format…"The CSV file does not follow the format of "Import a CSV file" on this pageStart again from the template
"An error occurred while creating the shipment…" or "Oops, an error occurred…"Another errorCheck the information and try again, or select Contact us

How shipment credits are counted is described in Shipment billing. The end of a free trial is described in Free trial.

Limits

  • There is no internal reference field: a shipment is identified by its number only.
  • A leased container is never created without a carrier, on any tab or in a CSV file.
  • The number of shipments detected in a CSV file counts every filled row, including leased containers without a carrier and invalid numbers.
  • The duplicate warning only covers shipments already loaded in the workspace, on the Single and Multiple tabs.
  • One paste on the Multiple tab adds up to 100 numbers.