# Ajouter des expéditions

> Les expéditions s'ajoutent dans Safecube depuis la page d'accueil d'un nouvel espace de travail ou depuis la page Track a new shipment, une par une, en collant une liste ou en important un fichier CSV, à partir d'un numéro de conteneur, de connaissement ou de booking.

Safecube suit une expédition à partir de l'une de ces trois références : un numéro de conteneur, un numéro de connaissement (master ou house, MBL ou HBL) ou un numéro de booking. Safecube détecte le type de référence à partir du numéro, il n'y a pas de type à choisir. Les expéditions s'ajoutent depuis la page d'accueil d'un espace de travail qui n'en a pas encore, puis depuis la page **Track a new shipment**, une par une, en collant une liste ou en important un fichier CSV.

## Qui peut ajouter des expéditions

| Action | Rôle minimum |
| ------ | ------------ |
| Ajouter des expéditions depuis la page **Track a new shipment** | Editor |
| Créer un champ personnalisé depuis le panneau **Teams and custom properties** | Admin |

Un Viewer qui ouvre la page **Track a new shipment** est redirigé vers une page indiquant que l'accès est interdit. Chaque nouvelle expédition consomme un des crédits d'expédition de l'espace de travail : quand il n'en reste plus, la création est refusée, comme le décrit « En cas d'échec de la création » sur cette page.

## Suivre votre première expédition

Tant qu'un espace de travail n'a aucune expédition, comme juste après la [création du compte](/fr/platform/getting-started/creating-an-account), la page d'accueil (Home) de la plateforme Safecube affiche une carte **Track your first shipment** à deux onglets :

- **Tracking number**, pour ajouter une seule expédition ;
- **Upload CSV**, pour importer plusieurs expéditions depuis un fichier CSV, au format décrit dans « Importer un fichier CSV » sur cette page.

Sur l'onglet **Tracking number**, le champ **Shipment number** est obligatoire. Il accepte un numéro de conteneur, de connaissement (BL) ou de booking. Le champ **Sealine** en dessous est indiqué comme facultatif, sauf pour les conteneurs en leasing, pour lesquels une compagnie maritime est obligatoire (voir « Détection de la compagnie maritime et conteneurs en leasing » sur cette page). Le bouton **Track shipment & build my dashboard** envoie l'expédition.

![Page d'accueil d'un espace de travail sans expédition : carte Track your first shipment avec les onglets Tracking number et Upload CSV, les champs Shipment number et Sealine, et le bouton Track shipment & build my dashboard](https://docs.safecube.ai/media/images/shared/home--default.webp?v=8af02c03)

La page d'accueil reste disponible jusqu'à la création de la première expédition de l'espace de travail, quelle que soit la page de la plateforme utilisée. Ensuite, l'adresse d'accueil de Safecube ouvre la liste des expéditions.

Un utilisateur qui suivait un conteneur sur l'outil de suivi public de Safecube avant de s'inscrire se voit proposer, sur la page d'accueil, la fenêtre **Continue tracking your container?** : **Track it here** ajoute ce conteneur à l'espace de travail, **Not now** l'écarte.

### Accepter ou écarter la suggestion de compagnie maritime

Quand Safecube reconnaît la compagnie maritime à partir du numéro saisi sur la page d'accueil, une suggestion apparaît sous le champ **Sealine**. Elle indique le nom de la compagnie, son code et la raison de la suggestion, par exemple « Prefix MSCU » pour un numéro de conteneur qui commence par MSCU. Deux boutons y répondent :

- **Use** remplit le champ Sealine avec la compagnie suggérée ;
- **Dismiss** ignore la suggestion et laisse le champ Sealine vide.

Tant que la suggestion n'est ni utilisée ni écartée, le bouton **Track shipment & build my dashboard** est désactivé et le message « Accept or dismiss the carrier suggestion to continue » s'affiche en dessous.

![Suggestion de compagnie maritime sous le champ Sealine de la page d'accueil : MSC avec la raison Prefix MSCU, les boutons Dismiss et Use mis en évidence, et le bouton Track shipment & build my dashboard désactivé au-dessus du message Accept or dismiss the carrier suggestion to continue](https://docs.safecube.ai/media/images/specific/getting-started/sealine-suggestion.webp?v=10476331)

### Retrouver la nouvelle expédition dans la liste

Une fois la première expédition envoyée depuis la page d'accueil, Safecube affiche le message « Shipment created successfully. » et ouvre la [liste des expéditions](/fr/platform/shipment-views/shipment-list), pas le détail de l'expédition. La nouvelle expédition y apparaît avec le statut **Identification**, suivi d'un compteur des secondes écoulées : Safecube récupère le statut de l'expédition auprès de la compagnie maritime. Les statuts que prend ensuite une expédition sont décrits dans [Statuts d'expédition](/fr/platform/container-tracking/shipping-statuses), et la marche à suivre quand l'identification dure ou se bloque, par exemple après un numéro ou une compagnie erronés, dans [Problèmes de suivi](/fr/platform/container-tracking/tracking-issues).

![Liste des expéditions avec une expédition, le conteneur MSCU1234566, dont le statut indique Identification · 1 s, et la confirmation Shipment created successfully](https://docs.safecube.ai/media/images/shared/shipments-list--resolving-pill.webp?v=fe30dfdf)

## Ajouter une expédition

1. Ouvrez la page [Track a new shipment](https://app.safecube.ai/shipments/new), depuis le bouton **New shipment** de la barre du haut. L'onglet **Single** est ouvert.
2. Saisissez la référence dans **Shipment number**. Les espaces ne peuvent pas être saisis. Un avertissement sous le champ signale un numéro de conteneur dont la longueur ou le chiffre de contrôle semble faux ; il ne bloque pas la création, et peut être ignoré pour un numéro de connaissement ou de booking.
3. Si vous le souhaitez, choisissez la compagnie maritime dans **Sealine**, par son nom ou son code SCAC. Safecube peut en suggérer une, comme le décrit « Détection de la compagnie maritime et conteneurs en leasing » sur cette page.
4. Si vous le souhaitez, ouvrez **Teams and custom properties** pour affecter à l'expédition des équipes, une colonne Kanban et des valeurs de propriétés personnalisées.
5. Sélectionnez **Track shipment**.

Safecube affiche « Shipment created successfully. » et ouvre la liste des expéditions.

L'icône d'information à côté de **Shipment number** présente les formats spéciaux exigés par quelques compagnies maritimes. L'icône d'information à côté de **Sealine** ouvre **Shipping line SCAC code**, une liste des compagnies maritimes et de leurs codes SCAC, avec une recherche.

![Onglet Single de la page Track a new shipment avec les champs Shipment number et Sealine et le panneau Teams and custom properties ouvert](https://docs.safecube.ai/media/images/shared/shipment-create--single.webp?v=69591cda)

## Ajouter plusieurs expéditions en collant une liste

1. Sur la page **Track a new shipment**, ouvrez l'onglet **Multiple**. Il démarre avec trois lignes vides.
2. Collez une liste de numéros, un par ligne, dans une ligne : les lignes se remplissent seules. Un collage ajoute au plus 100 numéros ; au-delà, les numéros en trop sont écartés et Safecube propose l'import CSV. **Add shipment** ajoute une ligne vide.
3. Si vous le souhaitez, réglez les équipes et les propriétés personnalisées du lot. Elles s'appliquent à chaque ligne sans réglage propre ; les réglages propres d'une ligne, sous **Teams and properties for this row**, remplacent ceux du lot.
4. Répondez aux suggestions de compagnie maritime ligne par ligne, ou toutes à la fois avec **Accept all** ou **Dismiss all**.
5. Sélectionnez **Track N shipments**, où N est le nombre de lignes remplies.

Quand toutes les expéditions sont créées, Safecube ouvre la liste des expéditions. Sinon, il affiche le rapport de création décrit dans « Lire le rapport de création » sur cette page.

![Onglet Multiple avec trois numéros de conteneurs et leurs compagnies, et le bouton Track 3 shipments](https://docs.safecube.ai/media/images/shared/shipment-create--multiple.webp?v=b859b0e0)

## Importer un fichier CSV

1. Sur la page **Track a new shipment**, ouvrez l'onglet **Import CSV**, ou l'onglet **Upload CSV** de la page d'accueil.
2. Sélectionnez **Download template** pour obtenir le fichier `Safecube_Sample_Import_Shipments.csv`.
3. Remplissez une expédition par ligne, puis déposez le fichier ou parcourez vos dossiers. Safecube affiche le nombre d'expéditions détectées.
4. Sélectionnez **Upload file**.

Safecube affiche **Creation succeeded** : le fichier est reçu et Safecube rassemble les données des expéditions. **View containers** ouvre la liste des expéditions.

| Règle | Valeur |
| ----- | ------ |
| Type de fichier | `.csv` uniquement |
| Encodage | UTF-8 |
| Séparateur | Point-virgule (`;`) |
| Lignes | 500 au plus |
| En-têtes | `shipmentNumber` (numéro de conteneur, de BL ou de booking), `sealineCode` (code SCAC de la compagnie maritime, comme ONEY ou MAEU), `groups` (noms d'équipes existantes, plusieurs entre crochets séparés par `\|`, comme `[Team_1 \| Team_2]`). Les en-têtes ne sont pas sensibles à la casse. |

Quand des lignes contiennent des conteneurs en leasing sans compagnie maritime, la fenêtre **Some lines need a carrier** les liste avant l'envoi. **Import N valid lines** importe les autres lignes, **Download N error lines** télécharge les lignes rejetées, et **Cancel everything** arrête l'import. Pour les importer, ajoutez le code SCAC dans la colonne `sealineCode` et importez de nouveau le fichier.

## Détection de la compagnie maritime et conteneurs en leasing

Quand le champ **Sealine** est vide, Safecube essaie de reconnaître la compagnie maritime à partir du numéro d'expédition :

- **Suggestion** : la compagnie s'affiche avec **Use** et **Dismiss**. Le bouton d'envoi reste désactivé tant que l'un des deux n'est pas sélectionné. Quand deux ou trois compagnies sont possibles, Safecube les liste.
- **Conflit** : quand la compagnie choisie ne correspond pas au numéro, Safecube affiche « The number looks like a » suivi de la compagnie détectée, avec **Keep** (la compagnie saisie) et **Replace**.
- **Préfixe inconnu** : le champ peut rester vide et Safecube tente une détection automatique, mais renseigner la compagnie améliore les chances de suivi.

Le conteneur en leasing fait exception. Son préfixe de quatre lettres désigne la société de leasing qui le possède, pas la compagnie maritime qui l'opère : Safecube ne peut donc pas le suivre sans compagnie maritime. Le champ **Sealine** affiche **Leased container — carrier unknown**, avec les compagnies les plus souvent vues sur ce préfixe quand Safecube les connaît. Un envoi sans compagnie ouvre la fenêtre **This container needs a carrier** : **Add the carrier** ramène au champ. Une fois la fenêtre fermée, le champ affiche aussi **Carrier required for this leased-fleet container**. La compagnie maritime figure sur le connaissement, dans l'en-tête ou dans la case Carrier, et sur la confirmation de booking envoyée par le transitaire. Aucun crédit n'est consommé avant la création de l'expédition.

Sur l'onglet **Multiple**, une ligne en leasing sans compagnie affiche « This container needs a carrier to be tracked. » et rien n'est envoyé tant que chacune de ces lignes n'a pas de compagnie.

![Champ Sealine d'un conteneur en leasing affichant Carrier required for this leased-fleet container au-dessus de la carte Leased container — carrier unknown, avec les trois compagnies les plus souvent vues sur son préfixe](https://docs.safecube.ai/media/images/shared/shipment-create--leasing-blocked.webp?v=9a17097f)

![Fenêtre This container needs a carrier expliquant que le préfixe désigne une société de leasing, avec les compagnies les plus souvent vues sur ce préfixe et les boutons Cancel et Add the carrier](https://docs.safecube.ai/media/images/shared/modal-sealine-blocked--default.webp?v=76b4abf7)

La liste des compagnies maritimes et de leurs codes SCAC figure dans [Compagnies maritimes supportées](/fr/platform/getting-started/supported-sealines).

## Expéditions en double

Sur les onglets **Single** et **Multiple**, Safecube avertit avant de créer une expédition dont le numéro est déjà suivi dans l'espace de travail :

- pour une expédition, **This Shipment Is Already Tracked** indique depuis quand elle est suivie, avec **View existing shipment** et **Track anyway** ;
- pour plusieurs, **Duplicates Detected** les liste, chacune avec un lien vers l'expédition existante, avec **Close** et **Track anyway**.

Suivre de nouveau le même numéro est inutile : quand **Track anyway** est sélectionné, Safecube refuse normalement la création et affiche « Container … is already tracked in your workspace. » avec **View shipment**. Le même refus s'applique sur la page d'accueil, où aucun avertissement ne s'affiche avant l'envoi.

## Lire le rapport de création

Quand un lot de l'onglet **Multiple** n'est pas entièrement créé, la fenêtre **Creation report** compte les expéditions **created**, **with warnings** et **failed**, et liste chaque ligne avec son numéro, le code de sa compagnie maritime et, pour une ligne en échec, la raison. Une expédition avec avertissement est créée, mais « Some custom fields could not be added. » **Contact us** ouvre le formulaire de support quand au moins une ligne a échoué. Fermer le rapport remet l'onglet à trois lignes vides.

## En cas d'échec de la création

La fenêtre **Creation failed** explique pourquoi Safecube a refusé une création :

| Message | Cause | Que faire |
| ------- | ----- | --------- |
| « Your free trial has ended. Subscribe now to continue creating shipments and tracking your containers. » | L'espace de travail n'a plus de crédit d'expédition | **Subscribe** ouvre la page des offres |
| « The container number you entered is invalid. Please ensure it follows the format: ABCD1234567. » | Le numéro de conteneur est invalide | Corrigez le numéro |
| « Container … is already tracked in your workspace. » | L'expédition est déjà suivie | **View shipment** ouvre l'expédition existante |
| « Oops! We couldn't process your file because it doesn't adhere to the required format… » | Le fichier CSV ne respecte pas le format d'« Importer un fichier CSV » sur cette page | Repartez du modèle |
| « An error occurred while creating the shipment… » ou « Oops, an error occurred… » | Autre erreur | Vérifiez les informations et réessayez, ou sélectionnez **Contact us** |

Le décompte des crédits d'expédition est décrit dans [Facturation des expéditions](/fr/platform/billing/shipment-billing). La fin d'un essai gratuit est décrite dans [Essai gratuit](/fr/platform/billing/free-trial).

![Fenêtre Creation failed indiquant que l'essai gratuit est terminé, avec les boutons Close et Subscribe](https://docs.safecube.ai/media/images/shared/modal-create-errors--credits.webp?v=0491f877)

## Limites

- Il n'existe pas de champ de référence interne : une expédition est identifiée par son numéro seul.
- Un conteneur en leasing n'est jamais créé sans compagnie maritime, quel que soit l'onglet ou dans un fichier CSV.
- Le nombre d'expéditions détectées dans un fichier CSV compte chaque ligne remplie, y compris les conteneurs en leasing sans compagnie et les numéros invalides.
- L'avertissement de doublon ne couvre que les expéditions déjà chargées dans l'espace de travail, sur les onglets **Single** et **Multiple**.
- Un collage sur l'onglet **Multiple** ajoute au plus 100 numéros.
