Skip to main content
Qargo

PN – Pallet-Track-Integration: Was, warum und wie.

Verbindet Qargo und Pallet Track durchgängig: eingehende Status- und Dokumentsynchronisierung, ausgehende Übertragung von Dokumenten, ETA, Beschädigungsstatus und manuellen Status sowie Tag- oder Nachtsortierung bei der Übermittlung.

Inhaltsverzeichnis
  1. Zusammenfassung
  2. Funktionsübersicht
  3. Begriffe
  4. Voraussetzungen
  5. Erste Schritte
  6. Eingehend: Statussynchronisierung
  7. Ausgehend: Manuelle Statusaktualisierungen
  8. Eingehend: Dokumentsynchronisierung
  9. Eingehend: Synchronisierung der Empfängerunterschrift
  10. Ausgehend: Dokumentübertragung
  11. Ausgehend: ETA-Übertragung
  12. Ausgehend: Aktualisierungen des Beschädigungsstatus
  13. Übermittlung: Sortierung
  14. Fehlerbehebung

Vorschläge für Screenshots

  1. Eine Sendung in Qargo mit der Barcode-Historie, die Pallet-Track-Statuscodes und Zeitstempel zeigt (z. B. Übermittelt, Im Hub, Zugestellt).
  2. Die Integrationsaktion für den manuellen Status an einer Sendung mit dem Dropdown Statuscode und den Eingabefeldern (Notiz, Barcode, Abmessungen, Datum/Uhrzeit).
  3. Eine Sendung mit einem Dokument (POD oder Lieferfoto), das aus Pallet Track übernommen wurde.
  4. Eine Sendung mit einer Unterschrift des Empfängers (ePOD) und den zugehörigen Metadaten: Name des Empfängers, Standort und Zeitstempel der Unterschrift.
  5. Eine Sendung mit einem in Qargo angehängten POD bzw. einer Unterschrift, gespiegelt im Pallet-Track-Portal.
  6. Ein Lieferstopp einer Fahrt mit einer geschätzten Ankunftszeit, die an Pallet Track gesendet wurde.
  7. Ein Foto beschädigter Ware an einem Auftrag und die Statushistorie der Palette mit einem Beschädigungscode (DAD / DDD / DAC).
  8. Das Feld Sortierung im Detailformular der Sendung mit dem Dropdown DAY / NIGHT.

Zusammenfassung

  • Was ist das?

    • Die Pallet-Track-Integration hält Qargo und das Pallet-Track-Netzwerk über den gesamten Lebenszyklus einer Sendung hinweg synchron. Status und Dokumente werden aus Pallet Track in Qargo übernommen. Dokumente, ETAs, Beschädigungsstatus und manuelle Statusaktualisierungen werden von Qargo an Pallet Track gesendet. Zusätzlich lässt sich bei der Übermittlung pro Sendung eine Tag- oder Nachtsortierung festlegen.
  • Warum nutzen?

    • Ohne Integration müssen bei der Arbeit mit beiden Plattformen Status in jedem System von Hand aktualisiert und Dokumente manuell übertragen werden. Die Automatisierung vermeidet doppelte Arbeit und verringert verpasste oder verspätete Aktualisierungen. Sie unterstützt die Einhaltung der Netzwerkvorgaben (rechtzeitige Statusmeldungen) und gibt allen Beteiligten eine einheitliche Sicht auf jede Sendung.
  • Wie funktioniert es?

    • Qargo fragt die Status-API von Pallet Track jede Minute ab und überträgt Statusaktualisierungen und eingehende Dokumente auf die passende Sendung. In der jeweiligen Phase des Transports sendet Qargo Dokumente, ETAs und Beschädigungsstatus automatisch an Pallet Track zurück. Nutzer im Büro können bei Bedarf zusätzlich weitere Statuscodes des Netzwerks senden. Bei der Übermittlung von Sendungen wird außerdem ein Sortierungswert an Pallet Track übergeben.

Funktionsübersicht

Überblick über die von der Pallet-Track-Integration unterstützten Funktionen.

Funktion Richtung Unterstützt Hinweise
Auftragsexport Q → PT Ja Sendungen werden an Pallet Track übermittelt
Auftragsimport / Implants PT → Q Ja Erfordert den Pallet-Track-Kontocode
Aktualisieren und Löschen von Jobs Q → PT Ja
Etikettenerstellung Q → PT Ja Auch vor der Übermittlung verfügbar
Statussynchronisierung PT → Q Ja Abfrage jede Minute; über 90 Codes zugeordnet
Stopp- / Statusaktualisierungen Q → PT Ja Automatisch, dazu manuelle Codes für Nutzer im Büro
POD Beide Ja Papier-POD in Pallet Track
ePOD / Unterschrift des Empfängers Beide Ja Eingehend sind eine zusätzliche Konfiguration der Statussynchronisierung und das zuständige Abholdepot erforderlich
Liefer- und Abholfotos Beide Ja Rollenbasiert: Versand für den Abschnitt, den der Mandant ausführt
COP (Abholbestätigung) Beide Noch zu bestätigen Siehe Hinweis für Prüfer oben auf dieser Seite
Hochladen von Kundendokumenten Q → PT Ja Über das Kundenportal und die API
ETA Q → PT Ja Nur Lieferstopps; automatisch
ETA PT → Q Offen Wird derzeit nicht vom Netzwerk empfangen
Cross-Docking-Scans Beide Ja
Aktualisierungen des Beschädigungsstatus Q → PT Ja DAD / DDD / DAC, abhängig vom aktuellen Stopp
Sortierung Q → PT Ja DAY oder NIGHT, bei der Übermittlung angewendet
Mehrere Depots — Ja Eine Depotnummer pro Pallet-Track-Integration
Gebühren über API Q → PT Offen Nicht bestätigt
Testsystem — Ja Für Tests vor dem Go-live verfügbar

Begriffe

‼️ Aufgabe für Prüfer – Platzierung der Begriffe. Einige der folgenden Begriffe beschreiben das Integrations-Framework von Qargo und nicht speziell Pallet Track. Sie kommen in mehreren Netzwerken vor und sollten daher auf die allgemeine Seite PN – Begriffe aus Palettennetzwerken verschoben werden (und anschließend hier entfernt werden): Statussynchronisierung, Dokumentsynchronisierung, Dokumentübertragung, Barcode-Historie, Warenverlaufshistorie und Presigned URL (Letzteres ist für eine Wissensdatenbank für Kunden vermutlich zu technisch).

Auf dieser Pallet-Track-Seite bleiben sollten: Pallet Track, Post Status API, Sortierung und Tracking-Code / Palettencode (mit Pallet-Track-Bezeichnung, obwohl das Konzept allgemein ist). Hinweis: Die Netzwerkartikel folgen dieser Regel derzeit nicht streng (z. B. wiederholt UPN allgemeine Begriffe). Die Konvention daher vor der Bearbeitung der veröffentlichten Seiten bestätigen. [roter Hinweis]

Die folgenden Begriffe beziehen sich speziell auf die Pallet-Track-Integration.

Begriff Definition
Pallet Track Ein britisches Palettennetzwerk, das regionale Transportunternehmen für landesweite Palettentransporte verbindet.
Tracking-Code / Palettencode Der Pallet-Track-Barcode bzw. die Referenz einer Sendung. Damit werden Aktualisierungen und Dokumente dem richtigen Auftrag zugeordnet.
Barcode-Historie Die Aufzeichnung aller Statusaktualisierungen einer Sendung in Qargo, angezeigt unter den Barcode-Informationen der Sendung.
Statussynchronisierung Automatischer Abruf von Statusaktualisierungen der Sendung aus Pallet Track in Qargo.
Dokumentsynchronisierung Automatischer Import von Dokumenten aus Pallet Track in Qargo.
Dokumentübertragung Automatische Übertragung von Dokumenten aus Qargo an Pallet Track.
Post Status API Die Pallet-Track-Schnittstelle, über die Qargo Statusaktualisierungen sendet.
Sortierung Zeitpunkt, zu dem die Ware im Pallet-Track-Hub sortiert wird: NIGHT (Standard, über Nacht) oder DAY (tagsüber).
Warenverlaufshistorie Die Aufzeichnung von Ereignissen und Vorfällen (z. B. Beschädigungen), die für eine einzelne Palette erfasst wurden.
Presigned URL Ein temporärer, sicherer Link von Pallet Track, der zeitlich begrenzten Zugriff auf ein Dokument gewährt.

Voraussetzungen

  • Die Pallet-Track-Integration muss im Qargo-Konto aktiv sein. Jeder Funktionsbereich wird vom Qargo-Team pro Mandant aktiviert.
  • Damit Status und Dokumente übertragen werden, müssen Sendungen an Pallet Track übermittelt sein und einen gültigen Pallet-Track-Tracking-Code haben.
  • Zu synchronisierende Dokumenttypen müssen in der Dokumentkonfiguration des Kontos aktiviert sein.
  • Für manuelle Statusaktualisierungen muss der Auftrag bereits an Pallet Track exportiert und die Aktion für den manuellen Status in der Integration konfiguriert sein.

Erste Schritte

Die Pallet-Track-Integration wird von Qargo konfiguriert und aktiviert. Zum Start den Account Manager oder das Integrationsteam kontaktieren. Von Kundenseite wird Folgendes benötigt:

  • Pallet-Track-Depotnummer: die Kennung des Depots in Pallet Track. Ein Depot entspricht einer Pallet-Track-Integration; bei mehreren Depots wird die Nummer jedes Depots benötigt.
  • Pallet-Track-Kontocode: nur erforderlich, wenn Implants genutzt werden (Aufträge, die im Pallet-Track-Portal erstellt werden und bei denen das anfordernde Depot das eigene Depot des Kunden ist).
  • Benötigte Funktionen: Bestätigung, welche Abläufe benötigt werden: Auftragsimport/-export, Statussynchronisierung, Dokumentsynchronisierung (welche Dokumente, ein- oder beidseitig), Etikettenerstellung, ETA-Synchronisierung, Cross-Docking-Synchronisierung, Gebühren über API und Implants.
  • Depot-Einrichtung: ob mehrere Depots betrieben werden, sowie die Rolle jedes Depots (Abholung, Lieferung, anfordernd) und die jeweils geltenden Servicelevel.
  • Ansprechpartner: ein IT-Kontakt, der bei der Abstimmung mit Pallet Track in Kopie gesetzt wird, und ein Eskalationskontakt bei Problemen (Name und E-Mail-Adresse).

Eingehend: Statussynchronisierung

Qargo fragt die Status-API von Pallet Track jede Minute ab und importiert neue Statusaktualisierungen für aktive Sendungen. Jede Aktualisierung wird über den Paletten-Tracking-Code dem Auftrag und der Ladeeinheit zugeordnet. Die Aktualisierungen erscheinen automatisch in der Barcode-Historie der Sendung. Ein manueller Eingriff ist nicht nötig.

  • Über 90 verschiedene Statuscodes werden unterstützt und jeweils dem passenden Qargo-Status zugeordnet.
  • Rund 70 administrative oder informative Codes (z. B. Dokumenten- oder Gutschriftanforderungen) haben keine Entsprechung in Qargo und werden als Sonstige gespeichert. Sie bleiben für Prüfzwecke erhalten, ändern aber nicht den Hauptstatus der Sendung.

Häufige Zuordnungen:

Pallet-Track-Code Qargo-Status Bedeutung
DSO Übermittelt Ware hat das Ursprungsdepot verlassen
DSI Im Hub Ware ist im Pallet-Track-Hub eingegangen
DSV Zugestellt Ware wurde erfolgreich zugestellt
DUE Nicht zustellbar Lieferung konnte nicht abgeschlossen werden
Sonstige Sonstige Administrative / informative Codes (ohne Entsprechung in Qargo)

Ausgehend: Manuelle Statusaktualisierungen

Über eine konfigurierbare Integrationsaktion können Nutzer im Büro bei Bedarf zusätzliche Pallet-Track-Statuscodes für eine Sendung senden, über die automatisch im Standardablauf gesendeten Status hinaus. So lässt sich die breite Palette an Lebenszyklusstatus abdecken, die Depots dem Netzwerk melden müssen (gescheiterte Abholungen, Lieferausnahmen, Änderungen, erneute Benachrichtigungskarten usw.). Viele davon entstehen im Büro und nicht im Fahrerhaus.

So wird eine manuelle Statusaktualisierung gesendet:

  1. Die Sendung, die aktualisiert werden muss, öffnen.
  2. Die Pallet-Track-Statusaktion auslösen.
  3. Den gewünschten Statuscode im Dropdown auswählen.
  4. Die relevanten optionalen Felder ausfüllen: eine Notiz, die betroffene Palette (Barcode), die Palettenabmessungen (Gewicht, Länge, Höhe, Breite) sowie Datum und Uhrzeit (ohne Angabe wird die aktuelle Uhrzeit verwendet).
  5. Die Aktualisierung an Pallet Track senden.

Eingehend: Dokumentsynchronisierung

In Pallet Track hochgeladene Dokumente werden automatisch erkannt, in Qargo importiert und an die passende Sendung angehängt. Die Dateien werden über Presigned URLs abgerufen, die die Status-API zurückgibt, und von der Standard-Dokumentsynchronisierung von Qargo verarbeitet.
Unterstützte eingehende Dokumenttypen: POD, Lieferfotos, Abholfotos.

Eingehend: Synchronisierung der Empfängerunterschrift

Wenn das Pallet-Track-Netzwerk eine Lieferung abschließt und der Empfänger unterschreibt, wird die Unterschrift als ePOD-Dokument mitsamt Metadaten in Qargo synchronisiert. Sie wird als Liefernachweis direkt an der Sendung gespeichert:

  • Die Unterschrift des Empfängers (ePOD-Dokument)
  • Name des Empfängers
  • Ort der Unterschrift
  • Zeitstempel der Unterschrift

Ausgehend: Dokumentübertragung

Werden in Qargo Dokumente zu einer Sendung hinzugefügt, werden sie automatisch an Pallet Track gesendet und dort mit dem passenden Sendungsdatensatz verknüpft. Bei Empfängerunterschriften enthält der Upload zusätzlich den Namen der unterschreibenden Person und den Zeitstempel der Erfassung.

Dokumenttyp in Qargo Darstellung in Pallet Track
Liefernachweis (POD) Papier-POD
Unterschrift des Empfängers Elektronischer POD (ePOD)
Lieferfoto Lieferfoto
Abholfoto Abholfoto

Die Übertragung ist rollenbasiert. Dokumente werden daher nur für den Abschnitt gesendet, den der Mandant ausführt:

  • POD, Empfängerunterschriften und Lieferfotos werden gesendet, wenn der Mandant die Lieferung durchführt.
  • Abholfotos werden gesendet, wenn der Mandant die Abholung durchführt.

Ausgehend: ETA-Übertragung

Ändert sich in Qargo die geschätzte Startzeit eines Lieferstopps (Fortschritt des Fahrers, Verzögerungen, Routenoptimierung), wird die aktualisierte ETA automatisch an Pallet Track gesendet. So kann der Hub Personal, Ausrüstung und Sortierung planen. Gesendet werden die ETA des Lieferstopps, die Sendungsreferenz, die Pallet-Track-Jobreferenz, der Depotcode und die Stoppreihenfolge.

Ausgehend: Aktualisierungen des Beschädigungsstatus

Wird ein Foto beschädigter Ware zu einem Auftrag hochgeladen, prüft Qargo, für welche Paletten ein Vorfall in der Warenverlaufshistorie erfasst ist. Nur für diese Paletten wird eine Beschädigungsstatusaktualisierung an Pallet Track gesendet. Der Code gibt an, an welcher Stelle des Transports die Beschädigung gemeldet wird, und richtet sich nach dem aktuellen Stopp:

  • DAD – Damaged on Arrival at Depot (beschädigt bei Ankunft im Depot): Der aktuelle Stopp ist ein Warenumschlag-Start im Depot (Ware trifft ein).
  • DDD – Damaged on Departure from Depot (beschädigt bei Abfahrt aus dem Depot): Der aktuelle Stopp ist ein Warenumschlag-Ende im Depot (Ware verlässt das Depot).
  • DAC – Damaged on Arrival at Consignee (beschädigt bei Ankunft beim Empfänger): Der aktuelle Stopp ist der Lieferstopp.

Übermittlung: Sortierung

Die Sortierung legt fest, wann die Ware im Pallet-Track-Hub sortiert wird. Ein Wert für Sortierung (NIGHT – Standard über Nacht; DAY – tagsüber während der Hub-Öffnungszeiten) wird pro Sendung festgelegt und bei der Übermittlung an Pallet Track übergeben.
So wird die Sortierung einer Sendung festgelegt:

  1. Zum Auftrag navigieren und die Sendung öffnen, die Pallet Track zugewiesen ist.
  2. Das Feld Sortierung (im Bereich der zusätzlichen Felder) auf NIGHT oder DAY setzen.
  3. Die Sendung speichern. Der Wert wird bei der Übermittlung angewendet.

Ein Standardwert lässt sich auch über den Auftragsimport festlegen. Dazu das Quellfeld dem Qargo-Feld pallet_track__sortation zuordnen und einen Standardwert (NIGHT oder DAY) für Sendungen ohne ausdrücklichen Wert konfigurieren. Einzelne Sendungen können vor der Übermittlung abweichend festgelegt werden.


Fehlerbehebung

Problem Lösung
Statusaktualisierungen erscheinen nicht in Qargo Prüfen, ob die Integration aktiv ist und die Sendung mit passendem Tracking-Code an Pallet Track übermittelt wurde. Neue Status können bis zu einer Minute brauchen.
Ein Status wird als Sonstige angezeigt Bei rund 70 administrativen Codes ohne Entsprechung in Qargo ist das zu erwarten; die vollständige Historie steht in der Barcode-Zeitleiste.
Aktion für den manuellen Status nicht sichtbar Prüfen, ob die Aktion für den manuellen Status in der Integration konfiguriert ist und der Nutzer ein Nutzer im Büro ist.
Manueller Status abgelehnt Prüfen, ob der Auftrag an Pallet Track exportiert wurde und der eingegebene Barcode zu einer Palette der Sendung passt. Manche Codes benötigen vor dem Senden zusätzliche Angaben.
Dokumente aus Pallet Track erscheinen nicht in Qargo Prüfen, ob die Dokumentsynchronisierung aktiv ist und der Typ POD, Lieferfoto oder Abholfoto ist (ePOD erfordert eine zusätzliche Einrichtung; COP wird nicht unterstützt).
Empfängerunterschrift / Metadaten fehlen Prüfen, ob Dokument- und Statussynchronisierung aktiv sind, die zusätzliche Konfiguration für Unterschriftsmetadaten vorhanden ist und das Depot das zuständige Abholdepot ist.
Dokumente aus Qargo erscheinen nicht in Pallet Track Prüfen, ob die Dokumentübertragung aktiviert ist, ein gültiger Tracking-Code vorhanden ist und das Dokument in der richtigen Phase (Lieferung oder Abholung) hinzugefügt wurde.
ETA wird nicht an Pallet Track gesendet Prüfen, ob der Stopp ein Lieferstopp ist, das Depot die liefernde Partei ist und die Sendung an Pallet Track übermittelt wurde (ETAs für Abholungen werden nicht unterstützt).
Kein Beschädigungsstatus nach dem Hochladen eines Fotos gesendet Prüfen, ob für die betroffenen Paletten tatsächlich ein Vorfall in der Warenverlaufshistorie erfasst ist. Nur diese Paletten erhalten eine Aktualisierung.
Unerwarteter Beschädigungscode (DAD/DDD/DAC) Der Code richtet sich nach dem aktuellen Stopp. Prüfen, welcher Stopp beim Hochladen des Fotos aktuell war.
Feld „Sortierung“ nicht sichtbar Prüfen, ob die Integration konfiguriert und die Sendung Pallet Track zugewiesen ist; das Feld gibt es nur für Pallet Track.
Sortierungsfehler bei der Übermittlung Der Wert muss NIGHT oder DAY lauten (Groß-/Kleinschreibung egal); ungültige Werte werden von Pallet Track abgelehnt.