Skip to main content
Qargo

Palletnetwerk: export en import van orders bij PALL-EX/Fortec

Dit artikel legt uit hoe orders vanuit Qargo naar het palletnetwerk van PALL-EX of Fortec worden geëxporteerd en hoe inkomende orders vanuit Nexus in Qargo worden geïmporteerd.

Inhoudsopgave
  1. Inleiding
  2. Terminologie
  3. Orderexport (Qargo → Nexus)
  4. Orderimport (Nexus → Qargo)
  5. Statussynchronisatie
  6. Synchronisatie van POD’s en documenten
  7. ETA-export via Optimize (optioneel)

Inleiding

Wat behandelt dit artikel?

  • Een zending naar PALL-EX of Fortec dispatchen
  • Hoe het netwerk wordt bepaald (PALL-EX of Fortec)
  • Labels genereren na de dispatch
  • Een dispatch annuleren
  • Regels voor de ophaaldatum en de cut-off om 12.00 uur
  • Hoe orders vanuit Nexus in Qargo worden geïmporteerd
  • Synchronisatie van de trackingstatus
  • Synchronisatie van POD’s en documenten
  • ETA-export via Optimize

Voor wie is dit artikel?

  • Dispatchers en planners die zendingen naar het palletnetwerk versturen
  • Medewerkers van operations die de status van trips in Qargo opvolgen

Terminologie

Term Definitie
Dispatchtaak voor de resource De taak in Qargo die bij voltooiing een zending via de Nexus API naar het palletnetwerk verzendt
PALLEX_OUT De resourcecode die een onderaannemer identificeert als resource voor het PALL-EX-netwerk
FORTEC_OUT De resourcecode die een onderaannemer identificeert als resource voor het Fortec-netwerk
Nexus-klant-ID De unieke code die een klant in het Nexus-systeem identificeert; moet in Qargo per klant worden geconfigureerd
Cut-off-tijd 12.00 uur (‘s middags): het tijdstip waarna ophalingen op dezelfde dag of de volgende dag een latere ophaaldatum vereisen
MPOD Digitale handtekening die bij de levering wordt vastgelegd
POD Afbeelding van het ondertekende afleveringsbewijs
MPODPHOTOE Foto van de pallets op de leveringslocatie
Optimize De module voor route-optimalisatie waarmee ETA’s van Qargo naar Nexus worden doorgestuurd

Orderexport (Qargo → Nexus)

Een zending dispatchen

  • De trip toewijzen aan de resource van onderaannemer PALL-EX of Fortec, afhankelijk van het netwerk dat voor de zending nodig is.
  • De dispatchtaak voor de resource op de trip voltooien. Hiermee wordt de zending via de API naar Nexus verzonden.
  • Controleren of er een palletlabel is gedownload en aan het documentenpaneel van de zending is toegevoegd.

Hoe het netwerk wordt bepaald

Het netwerk (PALL-EX of Fortec) wordt bepaald door de resource van de onderaannemer die aan de trip is toegewezen:

Resourcecode Netwerk
PALLEX_OUT` Zending naar PALL-EX verzonden
FORTEC_OUT` Zending naar Fortec verzonden
  • Bij de dispatch geeft Qargo de bijbehorende Nexus-klant-ID (geconfigureerd in de klantgegevens) door aan de API. De API stuurt de zending op basis van deze ID naar het juiste netwerk.

Wat er gebeurt na de dispatch

Nadat de dispatchtaak voor de resource is voltooid:

  • Er wordt automatisch een palletlabel uit Nexus gedownload en in Qargo aan de zending toegevoegd
  • De zending is zichtbaar in het Nexus-portaal
  • Nexus begint scanevenementen naar Qargo terug te sturen terwijl de zending door het netwerk gaat

Een dispatch annuleren

  • Een dispatch kan worden geannuleerd door de resource van de onderaannemer uit de trip te verwijderen.
  • Hiermee wordt een annuleringsverzoek naar Nexus gestuurd en wordt de zending uit het netwerk gehaald.

Regels voor de ophaaldatum

PALL-EX/Fortec hanteert strikte regels voor ophaaldata. Qargo bepaalt het serviceniveau van de ophaling automatisch op basis van de datum en het tijdstip van de export:

Scenario Resultaat
Export op dezelfde dag, vóór de cut-off van 12.00 uur Service PREMIUM gebruikt
Export op dezelfde dag, na de cut-off van 12.00 uur ❌ Fout: ophaling niet mogelijk
Export op vrijdag → ophaling op zaterdag ❌ Fout: niet ondersteund
Export op vrijdag → maandag, vóór 12.00 uur SPECIFIC_DAY
Export op vrijdag → maandag, na 12.00 uur PREMIUM
Volgende dag (ma–do), vóór 12.00 uur SPECIFIC_DAY
Volgende dag (ma–do), na 12.00 uur PREMIUM
Export in het weekend → volgende werkdag ❌ Fout
Toekomstige datum (>1 dag later) SPECIFIC_DAY

Labels genereren

  • Onmiddellijk na een geslaagde dispatch wordt automatisch een palletlabel uit Nexus gedownload.
  • Het label wordt in Qargo aan het documentenpaneel van de zending toegevoegd en kan van daaruit worden geprint.
  • Er is geen manuele stap nodig om het label te verkrijgen: het wordt gegenereerd en gedownload als onderdeel van het dispatchproces.

Orderimport (Nexus → Qargo)

Hoe de import werkt

  • Qargo bevraagt de Nexus API om de paar minuten om nieuwe en bijgewerkte zendingen voor het depot binnen te halen.
  • Geïmporteerde orders volgen de standaard orderimportflow van Qargo.

Import uit twee netwerken

  • Omdat PALL-EX en Fortec de Nexus API delen, importeert Qargo orders voor beide netwerken tegelijk in één bevragingscyclus.
  • Het netwerk (PALL-EX of Fortec) wordt herkend aan de hand van de gegevens die de API teruggeeft, en de betreffende codes worden in de importmapping gebruikt.

Statussynchronisatie

Statusimport (Nexus → Qargo)

Qargo bevraagt Nexus om de paar minuten op statusupdates. De onderstaande statussen worden geïmporteerd en gemapt naar de trackinglevenscyclus van Qargo:

Nexus-status Qargo-status
ARRIVED_AT_COLLECTION_POINT Ophaling aangekomen
COLLECTED Ophaling ingescand
DEPOT_SCAN_IN_FROM_CUSTOMER Ophaaldepot ingescand
DEPOT_SCAN_OUT_TO_HUB Ophaaldepot uitgescand
HUB_TRUNK_IN Hub aangekomen
HUB_SCAN_IN Hub ingescand
HUB_HELDOVER Hub opgeslagen
HUB_SCAN_OUT Hub uitgescand
HUB_TRUNK_OUT Hub vertrokken
DEPOT_SCAN_IN Leveringsdepot ingescand
OUT_FOR_DELIVERY Leveringsdepot vertrokken
ARRIVED_AT_DELIVERY_POINT Levering aangekomen
DELIVERY_EPOD_RECEIVED Levering uitgescand
DELIVERED Levering uitgescand

Statusexport (Qargo → Nexus)

Qargo stuurt statusupdates terug naar Nexus als onderdeel van het zichtbaarheidsframework. Die worden automatisch geactiveerd door specifieke evenementen in Qargo:

  • Ophaling voltooid → status geëxporteerd naar Nexus
  • Bij de leveringsstop → status geëxporteerd
  • Levering bevestigd → status geëxporteerd

Synchronisatie van POD’s en documenten

Leveringsbewijzen worden in beide richtingen gesynchroniseerd tussen Nexus en Qargo.

Documenttype Nexus Beschrijving Documenttype Qargo
MPOD Digitale handtekening / Sign-On-Glass-afbeelding van de ontvanger Handtekening ontvanger
POD Afbeelding van het ondertekende afleveringsbewijs POD/CMR
MPODPHOTOE Foto van de pallets op de leveringslocatie Foto van goederen (levering)
  • Import: documenten worden periodiek vanuit Nexus gesynchroniseerd en in Qargo bij de zending opgeslagen.
  • Export: wanneer in Qargo een document van een van de bovenstaande types wordt aangemaakt of geüpload en het depot het leveringsdepot van de zending is, wordt het document automatisch naar Nexus verzonden.

ETA-export via Optimize (optioneel)

ETA’s kunnen via Optimize, de module voor route-optimalisatie, van Qargo naar Nexus worden doorgestuurd.