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
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.
