Zum Inhalt springen

Schnittstellen-Mapping

Männliche Person, frontal, schaut in die Kamera; trägt kariertes Hemd über dunkelfarbigem T‑Shirt; heller Innenraum mit unscharfem Monitor oder Poster links und Fenster rechts.

von Richard Albrecht am 08.11.2026

Schnittstellen-Mapping ist die Zuordnung der Felder zweier Systeme, die Daten austauschen. Es legt fest, welches Feld im einen System welchem Feld im anderen entspricht und wie Werte dabei umgewandelt werden.

Schnittstellen-Mapping

Die festgelegte Zuordnung und Umwandlung von Datenfeldern zwischen zwei Systemen, die über eine Schnittstelle verbunden sind.
Beispiel: „Laut Schnittstellen-Mapping wird das Formularfeld Anliegen im CRM zur Kategorie der Anfrage.“

Das englische mapping bedeutet Zuordnung oder Abbildung.

Wie ein Schnittstellen-Mapping aussieht

Meist als Tabelle mit drei Spalten: Feld in System A, Feld in System B und die Regel dazwischen. Aus vorname und nachname wird etwa ein Feld name, aus einem Häkchen ein Ja oder Nein, aus einem Datum im deutschen Format eines nach ISO 8601.

Drei Spalten: links fünf Formularfelder mit Beispielwerten, in der Mitte die Regel, rechts das Feld im CRM mit dem umgewandelten Wert. Vorname und Nachname werden zusammengefügt, das Häkchen wird zu Ja, Deutschland zu DE, das Datum ins Format 2026-11-08 umgestellt und der Auswahlwert übernommen.
Aufwand machen vor allem die Felder mit Umwandlung; was eins zu eins wandert, ist schnell erledigt.

Diese Tabelle ist die Grundlage für den Code der Anbindung und zugleich ihre Dokumentation. Wer später fragt, warum ein Wert im CRM so aussieht, findet die Antwort dort.

Wo beim Schnittstellen-Mapping die Fallen liegen

Bei Pflichtfeldern, die nur ein System kennt, bei Auswahllisten mit unterschiedlichen Werten und bei Formaten für Telefonnummern, Länder und Datumsangaben. Ein Land, das im Formular Deutschland heißt und im CRM DE, bricht die Übertragung, wenn niemand die Umwandlung festlegt.

Heikel sind auch Felder, deren Bedeutung sich unterscheidet, obwohl sie gleich heißen. Status kann im Shop den Versand meinen und in der Buchhaltung die Zahlung.

Links der Shop mit dem Feld status: versendet, rechts die Buchhaltung mit status: bezahlt, dazwischen ein Ungleichheitszeichen. Darunter das CRM mit zwei getrennten Feldern, versandstatus aus dem Shop und zahlungsstatus aus der Buchhaltung.
Ein gemeinsames Feld status im CRM würde mit jeder Übertragung den Wert des anderen Systems überschreiben.

Ein Schnittstellen-Mapping testen

Mit echten Beispielen, auch den unbequemen: Umlaute, sehr lange Namen, leere Felder, Sonderzeichen. Ein Integrationstest mit diesen Fällen zeigt, ob das Mapping hält, bevor die ersten echten Daten falsch ankommen.

Siehe auch:

Drittanbieter-Integration

Die Anbindung eines fremden Dienstes an die eigene Website oder Anwendung.

#Programmiersprachen

API

Eine festgelegte Schnittstelle, über die ein Programm die Funktionen eines anderen benutzt.

#Programmiersprachen #Frontend-Entwicklung (HTML, CSS, JavaScript) #Hosting & Webserver

JSON

Das Format, in dem Daten heute durch das Web reisen.

#Programmiersprachen

Webhook

Eine Benachrichtigung, die ein System bei einem Ereignis von sich aus an eine Adresse eines anderen Systems schickt.

#Programmiersprachen

Payload

Die eigentlichen Nutzdaten einer Nachricht, ohne Verwaltungsangaben drumherum.

#Programmiersprachen

Integrationstest

Ein Test, der mehrere Teile im Zusammenspiel prüft, meist samt Datenbank.

#Deployment & Versionierung