Integrationen · Anleitung

Datenmapping: Felder zwischen Systemen sauber zuordnen

Datenmapping Schritt für Schritt: Felder zwischen Shopify und Fremdsystemen sauber zuordnen, Formate abgleichen, typische Fehler vermeiden.

Von der Redaktion16. November 20267 Min Lesezeit
KurzantwortStand 16. November 2026

Kurz gesagt: Datenmapping ist die Übersetzung zwischen den Feldern zweier Systeme. Shopify nennt ein Feld "SKU", Ihr Lagersystem nennt dasselbe "Artikelnummer", und Ihre Buchhaltung erwartet ein drittes Format. Damit eine Integration funktioniert, muss jedes Feld der einen Seite eindeutig einem Feld der anderen Seite zugeordnet werden, inklusive der Formate dahinter. Dieses unscheinbare Thema entscheidet darüber, ob eine Automatisierung saubere oder chaotische Ergebnisse liefert, denn ein Zuordnungsfehler wiederholt sich über jeden einzelnen Datensatz.

Diese Anleitung zeigt Schritt für Schritt, wie Sie Felder zwischen Systemen sauber zuordnen, welche Formate und Sonderfälle Sie beachten müssen und wie Sie typische Fehler vermeiden, bevor sie in den laufenden Betrieb gelangen. Die technische Einordnung, wie Daten überhaupt zwischen Systemen fließen, liefert der Überblick zu den Shopify-API-Grundlagen → und der Ratgeber zu den Schnittstellen-Arten.

✓Das Wichtigste in Kürze
  • Datenmapping ordnet die Felder zweier Systeme einander zu, zum Beispiel Shopify-SKU zu ERP-Artikelnummer.
  • Nicht nur Feldnamen zählen, sondern auch Formate: Datum, Zahlen, Währung, Einheiten, Pflichtfelder.
  • Ein eindeutiger Schlüssel pro Datensatz (meist SKU) verbindet beide Seiten verlässlich.
  • Die meisten stillen Integrationsfehler entstehen beim Mapping: falsches Format, leeres Pflichtfeld, falsches Trennzeichen.
  • Immer erst mit einer kleinen Teilmenge testen, prüfen, dann die volle Menge laufen lassen.

01Was Datenmapping bedeutet

Zwei Systeme speichern dieselbe Information fast nie gleich. Eine Bestellung in Shopify hat ein Feld für die Bestellnummer, Ihre Buchhaltung nennt es vielleicht Belegnummer, und das Format weicht ab. Datenmapping ist die Zuordnungstabelle, die festlegt: Dieses Feld hier entspricht jenem Feld dort. Erst wenn diese Übersetzung vollständig und korrekt ist, kann eine Integration Daten verlässlich von der einen auf die andere Seite bringen.

Das klingt simpel, und im Kern ist es das auch. Die Tücke liegt im Detail. Ein Feldname ist schnell zugeordnet, aber ob das Datum als "15.11.2026" oder "2026-11-15" ankommt, ob der Preis ein Komma oder einen Punkt verwendet und ob ein Pflichtfeld überhaupt gefüllt ist, entscheidet, ob die Zuordnung in der Praxis hält. Weil ein Automatisierungsfehler sich über jeden Datensatz wiederholt, ist sorgfältiges Mapping kein Luxus, sondern die Grundlage einer stabilen Integration.

Ein Feldname ist schnell zugeordnet. Ob das Format dahinter passt, entscheidet, ob die Integration im Alltag hält.

02Schritt für Schritt: ein Mapping aufbauen

Ein sauberes Mapping entsteht nicht nebenbei, sondern in einer klaren Reihenfolge. Die folgenden Schritte gelten unabhängig davon, ob Sie per CSV, über ein Werkzeug wie n8n oder über eine App arbeiten.

1

Beide Datenmodelle auflisten: Welche Felder hat die Quelle, welche das Ziel? Notieren Sie Namen, Typ und ob das Feld Pflicht ist.

2

Einen eindeutigen Schlüssel festlegen, der beide Seiten verbindet, meist die SKU. Ohne ihn lässt sich kein Datensatz sicher zuordnen.

3

Felder paarweise zuordnen: Jedes benötigte Zielfeld bekommt genau eine Quelle. Nicht benötigte Felder bewusst weglassen.

4

Formate abgleichen: Datum, Zahlen, Währung, Einheiten und Textlängen auf beiden Seiten prüfen und bei Bedarf umwandeln.

5

Pflichtfelder absichern: Für jedes Pflichtfeld im Ziel muss eine Quelle oder ein Standardwert existieren.

6

Mit einer kleinen Teilmenge testen, das Ergebnis im Ziel prüfen, dann erst die volle Menge übertragen.

Der zweite Schritt ist der wichtigste und wird am häufigsten unterschätzt. Ohne einen eindeutigen Schlüssel, der einen Datensatz auf beiden Seiten verlässlich identifiziert, weiß die Integration nicht, welches Produkt sie aktualisieren soll. In Shopify ist die SKU (Stock Keeping Unit) dafür der übliche Kandidat, weil sie pro Variante eindeutig sein sollte. Ist die SKU nicht sauber gepflegt, bricht das Mapping an genau dieser Stelle, und zwar still.

03Nicht nur Namen: Formate und Typen abgleichen

Die eigentliche Arbeit beim Mapping steckt in den Formaten. Zwei Felder können denselben Namen tragen und trotzdem nicht zusammenpassen, weil die Werte unterschiedlich aufgebaut sind. Diese Unterschiede sind die häufigste Quelle für stille Fehler.

FeldtypTypische StolperstelleWas zu prüfen ist
Datum15.11.2026 vs. 2026-11-15 vs. US-FormatEinheitliches Zielformat festlegen und umwandeln
Preis / ZahlKomma vs. Punkt als DezimaltrennzeichenDezimal- und Tausendertrennzeichen angleichen
WährungBruttopreis vs. Nettopreis, WährungscodeKlären, welcher Wert gemeint ist, und ob die Währung mitgeliefert wird
EinheitenGramm vs. Kilogramm, Stück vs. PaketEinheit explizit festlegen, nicht raten
TextZeichenlänge, Sonderzeichen, UmlauteMaximale Länge und Zeichensatz des Ziels beachten
Ja/Neintrue/false vs. 1/0 vs. ja/neinBoolesche Werte auf das Zielformat übersetzen

Ein konkretes Beispiel macht das Risiko greifbar: Ihr Lieferant liefert Gewichte in Gramm, Shopify erwartet an einer bestimmten Stelle Kilogramm. Wird das nicht umgerechnet, steht bei jedem Produkt das Tausendfache, und die Versandkostenberechnung läuft falsch. Der Fehler ist technisch unsichtbar, denn beide Felder heißen "Gewicht" und beide enthalten eine Zahl. Erst der Blick auf die Einheit deckt das Problem auf.

Besondere Aufmerksamkeit verdienen Umlaute und Sonderzeichen. Gerade bei CSV-Dateien kann ein falscher Zeichensatz aus "Prüfung" ein "Prüfung" machen. Prüfen Sie im Testlauf immer gezielt ein Feld mit Umlauten, denn dieser Fehler zieht sich sonst durch den ganzen Katalog.

04Metafields: wenn Standardfelder nicht reichen

Oft bringt ein Fremdsystem Daten mit, für die Shopify kein passendes Standardfeld hat, etwa eine Lieferanten-Artikelnummer, ein Material oder ein technisches Attribut. Für genau solche Fälle gibt es Metafields, also Zusatzfelder, mit denen Sie Shopify-Objekte um eigene Eigenschaften erweitern. Beim Mapping sind sie häufig die Zielstelle für alles, was über die Grundfelder hinausgeht.

Wichtig ist, Metafields vorher sauber anzulegen und ihren Typ festzulegen, bevor Sie Daten hineinmappen. Ein Metafield für eine Zahl nimmt keinen Text sauber auf, und ein falsch gewählter Typ führt wieder zu stillen Fehlern. Wie Sie Metafields sinnvoll strukturieren und für die Produktpflege nutzen, zeigt der Artikel zu Produktattributen und Metafields →. Für das Mapping gilt: Behandeln Sie ein Metafield wie jedes andere Zielfeld, mit festem Namen, festem Typ und einem klaren Quellfeld.

05Typische Fehler und wie Sie sie vermeiden

Die meisten Mapping-Probleme wiederholen sich, und sie lassen sich mit einer Handvoll Regeln vermeiden. Die folgende Übersicht fasst zusammen, was sich in der Praxis bewährt und was regelmäßig schiefgeht.

✓Mach das

  • Einen eindeutigen Schlüssel (meist SKU) festlegen und dessen Sauberkeit zuerst prüfen
  • Formate explizit umwandeln: Datum, Zahlen, Einheiten, Währung
  • Immer mit einer kleinen Teilmenge testen und das Ergebnis im Ziel kontrollieren
  • Das Mapping dokumentieren, damit es nachvollziehbar und wartbar bleibt
  • Für jedes Pflichtfeld eine Quelle oder einen sinnvollen Standardwert festlegen

✕Vermeide das

  • Felder allein nach ihrem Namen zuordnen, ohne das Format zu prüfen
  • Annehmen, dass gleiche Feldnamen auch gleiche Werte bedeuten
  • Ein neues Mapping direkt auf den gesamten Katalog loslassen
  • Leere Pflichtfelder ignorieren und hoffen, dass das Ziel sie füllt
  • Umlaute und Sonderzeichen im Testlauf überspringen

Ein eigener Risikofall sind Daten, die ein KI-Dienst erzeugt hat, etwa automatisch angereicherte Produktattribute. Hier kommt zur Format-Prüfung die inhaltliche Prüfung dazu, denn ein Modell kann plausibel aussehende, aber falsche Werte liefern. Wie Sie solche Ergebnisse vor der Übernahme kontrollieren, beschreibt der Artikel KI-Ergebnisse prüfen →. Datenmapping sorgt dafür, dass die Werte an der richtigen Stelle landen. Dass die Werte auch stimmen, ist eine zweite, eigene Prüfung.

✓
Tipp: Das Mapping ist ein Dokument, kein Bauchgefühl

Halten Sie jede Zuordnung schriftlich fest: Quellfeld, Zielfeld, Format, Umwandlung, Pflicht ja oder nein. Dieses Dokument ist Gold wert, wenn später etwas nicht stimmt oder eine zweite Person die Integration übernimmt. Ohne Dokumentation ist jedes Mapping eine Blackbox, die niemand mehr nachvollziehen kann.

06Mapping in Werkzeugen und bei größeren Datenmengen

In einem Werkzeug wie n8n ordnen Sie Felder visuell zu, indem Sie die Ausgabe eines Schritts mit den Eingabefeldern des nächsten verbinden und bei Bedarf Umwandlungen einbauen. Das macht das Mapping sichtbar und wiederholbar, nimmt Ihnen aber die inhaltliche Prüfung nicht ab. Auch hier gilt: erst mit Testdaten, dann scharf. Wie Sie solche Abläufe aufbauen, zeigt der Leitfaden zu n8n und Shopify →.

Bei großen Datenmengen kommt ein technischer Aspekt dazu. Wer tausende Produkte über die API aktualisiert, stößt an die Mengenbegrenzungen (Rate Limits), die der Artikel zu den Shopify-API-Grundlagen → erklärt. Das Mapping selbst ändert sich dadurch nicht, aber der Ablauf muss die Übertragung drosseln und Wiederholungen beherrschen. Wie Sie solche Massen-Übertragungen stabil halten, behandelt der Artikel zu zuverlässigen Integrationen. Wenn Sie viele Produkte auf einmal ändern wollen, lohnt außerdem ein Blick darauf, wie sich Produkte in Masse bearbeiten → lassen.

07Trust und Sicherheit: prüfen, bevor es scharf läuft

Datenmapping ist die Stelle, an der ein unauffälliger Fehler den größten Schaden anrichtet, weil er sich lautlos über jeden Datensatz zieht. Genau deshalb ist der Prüfschritt hier nicht verhandelbar. Jedes neue oder geänderte Mapping läuft zuerst gegen eine kleine, überschaubare Teilmenge, deren Ergebnis ein Mensch im Ziel kontrolliert. Erst wenn Felder, Formate und Sonderfälle sichtbar stimmen, folgt die volle Menge.

Diese Zurückhaltung kostet ein paar Minuten und spart im Ernstfall Stunden. Ein falsch gemappter Preis, ein verrutschtes Gewicht oder ein leeres Pflichtfeld lässt sich an zehn Testzeilen in Sekunden erkennen, aber an zehntausend Produkten nur mühsam wieder einfangen. Die Grundhaltung dieser Marke gilt auch hier: Automatisierung nimmt Ihnen die Arbeit ab, die Kontrolle über das Ergebnis behalten Sie.

FAQHäufige Fragen

Was genau ist Datenmapping? +

Datenmapping ist die Zuordnung der Felder zweier Systeme, damit Daten korrekt von einem ins andere übertragen werden. Es legt fest, welches Feld der Quelle welchem Feld im Ziel entspricht, und gleicht dabei auch Formate wie Datum, Zahlen und Einheiten ab. Ohne sauberes Mapping landen Werte im falschen Feld oder im falschen Format.

Warum reicht es nicht, Felder nach dem Namen zuzuordnen? +

Weil gleiche Namen nicht gleiche Werte bedeuten. Zwei Felder können beide "Gewicht" heißen, aber eines in Gramm und eines in Kilogramm rechnen. Oder ein Datum liegt in unterschiedlichen Formaten vor. Erst der Abgleich der Formate und Einheiten macht aus einer Namenszuordnung ein funktionierendes Mapping.

Was ist der wichtigste Schritt beim Mapping? +

Einen eindeutigen Schlüssel festzulegen, der einen Datensatz auf beiden Seiten verlässlich identifiziert, in Shopify meist die SKU. Ohne ihn weiß die Integration nicht, welches Produkt sie aktualisieren soll. Ist die SKU nicht sauber gepflegt, scheitert das Mapping an dieser Stelle, oft ohne sichtbare Fehlermeldung.

Wie teste ich ein Mapping sicher? +

Übertragen Sie zuerst eine kleine Teilmenge, etwa zehn Datensätze, und prüfen Sie das Ergebnis im Zielsystem gezielt auf Felder, Formate und Sonderfälle wie Umlaute. Stimmt alles, übertragen Sie die volle Menge. So fangen Sie einen Fehler an wenigen Zeilen ab, bevor er den ganzen Katalog betrifft.

Wohin mappe ich Daten, für die Shopify kein Feld hat? +

In Metafields, also Zusatzfelder, mit denen Sie Shopify-Objekte um eigene Eigenschaften erweitern. Legen Sie das Metafield vorher mit festem Namen und passendem Typ an, bevor Sie Daten hineinmappen. Mehr dazu im Artikel zu Produktattributen und Metafields →.

Bleib dran bei deinem Shop

Jede Woche eine kurze, verständliche Mail mit dem, was für Einsteiger wirklich zählt.

Newsletter abonnieren

Geschrieben von der Redaktion shopagentix. shopagentix ist ein Angebot der RIANTHIS GmbH.