Réseau de palettes : exportation et importation de commandes PALL-EX/Fortec
Cet article explique comment les commandes sont exportées de Qargo vers le réseau de palettes PALL-EX ou Fortec et comment les commandes entrantes sont importées de Nexus dans Qargo.
Table des matières
Introduction
Que couvre cet article ?
- Dispatcher une expédition vers PALL-EX ou Fortec
- Détermination du réseau (PALL-EX ou Fortec)
- Génération des étiquettes après le dispatch
- Annulation d’un dispatch
- Règles relatives à la date d’enlèvement et heure limite de 12 h
- Importation des commandes de Nexus dans Qargo
- Synchronisation des statuts de suivi
- Synchronisation des POD et des documents
- Exportation des ETA via Optimize
À qui s’adresse-t-il ?
- Aux dispatchers et exploitants qui envoient des expéditions au réseau de palettes
- Au personnel des opérations qui surveille le statut des expéditions dans Qargo
Terminologie
| Terme | Définition |
|---|---|
| Tâche de dispatch de ressource | Tâche Qargo qui, une fois terminée, envoie une expédition au réseau de palettes via l’API Nexus |
| PALLEX_OUT | Code de ressource qui identifie un sous-traitant comme la ressource du réseau PALL-EX |
| FORTEC_OUT | Code de ressource qui identifie un sous-traitant comme la ressource du réseau Fortec |
| ID client Nexus | Code unique qui identifie un client dans le système Nexus ; il doit être configuré pour chaque client dans Qargo |
| Heure limite | 12 h (midi) : au-delà de cette heure, les enlèvements le jour même ou le lendemain nécessitent une date d’enlèvement ultérieure |
| MPOD | Capture de signature numérique recueillie à la livraison |
| POD | Image du bon de livraison signé |
| MPODPHOTOE | Photo des palettes à l’emplacement de livraison |
| Optimize | Module d’optimisation des tournées utilisé pour envoyer les ETA de Qargo vers Nexus |
Exportation des commandes (Qargo → Nexus)
Dispatcher une expédition
- Affecter la tournée à la ressource sous-traitant PALL-EX ou Fortec, selon le réseau requis pour l’expédition.
- Terminer la tâche de dispatch de ressource sur la tournée. L’expédition est alors envoyée à Nexus via l’API.
- Vérifier qu’une étiquette de palette a été téléchargée et jointe au panneau des documents de l’expédition.
Détermination du réseau
Le réseau (PALL-EX ou Fortec) est déterminé par la ressource sous-traitant affectée à la tournée :
| Code de ressource | Réseau |
|---|---|
| PALLEX_OUT` | Expédition envoyée à PALL-EX |
| FORTEC_OUT` | Expédition envoyée à Fortec |
- Lors du dispatch, Qargo transmet à l’API l’ID client Nexus correspondant (configuré dans la fiche client). L’API achemine l’expédition vers le bon réseau en fonction de cet ID.
Après le dispatch
Une fois la tâche de dispatch de ressource terminée :
- Une étiquette de palette est automatiquement téléchargée depuis Nexus et jointe à l’expédition dans Qargo
- L’expédition est visible dans le portail Nexus
- Nexus commence à renvoyer des événements de scan à Qargo au fur et à mesure que l’expédition progresse dans le réseau
Annuler un dispatch
- Un dispatch peut être annulé en retirant la ressource sous-traitant de la tournée.
- Cette action déclenche une demande d’annulation auprès de Nexus et retire l’expédition du réseau.
Règles relatives à la date d’enlèvement
PALL-EX/Fortec applique des règles strictes aux dates d’enlèvement. Qargo détermine automatiquement le niveau de service d’enlèvement en fonction de la date et de l’heure de l’exportation :
| Scénario | Résultat |
|---|---|
| Exportation le jour même, avant l’heure limite de 12 h | Service PREMIUM utilisé |
| Exportation le jour même, après l’heure limite de 12 h | ❌ Erreur : enlèvement impossible |
| Exportation le vendredi → enlèvement le samedi | ❌ Erreur : non pris en charge |
| Exportation le vendredi → lundi, avant 12 h | SPECIFIC_DAY |
| Exportation le vendredi → lundi, après 12 h | PREMIUM |
| Lendemain (lun.–jeu.), avant 12 h | SPECIFIC_DAY |
| Lendemain (lun.–jeu.), après 12 h | PREMIUM |
| Exportation le week-end → jour ouvré suivant | ❌ Erreur |
| Date future (> 1 jour à l’avance) | SPECIFIC_DAY |
Génération des étiquettes
- Une étiquette de palette est téléchargée automatiquement depuis Nexus dès qu’un dispatch a réussi.
- L’étiquette est jointe au panneau des documents de l’expédition dans Qargo et peut être imprimée depuis cet emplacement.
- Aucune étape manuelle n’est nécessaire pour obtenir l’étiquette : elle est générée et téléchargée dans le cadre du processus de dispatch.
Importation des commandes (Nexus → Qargo)
Fonctionnement de l’importation
- Qargo interroge l’API Nexus à intervalles de quelques minutes pour récupérer les expéditions nouvelles et mises à jour du dépôt.
- Les commandes importées suivent le flux standard d’importation de commande de Qargo.
Importation depuis les deux réseaux
- Comme PALL-EX et Fortec partagent l’API Nexus, Qargo importe les commandes des deux réseaux simultanément, en un seul cycle d’interrogation.
- Le réseau (PALL-EX ou Fortec) est identifié à partir des données renvoyées par l’API, et les codes correspondants sont utilisés dans le mappage d’importation.
Synchronisation des statuts
Importation des statuts (Nexus → Qargo)
Qargo interroge Nexus à intervalles de quelques minutes pour récupérer les mises à jour de statut. Les statuts ci-dessous sont importés et mappés sur le cycle de suivi de Qargo :
| Statut Nexus | Statut Qargo |
|---|---|
ARRIVED_AT_COLLECTION_POINT |
Arrivé à l’enlèvement |
COLLECTED |
Enlèvement scanné en entrée |
DEPOT_SCAN_IN_FROM_CUSTOMER |
Scanné en entrée au dépôt d’enlèvement |
DEPOT_SCAN_OUT_TO_HUB |
Scanné en sortie du dépôt d’enlèvement |
HUB_TRUNK_IN |
Arrivé au hub |
HUB_SCAN_IN |
HUB entrant |
HUB_HELDOVER |
RETENU AU HUB |
HUB_SCAN_OUT |
Scanné en sortie du hub |
HUB_TRUNK_OUT |
Parti du hub |
DEPOT_SCAN_IN |
Scanné en entrée au dépôt de livraison |
OUT_FOR_DELIVERY |
Parti du dépôt de livraison |
ARRIVED_AT_DELIVERY_POINT |
Arrivé à la livraison |
DELIVERY_EPOD_RECEIVED |
Livraison scannée en sortie |
DELIVERED |
Livraison scannée en sortie |
Exportation des statuts (Qargo → Nexus)
Qargo renvoie les mises à jour de statut à Nexus dans le cadre du dispositif de visibilité. Elles sont déclenchées automatiquement par des événements précis dans Qargo :
- Enlèvement terminé → statut exporté vers Nexus
- À l’arrêt de livraison → statut exporté
- Livraison confirmée → statut exporté
Synchronisation des POD et des documents
Les justificatifs de livraison sont synchronisés dans les deux sens entre Nexus et Qargo.
| Type de document Nexus | Description | Type de document Qargo |
|---|---|---|
MPOD |
Capture de signature numérique / image de signature sur écran du destinataire | Signature du destinataire |
POD |
Image du bon de livraison signé | POD/CMR |
MPODPHOTOE |
Photo des palettes à l’emplacement de livraison | Photo des marchandises (livraison) |
- Importation : les documents sont synchronisés périodiquement depuis Nexus et enregistrés sur l’expédition dans Qargo.
- Exportation : lorsqu’un document de l’un des types ci-dessus est créé ou téléversé dans Qargo et que le dépôt est le dépôt de livraison de l’expédition, le document est envoyé automatiquement à Nexus.
Exportation des ETA (via Optimize) : facultatif
Les ETA peuvent être envoyées de Qargo vers Nexus via le module d’optimisation des tournées Optimize.
