Module Expéditions

Le module Expéditions d'HtkDoli vous permet de consulter, créer et suivre les expéditions liées à vos commandes clients. Il respecte le cycle de vie complet d'une expédition Dolibarr (Brouillon → Validée → Clôturée/Livrée) et inclut des actions de scan et de génération de facture.

⚠️ À savoir — création d'une expédition depuis une commande. La création depuis une commande client se fait en sélectionnant l'entrepôt d'expédition et les quantités à expédier par ligne. L'expédition nécessite des produits stockables disposant de stock dans l'entrepôt choisi (contrainte Dolibarr) ; une ligne sans produit stockable ne peut pas être expédiée.

Interface et Fonctionnalités (Liste)

La vue principale affiche la liste de toutes vos expéditions, avec un en-tête flottant qui se masque au défilement.

Consultation et Recherche

Barre de recherche : Recherche par référence d'expédition, nom du client ou numéro de suivi.
Tri :
- Date (Récent → Ancien, Ancien → Récent)
- Référence (A→Z, Z→A)
Filtres par statut (avec compteur d'éléments) :
- Tous
- Brouillon
- Validée
- Clôturée
Regroupement : En l'absence de recherche, la liste est regroupée par mois (tri par date) ou par première lettre de la référence (tri par référence), avec une bulle d'index lors du défilement.
Rafraîchissement : Bouton dans l'en-tête avec indicateur d'état (gris = à actualiser, bleu = en cours, vert = succès, rouge = erreur). Raccourci clavier ⌘R.

Informations affichées (Cartes Expédition)

Chaque ligne représente une expédition avec :

Sa référence (ex : SH2404-0001).
Le nom du client destinataire.
La date de livraison prévue si renseignée, sinon la date de création.
Le statut sous forme de pastille colorée (Brouillon, Validée, Clôturée).

Menu contextuel (appui long) :
- Voir le PDF : Aperçu du bon d'expédition.
- Valider l'expédition (si en brouillon) : raccourci affiché pour information ; la validation effective se fait depuis la fiche détail.
- Modifier.
- Supprimer.
Glissement vers la gauche (bord droit) : Supprimer (suppression immédiate, sans alerte de confirmation propre).
Glissement vers la droite (bord gauche) : Modifier.

Pagination

Chargement par paquets de 50 expéditions avec bouton « Charger plus ».
Pull-to-refresh pour resynchroniser.

Bouton de création

Un bouton « + » dans la barre du haut ouvre l'écran de création d'expédition (visible uniquement si vous disposez du droit de création).

Vue Détail (Consultation d'une expédition)

En touchant une expédition dans la liste, vous accédez à sa fiche complète.

En-tête (Hero Section)

Référence de l'expédition.
Nom du client lié.
Badge de statut (Brouillon / Validée / Clôturée).

Actions Workflow (selon le statut)

Si l'expédition est en Brouillon (statut 0) :

Valider l'expédition : Passe au statut Validée, déclenche la sortie de stock côté Dolibarr.

⚠️ Plus de « Scanner un produit ». Le scan menait à l'ajout d'une ligne, et POST /shipments/{id}/lines n'existe pas dans l'API de Dolibarr : les lignes d'une expédition se créent depuis la commande d'origine. L'action a été retirée, ainsi que « Rouvrir (Brouillon) », dont la route n'existe pas davantage.

Si l'expédition est Validée (statut 1) :

Créer Facture : Génère une facture client brouillon à partir de l'expédition.
Classer Livrée / Clôturer : Passe au statut Clôturée.
Rouvrir (Brouillon) : Revient à l'état Brouillon.
Gérer Retour (Web) : Ouvre la gestion de retour dans le navigateur (fonction Dolibarr non disponible en API).

Si l'expédition est Clôturée (statut 2) :

Créer Facture.
Rouvrir (Brouillon).
Gérer Retour (Web).

Informations

Référence Client (si renseignée)
Date de Création
Date d'Expédition
Date de Livraison (ou « Non définie »)

Liens

Liens directs vers les entités associées :

Commande client d'origine (avec accès à sa fiche, ou indication « Non synchronisée » si la commande n'est pas présente en local).
Projet rattaché.

Contacts

Liste des contacts associés à l'expédition, avec leur rôle (Livraison, Contact Client…) et accès direct par téléphone ou e-mail.

Ajouter un contact : associe un contact du tiers à l'expédition (rôle Livraison ou Contact Client).
Délier un contact : par glissement, retire le contact de l'expédition.

Logistique

Si renseignés :

Poids (avec son unité)
Dimensions (largeur × hauteur × profondeur)

Suivi Transporteur

Numéro de suivi du colis.
Lien « Suivre le colis » ouvrant l'URL de tracking du transporteur dans le navigateur (si renseignée).

Contenu

Liste des produits expédiés avec leur libellé, leur référence, leur description éventuelle et la quantité expédiée. Sur une expédition en brouillon, une ligne peut être supprimée par glissement. Une mention « Aucune ligne ou détail non synchronisé. » s'affiche si la fiche n'a pas encore été détaillée par le serveur.

Documents

Consultation, téléchargement, aperçu PDF.
Ajout de documents une fois l'expédition synchronisée côté serveur.

Notes

Note Publique.
Note Privée (usage interne).

Actions de l'en-tête flottant

Voir le PDF (si l'expédition est synchronisée).
Modifier (si vous disposez du droit de création/modification).
Supprimer (avec confirmation).

Création et modification

Création depuis une commande client

Depuis la fiche d'une commande client (action « Créer une expédition »), l'écran de création permet de :

Visualiser la commande d'origine et son client.
Choisir l'entrepôt source.
Définir les quantités à expédier par ligne de commande. L'app calcule automatiquement le reste à livrer (quantité commandée moins quantités déjà expédiées) et le propose par défaut.
Valider pour créer l'expédition en brouillon (synchronisée en arrière-plan).

Création depuis le bouton « + »

Le bouton « + » de la barre du haut de la liste ouvre un formulaire d'expédition « à blanc » :

Sélection du tiers (client) destinataire (obligatoire).
Référence client, dates (livraison, expédition).
Informations logistiques (poids + unité, dimensions + unité, méthode d'expédition).
Numéro et URL de suivi.
Notes publique et privée, projet rattaché.

À savoir. Cette création « à blanc » n'ajoute pas de lignes produits : les lignes s'ajoutent ensuite par scan code-barres, ou via une création depuis une commande.

Modification

Le formulaire de modification reprend les mêmes champs (référence client, dates, logistique, méthode d'expédition, suivi, notes, projet). La modification est appliquée de façon optimiste en local puis synchronisée.

Scan rapide (Brouillon)

Sur une expédition en brouillon, l'action « Scanner un produit » ouvre le scanner code-barres : un scan recherche le produit, ouvre une alerte de saisie de quantité, et la ligne est ajoutée à l'expédition. Si aucun produit ne correspond au code-barres, un message d'erreur s'affiche.

Comportement Métier et Dolibarr

Cycle de vie

Brouillon (0) : Création initiale, lignes modifiables (ajout par scan, suppression par glissement), scan possible.
Validée (1) : Stock décrémenté, facturable.
Clôturée (2) : Marquée comme livrée. La création de facture reste possible.
À tout moment depuis Validée ou Clôturée : retour possible en Brouillon.

Droits et Permissions

Lecture : Permission de lecture du module Expéditions requise.
Création / Modification : Bouton « + » et actions de modification conditionnés par la permission Dolibarr expedition.creer.
Certaines opérations avancées (gestion de retour) ne sont pas exposées par l'API Dolibarr et s'ouvrent dans le navigateur.

Synchronisation

Liste paginée par 50. Le nom du client et les lignes manquantes sont complétés en arrière-plan à la synchronisation.
Le détail d'une expédition est récupéré à l'ouverture de la fiche.
Les actions (validation, clôture, réouverture, création de facture, création/modification d'expédition) sont mises en file d'attente puis synchronisées.
Les documents associés sont chargés en arrière-plan.

Captures d'écran

1 capture — cliquez pour agrandir