Expéditions

Les colis que vous envoyez : destinataire, transporteur, numéro de suivi et contenu. À l'expédition, les articles sortent du stock et le client reçoit un lien pour suivre son colis.

/shipping /shipping/track /api/shipping shipping.view shipping.manage

À quoi sert ce module

Le module Expéditions suit chaque envoi de sa préparation à sa livraison. Une expédition reçoit un numéro chronologique du type EXP-2026-0001, un transporteur, un destinataire et la liste de ce que contient le colis. Chaque changement de statut est daté dans un historique (les jalons).

Il s'adresse à la logistique et à l'administration des ventes. Le module fonctionne seul, mais il tire parti des modules suivants lorsqu'ils sont activés : Clients (adresse préremplie, e-mail de suivi), Factures et Devis (import des lignes), Stock (sortie des articles à l'expédition, retour en stock).

Vue d'ensemble de l'écran

La liste, de la plus récente à la plus ancienne, avec une recherche (n° d'expédition, n° de suivi, destinataire) et des filtres par statut et par transporteur. Un clic sur une ligne ouvre la fiche ; le bouton Charger plus affiche la suite.

Créer une expédition

Cliquez sur Nouvelle expédition. L'expédition démarre en brouillon et reçoit son numéro à l'enregistrement.

1. Client (si Clients est activé) — choisissez-le puis cliquez sur le bouton de préremplissage : nom, adresse et pays sont repris de sa fiche.
2. Importer les lignes depuis (si Factures ou Devis est activé) — choisissez une facture ou un devis : ses lignes deviennent le contenu du colis, et son client est repris si aucun n'est choisi.
3. Destinataire (obligatoire), adresse, code postal, ville et pays (code ISO à 2 lettres, FR par défaut).
4. Transporteur (obligatoire) et N° de suivi s'il est déjà connu.
5. Poids (kg), Nombre de colis (1 à 250) et Notes internes.
6. Contenu du colis — une ligne par article : description, quantité et, si Stock est activé, l'article de stock correspondant.
7. Enregistrer.

Le cycle de vie d'un colis

Les boutons de la fiche ne proposent que les transitions autorisées depuis le statut courant :

Expédier un colis

Le bouton Expédier (depuis « Emballée ») demande une confirmation puis, en une seule opération :

1. passe le colis en Expédiée et enregistre la date d'expédition ;
2. génère le lien de suivi public du colis ;
3. si Stock est activé, fait sortir du stock chaque ligne liée à un article (motif « Expédition EXP-… ») ;
4. si Clients est activé et que le client rattaché a une adresse e-mail, lui envoie l'e-mail « Suivre mon colis ».

Jalons et historique

La fiche affiche l'historique du colis : un jalon est ajouté automatiquement à chaque changement de statut. Le bouton Ajouter un jalon permet d'en saisir d'autres (passage sur une plateforme, appel du transporteur) sans changer le statut du colis :

• Type de jalon — « Information » ou l'un des statuts ;
• Lieu — visible par le client sur la page de suivi ;
• Date / heure — maintenant si laissée vide ;
• Message interne — jamais publié. Un lieu ou un message est requis.

Le N° de suivi peut aussi être saisi ou corrigé directement depuis la fiche. Si le gabarit du transporteur est renseigné, un lien ouvre le suivi sur le site du transporteur.

La page de suivi client

Chaque colis expédié dispose d'une page publique, sans connexion, à l'adresse /shipping/track?token=…. La fiche affiche ce lien de suivi client avec deux boutons : copier le lien et ouvrir la page.

Le destinataire y voit le numéro du colis, son statut, le transporteur, le nombre de colis, les dates d'expédition et de livraison, le lien vers le suivi détaillé du transporteur et l'acheminement (statut, date et lieu de chaque jalon). Un lien inconnu affiche « Lien de suivi invalide ».

Le bouton Renvoyer le lien de suivi renvoie l'e-mail au client, pour un colis expédié, en transit ou livré. Il exige un client rattaché avec une adresse e-mail et une configuration mail fonctionnelle (voir Paramètres).

Gérer les transporteurs

L'onglet Transporteurs (réservé à shipping.manage) liste le référentiel. Cinq transporteurs sont créés à l'installation : Colissimo, Chronopost, DHL, UPS et « Autre ».

• Nom — obligatoire.
• Gabarit d'URL de suivi — une adresse https:// contenant {tracking}, remplacé par le numéro de suivi. Vide : pas de lien transporteur.
• Actif — un transporteur désactivé n'est plus proposé pour les nouvelles expéditions ; les expéditions existantes le conservent.

Supprimer une expédition

Seule une expédition en brouillon ou annulée peut être supprimée, avec son contenu et ses jalons. Une fois le colis emballé, annulez-le plutôt ; une fois expédié, il garde ses traces (sorties de stock, e-mail).

Les colis retournés au cours des 30 derniers jours sont signalés dans la barre latérale. Les expéditions apparaissent dans la recherche globale du tableau de bord et s'exportent (en-têtes seulement, en lecture seule) depuis Import / Export.

Permissions

Les deux permissions sont accordées au rôle Employé à l'installation du module. Voir Rôles & permissions.

Liens utiles

• Stock — sorties et retours d'articles déclenchés par les expéditions.
• Clients — adresse préremplie et e-mail « Suivre mon colis ».
• Paramètres — installation du module et configuration mail.
• Rôles & permissions — qui peut expédier.