PN - Présentation de l'intégration Hazchem
Fonctionnement de l'intégration Hazchem dans Qargo : réception des expéditions, dispatch, suivi, étiquettes, POD, images de livraison et documents propres au client.
Table des matières
Fonctionnement de l’intégration en bref
- Les expéditions Hazchem arrivent automatiquement dans Qargo via l’API.
- Au fil de l’avancement du travail, Qargo renvoie à Hazchem les informations de dispatch, les étapes de suivi et les documents.
- Les étiquettes, les événements de scan, les POD, les images de livraison et les documents propres au client sont échangés afin que les deux systèmes restent synchronisés.
- Le travail est géré dans Qargo ; l’intégration prend en charge le flux de données vers et depuis Hazchem.
À qui s’adresse ce guide
- Équipes de dépôt et d’exploitation qui reçoivent les expéditions Hazchem
- Exploitants qui affectent et ordonnancent le travail Hazchem
- Chauffeurs (via l’application chauffeur Qargo) qui effectuent les livraisons
- Équipes du service client qui suivent l’avancement et récupèrent les POD ou les images de livraison
Terminologie
| Terme | Définition |
|---|---|
| Expédition | Une expédition Hazchem, généralement une ou plusieurs palettes sous une seule référence de suivi. |
| Référence Hazchem | L’identifiant unique attribué par Hazchem, utilisé pour faire correspondre les enregistrements entre les deux systèmes. |
| Dispatcher | L’action de confirmer une expédition dans le système de Hazchem, qui génère les étiquettes de palettes. |
| COP (documents propres au client) | Documents associés à l’expédition, par ex. documents douaniers ou de livraison. |
| POD (preuve de livraison) | Preuve d’une livraison effectuée : généralement le nom du destinataire, la signature et l’horodatage. |
| Image de livraison | Une photo prise au moment de la livraison, via l’application chauffeur. |
| Mise à jour de statut | Une étape de suivi (par ex. enlevé, en cours, livré) envoyée par Qargo à Hazchem. |
| Événement de scan | Un scan de code-barres enregistré lors d’une étape de manutention, comme le scan d’entrée ou de sortie au dépôt. |
| Push (données) | Données envoyées automatiquement du système source vers le système de destination. |
| Pull / synchronisation | Le système de destination récupère activement les données du système source selon une planification. |
Prérequis
- Une intégration Hazchem active a été configurée par l’équipe d’administration Qargo
- Les rôles des utilisateurs dans Qargo permettent de consulter et de traiter les expéditions Hazchem
- Les appareils utilisés pour le scan ou la saisie des POD sont connectés et synchronisés avec Qargo
Flux de travail quotidien dans Qargo
Recevoir les expéditions
-
Hazchem envoie (push) les nouvelles expéditions à Qargo via l’API.
-
Les expéditions apparaissent dans la vue Commandes ou dans la vue du travail entrant, avec la référence de suivi Hazchem visible.
- Les détails de base comprennent l’expéditeur, le destinataire, le type de service, le nombre de palettes, le poids et les éventuelles instructions particulières.
Dispatcher et imprimer les étiquettes
- Lorsqu’une expédition est prête à être dispatchée, la tâche de dispatch dans Qargo crée ou confirme l’expédition dans le système de Hazchem.
- Les étiquettes de palettes sont générées lors de l’étape de dispatch. Elles portent la référence de suivi Hazchem et servent au scan tout au long du processus au dépôt et de la livraison.
Suivre et mettre à jour le statut
À mesure que les chauffeurs et le personnel du dépôt avancent dans le travail, Qargo envoie à Hazchem les étapes de suivi, y compris des événements de scan tels que :
- Scan de sortie au dépôt d’enlèvement
- Scan d’entrée au dépôt de livraison
- Stockage au dépôt de livraison
- Scan de sortie au dépôt de livraison
Export des statuts
Qargo envoie également un statut à Hazchem lors des événements suivants :
| Événement Qargo | Événement de statut | Rôle du dépôt |
|---|---|---|
| POC | L’arrêt d’enlèvement est terminé | Enlèvement |
| DONR | L’enlèvement par le dépôt de livraison est terminé | Livraison |
| ARDL | À l’arrêt de livraison | Livraison |
| POD | Le POD a été créé | Livraison |
Saisir et partager la preuve de livraison
Le POD est saisi dans Qargo via l’application chauffeur ou le back-office. Une fois téléversé, le POD
est envoyé à Hazchem via l’API, ce qui offre une visibilité immédiate aux acteurs du réseau.
Images de livraison et documents propres au client
Les images de livraison (photos prises au moment de la livraison) et les documents COP sont échangés dans les deux sens :
- Lorsqu’ils sont ajoutés à une expédition dans Qargo, les images de livraison et les COP sont automatiquement téléversés vers Hazchem via l’API
- Les images de livraison et les documents COP provenant de Hazchem sont récupérés automatiquement dans Qargo toutes les 10 minutes par une synchronisation en arrière-plan
Récapitulatif des fonctionnalités et sens des flux de données
| Fonctionnalité | Sens | Déclencheur habituel | Emplacement dans Qargo |
|---|---|---|---|
| Nouvelle expédition | Push depuis Hazchem | Commande créée dans Hazchem | Liste des commandes / file d’attente entrante |
| Étiquettes de palettes | Générées dans Qargo | Action de dispatch | Section des étiquettes de la commande |
| Étapes de suivi | Push depuis Qargo | Changement de statut / application chauffeur | Chronologie et activité de la commande |
| Événements de scan | Push depuis Qargo | Scan de code-barres au dépôt | Historique des scans de la commande |
| POD (signature, nom, horodatage) | Push depuis Qargo | POD saisi dans l’application ou le back-office | Section POD et pièces jointes |
| Images de livraison (sortantes) | Push depuis Qargo | Image téléversée sur l’expédition | Pièces jointes de la commande |
| Images de livraison (entrantes) | Synchronisation depuis Hazchem | Toutes les 10 minutes | Pièces jointes de la commande |
| Documents COP (sortants) | Push depuis Qargo | COP téléversé sur l’expédition | Documents de la commande |
| Documents COP (entrants) | Synchronisation depuis Hazchem | Toutes les 10 minutes | Documents de la commande |
| Numéro d’expédition (rapprochement des factures) | Utilisé dans Qargo | Téléversement d’une facture d’achat | Rapprochement des factures / scan et rapprochement |
Conseils pratiques
- Terminer l’étape de dispatch dans Qargo avant que l’expédition ne quitte le dépôt afin que les étiquettes de palettes soient générées et que le suivi démarre correctement.
- Les images de livraison et les COP se synchronisent automatiquement toutes les 10 minutes ; il n’est pas nécessaire de les demander manuellement à Hazchem.
- Lors du téléversement des COP, s’assurer que le téléversement est effectué par le dépôt demandeur ou le dépôt d’enlèvement ; les dépôts de livraison ne peuvent pas téléverser de COP via l’API.
- Pour le rapprochement des factures, le numéro d’expédition Hazchem fait partie des champs utilisés par la fonction de scan et rapprochement de Qargo lors du téléversement des factures d’achat.
FAQ
Pourquoi le POD n’apparaît-il pas dans Hazchem ?
- Vérifier que le POD est présent et joint dans Qargo, avec un horodatage.
- Vérifier que l’application chauffeur a été synchronisée après la saisie du POD.
- Prévoir un court délai de traitement pour que l’envoi via l’API se termine.
Les images de livraison provenant de Hazchem n’apparaissent pas : que faut-il vérifier ?
- La synchronisation entrante s’exécute toutes les 10 minutes. Si les images n’apparaissent toujours pas après 10–15 minutes, vérifier que l’expédition possède une référence de suivi Hazchem et que l’intégration est active.
- Contacter l’assistance Qargo si le problème persiste.
Faut-il ressaisir les POD dans Hazchem ?
Non. Les POD saisis dans Qargo sont envoyés automatiquement à Hazchem ; aucune ressaisie manuelle n’est nécessaire dans le système Hazchem.
Est-il possible d’imprimer les étiquettes Hazchem depuis Qargo ?
Oui. Les étiquettes sont générées lors de l’étape de dispatch et sont disponibles sur la commande
dans Qargo. Suivre la procédure d’impression du dépôt pour produire et apposer les étiquettes avant le chargement.
Dépannage
| Symptôme | Étapes de résolution |
|---|---|
| Les nouvelles expéditions n’apparaissent pas dans Qargo | Vérifier les filtres de la vue des commandes. Vérifier que l’intégration Hazchem est active et que l’expédition a bien été créée dans Hazchem. |
| Les étiquettes ne sont pas générées | Vérifier que l’action de dispatch a été terminée. Vérifier si des champs obligatoires de l’expédition sont manquants. |
| Le suivi n’est pas visible dans Hazchem | S’assurer que l’expédition a été dispatchée dans Qargo et que les mises à jour de statut du chauffeur/de l’application ont été envoyées. Vérifier la connectivité. |
| Les images de livraison ou les COP ne se synchronisent pas | Prévoir jusqu’à 10 minutes pour la synchronisation automatique. Vérifier que la référence de suivi Hazchem figure sur l’expédition dans Qargo. |
| Hazchem ne reçoit pas le POD | Vérifier que le POD est enregistré dans Qargo avec un horodatage et une pièce jointe. Contacter l’assistance en indiquant la référence Hazchem si le problème persiste. |
