Das Grundmodell
Eine Integration in Xchange besteht aus drei Bausteinen: der Anbindung, der Route und dem Schritt. Der Konfigurationsstand fasst sie zusammen und legt fest, in welcher Fassung sie gelten. Wenn Sie die vier auseinanderhalten, wissen Sie, wohin eine Einstellung gehört: die Adresse des Onlineshops in die Anbindung, der Zeitplan in die Route, das Zielfeld in den Schritt. Ob eine Änderung schon wirkt, sagt der Konfigurationsstand.
Diese Seite spielt die vier an einem einzigen Vorgang durch: einer Bestellung aus dem Onlineshop der Cambira Sanitärtechnik GmbH.
Der Fall
Um 08:41 Uhr bestellt jemand im Onlineshop zwei Einhebelmischer. Um 08:45 Uhr steht die Bestellung als Beleg in SAP Business One, mit Kundennummer, Bestelldatum, Zahlungsart und zwei Positionen.
| Begriff | Die Frage, die er beantwortet | Im Fall |
|---|---|---|
| Anbindung | Mit welchem System sprechen wir, unter welcher Adresse, mit welcher Anmeldung? | Webshop Cambira |
| Route | In welche Richtung geht es, woher kommen die Daten, was startet sie? | Bestellungen Webshop |
| Schritt | Was wird am Ziel angelegt, und welches Feld bekommt welchen Wert? | ein Schritt, der den Beleg anlegt |
| Konfigurationsstand | Welche Fassung dieser Einstellungen gilt gerade? | Version 7 (Aktiv) |
Am Weg der Bestellung stehen sie so zueinander:
Die Anbindung – das Gegenüber
Eine Anbindung ist ein Fremdsystem, so wie Xchange es erreicht: mit Typ, Adresse und Anmeldung. Das Übertragen übernehmen die Routen, die sie benutzen.
Cambira hat drei davon:
| Anbindung | Typ | Basisadresse |
|---|---|---|
| Webshop Cambira | REST | https://shop.cambira.example.com/api |
| Cambira Austria | SAP Business One | https://sap-at.cambira.intern:50000 |
| Kessler Logistik | REST | https://edi.kessler-logistik.example.com/v2 |
Eine Anbindung wird einmal eingerichtet und danach von mehreren Routen benutzt. „Webshop Cambira“ trägt die Bestellungen herein und die Artikel hinaus – zwei Richtungen, zwei Routen, eine Anbindung. Ändert der Shop seine Adresse, ist das eine Änderung an einer Stelle.
Eine Route nennt genau eine Anbindung. Die zweite Seite ist fest: immer das SAP Business One, in dem Xchange arbeitet. Deshalb meint eine Anbindung vom Typ SAP Business One stets ein zweites, fremdes System: bei Cambira den Mandanten der österreichischen Schwestergesellschaft. Bleiben die Daten innerhalb von SAP Business One, ist das eine interne Route, und sie nennt keine Anbindung.
Mehr dazu: Anbindungen.
Die Route – der Weg für einen Datenaustausch
Eine Route ist ein Weg in eine Richtung, über eine Anbindung. Sie sagt:
- Richtung – Import, Export oder Intern, gemessen an Xchange. Bestellungen kommen herein, also Import.
- Anbindung – mit welchem Gegenüber. Hier: „Webshop Cambira“.
- Datenherkunft – woher die Daten kommen: aus einem Datenbestand, den Xchange abfragt, aus einer Warteschlange, in die das Fremdsystem legt, oder aus einem Verteilungseingang. Der Shop legt jede Bestellung in eine Warteschlange.
- Auslöser – was sie startet. Hier ein Zeitplan, alle fünf Minuten.
Was die Route tatsächlich überträgt – ihr Objekt –, ist keine eigene Angabe, sondern liest sich
aus ihrer Konfiguration ab: bei einer Export- oder internen Route aus dem Abrufendpunkt, bei einer Importroute aus
dem Zielpfad ihres Hauptschritts. Bei „Bestellungen Webshop“ ist das Orders, die Kundenaufträge
in SAP Business One.
Daraus folgt die Zahl der Routen: Cambira hat neun, weil es neun solche Wege gibt – Bestellungen herein, Artikel hinaus an den Shop, Artikel hinaus nach Österreich, Lieferaufträge hinaus an den Logistikpartner und fünf weitere für die Nachrichten, die er zurückschickt. Jeder dieser Wege ist eine eigene Route – auch wenn zwei davon, wie hier „Artikel hinaus an den Shop“ und „Artikel hinaus nach Österreich“, dasselbe Objekt übertragen.
Mehr dazu: Routen und Auslösung.
Der Schritt – was am Ziel entsteht
Eine Route beschreibt den Weg, ein Schritt die Ankunft: welches Objekt im Zielsystem entsteht und welches Feld welchen Wert bekommt.
Der Schritt der Route „Bestellungen Webshop“ legt den Beleg an. Seine Zuordnung liest aus der Nachricht des Shops und schreibt nach SAP Business One:
| Zielfeld | Quelle |
|---|---|
CardCode | OriginalPayload.customer_no |
NumAtCard | OriginalPayload.order_id |
DocDate | OriginalPayload.placed_at |
DocDueDate | OriginalPayload.placed_at |
PaymentMethod | OriginalPayload.payment |
DocumentLines | OriginalPayload.lines[*] |
DocumentLines → ItemCode | sku |
DocumentLines → Quantity | qty |
DocumentLines → „Fracht“ | FRACHT-PAUSCHAL, Menge 1, Preis aus OriginalPayload.shipping_total |
Zwei Werte werden unterwegs umgeformt. Das Datum kommt vom Shop mit Uhrzeit
(2026-10-08T08:41:12Z), SAP Business One erwartet es als 2026-10-08. Die Zahlungsart schreibt
der Shop als paypal, SAP Business One erwartet PP. Diese Umschlüsselung steht in einer
Wertetabelle, die mehrere Routen benutzen können.
Die zweite Position des Belegs schickt der Shop nicht als Position: Die Versandkosten kommen als ein
Betrag im Kopf der Bestellung, und die Zuordnung macht daraus eine Zusatzzeile mit dem Frachtartikel
FRACHT-PAUSCHAL.
Eine Route kann mehrere Schritte haben – dann entsteht am Ziel mehr als ein Objekt, oder es wird nach dem Schreiben noch etwas zurückgemeldet. Einer davon ist der Hauptschritt: der, der das Hauptobjekt der Route schreibt. Es gibt ihn genau einmal, und der Schlüssel der Route hängt an ihm. Bei den Bestellungen ist der Hauptschritt der, der den Beleg anlegt.
Mehr dazu: Zuordnung und Schreiben ins Zielsystem.
Der Konfigurationsstand – welche Fassung gerade gilt
Anbindungen, Routen, Schritte und Wertetabellen bilden zusammen eine Fassung der Konfiguration, und diese Fassung heißt Konfigurationsstand.
Im Alltag haben Sie es mit höchstens zwei Ständen zu tun:
- Der aktive Konfigurationsstand – nach ihm arbeitet Xchange im laufenden Betrieb. Bei Cambira ist das Version 7, aktiviert am 02.10.2026 um 16:40 von M. Brandt. Die Bestellung von heute Morgen lief nach dieser Fassung.
- Der Entwurf – er sammelt Ihre Änderungen, solange sie noch nicht aktiviert sind; im Betrieb wirkt er erst nach der Aktivierung. Bei Cambira ist das Version 8, zuletzt geändert heute um 08:57. Sie enthält eine zusätzliche Zeile in der Wertetabelle „Zahlungsarten Webshop“, und diese Zeile wirkt noch nicht.
Wirksam macht eine Änderung erst die Aktivierung eines Stands – gesichert ist sie schon vorher. Xchange sichert jede Eingabe von selbst – sie landet im Entwurf.
Mehr dazu: Konfigurationsstände.
Was zum Betrieb gehört
Zwei weitere Begriffe begegnen Ihnen ständig. Die vier Bausteine oben beschreiben die Einrichtung, diese beiden den Betrieb:
- Ein Lauf ist ein Durchgang einer Route. Der Lauf um 08:45 Uhr hat die Warteschlange geleert.
- Ein Vorgang ist ein einzelner Datensatz auf seinem Weg. Die Bestellung
WS-2026-104877war einer von ihnen.
Ein Lauf bündelt die Vorgänge, die er erzeugt hat. Beide gehören zur Ausführung.
Mehr dazu: Ausführung.
Siehe auch
- Rundgang durch die Oberfläche (Erste Schritte) – wo Anbindungen, Routen und Konfigurationsstände auf dem Bildschirm zu finden sind
- Routen (Referenz) – jedes Feld der Route, einzeln erklärt
- Berechtigungen (Grundkonzept) – was eine Person sehen und ändern darf