# Problèmes de suivi

> Quand Safecube ne parvient pas à suivre une expédition, la liste des expéditions et la page de détail affichent la cause, comme un numéro erroné, une compagnie maritime manquante ou une compagnie qui n'a pas encore répondu, et l'action qui la corrige.

Juste après l'ajout d'une expédition, Safecube contacte la compagnie maritime pour l'identifier et récupérer ses premiers événements. Quand cela échoue, l'expédition est bloquée : la liste des expéditions et la page de détail affichent la cause et l'action qui la débloque. La plupart des causes se corrigent en modifiant le numéro ou en choisissant la compagnie maritime ; les autres dépendent de la compagnie et ne demandent aucune action.

## Qui peut corriger une expédition bloquée

| Action | Rôle minimum |
| ------ | ------------ |
| Voir la cause d'une expédition bloquée | Viewer |
| Corriger le numéro ou choisir la compagnie maritime | Editor |
| Archiver une expédition bloquée | Editor |
| Ouvrir les réglages de notification depuis une expédition bloquée (**Notify me**, **Manage alerts**) | Admin |
| Supprimer définitivement une expédition bloquée | Admin |

Un Viewer voit l'explication d'une expédition bloquée, sans aucun bouton d'action.

## Suivre une expédition pendant que Safecube l'identifie

Pendant que Safecube récupère auprès de la compagnie maritime les premières données d'une nouvelle expédition, celle-ci est en cours d'identification :

- dans la liste des expéditions, son statut affiche **Identification**, suivi du nombre de secondes écoulées. Au-delà de 90 secondes, il affiche **Pending**, avec l'infobulle « This is taking longer than expected. Turn on notifications in your settings to be alerted as soon as the data is available. » ;
- dans le filtre **Status** de la liste, ces expéditions sont regroupées sous **Fetching data** ;
- sur la page de détail, une liste d'étapes montre la progression : **Connecting to carrier**, **Validating shipment number**, **Retrieving tracking info**, puis **Finalizing shipment**. Le titre au-dessus change avec le temps : **Fetching Shipment Details**, **Connecting to the carrier**, **Retrieving tracking events**, **Almost there — still gathering data**, et enfin **This is taking longer than usual**, avec « You can safely leave this page — we'll keep building your shipment in the background. » et un bouton **Back to shipments**.

![Page de détail du conteneur MSCU1234566 en cours d'identification : la liste d'étapes intitulée Connecting to the carrier montre Connecting to carrier terminé, Validating shipment number en cours et Retrieving tracking info en attente](https://docs.safecube.ai/media/images/shared/shipment-details--resolving.webp?v=6b789a35)

Quand l'identification se termine, la page affiche les données de l'expédition, ou la cause du blocage décrite dans « Pourquoi une expédition est bloquée » sur cette page. Quand elle dure plus longtemps que la page n'attend, la page de détail cesse de se rafraîchir et affiche **Still in progress** et « We're still building this shipment » : l'identification continue, et l'expédition est à jour quand la page est rouverte.

![Page de détail du conteneur MSCU1234566 avec le titre This is taking longer than usual, le message indiquant que la page peut être quittée, trois étapes terminées, Finalizing shipment en cours et le bouton Back to shipments](https://docs.safecube.ai/media/images/shared/shipment-details--resolving-long.webp?v=e6dec120)

## Pourquoi une expédition est bloquée

Une expédition bloquée a le statut **No data found** sur sa page de détail et dans les archives. Dans la liste des expéditions, son statut affiche la cause à la place, dans l'onglet **Warning**. Sélectionner la cause dans la colonne **Status** déplie un panneau avec une explication et les actions disponibles.

La page de détail explique la même cause dans une carte, qui se termine par « Ref: » suivi du code de la cause, à citer en contactant le support.

| Cause dans la liste | Carte de la page de détail | Code | Ce qui s'est passé | Que faire |
| ------------------- | -------------------------- | ---- | ------------------ | --------- |
| **Wrong number** | **Check the shipment number** | `WRONG_NUMBER` | La compagnie maritime, ou aucune compagnie, ne reconnaît le numéro : un caractère manque ou est faux | Corriger le numéro, comme le décrit « Corriger le numéro » sur cette page |
| **Carrier needed** | **Select the shipping line** | `WRONG_SEALINE`, `AUTO_CANT_DETECT_SEALINE` | Safecube n'a pas pu déduire la compagnie du numéro, utilisé par plusieurs compagnies, ou la compagnie indiquée ne correspond pas | Choisir la compagnie, comme le décrit « Choisir la compagnie maritime » sur cette page |
| **Awaiting carrier** | **Waiting on the carrier** | `SEALINE_NO_RESPONSE`, `SEALINE_HASNT_PROVIDE_INFO`, `SEALINE_UNDER_MAINTENANCE`, `SEALINE_TEMPORARY_DISABLED` | L'expédition est valide, mais la compagnie n'a pas répondu ou n'a encore publié aucun événement, ou elle est en maintenance ou inactive | Rien : Safecube continue d'interroger la compagnie |
| **Not trackable** | **Carrier not yet supported** | `SEALINE_NOT_SUPPORTED` | La compagnie ne publie pas de données de suivi lisibles par Safecube | Archiver l'expédition, la suivre hors de Safecube, ou demander la compagnie au support |
| **Cancelled** | **Shipment cancelled by the carrier** | `SEALINE_CANCELED_SHIPMENT` | La compagnie a annulé l'expédition de son côté : aucun événement ne sera plus publié | Archiver ou supprimer l'expédition |
| **Tracking on hold** | **Shipment data is currently unavailable** | tout autre code | La cause n'est pas encore identifiée | Rien : Safecube continue d'essayer ; contacter le support si cela dure |

Une expédition au statut **Incomplete** n'est pas bloquée : elle est suivie, mais la compagnie ne partage qu'une partie de ses données. Elle apparaît aussi dans l'onglet **Warning**, sans panneau de cause. Les statuts sont décrits dans [Statuts d'expédition](/fr/platform/container-tracking/shipping-statuses).

Des réponses courtes aux questions fréquentes sur le suivi, comme **Tracking on hold** ou une expédition sans données, sont dans la [FAQ Suivi](/fr/faq/tracking).

![Onglet Warning de la liste des expéditions avec le panneau du conteneur TGHU8830217 déplié sous son statut Carrier needed : l'explication que la compagnie n'a pas pu être déduite du numéro, et le bouton Select carrier](https://docs.safecube.ai/media/images/shared/shipments-list--untrackable-panel.webp?v=e318a3b4)

![Page de détail du conteneur bloqué TGHU8830217 avec la carte Select the shipping line, l'étiquette Action needed, le bouton Select shipping line et le code WRONG_SEALINE](https://docs.safecube.ai/media/images/shared/shipment-details--untrackable.webp?v=df27893a)

## Corriger le numéro

Une expédition bloquée avec **Wrong number** a été ajoutée avec un numéro que la compagnie maritime ne reconnaît pas. Comparez-le à la confirmation de booking ou au connaissement.

1. Ouvrez la liste des expéditions, puis l'onglet **Warning**.
2. Sélectionnez **Wrong number** dans la colonne **Status** de l'expédition, puis **Fix the number**. Depuis la page de détail, sélectionnez **Edit shipment number**.
3. Dans la boîte de dialogue **Edit shipment**, corrigez le **Shipment number**. Les espaces ne peuvent pas être saisis.
4. Sélectionnez **Edit shipment**.

Safecube recharge l'expédition avec le numéro corrigé.

## Choisir la compagnie maritime

Une expédition bloquée avec **Carrier needed** a un numéro dont Safecube ne peut pas déterminer la compagnie maritime.

1. Ouvrez la liste des expéditions, puis l'onglet **Warning**.
2. Sélectionnez **Carrier needed** dans la colonne **Status** de l'expédition, puis **Select carrier**. Depuis la page de détail, sélectionnez **Select shipping line**.
3. Dans la boîte de dialogue **Edit shipment**, choisissez la compagnie dans **Shipping line**. La compagnie d'une expédition figure sur son connaissement ou sa confirmation de booking.
4. Sélectionnez **Edit shipment**.

Safecube recharge l'expédition avec la compagnie choisie. Un conteneur en leasing a toujours besoin d'une compagnie : son préfixe désigne la société de leasing, pas la compagnie maritime.

![Boîte de dialogue Edit shipment avec TGHU8830217 dans le champ Shipment number, MSC dans le sélecteur Shipping line, et les boutons Cancel et Edit shipment](https://docs.safecube.ai/media/images/shared/modal-shipment-edit-error--default.webp?v=bd5d149f)

Quand la modification est refusée, la boîte de dialogue affiche **Edition failed** avec l'un de ces messages :

| Message | Cause |
| ------- | ----- |
| « Shipment cannot be updated » | L'expédition ne peut plus être modifiée |
| « This container number is already in use. Please enter a new one. » | Le numéro corrigé est déjà suivi dans l'espace de travail |
| « An error occurred while creating the shipment. Please check the accuracy of the information provided and try again… » | Une autre erreur |

**Update selection** ou **Retry** ramène au formulaire.

## Attendre la compagnie maritime

Une expédition bloquée avec **Awaiting carrier** dans la liste, ou **Waiting on the carrier** sur la page de détail, est valide : la compagnie maritime n'a pas encore envoyé de données de suivi. La page de détail affiche **Carrier-side** et la mention « Auto-retrying — checking every few minutes » : Safecube interroge de nouveau la compagnie automatiquement, et l'expédition ne demande aucune action. Il en va de même pour **Tracking on hold**.

![Page de détail du connaissement bloqué HLCUBSC2409731 avec la carte Waiting on the carrier, l'étiquette Carrier-side, la mention Auto-retrying — checking every few minutes et le code SEALINE_NO_RESPONSE](https://docs.safecube.ai/media/images/shared/shipment-details--carrier-wait.webp?v=02dc87f3)

Pour être prévenu de l'arrivée des données, un Admin sélectionne **Notify me** dans le panneau de la liste, qui ouvre **My notifications** dans Settings, ou **Manage alerts** sur la page de détail, qui ouvre **Alerts** dans Settings. **My notifications** est décrit dans [Notifications et rapports](/fr/platform/alerts/notifications-and-reports), et les réglages d'alertes dans [Gestion des alertes](/fr/platform/alerts/alert-management).

## Archiver ou supprimer une expédition bloquée

Une expédition **Not trackable** ou **Cancelled** ne reçoit jamais d'événement. Retirez-la des expéditions actives :

- **Archive**, dans le panneau de la liste, la déplace dans les archives (Editor et au-delà). L'archivage est décrit dans [Archivage des expéditions](/fr/platform/container-tracking/shipment-archiving).
- **Delete** dans le panneau de la liste, ou **Delete shipment** sur la page de détail, la supprime définitivement (Admin et au-delà). Un Editor voit **Delete shipment** grisé, avec « Only admins or owners can delete shipments permanently. ».

Sur la page de détail, **Carrier not yet supported** propose aussi **Contact support**, pour demander à Safecube d'ajouter la compagnie.

## Limites

- Safecube ne publie pas la fréquence à laquelle il interroge la compagnie pour une expédition en attente.
- Un Viewer ne peut pas corriger une expédition bloquée, et le panneau de la liste ne lui propose aucune action.
- Les expéditions **Not trackable** et **Cancelled** ne sont plus suivies : seule une expédition bloquée avec **Wrong number** ou **Carrier needed** se corrige.
- Le filtre **Status** de la liste n'a pas d'option pour les expéditions **Incomplete** : elles se trouvent dans l'onglet **Warning**.
