Was eine Orbit Resource Number (ORN) ist, wie sie sich von der alltäglichen Referenz auf dem Bildschirm unterscheidet und wo ORNs beim Scannen und auf Etiketten genutzt werden.
Fragen Sie Luna oder schreiben Sie unserem Support-Team.
Tip
Eine Orbit Resource Number (ORN) ist eine eindeutige Kennung, die Orbit Ressourcen wie Touren, Shipments und Ladungen (Loads) zuweist. ORNs ermöglichen Funktionen wie Cockpit Identify und scanbare QR-Codes auf gedruckten Etiketten.
Das Wichtigste
Eindeutige Kennung: Jede ORN kennzeichnet eine Ressource eindeutig im gesamten Orbit-System
Feste Struktur: Ein einheitliches Muster orn:<tenant-id>:<resource-path>, das Touren, Shipments und Ladungen abdeckt
Scanbare Etiketten: Betten Sie ORNs mit der Document Engine als QR-Codes in Versandetiketten ein
Funktionsübergreifend: Genutzt von Cockpit Identify, dem Scanner für den Ladungsstatus und dem Document Engine Format
Jede ORN folgt derselben Struktur:
orn:<tenant-id>:<resource-path>
orn: Ein festes Präfix, das die Zeichenkette als Orbit Resource Number kennzeichnet.
tenant-id: Die ID des Tenants, dem die Ressource gehört.
resource-path: Typ und ID der Ressource, getrennt durch /.
Der kurze Code, den Sie im Alltag nennen (der Tour-Code, die Shipmentnummer oder die Order-Referenz, die Orbit MissionControl auf dem Bildschirm zeigt), ist der Anzeigename oder die Referenz des Datensatzes. Er ist nicht dasselbe wie eine ORN, und es hilft, beides auseinanderzuhalten.
Alltägliche Referenzen sind kurz. Der Code, an dem Sie und Ihr Team einen Datensatz erkennen, ist eine kurze Referenz in der Oberfläche. Eine ORN ist dagegen die längere, vollständige Zeichenkette orn:<tenant-id>:<resource-path>, die im Hintergrund für Scannen und Etiketten arbeitet.
Nicht alles hat eine ORN. ORNs gibt es für die Ressourcen, die gescannt oder per Deep Link geöffnet werden müssen, vor allem Touren, Shipments und Ladungen. Viele Datensätze, mit denen Sie arbeiten, haben nur ihren alltäglichen Code oder ihre Nummer.
Nennen Sie den Code, den Sie sehen. Wenn Sie mit einer Kollegin, einem Kollegen oder dem Support über einen Datensatz sprechen, ist die kurze Referenz auf dem Bildschirm die richtige. Orbit ordnet sie für Sie der zugrunde liegenden Ressource zu; Sie müssen keine ORN von Hand bauen.
Wenn Sie Versandetiketten mit der Document Engine von Orbit erzeugen, können Sie auf jedem Etikett eine ORN als QR-Code einbetten. Wer diesen QR-Code mit der Handykamera scannt, öffnet Cockpit Identify und sieht die zugehörige Tour, ihre Stopps (Stops) und Ladungen.
Die Document Engine bietet den Template-Filter generateLoadDeepLink, der für jede Ladung eine scanbare Deep-Link-URL erzeugt. Details zum Ablauf beim Scannen finden Sie in der Dokumentation zu Cockpit Identify.
Die Funktion Identifizieren in Orbit Cockpit nutzt ORNs, um gescannte Barcodes aufzulösen. Scannt ein Fahrer (Driver) oder eine Lagerkraft einen Barcode mit einer ORN, sucht Cockpit die zugehörige Tour und zeigt ihre Details. Das funktioniert für ORNs von Touren, Shipments und Ladungen.
Auch der Barcode-Scanner im Bereich für den Ladungsstatus erkennt ORNs. Wird bei der Abfahrt ein Barcode mit der ORN einer Ladung gescannt, ordnet das System ihn der passenden Ladung am aktuellen Stopp zu.
Note
Beispiel aus der Praxis:
Spaceport Shipping Co. in Berlin druckt mit der Document Engine von Orbit Versandetiketten für ausgehende Zustellungen. Jedes Etikett trägt einen QR-Code, der mit dem Template-Filter generateLoadDeepLink erzeugt wird. Scannt ein Fahrer im Ziellager in London den QR-Code mit der Handykamera, öffnet sich Cockpit und zeigt, dass die Ladung zur Tour TUR-2024-112 gehört, mit einem Zustellfenster von 14:00–16:00 bei ACME Ltd, 45 King Street. Der Fahrer bestätigt, dass das Paket auf dem richtigen Fahrzeug ist, ohne beim Disponenten nachfragen zu müssen.
Meistens nicht. Orbit erzeugt ORNs automatisch, zum Beispiel wenn Sie in der Document Engine den Filter generateLoadDeepLink verwenden. Wenn Sie eine eigene Integration bauen, können Sie ORNs aus den Ressourcen-IDs zusammensetzen, die in API-Antworten und Webhook-Payloads stehen.
Kann ich ORNs in der API verwenden?
ORNs werden derzeit zum Scannen von Barcodes und zum Erzeugen von Etiketten verwendet. Für normale API-Aufrufe brauchen Sie sie nicht; diese arbeiten weiter direkt mit Ressourcen-IDs.
Welches Barcode-Format sollte ich für ORNs verwenden?
Wir empfehlen, ORNs als QR-Codes zu kodieren. QR-Codes fassen die ganze ORN-Zeichenkette und werden vom Cockpit-Scanner und von normalen Handykameras zuverlässig gelesen.
