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