Skip to content
Documentation sections

Tracking issues

Right after a shipment is added, Safecube contacts the carrier to identify it and retrieve its first events. When that fails, the shipment is blocked: the shipment list and the shipment details page show the cause and the action that unblocks it. Most causes are fixed by correcting the number or selecting the carrier; the others depend on the carrier and need no action.

Who can fix a blocked shipment

GestureMinimum role
See the cause of a blocked shipmentViewer
Correct the number or select the carrierEditor
Archive a blocked shipmentEditor
Open the notification settings from a blocked shipment (Notify me, Manage alerts)Admin
Delete a blocked shipment permanentlyAdmin

A Viewer sees the explanation of a blocked shipment without any action button.

Follow a shipment while Safecube identifies it

While Safecube retrieves the first data of a new shipment from the carrier, the shipment is being identified:

  • in the shipment list, its status reads Identification, followed by the number of seconds elapsed. After 90 seconds, it reads Pending, with the tooltip "This is taking longer than expected. Turn on notifications in your settings to be alerted as soon as the data is available.";
  • in the Status filter of the shipment list, these shipments are grouped under Fetching data;
  • on the shipment details page, a checklist shows the progress: Connecting to carrier, Validating shipment number, Retrieving tracking info, then Finalizing shipment. The title above it changes as time passes: Fetching Shipment Details, Connecting to the carrier, Retrieving tracking events, Almost there — still gathering data, and finally This is taking longer than usual, with "You can safely leave this page — we'll keep building your shipment in the background." and a Back to shipments button.

When the identification ends, the page shows the shipment data, or the cause of the blocking described in "Why a shipment is blocked" on this page. When it takes longer than the page waits, the details page stops refreshing and shows Still in progress and "We're still building this shipment": the identification keeps running, and the shipment is up to date when the page is opened again.

Why a shipment is blocked

A blocked shipment has the status No data found on its shipment details page and in the Archives. In the shipment list, its status shows the cause instead, in the Warning tab. Selecting the cause in the Status column unfolds a panel with an explanation and the actions available.

The shipment details page explains the same cause in a card, ending with "Ref:" followed by the cause code, to quote when contacting support.

Cause in the listCard on the details pageCodeWhat happenedWhat to do
Wrong numberCheck the shipment numberWRONG_NUMBERThe carrier, or no carrier, recognises the number: a character is probably missing or wrongCorrect the number, as described in "Fix the number" on this page
Carrier neededSelect the shipping lineWRONG_SEALINE, AUTO_CANT_DETECT_SEALINESafecube could not work out the carrier from the number, which several carriers use, or the carrier set does not match itSelect the carrier, as described in "Select a carrier" on this page
Awaiting carrierWaiting on the carrierSEALINE_NO_RESPONSE, SEALINE_HASNT_PROVIDE_INFO, SEALINE_UNDER_MAINTENANCE, SEALINE_TEMPORARY_DISABLEDThe shipment is valid, but the carrier has not answered or has not published any event yet, or is under maintenance or inactiveNothing: Safecube keeps querying the carrier
Not trackableCarrier not yet supportedSEALINE_NOT_SUPPORTEDThe carrier does not publish tracking data that Safecube can readArchive the shipment, follow it outside Safecube, or ask support for the carrier
CancelledShipment cancelled by the carrierSEALINE_CANCELED_SHIPMENTThe carrier cancelled the shipment on its side: no further event will be publishedArchive or delete the shipment
Tracking on holdShipment data is currently unavailableany other codeThe cause is not identified yetNothing: Safecube keeps trying; contact support if it lasts

A shipment with the status Incomplete is not blocked: it is tracked, but the carrier shares only part of its data. It also appears in the Warning tab, without a cause panel. The statuses are described in Shipping statuses.

Short answers to frequent tracking questions, such as Tracking on hold or a shipment without data, are in the Tracking FAQ.

Fix the number

A shipment blocked with Wrong number was added with a number the carrier does not recognise. Compare it with the booking confirmation or the bill of lading.

  1. Open the shipment list, then the Warning tab.
  2. Select Wrong number in the Status column of the shipment, then Fix the number. From the shipment details page, select Edit shipment number.
  3. In the Edit shipment dialog, correct the Shipment number. Spaces cannot be typed.
  4. Select Edit shipment.

Safecube reloads the shipment with the corrected number.

Select a carrier

A shipment blocked with Carrier needed has a number whose carrier Safecube cannot determine.

  1. Open the shipment list, then the Warning tab.
  2. Select Carrier needed in the Status column of the shipment, then Select carrier. From the shipment details page, select Select shipping line.
  3. In the Edit shipment dialog, choose the carrier in Shipping line. The carrier of a shipment is written on its bill of lading or booking confirmation.
  4. Select Edit shipment.

Safecube reloads the shipment with the carrier selected. A leased container always needs a carrier: its prefix names the leasing company, not the carrier.

When the change is refused, the dialog shows Edition failed with one of these messages:

MessageCause
"Shipment cannot be updated"The shipment can no longer be changed
"This container number is already in use. Please enter a new one."The corrected number is already tracked in the workspace
"An error occurred while creating the shipment. Please check the accuracy of the information provided and try again…"Another error

Update selection or Retry returns to the form.

Wait for the carrier

A shipment blocked with Awaiting carrier in the list, or Waiting on the carrier on the shipment details page, is valid: the carrier has not sent tracking data yet. The details page shows Carrier-side and the label "Auto-retrying — checking every few minutes": Safecube queries the carrier again automatically, and the shipment needs no action. The same applies to Tracking on hold.

To be told when the data arrives, an Admin selects Notify me in the list panel, which opens My notifications in Settings, or Manage alerts on the shipment details page, which opens Alerts in Settings. My notifications is described in Notifications and reports, and alert settings in Alert management.

Archive or delete a blocked shipment

A shipment that is Not trackable or Cancelled never receives an event. Remove it from the active shipments:

  • Archive, in the list panel, moves it to the Archives (Editor and above). Archiving is described in Shipment archiving.
  • Delete in the list panel, or Delete shipment on the shipment details page, deletes it permanently (Admin and above). An Editor sees Delete shipment greyed out, with "Only admins or owners can delete shipments permanently."

On the shipment details page, Carrier not yet supported also offers Contact support, to ask Safecube to add the carrier.

Limits

  • Safecube does not publish how often it queries a carrier for a shipment that is waiting on the carrier.
  • A blocked shipment cannot be corrected by a Viewer, and the list panel shows a Viewer no action.
  • Not trackable and Cancelled shipments are not tracked again: a corrected shipment is one blocked with Wrong number or Carrier needed.
  • The Status filter of the shipment list has no option for Incomplete shipments: they are found in the Warning tab.