Regrouper plusieurs colis d'un meme depot en une seule tache de collecte, avec routage direct ou via hub.

Collecte groupee

La collecte groupee permet de creer une seule tache de collecte couvrant plusieurs colis issus d'un meme depot permanent. C'est l'outil adapte aux marchands et entrepots qui remettent plusieurs envois en une seule fois : au lieu de generer une tache de collecte par colis, un seul passage du chauffeur au depot suffit.

Acceder a la fonctionnalite

La collecte groupee se cree depuis la page Colis (/shipments) :

Selectionnez au minimum 2 colis dans le tableau en cochant les cases a gauche de chaque ligne.
Une barre d'actions apparait en haut du tableau.
Cliquez sur le bouton Planifier une collecte.
Le formulaire de collecte groupee s'ouvre dans une modale.

Si le bouton est desactive, un message explique pourquoi (voir les conditions d'eligibilite ci-dessous).

Conditions d'eligibilite

Pour pouvoir etre regroupes en une collecte, tous les colis selectionnes doivent remplir ces conditions :

Condition	Detail
Meme depot permanent	Tous les colis doivent provenir du meme point de collecte permanent. On ne peut pas melanger des colis de depots differents.
Depot permanent	Le depot doit etre marque comme permanent (`isPermanent: true`). Les points de collecte ad-hoc ne sont pas eligibles.
Pas en attente d'approbation	Les colis au statut `pending_approval` ne sont pas eligibles. Ils doivent d'abord etre approuves.
Pas de collecte active	Les colis ne doivent pas deja avoir une tache de collecte en cours ou faire partie d'une autre collecte groupee active.
Tache de livraison eligible	Chaque colis doit avoir une tache de livraison dans un statut eligible (`pending`, `assigned`, ou `waiting_for_pickup`).
Minimum 2 colis	Une collecte groupee necessite au moins 2 colis.
Maximum 200 colis	Une collecte groupee peut contenir jusqu'a 200 colis.

Formulaire de creation

La modale de collecte groupee est divisee en deux panneaux :

Panneau gauche : le formulaire de configuration
Panneau droit : la liste des colis selectionnes (numero de tracking, destinataire, ville)

Un badge en haut du formulaire rappelle le nom du depot et le nombre de colis selectionnes.

Mode de routage

Choisissez comment les colis seront achemines apres la collecte :

Mode	Label	Description
Direct	Livraison directe	Le chauffeur collecte les colis au depot puis les livre directement aux destinataires. Les taches de livraison de chaque colis lui sont pre-assignees automatiquement. Un chauffeur est obligatoire.
Via Hub	Deposer au hub	Le chauffeur collecte les colis au depot puis les depose dans un hub de destination (entrepot intermediaire). Les taches de livraison restent en attente de collecte (`waiting_for_pickup`) jusqu'a ce qu'un autre chauffeur retire les colis au hub. Un hub de destination est obligatoire.

Hub de destination (mode Via Hub uniquement)

Lorsque le mode Via Hub est selectionne, une section supplementaire apparait pour choisir le hub de destination. La liste affiche les depots permanents de l'organisation (hors depots marchands). Cliquez sur un hub pour le selectionner.

Chauffeur

Selectionnez le chauffeur qui effectuera la collecte au depot.

En mode Direct : le chauffeur est obligatoire. Il se verra aussi pre-assigner les taches de livraison de tous les colis collectes.
En mode Via Hub : le chauffeur est optionnel. Il n'effectuera que la collecte et le transfert vers le hub.

La liste des chauffeurs de l'organisation est affichee. Cliquez sur un chauffeur pour le selectionner, cliquez a nouveau pour le deselectionner.

Planification

Configurez quand la collecte doit avoir lieu :

Option	Description
Des que possible	La collecte sera effectuee au plus tot (par defaut).
Planifier	Choisissez une date et un creneau horaire precis.

En mode Planifier, trois champs apparaissent :

Champ	Description
Date de collecte	Date souhaitee pour le passage au depot
Debut creneau	Heure de debut (defaut : 08:00)
Fin creneau	Heure de fin (defaut : 18:00)

Notes

Un champ texte libre pour transmettre des instructions au chauffeur (ex : « Sonner au portail B, demander Monsieur Dupont »).

Validation et creation

Cliquez sur Creer la collecte pour lancer la collecte groupee. Le bouton est desactive tant que les champs obligatoires ne sont pas remplis (chauffeur en mode Direct, hub en mode Via Hub).

A la creation :

Une tache de collecte unique de type pickup est creee, contenant tous les colis selectionnes.
Les taches de livraison de chaque colis sont verrouillees en statut waiting_for_pickup (elles ne peuvent pas demarrer tant que la collecte n'est pas terminee).
En mode Direct, les taches de livraison sont pre-assignees au chauffeur selectionne.
Un evenement grouped_pickup_created est enregistre dans l'historique de chaque colis.
Une notification temps reel est envoyee via Mercure.

Cycle de vie apres la creation

Mode Direct

Depot ──(chauffeur collecte)──> Colis recuperes
                                      │
                          (livraisons pre-assignees
                           au meme chauffeur)
                                      │
                                      v
                              Livraison directe
                              aux destinataires

Le chauffeur se rend au depot et collecte tous les colis.
La tache de collecte groupee passe en picked_up.
Les taches de livraison sont automatiquement deverrouillees (waiting_for_pickup -> assigned).
Le chauffeur livre chaque colis a son destinataire.

Mode Via Hub

Depot ──(chauffeur A collecte)──> Hub de destination
                                        │
                                  (colis deposes
                                   par scan)
                                        │
                              (chauffeur B retire
                               les colis par scan)
                                        │
                                        v
                                Livraison aux
                                destinataires

Le chauffeur A se rend au depot et collecte tous les colis.
Le chauffeur A depose les colis au hub de destination.
Chaque depot est trace par un scan (package_deposited).
Un chauffeur B retire les colis au hub par scan (package_collected).
Les taches de livraison sont automatiquement deverrouillees.
Le chauffeur B livre chaque colis a son destinataire.

Scan au depot : depot et retrait

Lorsque les colis transitent par un hub (mode Via Hub), le suivi se fait par scan du code-barres ou QR code de chaque colis au depot.

Action	Code	Effet
Deposer	`deposit`	Le chauffeur depose le colis au depot. La tache de transfert en cours est completee. Un evenement `package_deposited` est enregistre.
Recuperer	`collect`	Un chauffeur retire le colis du depot. La tache de livraison en attente est deverrouillee (`waiting_for_pickup` -> `pending`). Un evenement `package_collected` est enregistre.

Retirer des colis d'une collecte groupee

Apres la creation d'une collecte groupee, il est possible de retirer un ou plusieurs colis du groupe.

Retrait partiel

Si au moins 2 colis restent dans le groupe apres le retrait :

Les colis retires sont dissocies de la tache de collecte groupee.
Leurs taches de livraison sont deverrouillees (repassent en pending).
La tache de collecte groupee continue avec les colis restants.
Un evenement removed_from_grouped_pickup est enregistre pour chaque colis retire.

Dissolution automatique

Si le retrait fait tomber le groupe a moins de 2 colis :

Toutes les taches de livraison sont deverrouillees.
Le groupe est dissous et la tache de collecte est supprimee.
Un evenement removed_from_grouped_pickup est enregistre pour chaque colis.

Evenements de tracabilite

La collecte groupee genere les evenements suivants dans l'historique des colis :

Evenement	Code	Declencheur
Collecte groupee creee	`grouped_pickup_created`	Creation de la collecte groupee
Retire de la collecte groupee	`removed_from_grouped_pickup`	Retrait d'un colis du groupe
Colis depose	`package_deposited`	Scan de depot au hub (mode Via Hub)
Colis collecte	`package_collected`	Scan de retrait au hub (mode Via Hub)

Voir aussi : Gestion des colis | Statuts des colis

Collecte groupee

On this page