Notre API de suivi répond à TGBU6232252 par invalid_number. Remplacez le dernier chiffre par 1 et TGBU6232251 renvoie un voyage en cours de Nhava Sheva vers Long Beach. Même préfixe. Un tracker avec un seul message d’erreur afficherait « conteneur introuvable » pour les deux, et pour beaucoup d’autres cas aussi.
Notre API de suivi m’a permis de compter les autres. Le 8 novembre 2026, j’ai extrait 4,000 références suivies d’un seul compte. Parmi elles, 1,026 étaient au statut unknown, et pour 1,011 le système avait enregistré un motif. Sept motifs en couvrent 951. 58 autres références portent un marqueur différent, no_data, et 2 de plus une variante non confirmée du premier groupe. Je les laisse de côté. Les proportions décrivent ce lot. Il contient quelques entrées de test, des identifiants comme ZZ0. Il ne dit rien de l’ensemble du secteur.
Notre premier essai a produit exactement le message du titre. Nous avons appelé le point d’accès de recherche avec le numéro dans une query string et obtenu Container not found pour tous les numéros, y compris celui qui se suit sans problème. Le point d’accès veut l’identifiant dans le chemin. Même appel, numéro dans le chemin, et ça a marché. Un « introuvable » peut donc vouloir dire que le conteneur n’existe pas, que la question est partie au mauvais endroit, ou que le conteneur existe et que personne ne le déclare. Les groupes ci-dessous vont du plus grand au plus petit.
L’armateur n’a aucune trace du conteneur (369 sur 1,011)
TFLU4505062 a renvoyé « no results found at carrier side ». L’armateur était Transfar Shipping. UETU3269340 a eu la même réponse. Son propriétaire est UES Investment. Asian Express Shipping (Hong Kong) le loue. TCKU3442774, propriété de Triton et marqué off lease, est revenu avec une liste d’événements vide et le statut de suivi not_found.
Ce groupe représente 36.5% du lot. L’API ne donne que le code de motif carrier_no_record et aucune cause. Le code ne dit pas pourquoi, voici donc mes hypothèses : une boîte réservée mais pas encore entrée au terminal (gate-in) n’a aucun événement, ou elle a été suivie chez le mauvais armateur. Les pages propriétaire de TCKU et UETU nomment les loueurs, Triton et UES. Le locataire de UETU3269340 vient de l’enregistrement du tracker. Ce sont l’armateur et non le loueur qui déclarent les mouvements d’une boîte, donc pour UETU3269340 la question sur la réservation et le gate-in va à l’armateur ou au transitaire. TCKU3442774 est marqué off lease, il se peut donc qu’aucun armateur ne soit concerné.
La boîte est louée et le tracker ne sait pas quel armateur l’a (222, 22%)
TGHU3855882 passe le chiffre de contrôle. Le préfixe appartient à Textainer, une société de location, et l’enregistrement montre la boîte louée à un armateur noté DOLPHIN SHPG. La recherche a répondu REFERENCE_NOT_RESOLVABLE. Motif : leased_needs_reference. Aucun armateur rattaché.
Comparez avec TGBU6232251. Aussi Textainer. Aussi en location. Là, la recherche côté loueur a associé la boîte à KMTC (l’enregistrement marque la source de l’armateur comme lessor), et l’API a renvoyé le trajet : gate-out à Nhava Sheva le 19 septembre, chargé sur XIN CHANG SHU le 24 septembre (UTC), déchargé à Busan (KRPUS) le 28 octobre, statut en transbordement, ETA à Long Beach le 6 décembre. Deux locations Textainer, deux réponses.
Pourquoi le propriétaire et l’armateur sont deux sociétés différentes, c’est expliqué dans recherche par préfixe de conteneur. Pour une boîte louée, la clé la plus fiable est le connaissement ou le numéro de réservation de l’armateur, puisque ce sont l’armateur et non Textainer qui déclarent les mouvements. C’est ce que conseillent nos pages TGHU et TGBU, et le transitaire a ce numéro.
Le tracker ne peut pas identifier l’armateur (213, 21%)
GATU1284385 a un chiffre de contrôle correct (5). L’enregistrement n’a ni propriétaire, ni loueur, ni armateur. Le préfixe n’est pas anonyme. L’alerte sectorielle du BIC de 2016, qui listait les propriétaires des boîtes précédemment louées à Hanjin, nomme GATU comme préfixe de Textainer, le même loueur que TGHU et TGBU plus haut. Cette liste ne couvre que les loueurs de Hanjin, et des préfixes peuvent avoir changé de mains depuis 2016. Notre référence des préfixes de conteneurs n’a pas de page GATU, et l’enregistrement du tracker n’a pas de propriétaire pour lui.
Une autre erreur de notre API donnait un conseil qui s’applique probablement ici aussi : « Please repeat the request specifying the shipping line SCAC code. » Elle est apparue quand un numéro avec trait d’union n’a pas pu être rapproché, et nous ne l’avons pas testée sur GATU1284385. Certains armateurs n’ont pas de code SCAC dans l’annuaire, mais la liste des codes SCAC affiche le vôtre s’il en a un. Indiquez l’armateur dans le champ Carrier du tracker. Il pourra ainsi éviter de deviner.
L’armateur est connu et ne dit rien (100, 9.9%)
CAIU7958630 a été ajouté le 5 novembre avec l’armateur défini par l’utilisateur comme CMA CGM. Le loueur, CAI, indique la boîte en location chez CMA CGM, l’association semble donc correcte. La dernière interrogation, à 03:02 UTC le 8 novembre, ne trouvait toujours rien. Motif : line_no_info.
La question est partie au bon endroit et revenue vide. Ouvrez le site de l’armateur. Essayez-y le même numéro. Puis essayez le connaissement. La page CMA CGM indique son code SCAC (CMDU) et les préfixes par lesquels commencent ses boîtes (CMAU, CMDU, CMNU), ce qui permet de vérifier que vous interrogez le bon armateur. Si le site de l’armateur est vide lui aussi, appelez le transitaire.
Seul un ancien voyage est visible (21)
SEGU1112302 est rattaché à COSCO et porte le motif previous_trip_only depuis le 3 novembre. TEXU2209771 a le même motif, posé le 1er novembre, et son enregistrement montre toujours un navire nommé KUO LUNG et une ETA du 27 juillet 2026. La dernière interrogation date du 7 novembre.
Un même conteneur fait de nombreux voyages sous un seul numéro. Une recherche par le seul numéro peut tomber sur le voyage précédent. Les données ne donnent aucune cause à l’absence du nouveau voyage. Quand vous attendez un nouvel envoi, suivez la nouvelle réservation ou le nouveau connaissement. La page COSCO indique son code SCAC (COSU).
Le numéro est faux (20)
TGBU6232252 est revenu avec invalid_number. Pourquoi ? Le chiffre de contrôle est le onzième caractère. Il se calcule à partir des dix premiers. Chaque lettre prend une valeur qui commence à 10 pour A en sautant les multiples de 11, chaque position est pondérée par une puissance de deux à partir de 2⁰, et la somme est divisée par 11, un reste de 10 comptant pour 0, comme l’expose la norme ISO 6346. Pour TGBU623225, la somme est 4,049, et 4,049 modulo 11 vaut 1. TGBU6232251 est donc valide. TGBU6232252 ne l’est pas. Le calculateur de chiffre de contrôle du BIC calcule le chiffre pour un code propriétaire et un numéro de série que vous lui donnez.
Le numéro invalide a mis 46 secondes à obtenir sa réponse au premier appel. La répétition a pris 0.6 seconde. Un mauvais chiffre n’obtient pas toujours un non rapide.
Le format est l’autre moitié du problème. tgbu6232251 et TGBU 6232251 ont tous deux trouvé la boîte, alors que TGBU-6232251 avec un trait d’union est revenu en « could not find tracking data ». Copiez le numéro depuis la porte ou le connaissement. Attention au O contre 0 et au I contre 1. Faites cette vérification en premier. Elle prend une minute. Lisez ensuite la page du préfixe pour voir si la boîte est louée.
Le navire n’a pas encore de nom (6)
TRDU9288422 a été ajouté le 18 septembre. Le motif awaiting_vessel_tbn est là depuis le 21 septembre. TBN signifie « to be nominated » (à désigner), donc aucun navire n’a encore été nommé. C’est tout ce que dit le code. Quand je l’ai interrogé, l’appel est resté bloqué 45 secondes et a renvoyé STILL_RESOLVING, un 202 avec l’instruction de réessayer dans 60 secondes.
Au 8 novembre, le motif avait 48 jours. Les données ne disent pas à partir de quand c’est trop long, demandez donc au transitaire la date de désignation. En attendant, les horaires de départ montrent quels navires desservent la ligne. Vous avez reçu un 202 ? Attendez les 60 secondes. Pour une recherche propre, collez le numéro dans le tracker Navo et ajoutez l’armateur si vous le connaissez. Le même poste de travail propose des tarifs de fret maritime et un calculateur de chargement. Une équipe qui suit beaucoup de boîtes à la main peut confier la surveillance à un agent Nav ou à l’un des assistants IA, et Navo Mesh est une place d’échange de tâches pour la logistique. Les questions passent par la page de contact.
Questions fréquentes
Pourquoi mon tracker indique-t-il conteneur introuvable pour un numéro qui semble valide ?
Un numéro peut passer le chiffre de contrôle et ne rien renvoyer. Dans notre extraction du 8 novembre 2026, la cause la plus fréquente était que l'armateur n'avait aucune trace de la boîte (369 sur 1,011), suivie des boîtes louées dont l'armateur était inconnu (222). Confirmez la réservation auprès de votre transitaire.
Combien de temps attendre avant de décider qu'un numéro de conteneur est faux ?
Pas longtemps. Le chiffre de contrôle vous dit en une minute si le numéro peut exister. S'il passe, l'attente dépend de l'expédition : avant le gate-in ou la désignation du navire, il peut n'y avoir aucun événement. Une boîte de nos données a porté un motif de désignation de navire pendant 48 jours.
Puis-je suivre par connaissement ou numéro de réservation plutôt que par numéro de conteneur ?
Oui, et pour les boîtes louées c'est généralement la meilleure clé. Notre recherche accepte un numéro de conteneur, un connaissement ou un numéro de réservation. L'armateur déclare les mouvements sous sa propre référence, donc un numéro de réservation oriente le tracker vers le bon système.