Skip to main content
Qargo

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
  1. Fonctionnement de l’intégration en bref
  2. À qui s’adresse ce guide
  3. Terminologie
  4. Prérequis
  5. Flux de travail quotidien dans Qargo
  6. Suivre et mettre à jour le statut
  7. Saisir et partager la preuve de livraison
  8. Récapitulatif des fonctionnalités et sens des flux de données
  9. Conseils pratiques
  10. FAQ
  11. Dépannage

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.