Skip to main content
Qargo

Palettennetzwerk – PALL-EX/Fortec Auftragsexport und -import

Dieser Artikel erklärt, wie Aufträge aus Qargo an das Palettennetzwerk PALL-EX oder Fortec exportiert und wie eingehende Aufträge aus Nexus in Qargo importiert werden.

Inhaltsverzeichnis
  1. Einführung
  2. Begriffe
  3. Auftragsexport (Qargo → Nexus)
  4. Auftragsimport (Nexus → Qargo)
  5. Synchronisieren des Status
  6. Synchronisieren von POD und Dokumenten
  7. ETA-Export (über Optimize) – optional

Einführung

Was behandelt dieser Artikel?

  • Übermitteln einer Sendung an PALL-EX oder Fortec
  • Wie das Netzwerk bestimmt wird (PALL-EX oder Fortec)
  • Etikettenerstellung nach der Übermittlung
  • Stornieren einer Übermittlung
  • Regeln für das Abholdatum und der Annahmeschluss um 12:00 Uhr
  • Wie Aufträge aus Nexus in Qargo importiert werden
  • Synchronisieren des Nachverfolgungsstatus
  • Synchronisieren von POD und Dokumenten
  • ETA-Export über Optimize

Für wen ist dieser Artikel?

  • Disponenten, die Sendungen an das Palettennetzwerk senden
  • Mitarbeitende in Operations, die den Versandstatus in Qargo überwachen

Begriffe

Begriff Definition
Aufgabe zur Ressourcenübermittlung Die Qargo-Aufgabe, die beim Abschließen eine Sendung über die Nexus-API an das Palettennetzwerk sendet
PALLEX_OUT Der Ressourcencode, der einen Subunternehmer als Ressource des PALL-EX-Netzwerks kennzeichnet
FORTEC_OUT Der Ressourcencode, der einen Subunternehmer als Ressource des Fortec-Netzwerks kennzeichnet
Nexus-Kunden-ID Der eindeutige Code, der einen Kunden im Nexus-System kennzeichnet; muss in Qargo für jeden Kunden konfiguriert werden
Annahmeschluss 12:00 Uhr (mittags): die Frist, nach der Abholungen am selben Tag oder am Folgetag ein späteres Abholdatum erfordern
MPOD Digitale Unterschriftenerfassung bei der Lieferung
POD Bild des unterschriebenen Lieferscheins
MPODPHOTOE Foto der Paletten am Lieferstandort
Optimize Das Routenoptimierungsmodul, mit dem ETAs aus Qargo an Nexus übertragen werden

Auftragsexport (Qargo → Nexus)

Übermitteln einer Sendung

  • Die Fahrt je nach dem für die Sendung benötigten Netzwerk der Subunternehmer-Ressource PALL-EX oder Fortec zuweisen.
  • Die Aufgabe zur Ressourcenübermittlung in der Fahrt abschließen. Dadurch wird die Sendung über die API an Nexus gesendet.
  • Prüfen, ob ein Palettenetikett heruntergeladen und dem Dokumentenbereich der Sendung angehängt wurde.

Wie das Netzwerk bestimmt wird

Das Netzwerk (PALL-EX oder Fortec) wird durch die Subunternehmer-Ressource bestimmt, die der Fahrt zugewiesen ist:

Ressourcencode Netzwerk
PALLEX_OUT` Sendung wird an PALL-EX gesendet
FORTEC_OUT` Sendung wird an Fortec gesendet
  • Bei der Übermittlung gibt Qargo die entsprechende Nexus-Kunden-ID (im Kundendatensatz konfiguriert) an die API weiter. Die API leitet die Sendung anhand dieser ID an das richtige Netzwerk weiter.

Was nach der Übermittlung passiert

Nachdem die Aufgabe zur Ressourcenübermittlung abgeschlossen wurde:

  • Ein Palettenetikett wird automatisch aus Nexus heruntergeladen und der Sendung in Qargo angehängt
  • Die Sendung ist im Nexus-Portal sichtbar
  • Nexus sendet Scan-Ereignisse an Qargo zurück, während die Sendung das Netzwerk durchläuft

Stornieren einer Übermittlung

  • Eine Übermittlung kann storniert werden, indem die Subunternehmer-Ressource aus der Fahrt entfernt wird.
  • Dadurch wird eine Stornierungsanfrage an Nexus ausgelöst und die Sendung aus dem Netzwerk entfernt.

Regeln für das Abholdatum

PALL-EX/Fortec wendet strenge Regeln für Abholdaten an. Qargo bestimmt das Servicelevel der Abholung automatisch anhand von Datum und Uhrzeit des Exports:

Szenario Ergebnis
Export am selben Tag, vor dem Annahmeschluss um 12:00 Uhr PREMIUM-Service wird verwendet
Export am selben Tag, nach dem Annahmeschluss um 12:00 Uhr ❌ Fehler: Abholung nicht möglich
Export am Freitag → Abholung am Samstag ❌ Fehler: nicht unterstützt
Export am Freitag → Montag, vor 12:00 Uhr SPECIFIC_DAY
Export am Freitag → Montag, nach 12:00 Uhr PREMIUM
Folgetag (Mo–Do), vor 12:00 Uhr SPECIFIC_DAY
Folgetag (Mo–Do), nach 12:00 Uhr PREMIUM
Export am Wochenende → nächster Werktag ❌ Fehler
Späteres Datum (>1 Tag im Voraus) SPECIFIC_DAY

Etikettenerstellung

  • Ein Palettenetikett wird unmittelbar nach einer erfolgreichen Übermittlung automatisch aus Nexus heruntergeladen.
  • Das Etikett wird dem Dokumentenbereich der Sendung in Qargo angehängt und kann dort gedruckt werden.
  • Für das Etikett ist kein manueller Schritt erforderlich. Es wird im Rahmen des Übermittlungsprozesses erstellt und heruntergeladen.

Auftragsimport (Nexus → Qargo)

So funktioniert der Import

  • Qargo fragt die Nexus-API alle paar Minuten ab, um neue und aktualisierte Sendungen für das Depot abzurufen.
  • Importierte Aufträge durchlaufen den Standardablauf des Auftragsimports in Qargo.

Import aus beiden Netzwerken

  • Da PALL-EX und Fortec dieselbe Nexus-API nutzen, importiert Qargo Aufträge für beide Netzwerke gleichzeitig in einem einzigen Abfragezyklus.
  • Das Netzwerk (PALL-EX oder Fortec) wird anhand der von der API zurückgegebenen Daten erkannt, und die entsprechenden Codes werden im Import-Mapping verwendet.

Synchronisieren des Status

Statusimport (Nexus → Qargo)

Qargo fragt Nexus alle paar Minuten nach Statusaktualisierungen ab. Die folgenden Status werden importiert und dem Nachverfolgungsablauf in Qargo zugeordnet:

Nexus-Status Qargo-Status
ARRIVED_AT_COLLECTION_POINT Abholung angekommen
COLLECTED Abholung eingescannt
DEPOT_SCAN_IN_FROM_CUSTOMER Abholdepot eingescannt
DEPOT_SCAN_OUT_TO_HUB Abholdepot ausgescannt
HUB_TRUNK_IN Hub angekommen
HUB_SCAN_IN Hub eingescannt
HUB_HELDOVER Hub eingelagert
HUB_SCAN_OUT Hub ausgescannt
HUB_TRUNK_OUT Hub abgefahren
DEPOT_SCAN_IN Lieferdepot eingescannt
OUT_FOR_DELIVERY Lieferdepot abgefahren
ARRIVED_AT_DELIVERY_POINT Lieferung angekommen
DELIVERY_EPOD_RECEIVED Lieferung ausgescannt
DELIVERED Lieferung ausgescannt

Statusexport (Qargo → Nexus)

Qargo sendet im Rahmen des Visibility-Frameworks Statusaktualisierungen an Nexus zurück. Diese werden automatisch durch bestimmte Ereignisse in Qargo ausgelöst:

  • Abholung abgeschlossen → Status wird an Nexus exportiert
  • Am Lieferstopp → Status wird exportiert
  • Lieferung bestätigt → Status wird exportiert

Synchronisieren von POD und Dokumenten

Liefernachweise werden in beide Richtungen zwischen Nexus und Qargo synchronisiert.

Nexus-Dokumenttyp Beschreibung Qargo-Dokumenttyp
MPOD Bild der digitalen Unterschriftenerfassung (Sign-On-Glass) des Empfängers Unterschrift des Empfängers
POD Bild des unterschriebenen Lieferscheins POD/CMR
MPODPHOTOE Foto der Paletten am Lieferstandort Foto der Ware (Lieferung)
  • Import: Dokumente werden regelmäßig aus Nexus synchronisiert und in Qargo bei der Sendung gespeichert.
  • Export: Wenn ein Dokument der oben genannten Typen in Qargo erstellt oder hochgeladen wird und das Depot das Lieferdepot der Sendung ist, wird das Dokument automatisch an Nexus gesendet.

ETA-Export (über Optimize) – optional

ETAs können über das Routenoptimierungsmodul Optimize aus Qargo an Nexus übertragen werden.