Wie Sie eine andere Organisation, die in Orbit arbeitet, als Ihren integrierten Carrier buchen: was der Partner vorbereitet, wie Sie den Carrier einrichten, welche Status, Nachweise, Dokumente und Standorte zurückkommen und wie der Preis zwischen Ihnen wandern kann.
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. Der Key wird nur einmal angezeigt, im Dialog nach Erstellen: kopieren Sie ihn, bevor Sie Ich habe den Key gespeichert wählen. Siehe API-Keys.
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.
Prüfen Sie die Einstellungen unter Einstellungen und Preise. Sie sind unten unter Einstellungen des Carriers beschrieben.
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 und, wenn der Carrier Preisänderungen übernimmt, jede Änderung an den Orders, die Sie gebucht haben. 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.
Der Abschnitt Integration des Carriers enthält vier Einstellungen. Sie wählen sie beim Anlegen des Carriers und können sie jederzeit auf der Detailseite des Carriers ändern. Tours beim Partner und Preis bei der Buchung senden gelten für die Touren, die Sie danach zuweisen. Wie Preisänderungen übernehmen auf gebuchte Touren wirkt, steht unter Preise.
Unter Einstellungen:
| Einstellung | Optionen |
|---|---|
| Tours beim Partner | Ursprüngliche Tour (Standard): Der Partner erhält eine Tour mit derselben Stoppreihenfolge wie die ursprüngliche Tour. Keine Tour: Der Partner erhält die Shipments ungeroutet, ohne Tour, und plant sie selbst. Eine Tour pro Shipment: Der Partner erhält für jedes Shipment eine eigene Tour. |
Unter Preise:
| Einstellung | Optionen |
|---|---|
| Preis bei der Buchung senden | Nicht senden (Standard): Der Partner bekommt die Order ohne Preis. Positionen der Tour senden: Der Partner bekommt die Positionen der Tour als Startpreis der Order. |
| Preisänderungen übernehmen | Nicht übernehmen (Standard): Preisänderungen des Partners erreichen die Tour nicht. Laufend übernehmen: Ändert der Partner die Positionen der Order, übernimmt die Tour alle Positionen und sperrt sie. |
| Aufgabe bei Preisänderung | Aus (Standard), oder an mit einer Aufgabenvorlage: Öffnet bei jeder übernommenen Preisänderung eine Aufgabe aus dieser Vorlage. Siehe Eine Aufgabe für jede Preisänderung. |
Die beiden Preiseinstellungen sind unabhängig voneinander. Sie können den Preis senden und Ihren eigenen behalten, oder ohne Preis buchen und den Partner den Preis festlegen lassen.
Eine Änderung an Preisänderungen übernehmen aktualisiert auch die Anmeldung beim Partner, deshalb muss das Orbit des Partners beim Speichern erreichbar sein. Ist es das nicht, wird die Änderung nicht gespeichert; versuchen Sie es später erneut.
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.
Der Preis wandert immer nur in eine Richtung. Bei der Buchung kann er von Ihrer Tour zum Partner gehen. Nach der Buchung kann er nur vom Partner auf Ihre Tour zurückkommen. Ihre eigenen Preisänderungen nach der Buchung erreichen den Partner nie.
Steht Preisänderungen übernehmen auf Laufend übernehmen, wenn Sie den Partner zuweisen, kommt der Preis der Tour ab der erfolgreichen Buchung vom Partner. Ihre Positionen bleiben, wie sie sind, bis der Partner den Preis der Order ändert.
Wann immer der Partner die Positionen der Order ändert, zum Beispiel um Wartezeit oder einen Zuschlag für die Hebebühne hinzuzufügen, übernimmt Ihre Tour innerhalb von Sekunden alle Positionen des Partners. Jede Position behält ihren eigenen Mehrwertsteuersatz. Preisänderungen kommen nur über die Meldungen des Partners an: Die Prüfung alle 15 Minuten betrifft Status, keine Preise. Die Timeline vermerkt Positionen vom Carrier übernommen, mit dem Partner als dem, der die Änderung gemacht hat.
Ihre Tour ändert sich nur, wenn sich der Inhalt unterscheidet: Name, Menge, Einzelpreis oder Mehrwertsteuersatz einer Position, eine hinzugefügte oder entfernte Position oder eine neue Reihenfolge, die die Summe ändert (ein prozentualer Zuschlag wird auf die Positionen darüber berechnet). Eine Statusänderung beim Partner, dieselben Positionen in anderer Reihenfolge mit derselben Summe oder die Positionen, die Sie bei der Buchung gesendet haben, ändern nichts. Eine Order ohne Positionen ersetzt Ihren Preis nie: Entfernt der Partner alle Positionen, legen Sie den Preis selbst fest.
Die Übernahme läuft auch nach dem Abschluss Ihrer Tour weiter, solange der Partner zugewiesen bleibt. Es ändert sich nur der Preis der Tour. Der Preis der Order Ihres Kunden bleibt immer unberührt.
Solange der Preis vom Partner kommt, kann niemand die Positionen oder den Preis der Tour bearbeiten, weder in Orbit MissionControl noch über die Orbit API oder einen KI-Assistenten:
So holen Sie den Preis einer Tour vom Partner zurück:
Fahren Sie auf der Detailseite der Tour in Orbit MissionControl mit der Maus über den Preis.
Wählen Sie Preis selbst festlegen.
Lesen Sie den Dialog Preis für diese Tour selbst festlegen? und bestätigen Sie mit Preis selbst festlegen.
Die Positionen bleiben, wie sie sind, und Sie können sie wieder bearbeiten. Preisänderungen des Partners werden für diese Tour nicht mehr übernommen, und der Partner erfährt von Ihren Änderungen nichts, rechnen Sie den Preis deshalb direkt mit dem Partner ab. Die Timeline vermerkt Preis selbst festgelegt. Das betrifft nur diese Tour; andere Touren, die beim selben Partner gebucht sind, übernehmen seine Preisänderungen weiter.
Schalten Sie Aufgabe bei Preisänderung ein und wählen Sie daneben eine Vorlage, damit jemand jeden Preis prüft, den Ihre Tour vom Partner übernimmt: Jede übernommene Preisänderung öffnet eine Aufgabe aus dieser Vorlage. Die Liste bietet nur Aufgabenvorlagen mit dem Auslöser Durch eine Einstellung ausgelöst an; legen Sie dort zuerst eine an. Solange die Einstellung ohne Vorlage eingeschaltet ist, wird sie nicht gespeichert. Solange ein Carrier eine Vorlage verwendet, kann die Vorlage weder gelöscht noch auf einen anderen Auslöser umgestellt werden; setzen Sie sie auf inaktiv, um die Aufgaben zu stoppen.
Die Aufgabe gehört zur Tour. Ihr Name und ihre Beschreibung kommen aus der Vorlage und können zeigen, was sich geändert hat: die Netto-Summe vor und nach der Änderung, die Differenz und die Positionen, die der Partner hinzugefügt, entfernt oder geändert hat. Die Platzhalter stehen unter Aufgabenvorlagen. Empfänger, Fälligkeit, Benachrichtigungen und ob die Aufgabe die Tour sperrt, kommen ebenfalls aus der Vorlage.
Jede Tour hat höchstens eine offene Aufgabe aus der Vorlage:
Nur eine übernommene Preisänderung öffnet eine Aufgabe. Die Buchung beim Partner, Preis selbst festlegen und das Entfernen des Carriers öffnen keine. Solange Aufgabe bei Preisänderung ausgeschaltet oder die Vorlage inaktiv oder gelöscht ist, werden Preisänderungen weiter übernommen, öffnen aber keine Aufgabe, und auch später wird keine für sie geöffnet.
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. Änderungen an den Positionen der Tour werden nie an den Partner gesendet und zeigen nie Aktualisierung beim Carrier ausstehend.
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. Stornokosten, die der Partner danach berechnet, erreichen Ihre Tour nicht; rechnen Sie sie direkt mit dem Partner ab.
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, und ein vom Partner übernommener Preis bleibt bis dahin gesperrt.
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, wenn Preisänderungen übernehmen eingeschaltet ist, für Ihre Orders, und Dokumente wandern über die Dokument-Endpunkte. Die Endpunkte und Schemas finden Sie in der Orbit API Reference.
Die Orbit API bietet auch die Einstellungen des Carriers und das Selbstfestlegen des Preises:
edit-integration-toggles ändert die Einstellungen des Carriers und lässt den API-Key und die übrigen Verbindungsdaten unverändert. Aufgabe bei Preisänderung ist die Einstellung priceChangeTask mit dem Wert { "enabled": true, "templateId": "<ID der Aufgabenvorlage>" }. Abgelehnt wird sie mit einer Vorlage, die es nicht gibt oder die einen anderen Auslöser als Durch eine Einstellung ausgelöst hat, und wenn sie ohne Vorlage eingeschaltet ist.detach-carrier-price legt den Preis einer Tour selbst fest, wie Preis selbst festlegen.detach-carrier-price nennt.KI-Assistenten, die mit Orbit verbunden sind, können beides, mit Ihrem Login und Ihren Berechtigungen.
Nein. Ihre Buchungen kommen als gewöhnliche Orders eines Shipper an. Der Partner plant und führt sie aus wie jede andere Order.
Ja, wenn Sie Preisänderungen übernehmen am Carrier auf Laufend übernehmen stellen. Jede Änderung des Partners an den Positionen der Order ersetzt dann die Positionen Ihrer Tour, und der Preis bleibt gesperrt, bis Sie Preis selbst festlegen wählen. Mit Nicht übernehmen behält Ihre Tour den Preis, den Sie berechnet haben, und Sie vereinbaren Preise direkt mit dem Partner.
Nein. Nach der Buchung wandert der Preis nur vom Partner zu Ihnen. Legen Sie den Preis einer Tour selbst fest, rechnen Sie ihn direkt mit dem Partner ab.
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.