Wie Sie eine andere Organisation, die in Orbit arbeitet, als Ihren integrierten Carrier buchen: was der Partner vorbereitet, wie Sie den Carrier einrichten und welche Status, Nachweise, Dokumente und Standorte zurückkommen.
War dieser Artikel hilfreich?
Keine Antwort gefunden?
Fragen Sie Luna oder schreiben Sie unserem Support-Team.
Note
Sie können eine andere Organisation, die in Orbit arbeitet, als integrierten Carrier buchen. Wenn Sie diesem Carrier eine Tour zuweisen, entsteht im Orbit des Partners eine passende Order, und Status, Nachweise, Dokumente und der Live-Standort kommen automatisch auf Ihre Tour zurück.
Viele Transportunternehmen geben einen Teil ihrer Arbeit an Partner weiter. Wenn dieser Partner seinen Betrieb ebenfalls in Orbit führt, können sich die beiden Organisationen direkt verbinden. Sie planen und verkaufen den Transport weiter in Ihrem eigenen Orbit. Der Partner erhält die Arbeit als gewöhnliche Order eines Kunden, plant sie mit seinen eigenen Fahrern (Driver) und Fahrzeugen und führt sie in Orbit Cockpit aus. Niemand überträgt Daten von Hand zwischen den beiden Systemen.
Für Sie verhält sich der Partner wie jeder andere integrierte Carrier: Sie weisen ihn auf der Tour zu, und die Tour kommt von selbst voran, während der Partner arbeitet. Für den Partner sind Sie ein Shipper, der Orders über die Orbit API bucht.
Das Wichtigste:
Load), samt Ankunfts- und AbfahrtszeitenDieser Artikel nennt die beiden Seiten der Verbindung so:
Shipper an, der Sie vertritt.Der Partner bereitet zuerst einiges vor, danach richten Sie den Carrier ein. Beide Schritte finden in Orbit MissionControl statt.
Der Partner erledigt diese Schritte in seinem eigenen Orbit MissionControl und schickt Ihnen die Ergebnisse:
Einen Shipper anlegen, der Ihre Organisation vertritt. Jede Order, die Sie buchen, kommt mit diesem Shipper als Kunde an. Seine ID ist der letzte Teil der Adresse der Shipper-Seite.
Optional ein Team und einen Benutzer in diesem Shipper anlegen. Der Benutzer erscheint als Kontakt auf jeder gebuchten Order.
Die Region wählen, in der Ihre Shipments angelegt werden, und ihren kurzen Regionscode notieren, zum Beispiel berlin.
Einstellungen > API-Keys öffnen, API-Key erstellen wählen und dem Key einen Namen geben, der Sie erkennbar macht, zum Beispiel ACME Ltd. Der Partner sieht jede Ihrer Aktionen unter diesem Namen.
Ihnen den API-Key, die Shipper-ID, den Regionscode und, falls angelegt, die IDs von Team und Benutzer schicken.
Ein API-Key gibt Zugriff auf die ganze Organisation des Partners in Orbit. Der Partner sollte für jede buchende Organisation einen eigenen Key anlegen und nie einen Key weitergeben, den er für etwas anderes nutzt. Um die Verbindung zu beenden, löscht der Partner den Key.
Sie richten den Partner in Orbit MissionControl ein wie jeden anderen integrierten Carrier:
Legen Sie einen Carrier (Carrier) an und schalten Sie am Ende des Formulars Integrierter Carrier ein.
Wählen Sie als Anbieter Orbit (partner organization).
Behalten Sie die vorbelegte API-Adresse des Partners. Ändern Sie sie nur, wenn Ihr Partner Ihnen sagt, dass er auf einer anderen Orbit-Installation arbeitet.
Geben Sie den API-Schlüssel des Partners ein.
Geben Sie unter Ihre Identität beim Partner die Region beim Partner und Ihre Shipper-ID beim Partner ein. Hat Ihnen der Partner ein Team oder einen Benutzer genannt, tragen Sie diese in Team beim Partner (optional) und Benutzer beim Partner (optional) ein.
Wählen Sie Verbindung testen.
Speichern Sie den Carrier.
Verbindung testen prüft jeden Wert gegen das Orbit des Partners. Bei Erfolg nennt der Test die Organisation, mit der Sie verbunden sind. Bei einem Fehler nennt er den Wert, der nicht stimmt:
| Meldung | Was Sie tun |
|---|---|
| The counterparty rejected the API key. | Bitten Sie den Partner um einen gültigen Key. Der Key ist vielleicht falsch eingegeben oder gelöscht. |
| This API key belongs to your own organization. | Sie haben einen Ihrer eigenen Keys eingegeben. Nutzen Sie den Key, den der Partner für Sie angelegt hat. |
| The counterparty knows no shipper with the configured id. | Prüfen Sie die Shipper-ID mit dem Partner. Dieselbe Prüfung gibt es für Team und Benutzer. |
| The counterparty has no region "…". Available: … | Wählen Sie gemeinsam mit dem Partner einen der aufgeführten Regionscodes. |
| The counterparty endpoint did not answer like an Orbit external API. | Stellen Sie die vorbelegte API-Adresse des Partners wieder her. |
Nach dem Speichern zeigt die Detailseite des Carriers, mit welcher Organisation Sie verbunden sind, und den Namen des Keys. Das Speichern meldet den Carrier außerdem beim Partner an, sodass das Orbit des Partners jede Änderung an Ihren Shipments an Sie zurückmeldet. Der Partner sieht diesen Eintrag unter Einstellungen > Webhooks mit dem Namen Orbit carrier integration, gefolgt vom Namen des Keys, und darf ihn nicht löschen.
Ändern Sie später die API-Adresse des Partners, geben Sie den API-Key erneut ein. Orbit sendet einen gespeicherten Key nur an die Adresse, für die er eingegeben wurde.
Sie weisen den Partner auf der Detailseite der Tour in Orbit MissionControl zu, wie jeden anderen Carrier. Orbit legt sofort eine Order im Orbit des Partners an:
Shipper beim Partner als Kunden.Der Bereich Carrier-Integration auf Ihrer Tour zeigt die Order-ID des Partners als Referenz. Nennen Sie sie, wenn Sie mit dem Partner über die Buchung sprechen.
Der Partner entscheidet, wer fährt. Er kann die Tour seinen eigenen Fahrern zuweisen und die Arbeit mit anderen Touren aufteilen oder zusammenlegen. Ihre Tour behält in jedem Fall ihre eigenen Stopps.
Eine Tour mit mehr als 50 Stopps oder mehr als 40 Shipments lehnt Orbit ab, bevor es den Partner kontaktiert. Jede Ladung braucht eine Ladungsart, ihre Maße und ihr Gewicht.
Das Orbit des Partners meldet jede Änderung innerhalb von Sekunden. Zur Sicherheit prüft Orbit außerdem alle 15 Minuten jede Buchung beim Partner.
| Der Fahrer des Partners… | …und Ihre Tour |
|---|---|
| fährt zur ersten Beladung oder kommt dort an | Die Tour geht auf Laufend. |
| verlässt eine Beladung | Das Shipment ist unterwegs zur Entladung, und seine Ladungen sind Geladen. |
| stellt ein Shipment zu | Das Shipment ist Ausgeliefert, mit dem Ergebnis für jede Ladung und allen Bemerkungen. |
| meldet eine gescheiterte Zustellung | Das Shipment ist Fehlgeschlagen, mit dem Grund. |
| schließt das letzte Shipment ab | Die Tour geht auf Review nötig. |
Ankunfts- und Abfahrtszeiten an jedem Stopp kommen vom Fahrer des Partners. Eine Ladung, die der Partner zurückgebracht oder als beschädigt gemeldet hat, erscheint als nicht entladen, mit einer Ausnahme. Jede Meldung erscheint in der Timeline der Tour als Statusmeldung vom Carrier. Wählen Sie Meldung des Carriers anzeigen, um zu lesen, was der Partner für jedes Shipment gemeldet hat.
Eine Ankunft erscheint manchmal erst zusammen mit der Abfahrt vom selben Stopp. Die Zeiten stimmen trotzdem genau.
Dateien über 25 MB werden in keine Richtung übertragen. Wenn Sie ein Dokument löschen oder eine neue Version eines schon gesendeten Dokuments hochladen, ändert das die Kopie auf der anderen Seite nicht.
Solange Ihre Tour Laufend ist, liest Orbit jede Minute die Position des Fahrzeugs des Partners und zeigt sie auf Ihrer Tour, auch auf der Karte und im Live-Tracking, das Ihre Shipper sehen. Das funktioniert, wenn der Partner seiner Tour ein Fahrzeug mit Ortungsgerät zugewiesen hat. Die Timeline vermerkt Live-Standort des Carriers verbunden, sobald die erste Position ankommt.
Eine gebuchte Tour bearbeiten. Orbit ändert die Order beim Partner nach der Buchung nicht. Bearbeiten Sie Daten, die der Partner schon erhalten hat, zeigt der Bereich Carrier-Integration Aktualisierung beim Carrier ausstehend. Um die Änderung zu senden, entfernen Sie den Carrier und weisen ihn erneut zu: Der Partner erhält dann eine neue Order. Wählen Sie stattdessen Bestätigen, wenn die Änderung für den Partner keine Rolle spielt oder Sie sie dem Partner selbst mitgeteilt haben.
Den Carrier entfernen. Wenn Sie den Partner von der Tour entfernen, wird die ganze Order beim Partner storniert. Kann das Orbit des Partners die Stornierung nicht bestätigen, bleibt der Carrier zugewiesen, und Orbit zeigt Buchung konnte nicht storniert werden. Ein erneuter Versuch ist gefahrlos.
Wenn der Partner storniert. Löscht oder storniert der Partner eines Ihrer Shipments, wird dieses Shipment im Bereich und in der Timeline markiert, und Sie entscheiden, wie es weitergeht. Storniert der Partner alle Shipments, zeigt der Bereich die Buchung als storniert. Ihre Tour bleibt, wie sie ist, bis Sie den Carrier entfernen oder die Tour stornieren.
Wenn eine Buchung keine klare Antwort bekommt. Antwortet das Orbit des Partners nicht rechtzeitig, kann Orbit nicht wissen, ob die Order existiert. Bitten Sie den Partner, nach einer Order mit Ihrem Tournamen als Kundenreferenz zu suchen, bevor Sie es erneut versuchen. Eine doppelte Order kann der Partner einfach bei sich stornieren.
ACME Ltd in Lyon verkauft eine Zustellung am selben Tag für Fahrradteile aus seinem Lager an vier Geschäfte in Paris. ACME hat in Paris keine Transporter, also weist Mohammad, Operator bei ACME, die Tour Spaceport Shipping Co. zu, einem Kurierpartner, der ebenfalls in Orbit arbeitet. Innerhalb von Sekunden sieht der Disponent von Spaceport eine Order vom Shipper ACME Ltd mit vier Shipments und einer Tour in der richtigen Stopp-Reihenfolge und weist sie einem Fahrer zu. Die Packlisten, die ACME angehängt hat, kommen mit der Order an. Während der Fahrer die Stopps in Orbit Cockpit abarbeitet, geht Mohammads Tour auf Laufend, jede Zustellung an ein Geschäft erscheint mit ihrer Unterschrift, und die Kunden von ACME verfolgen den Transporter auf der Live-Karte. Als das letzte Geschäft unterschreibt, wartet die Tour in Review nötig, und Mohammad schließt sie ab.
Die Verbindung nutzt auf beiden Seiten die gewöhnliche Orbit API. Die Buchung legt eine Order mit dem Shipper beim Partner als Kunden an, die Meldungen kommen als Webhook für Ihre Shipments, und Dokumente wandern über die Dokument-Endpunkte. Die Endpunkte und Schemas finden Sie in der Orbit API Reference.
Nein. Ihre Buchungen kommen als gewöhnliche Orders eines Shipper an. Der Partner plant und führt sie aus wie jede andere Order.
Nein. Vereinbaren Sie Preise direkt mit dem Partner. Ihre Tour behält den Preis, den Sie berechnet haben.
Auf Ihrer Seite nichts. Ihre Tour geht auf Review nötig, sobald jedes Shipment zugestellt oder fehlgeschlagen ist, und Sie schließen sie selbst ab.
Der Partner erhält nur, was Sie bei ihm buchen, dazu die für Carrier sichtbaren Dokumente auf diesen Touren. Ihre internen Kommentare und benutzerdefinierten Properties bleiben bei Ihnen.
Jeder Carrier sendet seine Shipments in eine Region beim Partner. Legen Sie pro Region einen Carrier an, jeweils mit dem passenden Regionscode.
Entfernen Sie den Partner zuerst von allen offenen Touren, damit die Orders beim Partner storniert werden. Danach löscht der Partner den API-Key, den er für Sie angelegt hat.