Skip to main content
Qargo

PN - Pallet Track-integratie: wat, waarom en hoe.

Verbindt Qargo en Pallet Track van begin tot eind: inkomende status- en documentsynchronisatie, uitgaande zichtbaarheid van documenten, ETA, schadestatussen en manuele statussen, plus dag- of nachtsortering bij het dispatchen.

Inhoudsopgave
  1. Samenvatting
  2. Overzicht van de functionaliteit
  3. Terminologie
  4. Vereisten
  5. Aan de slag
  6. Inkomend: statussynchronisatie
  7. Uitgaand: manuele statusupdates
  8. Inkomend: documentsynchronisatie
  9. Inkomend: synchronisatie van de handtekening van de ontvanger
  10. Uitgaand: documentzichtbaarheid
  11. Uitgaand: ETA-zichtbaarheid
  12. Uitgaand: updates van schadestatussen
  13. Dispatchen: sortering
  14. Probleemoplossing

Suggesties voor screenshots

  1. Een zending in Qargo met de Barcodegeschiedenis met Pallet Track-statuscodes en tijdstempels (bv. Gedispatcht, In hub, Geleverd).
  2. De integratieactie voor manuele statussen op een zending, met de keuzelijst Statuscode en de invoervelden (notitie, barcode, afmetingen, datum/tijd).
  3. Een zending met een document (POD of leveringsfoto) dat uit Pallet Track is opgehaald.
  4. Een zending met een handtekening van de ontvanger (ePOD) en de bijbehorende metadata: naam van de ontvanger, locatie en tijdstip van ondertekening.
  5. Een zending met een POD of handtekening die in Qargo is toegevoegd en in het Pallet Track-portaal gespiegeld wordt weergegeven.
  6. Een leveringsstop van een trip met een geschatte aankomsttijd die naar Pallet Track is verzonden.
  7. Een foto van beschadigde goederen op een order en de statusgeschiedenis van de pallet met een schadecode (DAD / DDD / DAC).
  8. Het veld Sortering in het detailformulier van de zending met de keuzelijst DAY / NIGHT.

Samenvatting

  • Wat is het?

    • De Pallet Track-integratie houdt Qargo en het Pallet Track-netwerk gesynchroniseerd gedurende de volledige levenscyclus van een zending. Statussen en documenten worden uit Pallet Track in Qargo opgehaald. Documenten, ETA’s, schadestatussen en manuele statusupdates worden vanuit Qargo naar Pallet Track verzonden. Daarnaast kan per zending bij het dispatchen dag- of nachtsortering worden ingesteld.
  • Waarom gebruiken?

    • Wie op beide platformen werkt, moet anders in elk systeem manueel statussen bijwerken en documenten overzetten. Door de stroom te automatiseren verdwijnt dubbel werk en zijn er minder gemiste of vertraagde updates. De integratie helpt ook om aan de netwerkvereisten te voldoen (tijdige statusrapportering) en geeft elke partij hetzelfde beeld van elke zending.
  • Hoe werkt het?

    • Qargo bevraagt de status-API van Pallet Track elke minuut en verwerkt statusupdates en inkomende documenten op de overeenkomstige zending. In de relevante fase van het transport stuurt Qargo automatisch documenten, ETA’s en schadestatussen terug naar Pallet Track. Kantoorgebruikers kunnen daarnaast op aanvraag een ruimere set netwerkstatuscodes verzenden. Bij het dispatchen van zendingen wordt een sorteringswaarde aan Pallet Track doorgegeven.

Overzicht van de functionaliteit

Overzicht in één oogopslag van wat de Pallet Track-integratie ondersteunt.

Functie Richting Ondersteund Opmerkingen
Orderexport Q → PT Ja Zendingen gedispatcht naar Pallet Track
Orderimport / implants PT → Q Ja Vereist de accountcode van Pallet Track
Updates en verwijderingen van jobs Q → PT Ja
Labels aanmaken Q → PT Ja Ook beschikbaar vóór het dispatchen
Statussynchronisatie PT → Q Ja Elke minuut bevraagd; meer dan 90 codes gemapt
Stop- en statusupdates Q → PT Ja Automatisch, plus manuele codes voor kantoorgebruikers
POD Beide Ja Papieren POD in Pallet Track
ePOD / handtekening van de ontvanger Beide Ja Inkomend vereist extra configuratie van de statussynchronisatie en het verantwoordelijke ophalende depot
Leverings- en ophalingsfoto’s Beide Ja Op basis van rol: verzonden voor het traject dat de tenant uitvoert
COP (Confirmation of Pickup) Beide Te bevestigen Zie de opmerking voor de reviewer bovenaan deze pagina
Uploaden van klantdocumenten Q → PT Ja Via het klantenportaal en de API
ETA Q → PT Ja Alleen leveringsstops; automatisch
ETA PT → Q Nog te bepalen Wordt momenteel niet van het netwerk ontvangen
Crossdockscans Beide Ja
Updates van schadestatussen Q → PT Ja DAD / DDD / DAC, bepaald door de huidige stop
Sortering Q → PT Ja DAY of NIGHT, toegepast bij het dispatchen
Meerdere depots — Ja Eén depotnummer per Pallet Track-integratie
Kosten via API Q → PT Nog te bepalen Niet bevestigd
Testsysteem — Ja Beschikbaar om te testen vóór de livegang

Terminologie

‼️ Actie voor de reviewer: plaats van de terminologie. Sommige termen hieronder beschrijven het integratiekader van Qargo eerder dan Pallet Track specifiek, en komen bij meerdere netwerken terug. Ze moeten daarom naar de algemene pagina PN - Terminologie van palletnetwerken worden verplaatst (en hier worden verwijderd): Statussynchronisatie, Documentsynchronisatie, Documentzichtbaarheid, Barcodegeschiedenis, Traceergeschiedenis van goederen en Vooraf ondertekende URL (die laatste is wellicht te technisch voor een KB voor klanten).

De termen die op deze Pallet Track-pagina moeten blijven, zijn: Pallet Track, Post Status API, Sortering en Trackingcode / palletcode (met een Pallet Track-naam, al is het concept algemeen). Opmerking: netwerkartikels volgen dit vandaag niet strikt (bv. UPN herhaalt algemene termen), dus de afspraak eerst bevestigen voordat de gepubliceerde pagina’s worden bewerkt. [rode callout]

De termen hieronder zijn specifiek voor de Pallet Track-integratie.

Term Definitie
Pallet Track Een Brits palletnetwerk dat regionale vervoerders verbindt voor landelijk vervoer van palletgoederen.
Trackingcode / palletcode De barcode of referentie van Pallet Track die aan een zending is toegekend, gebruikt om updates en documenten aan het juiste order te koppelen.
Barcodegeschiedenis Het overzicht van alle statusupdates van een zending in Qargo, weergegeven bij de barcode-informatie van de zending.
Statussynchronisatie Automatisch ophalen van statusupdates van zendingen uit Pallet Track in Qargo.
Documentsynchronisatie Automatisch importeren van documenten uit Pallet Track in Qargo.
Documentzichtbaarheid Automatisch verzenden van documenten van Qargo naar Pallet Track.
Post Status API De interface van Pallet Track die Qargo gebruikt om statusupdates te verzenden.
Sortering Wanneer goederen in de hub van Pallet Track worden gesorteerd: NIGHT (standaard, ‘s nachts) of DAY (overdag).
Traceergeschiedenis van goederen Het overzicht van evenementen en incidenten (zoals schade) die voor een individuele pallet zijn geregistreerd.
Vooraf ondertekende URL Een tijdelijke, beveiligde link van Pallet Track die gedurende een beperkte tijd toegang geeft tot een document.

Vereisten

  • De Pallet Track-integratie moet actief zijn op het Qargo-account. Elk functiedomein wordt per tenant door het Qargo-team geactiveerd.
  • Zendingen moeten naar Pallet Track gedispatcht zijn en een geldige trackingcode van Pallet Track hebben, zodat statussen en documenten kunnen doorstromen.
  • Documenttypes die gesynchroniseerd moeten worden, moeten in de documentconfiguratie van het account geactiveerd zijn.
  • Voor manuele statusupdates moet het order al naar Pallet Track geëxporteerd zijn en moet de actie voor manuele statussen op de integratie geconfigureerd zijn.

Aan de slag

De Pallet Track-integratie wordt door Qargo geconfigureerd en geactiveerd. Om te beginnen contact opnemen met de accountmanager of het integratieteam. Het volgende is nodig van de klant:

  • Depotnummer bij Pallet Track: de identificatie van het depot in Pallet Track. Eén depot komt overeen met één Pallet Track-integratie; bij meerdere depots is het nummer van elk depot nodig.
  • Accountcode bij Pallet Track: alleen vereist als implants worden gebruikt (orders die in het Pallet Track-portaal worden aangemaakt waarbij het aanvragende depot het eigen depot van de klant is).
  • Vereiste functies: bevestiging van de nodige stromen: orderimport/-export, statussynchronisatie, documentsynchronisatie (welke documenten, en in één of twee richtingen), labels aanmaken, ETA-synchronisatie, crossdocksynchronisatie, kosten via API en implants.
  • Depotinstellingen: of er met meerdere depots wordt gewerkt, en de rol van elk depot (ophaling, levering, aanvraag) en de geldende serviceniveaus.
  • Contactpersonen: een IT-contactpersoon om in kopie te zetten bij contact met Pallet Track, en een escalatiecontact voor problemen (naam en e-mailadres).

Inkomend: statussynchronisatie

Qargo bevraagt de status-API van Pallet Track elke minuut en importeert nieuwe statusupdates voor actieve zendingen. Elke update wordt via de trackingcode van de pallet aan het order en de verpakkingseenheid gekoppeld. Updates verschijnen automatisch in de Barcodegeschiedenis van de zending; er is geen manuele actie nodig.

  • Meer dan 90 verschillende statuscodes worden ondersteund, elk gemapt naar de passende Qargo-status.
  • Ongeveer 70 administratieve of informatieve codes (bv. aanvragen voor documenten of creditnota’s) hebben geen equivalent in Qargo en worden als Overig opgeslagen. Ze worden bewaard voor audits, maar wijzigen de hoofdstatus van de zending niet.

Veelvoorkomende mappings:

Pallet Track-code Qargo-status Betekenis
DSO Gedispatcht Goederen vertrokken uit het depot van herkomst
DSI In hub Goederen ontvangen in de hub van Pallet Track
DSV Geleverd Goederen succesvol geleverd
DUE Onbestelbaar Levering kon niet worden voltooid
Other Overig Administratieve / informatieve codes (geen equivalent in Qargo)

Uitgaand: manuele statusupdates

Met een configureerbare integratieactie kunnen kantoorgebruikers op aanvraag extra Pallet Track-statuscodes voor een zending verzenden, naast de statussen die de standaardwerkstroom automatisch verzendt. Zo kan de brede set levenscyclusstatussen worden gemeld die het netwerk van depots verlangt (mislukte ophalingen, uitzonderingen bij levering, wijzigingen, re-carding en dergelijke). Veel daarvan ontstaan op kantoor en niet in de cabine.

Om een manuele statusupdate te verzenden:

  1. De zending die een update nodig heeft openen.
  2. De Pallet Track-statusactie starten.
  3. De vereiste statuscode in de keuzelijst selecteren.
  4. De relevante optionele velden invullen: een notitie, de betrokken pallet (barcode), de afmetingen van de pallet (gewicht, lengte, hoogte, breedte) en de datum en tijd (zonder invoer wordt het huidige tijdstip gebruikt).
  5. De update naar Pallet Track verzenden.

Inkomend: documentsynchronisatie

Documenten die in Pallet Track worden geüpload, worden automatisch gedetecteerd, in Qargo geïmporteerd en aan de overeenkomstige zending gekoppeld. Bestanden worden opgehaald via vooraf ondertekende URL’s die de status-API teruggeeft, en verwerkt door de standaard documentsynchronisatie van Qargo.
Ondersteunde inkomende documenttypes: POD, leveringsfoto’s, ophalingsfoto’s.

Inkomend: synchronisatie van de handtekening van de ontvanger

Wanneer het Pallet Track-netwerk een levering voltooit en de ontvanger tekent, wordt de handtekening van de ontvanger als ePOD-document met de bijbehorende metadata in Qargo gesynchroniseerd. Ze wordt rechtstreeks op de zending opgeslagen als bewijs van levering:

  • De handtekening van de ontvanger (ePOD-document)
  • Naam van de ontvanger
  • Locatie van ondertekening
  • Tijdstip van ondertekening

Uitgaand: documentzichtbaarheid

Wanneer documenten in Qargo aan een zending worden toegevoegd, worden ze automatisch naar Pallet Track verzonden en daar aan het overeenkomstige zendingsrecord gekoppeld. Bij handtekeningen van ontvangers bevat de upload ook de naam van de ondertekenaar en het tijdstip van registratie.

Documenttype in Qargo Weergave in Pallet Track
Bewijs van levering (POD) Papieren POD
Handtekening van de ontvanger Elektronische POD (ePOD)
Leveringsfoto Leveringsfoto
Ophalingsfoto Ophalingsfoto

De verzending gebeurt op basis van rol, dus documenten worden alleen verzonden voor het traject dat de tenant uitvoert:

  • POD’s, handtekeningen van ontvangers en leveringsfoto’s worden verzonden wanneer de tenant de levering uitvoert.
  • Ophalingsfoto’s worden verzonden wanneer de tenant de ophaling uitvoert.

Uitgaand: ETA-zichtbaarheid

Wanneer de geschatte starttijd van een leveringsstop in Qargo wijzigt (voortgang van de chauffeur, vertragingen, route-optimalisatie), wordt de bijgewerkte ETA automatisch naar Pallet Track verzonden. Zo kan de hub personeel, materieel en sortering plannen. De verzonden gegevens omvatten de ETA van de leveringsstop, de referentie van de zending, de jobreferentie van Pallet Track, de depotcode en de volgorde van de stops.

Uitgaand: updates van schadestatussen

Wanneer een foto van beschadigde goederen bij een order wordt geüpload, controleert Qargo welke pallets een incident in hun traceergeschiedenis van goederen hebben. Alleen voor die pallets wordt een update van de schadestatus naar Pallet Track verzonden. De code geeft aan waar in het transport de schade wordt gemeld en wordt bepaald door de huidige stop:

  • DAD – beschadigd bij aankomst in depot: de huidige stop is het begin van een goederentransfer in het depot (aankomende goederen).
  • DDD – beschadigd bij vertrek uit depot: de huidige stop is het einde van een goederentransfer in het depot (vertrekkende goederen).
  • DAC – beschadigd bij aankomst bij ontvanger: de huidige stop is de leveringsstop.

Dispatchen: sortering

De sortering bepaalt wanneer goederen in de hub van Pallet Track worden gesorteerd. Een waarde voor Sortering (NIGHT: standaard, ‘s nachts; DAY: tijdens de dagopeningsuren van de hub) wordt per zending ingesteld en bij het dispatchen aan Pallet Track doorgegeven.
Om de sortering op een zending in te stellen:

  1. Naar het order gaan en de zending openen die aan Pallet Track is toegewezen.
  2. Het veld Sortering (in de sectie met extra velden) op NIGHT of DAY instellen.
  3. De zending opslaan: de waarde wordt bij het dispatchen toegepast.

Via de orderimport kan ook een standaardwaarde worden ingesteld, door het bronveld te mappen naar het Qargo-veld pallet_track__sortation en een standaardwaarde (NIGHT of DAY) te configureren voor zendingen zonder expliciete waarde. Voor individuele zendingen kan de waarde vóór het dispatchen worden gewijzigd.


Probleemoplossing

Probleem Oplossing
Statusupdates verschijnen niet in Qargo Controleren of de integratie actief is en de zending naar Pallet Track is gedispatcht met een overeenkomstige trackingcode. Nieuwe statussen kunnen tot één minuut nodig hebben.
Een status wordt als Overig weergegeven Normaal voor de ongeveer 70 administratieve codes zonder equivalent in Qargo; de volledige geschiedenis staat in de barcodetijdlijn.
Actie voor manuele statussen niet zichtbaar Controleren of de actie voor manuele statussen op de integratie is geconfigureerd en de gebruiker een kantoorgebruiker is.
Manuele status afgewezen Controleren of het order naar Pallet Track is geëxporteerd en de ingevoerde barcode overeenkomt met een pallet op de zending; sommige codes vereisen extra details vóór het verzenden.
Documenten uit Pallet Track verschijnen niet in Qargo Controleren of de documentsynchronisatie actief is en het type een POD, leveringsfoto of ophalingsfoto is (ePOD vereist extra instellingen; COP wordt niet ondersteund).
Handtekening van de ontvanger of metadata ontbreekt Controleren of documentsynchronisatie en statussynchronisatie actief zijn, de extra configuratie voor de metadata van handtekeningen aanwezig is en het depot het verantwoordelijke ophalende depot is.
Documenten uit Qargo verschijnen niet in Pallet Track Controleren of documentzichtbaarheid is geactiveerd, er een geldige trackingcode aanwezig is en het document in de juiste fase (levering of ophaling) is toegevoegd.
ETA niet naar Pallet Track verzonden Controleren of de stop een leveringsstop is, het depot de leverende partij is en de zending naar Pallet Track is gedispatcht (ETA’s voor ophalingen worden niet ondersteund).
Geen schadestatus verzonden na het uploaden van een foto Controleren of de betrokken pallets daadwerkelijk een incident in hun traceergeschiedenis van goederen hebben; alleen die pallets krijgen een update.
Onverwachte schadecode (DAD/DDD/DAC) De code wordt bepaald door de huidige stop; nagaan welke stop de huidige was toen de foto werd geüpload.
Veld voor sortering niet zichtbaar Controleren of de integratie is geconfigureerd en de zending aan Pallet Track is toegewezen; het veld is specifiek voor Pallet Track.
Fouten in de sortering bij het dispatchen De waarde moet NIGHT of DAY zijn (niet hoofdlettergevoelig); ongeldige waarden worden door Pallet Track geweigerd.