--- title: "Orbit Resource Number (ORN)" description: "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." url: "https://support.pr-4.orbit.do/de/advanced-features/orbit-resource-number-orn" locale: "de" lastReviewed: "2026-10-09" --- # Orbit Resource Number (ORN) 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. > **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::`, 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:: ``` * `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 `/`. ### Beispiele | **Ressource** | **Format** | **Beispiel** | | ------------- | ------------------------------------------------------- | ----------------------------------------------------- | | Tour | `orn::tour/` | `orn:acmelogistics:tour/TUR-2024-001` | | Shipment | `orn::shipment/` | `orn:acmelogistics:shipment/SHP-2024-042` | | Ladung | `orn::shipment//load/` | `orn:acmelogistics:shipment/SHP-2024-042/load/LD-001` | > **Tip:** Ladungen gelten als Unterressourcen ihres Shipments. Darum enthält die ORN sowohl die ID des Shipments als auch die ID der Ladung. ## IDs, Referenzen und ORNs 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::`, 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. ## Wo ORNs genutzt werden ### [Gedruckte Etiketten](https://support.pr-4.orbit.do/de/advanced-features/document-engine) 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. ### [Cockpit Identify](https://support.pr-4.orbit.do/de/advanced-features/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. ### [Scanner für den Ladungsstatus](https://support.pr-4.orbit.do/de/core-features/load-status-tracking#barcode-scan) 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. ## FAQ **Q: Muss ich ORNs von Hand bauen?** 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. **Q: 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. **Q: 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.