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) : valide l'expédition depuis la liste, comme depuis la fiche (mise en file puis envoi à Dolibarr).
- 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.

Pas de bouton « + » sur la liste

Une expédition se crée depuis la fiche d'une commande client (action « Créer une expédition »), jamais depuis la liste : Dolibarr exige la commande d'origine à la création, et une expédition « libre » est refusée par le serveur.

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 :

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, ce que l'API de Dolibarr ne permet pas : les lignes d'une expédition se créent depuis la commande d'origine. L'action a été retirée, ainsi que « Rouvrir (Brouillon) », que l'API ne permet pas davantage. Une ligne d'un brouillon se supprime par un appui long sur la ligne.

Si l'expédition est Validée :

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.
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 :

Créer Facture.
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

La carte le dit elle-même : les contacts d'une expédition ne se consultent ni ne se modifient depuis l'application, l'API de Dolibarr ne les proposant pas. Utilisez l'interface web de Dolibarr.

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).

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.

Comportement Métier et Dolibarr

Cycle de vie

Brouillon : Création initiale depuis la commande ; une ligne se supprime par appui long.
Validée : Stock décrémenté, facturable.
Clôturée : Marquée comme livrée. La création de facture reste possible.
Le retour en Brouillon se fait depuis l'interface web de Dolibarr.

Droits et Permissions

Lecture : Permission de lecture du module Expéditions requise.
Création / Modification : Bouton « + » et actions de modification conditionnés par le droit de création/modification du module Expéditions.
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