---
title: "Orbit-Partnerorganisationen als Carrier"
description: "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."
url: "https://support.pr-2.orbit.do/de/advanced-features/orbit-partner-carriers"
locale: "de"
lastReviewed: "2026-10-26"
---

# Orbit-Partnerorganisationen als Carrier

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.

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

## Überblick

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](https://support.pr-2.orbit.do/de/advanced-features/integrated-carriers): 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:**

* **Touren mit mehreren Stopps:** Eine Tour mit bis zu 50 Stopps (Stop) und 40 Shipments geht als eine Order an den Partner, in Ihrer Stopp-Reihenfolge
* **Status pro Shipment:** Beladungen, Zustellungen und gescheiterte Zustellungen des Partners aktualisieren jedes Ihrer Shipments und jede Ladung (`Load`), samt Ankunfts- und Abfahrtszeiten
* **Nachweise und Dokumente in beide Richtungen:** Ihre für Carrier sichtbaren Dokumente gehen an den Partner, und die Nachweise des Partners sowie seine für Shipper sichtbaren Dokumente kommen zu Ihnen zurück
* **Live-Standort:** Die Position des Fahrzeugs des Partners erscheint auf Ihrer Tour, solange sie läuft
* **Den Abschluss machen Sie:** Das eigene Review des Partners schließt Ihre Tour nie ab; Sie prüfen und schließen sie selbst ab
* **Preise, wenn Sie sie wollen:** Die Positionen Ihrer Tour können bei der Buchung an den Partner gehen, und spätere Preisänderungen des Partners können auf Ihre Tour zurückkommen

## Zwei Organisationen, zwei Rollen

Dieser Artikel nennt die beiden Seiten der Verbindung so:

* **Sie, die buchende Organisation:** Ihnen gehören die Order und die Tour, und Sie weisen den Partner als Carrier zu.
* **Die Partnerorganisation:** Sie führt den Transport aus. In ihrem Orbit kommen Ihre Buchungen als Orders eines `Shipper` an, der Sie vertritt.

Der Partner bereitet zuerst einiges vor, danach richten Sie den Carrier ein. Beide Schritte finden in Orbit MissionControl statt.

## Was der Partner vorbereitet

Der Partner erledigt diese Schritte in seinem eigenen Orbit MissionControl und schickt Ihnen die Ergebnisse:

1. 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.
2. Optional ein Team und einen Benutzer in diesem `Shipper` anlegen. Der Benutzer erscheint als Kontakt auf jeder gebuchten Order.
3. Die Region wählen, in der Ihre Shipments angelegt werden, und ihren kurzen Regionscode notieren, zum Beispiel `berlin`.
4. **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](https://support.pr-2.orbit.do/de/advanced-features/api-keys).
5. 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.

## Den Carrier einrichten

Sie richten den Partner in Orbit MissionControl ein wie jeden anderen integrierten Carrier:

1. Legen Sie einen Carrier (`Carrier`) an und schalten Sie am Ende des Formulars **Integrierter Carrier** ein.
2. Wählen Sie als **Anbieter** **Orbit (partner organization)**.
3. 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.
4. Geben Sie den **API-Schlüssel des Partners** ein.
5. 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.
6. Prüfen Sie die Einstellungen unter **Einstellungen** und **Preise**. Sie sind unten unter [Einstellungen des Carriers](#einstellungen-des-carriers) beschrieben.
7. Wählen Sie **Verbindung testen**.
8. 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.

## Einstellungen des Carriers

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](#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](#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.

## Eine Tour beim Partner buchen

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:

* Die Order trägt den Namen Ihrer Tour als Namen und als Kundenreferenz, und Ihren `Shipper` beim Partner als Kunden.
* Jedes Ihrer Shipments wird beim Partner zu einem Shipment, mit seinen Adressen, Zeitfenstern, Ladungen, Extras, öffentlichem Kommentar und Nachweisanforderungen.
* Steht **Tours beim Partner** auf **Ursprüngliche Tour**, erhält der Partner eine Tour in Ihrer Stopp-Reihenfolge. Stopps, die Sie zusammengefasst haben, kommen zusammengefasst an.
* Steht **Preis bei der Buchung senden** auf **Positionen der Tour senden**, trägt die Order die Positionen Ihrer Tour, jede mit ihrem eigenen Mehrwertsteuersatz. Andernfalls hat die Order keinen Preis.
* Interne Kommentare, benutzerdefinierte Properties und die Fahrzeugklasse bleiben bei Ihnen. Der Partner wählt seine eigenen Fahrzeuge.

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.

## Was auf Ihre Tour zurückkommt

Das Orbit des Partners meldet jede Änderung innerhalb von Sekunden. Zur Sicherheit prüft Orbit außerdem alle 15 Minuten jede Buchung beim Partner.

### Status

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

### Nachweise und Dokumente

* **Nachweise**, die der Fahrer des Partners erfasst, etwa Unterschriften und Fotos, kommen immer zurück und landen am passenden Stopp Ihrer Tour. Für sie gelten dieselben Sichtbarkeitsregeln wie für Nachweise Ihrer eigenen Fahrer.
* **Andere Dokumente** kommen nur zurück, wenn der Partner sie für Shipper sichtbar macht.
* **Ihre Dokumente** gehen an den Partner, wenn sie für Carrier sichtbar sind. Orbit sendet sie direkt nach der Buchung und erneut, wann immer Sie eines hinzufügen, solange die Buchung aktiv ist. Dokumente der Tour gehen an jedes Shipment beim Partner, Dokumente eines Stopps an die Shipments an diesem Stopp.

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.

### Live-Standort

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.

## Preise

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.

### Preisänderungen des Partners übernehmen

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.

### Was Sie auf der Tour sehen

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:

* Auf der Detailseite der Tour zeigt der Preis die Preisquelle **vom Carrier** und ein Schloss hinter dem Betrag.
* Neben dem Preis werden weder **Preis bearbeiten** noch **Neu berechnen** angeboten.
* Fahren Sie mit der Maus über den Preis, sehen Sie die Positionen und einen Hinweis, dass sie vom Partner kommen und bei jeder Änderung des Partners übernommen werden. Nach der ersten Übernahme nennt der Hinweis auch, wann die Positionen zuletzt aktualisiert wurden.
* Dürfen Sie die Tour bearbeiten, bietet der Hinweis **Preis selbst festlegen** an.

### Den Preis selbst festlegen

So holen Sie den Preis einer Tour vom Partner zurück:

1. Fahren Sie auf der Detailseite der Tour in Orbit MissionControl mit der Maus über den Preis.
2. Wählen Sie **Preis selbst festlegen**.
3. 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.

### Die Übernahme beenden

* **Für eine Tour:** Legen Sie den Preis selbst fest, wie oben beschrieben.
* **Für alle Touren des Carriers:** Stellen Sie **Preisänderungen übernehmen** auf **Nicht übernehmen**. Die Preisänderungen des Partners erreichen Ihre Touren nicht mehr, und ihre Positionen lassen sich wieder bearbeiten.
* **Durch Entfernen des Carriers:** Wenn Sie den Partner von der Tour entfernen, enden die Buchung und die Übernahme. Die Positionen bleiben, wie sie sind.

### Eine Aufgabe für jede Preisänderung

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](https://support.pr-2.orbit.do/de/tasks/task-templates) 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](https://support.pr-2.orbit.do/de/tasks/task-templates#platzhalter-für-preisänderungen). 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:

* **Solange die Aufgabe offen ist,** öffnet eine weitere Preisänderung keine zweite Aufgabe. Name und Beschreibung der Aufgabe werden mit der neuesten Änderung neu ausgefüllt, und ihr Verlauf vermerkt **Preisänderung von … übernommen** mit den Netto-Summen davor und danach.
* **Sobald die Aufgabe abgeschlossen oder übersprungen ist,** öffnet die nächste Preisänderung eine neue Aufgabe.

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 Buchung ändern oder entfernen

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

## Beispiel

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.

## Technische Details

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](https://orbit-api.readme.io).

Die Orbit API bietet auch die Einstellungen des Carriers und das Selbstfestlegen des Preises:

* Die Carrier-Aktion `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.
* Die Tour-Aktion `detach-carrier-price` legt den Preis einer Tour selbst fest, wie **Preis selbst festlegen**.
* Eine Änderung an einem gesperrten Preis wird mit einem Fehler abgelehnt, der den Partner und die Aktion `detach-carrier-price` nennt.

[KI-Assistenten, die mit Orbit verbunden sind](https://support.pr-2.orbit.do/de/advanced-features/connecting-ai-assistants-to-orbit), können beides, mit Ihrem Login und Ihren Berechtigungen.

## FAQ

**Q: Muss der Partner mit meinen Orders etwas Besonderes tun?**

Nein. Ihre Buchungen kommen als gewöhnliche Orders eines `Shipper` an. Der Partner plant und führt sie aus wie jede andere Order.

**Q: Kommt der Preis des Partners auf meine Tour zurück?**

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.

**Q: Sieht der Partner meine Preisänderungen?**

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.

**Q: Was passiert, wenn der Partner die Tour in seinem eigenen Orbit abschließt?**

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.

**Q: Kann der Partner meine übrigen Daten sehen?**

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.

**Q: Kann ich denselben Partner für mehrere Regionen nutzen?**

Jeder Carrier sendet seine Shipments in eine Region beim Partner. Legen Sie pro Region einen Carrier an, jeweils mit dem passenden Regionscode.

**Q: Wie beenden wir die Verbindung?**

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.
