# Tracking issues

> When Safecube cannot track a shipment, the shipment list and the shipment details page show the cause, such as a wrong number, a missing carrier or a carrier that has not answered yet, and the action that fixes it.

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

| Gesture | Minimum role |
| ------- | ------------ |
| See the cause of a blocked shipment | Viewer |
| Correct the number or select the carrier | Editor |
| Archive a blocked shipment | Editor |
| Open the notification settings from a blocked shipment (**Notify me**, **Manage alerts**) | Admin |
| Delete a blocked shipment permanently | Admin |

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.

![Shipment details page of container MSCU1234566 being identified: the checklist titled Connecting to the carrier shows Connecting to carrier done, Validating shipment number in progress and Retrieving tracking info pending](https://docs.safecube.ai/media/images/shared/shipment-details--resolving.webp?v=6b789a35)

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.

![Shipment details page of container MSCU1234566 with the title This is taking longer than usual, the message that the page can be left safely, three checklist steps done, Finalizing shipment in progress and the Back to shipments button](https://docs.safecube.ai/media/images/shared/shipment-details--resolving-long.webp?v=e6dec120)

## 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 list | Card on the details page | Code | What happened | What to do |
| ----------------- | ------------------------ | ---- | ------------- | ---------- |
| **Wrong number** | **Check the shipment number** | `WRONG_NUMBER` | The carrier, or no carrier, recognises the number: a character is probably missing or wrong | Correct the number, as described in "Fix the number" on this page |
| **Carrier needed** | **Select the shipping line** | `WRONG_SEALINE`, `AUTO_CANT_DETECT_SEALINE` | Safecube could not work out the carrier from the number, which several carriers use, or the carrier set does not match it | Select the carrier, as described in "Select a carrier" on this page |
| **Awaiting carrier** | **Waiting on the carrier** | `SEALINE_NO_RESPONSE`, `SEALINE_HASNT_PROVIDE_INFO`, `SEALINE_UNDER_MAINTENANCE`, `SEALINE_TEMPORARY_DISABLED` | The shipment is valid, but the carrier has not answered or has not published any event yet, or is under maintenance or inactive | Nothing: Safecube keeps querying the carrier |
| **Not trackable** | **Carrier not yet supported** | `SEALINE_NOT_SUPPORTED` | The carrier does not publish tracking data that Safecube can read | Archive the shipment, follow it outside Safecube, or ask support for the carrier |
| **Cancelled** | **Shipment cancelled by the carrier** | `SEALINE_CANCELED_SHIPMENT` | The carrier cancelled the shipment on its side: no further event will be published | Archive or delete the shipment |
| **Tracking on hold** | **Shipment data is currently unavailable** | any other code | The cause is not identified yet | Nothing: 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](/en/platform/container-tracking/shipping-statuses).

Short answers to frequent tracking questions, such as **Tracking on hold** or a shipment without data, are in the [Tracking FAQ](/en/faq/tracking).

![Warning tab of the shipment list with the panel of container TGHU8830217 unfolded under its Carrier needed status: the explanation that the shipping line could not be worked out from the number, and the Select carrier button](https://docs.safecube.ai/media/images/shared/shipments-list--untrackable-panel.webp?v=e318a3b4)

![Shipment details page of blocked container TGHU8830217 with the card Select the shipping line, the Action needed label, the Select shipping line button and the code WRONG_SEALINE](https://docs.safecube.ai/media/images/shared/shipment-details--untrackable.webp?v=df27893a)

## 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.

![Edit shipment dialog with TGHU8830217 in the Shipment number field, MSC in the Shipping line selector, and the Cancel and Edit shipment buttons](https://docs.safecube.ai/media/images/shared/modal-shipment-edit-error--default.webp?v=bd5d149f)

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

| Message | Cause |
| ------- | ----- |
| "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**.

![Shipment details page of blocked bill of lading HLCUBSC2409731 with the card Waiting on the carrier, the Carrier-side label, the Auto-retrying — checking every few minutes label and the code SEALINE_NO_RESPONSE](https://docs.safecube.ai/media/images/shared/shipment-details--carrier-wait.webp?v=02dc87f3)

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](/en/platform/alerts/notifications-and-reports), and alert settings in [Alert management](/en/platform/alerts/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](/en/platform/container-tracking/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.
