PN - Hazchem-overzicht
Hoe de Hazchem-integratie in Qargo werkt: zendingen ontvangen, dispatchen, tracking, labels, POD's, leveringsfoto's en klantdocumenten.
Inhoudsopgave
Wat de integratie doet in een oogopslag
- Zendingen van Hazchem komen automatisch via de API in Qargo binnen.
- Qargo stuurt dispatchgegevens, trackingmijlpalen en documenten terug naar Hazchem naarmate het werk vordert.
- Labels, scanevenementen, POD’s, leveringsfoto’s en klantdocumenten worden uitgewisseld, zodat beide systemen op elkaar afgestemd blijven.
- Het werk wordt in Qargo beheerd; de integratie verzorgt de gegevensstroom van en naar Hazchem.
Voor wie deze handleiding bedoeld is
- Depot- en planningsteams die Hazchem-zendingen ontvangen
- Planners die Hazchem-werk toewijzen en in volgorde zetten
- Chauffeurs (via de Qargo chauffeur-app) die leveringen uitvoeren
- Klantenserviceteams die de voortgang opvolgen en POD’s of leveringsfoto’s opvragen
Terminologie
| Term | Definitie |
|---|---|
| Zending | Een Hazchem-trip, meestal een of meer pallets onder één trackingreferentie. |
| Hazchem-referentie | De unieke identificatie die Hazchem toekent en die wordt gebruikt om records in beide systemen aan elkaar te koppelen. |
| Dispatch | Het bevestigen van een zending in het systeem van Hazchem, waarbij palletlabels worden aangemaakt. |
| COP (klantdocumenten) | Documenten die bij de zending horen, zoals douane- of leveringsdocumenten. |
| POD (proof of delivery) | Bewijs van een voltooide levering, meestal met de naam van de ontvanger, een handtekening en een tijdstempel. |
| Leveringsfoto | Een foto die bij de levering wordt genomen via de chauffeur-app. |
| Statusupdate | Een trackingmijlpaal (bv. opgehaald, in transit, geleverd) die Qargo naar Hazchem stuurt. |
| Scanevenement | Een barcodescan die bij een behandelingsstap wordt geregistreerd, zoals inscannen of uitscannen in het depot. |
| Push (gegevens) | Gegevens die automatisch van het bronsysteem naar de bestemming worden verzonden. |
| Pull / synchronisatie | Het doelsysteem haalt volgens een schema zelf gegevens op uit de bron. |
Vereisten
- Het Qargo admin-team heeft een actieve Hazchem-integratie geconfigureerd
- De gebruikersrollen in Qargo laten toe om Hazchem-zendingen te bekijken en te verwerken
- Toestellen die worden gebruikt om te scannen of POD’s te registreren, zijn verbonden en gesynchroniseerd met Qargo
Dagelijkse werkwijze in Qargo
Zendingen ontvangen
-
Hazchem pusht nieuwe zendingen via de API naar Qargo.
-
Zendingen verschijnen in Orders of in het overzicht met inkomend werk, met de Hazchem-trackingreferentie zichtbaar.
- De basisgegevens omvatten verzender, ontvanger, type service, aantal pallets, gewicht en eventuele speciale instructies.
Dispatchen en labels printen
- Wanneer een zending klaar is om te dispatchen, maakt of bevestigt de dispatchtaak in Qargo de zending in het systeem van Hazchem.
- Palletlabels worden aangemaakt als onderdeel van de dispatchstap. De labels bevatten de Hazchem-trackingreferentie en worden gebruikt om te scannen tijdens het hele depot- en leveringsproces.
Status opvolgen en bijwerken
Naarmate chauffeurs en depotmedewerkers het werk uitvoeren, stuurt Qargo trackingmijlpalen naar Hazchem, waaronder scanevenementen zoals:
- Ophaaldepot uitgescand
- Leveringsdepot ingescand
- Leveringsdepot opgeslagen
- Leveringsdepot uitgescand
Statusexport
Qargo stuurt ook een status naar Hazchem bij de volgende evenementen:
| Qargo-evenement | Statusevenement | Rol van het depot |
|---|---|---|
| POC | Ophaalstop is voltooid | Ophaling |
| DONR | Ophaling in het leveringsdepot is voltooid | Levering |
| ARDL | Bij de leveringsstop | Levering |
| POD | POD is aangemaakt | Levering |
Proof of delivery registreren en delen
De POD wordt in Qargo geregistreerd via de chauffeur-app of de backoffice. Na het uploaden wordt de POD
via de API naar Hazchem verzonden, zodat de betrokken partijen in het netwerk deze meteen kunnen zien.
Leveringsfoto’s en klantdocumenten
Leveringsfoto’s (foto’s die bij de levering zijn genomen) en COP-documenten worden in beide richtingen uitgewisseld:
- Wanneer leveringsfoto’s en COP in Qargo aan een zending worden toegevoegd, worden ze automatisch via de API naar Hazchem geüpload
- Leveringsfoto’s en COP-documenten van Hazchem worden elke 10 minuten automatisch via een achtergrondsynchronisatie in Qargo opgehaald
Overzicht van functies en richting van de gegevensstroom
| Functie | Richting | Typische trigger | Waar zichtbaar in Qargo |
|---|---|---|---|
| Nieuwe zending | Push vanuit Hazchem | Order aangemaakt in Hazchem | Orderlijst / wachtrij met inkomend werk |
| Palletlabels | Aangemaakt in Qargo | Dispatchactie | Labelsectie van de order |
| Trackingmijlpalen | Push vanuit Qargo | Statuswijziging / chauffeur-app | Tijdlijn en activiteit van de order |
| Scanevenementen | Push vanuit Qargo | Barcodescan in het depot | Scangeschiedenis van de order |
| POD (handtekening, naam, tijdstempel) | Push vanuit Qargo | POD geregistreerd in de app of de backoffice | POD-sectie en bijlagen |
| Leveringsfoto’s (uitgaand) | Push vanuit Qargo | Foto geüpload naar de zending | Bijlagen bij de order |
| Leveringsfoto’s (inkomend) | Synchronisatie vanuit Hazchem | Elke 10 minuten | Bijlagen bij de order |
| COP-documenten (uitgaand) | Push vanuit Qargo | COP geüpload naar de zending | Documenten bij de order |
| COP-documenten (inkomend) | Synchronisatie vanuit Hazchem | Elke 10 minuten | Documenten bij de order |
| Zendingsnummer (factuurmatching) | Gebruikt in Qargo | Upload van een aankoopfactuur | Factuurmatching / scannen en matchen |
Praktische tips
- De dispatchstap in Qargo voltooien voordat de zending het depot verlaat, zodat de palletlabels worden aangemaakt en de tracking correct start.
- Leveringsfoto’s en COP worden elke 10 minuten automatisch gesynchroniseerd; ze hoeven dus niet handmatig bij Hazchem te worden opgevraagd.
- Bij het uploaden van COP erop letten dat de upload door het aanvragende depot of het ophaaldepot gebeurt; leveringsdepots kunnen geen COP via de API uploaden.
- Voor de factuurafstemming is het Hazchem-zendingsnummer een van de velden die de functie scannen en matchen in Qargo gebruikt bij het uploaden van aankoopfacturen.
Veelgestelde vragen
Waarom is een POD niet zichtbaar in Hazchem?
- Controleren of de POD met een tijdstempel aanwezig en bijgevoegd is in Qargo.
- Controleren of de chauffeur-app gesynchroniseerd is nadat de POD werd geregistreerd.
- De API-push even de tijd geven om te worden verwerkt.
Leveringsfoto’s van Hazchem verschijnen niet: wat controleren?
- De inkomende synchronisatie loopt elke 10 minuten. Als de foto’s na 10–15 minuten nog niet verschijnen, controleren of de zending een Hazchem-trackingreferentie heeft en of de integratie actief is.
- Contact opnemen met Qargo support als het probleem aanhoudt.
Moeten POD’s opnieuw worden ingevoerd in Hazchem?
Nee. POD’s die in Qargo worden geregistreerd, worden automatisch naar Hazchem gepusht; handmatig opnieuw invoeren in het Hazchem-systeem is niet nodig.
Kunnen Hazchem-labels vanuit Qargo worden geprint?
Ja. Labels worden aangemaakt als onderdeel van de dispatchstap en zijn beschikbaar bij de order
in Qargo. De printprocedure van het depot volgen om de labels te printen en aan te brengen voordat de goederen worden geladen.
Probleemoplossing
| Symptoom | Stappen om het op te lossen |
|---|---|
| Nieuwe zendingen verschijnen niet in Qargo | De filters in het orderoverzicht controleren. Controleren of de Hazchem-integratie actief is en of de zending in Hazchem is aangemaakt. |
| Labels worden niet aangemaakt | Controleren of de dispatchactie voltooid is. Nagaan of er verplichte velden van de zending ontbreken. |
| Tracking niet zichtbaar in Hazchem | Controleren of de zending in Qargo gedispatcht is en of de statusupdates van de chauffeur of de app zijn verzonden. De verbinding controleren. |
| Leveringsfoto’s of COP worden niet gesynchroniseerd | Tot 10 minuten wachten op de automatische synchronisatie. Controleren of de Hazchem-trackingreferentie op de zending in Qargo staat. |
| POD niet ontvangen door Hazchem | Controleren of de POD met een tijdstempel en bijlage in Qargo is opgeslagen. Contact opnemen met support en de Hazchem-referentie vermelden als het probleem aanhoudt. |
