Artikel, Bezugsquellen und Preisstaffeln per CSV in weclapp importieren: Reihenfolge, Pflichtfelder und typische Abbrüche
Kurz gesagt: Artikelstammdaten importierst du in weclapp in vier festen Stufen — erst Einheiten, Warengruppen und Lieferant:innen, danach Verkaufsartikel, anschließend Bezugsquellen und zuletzt gestaffelte Artikelpreise. Für einmalige Übernahmen bis 49.999 Zeilen je Datei reicht der CSV-Import-Wizard, für laufende Einzeländerungen die REST-API und für große Lieferantenkataloge samt Bildern und Varianten der Katalog-Importer 4 weclapp. Die häufigsten Abbrüche und Dubletten entstehen durch gelöschte Vorlagenspalten, von Excel veränderte Artikelnummern und fehlende Referenzfelder.
Kaum ein Schritt in einer Neueinführung oder Datenübernahme kostet so viel Nacharbeit wie ein unsauberer Artikelimport. Stehen Einheiten, Artikeltypen oder Lieferantenartikelnummern beim ersten Lauf schief, merkst du das oft erst Wochen später beim Bestellvorschlag, am Packtisch oder auf der Rechnung.
Aus unseren Einrichtungsprojekten und aus unserem Support kennen wir die Stellen, an denen der Import/Export-Wizard von weclapp abbricht oder unbemerkt doppelte Datensätze anlegt. Mit der richtigen Reihenfolge und einem kleinen Probelauf am Testmandanten vermeidest du dieses Aufräumen von Anfang an.
Das Wichtigste in Kürze
- Nie alles in einem Schritt erzwingen. Lege zuerst Einheiten, Warengruppen, Vertriebswege und Lieferant:innen an und importiere danach getrennt Verkaufsartikel, Bezugsquellen und Artikelpreise.
-
Die Original-Kopfzeile der Demo-CSV bleibt unangetastet. Lösche oder verschiebe keine ungenutzten Spalten, nutze Semikolon als Trennzeichen, Komma als Dezimalzeichen und das Datumsformat
dd.MM.yyyy. - CSV-Wizard, API und Katalog-Importer lösen verschiedene Aufgaben. Einmalige Listen bis 49.999 Zeilen gehören in den Wizard, gezielte Einzel-Updates in die API und regelmäßige Lieferantenkataloge mit Bildern in den Katalog-Importer 4 weclapp.
- Bezugsquellen und Preisstaffeln haben verdeckte Pflichtkombinationen. Bei Einkaufspreis-Updates über die Preisvorlage verlangt weclapp beispielsweise Lieferantenname und Lieferantennummer gleichzeitig.
- Immer erst 5 bis 10 Zeilen im Testsystem prüfen. Erst wenn Artikeltyp, Steuersatz, Bezugsquelle und Staffelpreis am echten Datensatz stimmen, folgt der Gesamtlauf.
Welcher Weg passt: CSV-Wizard, REST-API oder Katalog-Importer?
Bevor du eine Excel-Tabelle umbaust, solltest du entscheiden, ob es um eine einmalige Datenübernahme oder um eine dauerhafte Lieferantenstrecke geht. weclapp bietet im Standard den Import/Export-Wizard unter Globale Einstellungen → Import/Export-Wizard an, der rund drei Dutzend Importtypen per Datei entgegennimmt. Eine Programmierschnittstelle für den Datei-Upload im Wizard gibt es nicht; Hochladen und Starten erfolgen bewusst durch eine angemeldete Person im Browser.
Für die Vorbereitung der CSV-Dateien kannst du dir heute viel Handarbeit sparen: Über wals.pro AI 4 weclapp prüfst du im Dialog — etwa mit Claude oder Claude Code — deine vorhandenen Einheiten, Warengruppen und Lieferantennummern live gegen deinen Mandanten und lässt Rohlisten in die exakte Spaltenstruktur der weclapp-Vorlagen bringen. Kleinere Preis- oder Stammdatenkorrekturen bereitet der Assistent bei Bedarf auch direkt mit Vorschau und payload-gebundener Einmal-Freigabe per SHA-256 vor.
| Weg | Wann sinnvoll | Umfang & Formate | Wichtige Grenze |
|---|---|---|---|
| weclapp Import/Export-Wizard | Ersteinrichtung, Systemwechsel, saisonale Preisrunde | CSV mit Semikolon, bis 49.999 Datenzeilen je Datei | Manueller Upload im Browser, keine automatische Bild- oder Variantenlogik aus Rohkatalogen |
| weclapp REST-API | Laufende Einzel- und Delta-Updates aus PIM, Shop oder Workflow | JSON je Endpunkt (article, articleSupplySource, articlePrice) |
Parallele Last begrenzt; PUT ersetzt Preislisten am Artikel vollständig, wenn Zeilen fehlen |
| Katalog-Importer 4 weclapp | Viele oder große Lieferant:innen mit laufenden Katalog-Updates | BMEcat (XML), XML, JSON, Excel, CSV über eigenen FTP-Ordner je Lieferant:in | Jede(r) Lieferant:in erhält ein eigenes Profil; die Ersteinrichtung des Mappings übernimmt wals.pro |
Wenn du aus einem Altsystem wechselst und neben Artikeln auch offene Vorgänge und Kundenstämme übernimmst, findest du den Gesamtablauf auf unserer Seite weclapp Migration.
Fazit: Nutze den CSV-Wizard für überschaubare Einmalläufe, die API für gezielte Systemabgleiche und den Katalog-Importer, sobald große Lieferantensortimente samt Bildern und Preisformeln laufend aktuell bleiben müssen.
In welcher Reihenfolge importierst du Stammdaten, Bezugsquellen und Preise?
Der häufigste Anfängerfehler besteht darin, Artikel, Einkaufsdaten und mehrstufige Preislisten in einem einzigen Schritt erzwingen zu wollen. Weil weclapp beim Einlesen Referenzen sofort prüft, schlägt jede Zeile fehl, deren Einheit, Lieferant oder Vertriebsweg noch nicht existiert.
-
Vorbedingungen im Mandanten schaffen: Prüfe und ergänze vorab alle verwendeten Mengeneinheiten (zum Beispiel
Stk,m,Std), Warengruppen, Währungen und Steuersätze. Aktiviere benötigte Vertriebswege (NET1bisNET15beziehungsweiseGROSS1bisGROSS15) und importiere oder pflege zuerst alle Lieferant:innen, damit jedeLIEFERANTENNUMMERfeststeht. -
Verkaufsartikel anlegen (Vorlage
Verkaufsartikel, 93 Spalten): Spiele zuerst den sauberen Artikelstamm mit deiner eigenenARTIKELNUMMER, Bezeichnung, Artikeltyp, Einheit und Warengruppe ein. Einen einfachen Basis-Verkaufspreis kannst du hier bereits mitgeben. -
Bezugsquellen verknüpfen (Vorlage
Bezugsquellen, 69 Spalten): Importiere im zweiten Lauf die Einkaufsdaten je Lieferant:in — inklusiveLieferantenartikelnummer, Einkaufspreis, Mindestbestellmenge und Wiederbeschaffungszeit — und verknüpfe sie über dieVerkaufsartikel-Nummermit dem bestehenden Artikel. -
Preisstaffeln und weitere Vertriebswege ergänzen (Vorlage
Artikelpreise, 28 Spalten): Sobald ein Artikel mehrere Mengenstaffeln, Aktionszeiträume oder Preise je Vertriebsweg und Kund:in hat, lädst du diese Zeilen getrennt über den Importtyp Artikelpreise hoch.
Fazit: Erst Referenzen und Lieferant:innen, dann Verkaufsartikel, dann Bezugsquellen, zuletzt Preisstaffeln — diese vier Stufen trennen Fehlerquellen sauber voneinander.
Welche Pflichtfelder und verdeckten Fallen gelten je Vorlage?
Die offiziellen Demo-CSVs und Feldbeschreibungen von weclapp enthalten einige Abweichungen zwischen Übersichtsseite und Detailtabelle, an denen Importe in der Praxis regelmäßig hängenbleiben. Die wichtigsten Felder im Überblick:
| Importtyp | Zwingende Pflichtfelder (Neuanlage) | Bedingte Pflichtfelder | Typische Stolperfalle |
|---|---|---|---|
| Verkaufsartikel |
ARTIKELNAME, ARTIKELNUMMER, EINHEIT, LADEHILFSMITTEL BESTANDSFÜHREND
|
Bei Verkaufspreis: VERTRIEBSWEG, WÄHRUNG, VERKAUF AB
|
Für normale Handels- und Lagerartikel LADEHILFSMITTEL BESTANDSFÜHREND ausdrücklich auf nein setzen; Artikeltyp als englischen Schlüssel wie STORABLE oder BASIC übergeben |
| Bezugsquellen |
ARTIKELNAME, Lieferantenartikelnummer, LIEFERANTENNUMMER, Artikel-Mengeneinheit
|
Bei Preis/Rabatt: Währung, Preis-Eintritt, Vertriebsweg, Zu- und Abschläge Typ 1/2
|
Verkaufsartikel-Nummer und den Schalter zum Aktualisieren des Verkaufsartikels bewusst setzen; Kopfzeile exakt aus der Demo-CSV übernehmen (Spalte 62 heißt dort Gebindemenge) |
| Artikelpreise |
ARTIKELNUMMER (Artikel muss existieren), NEUER PREIS GÜLTIG AB, ARTIKELPREIS
|
Bei Einkaufspreis-Update: Lieferantenname und Lieferantennummer gemeinsam |
Jede Staffel (STAFFELWERT) braucht eine eigene Zeile; für Belegmengen unter 1 (etwa 0,5) ist eine Staffel ab 0,00 nötig |
Verkaufsartikel: Systemschlüssel statt Oberflächenwörter
Im CSV-Import akzeptiert weclapp in Auswahlfeldern meist die internen englischen Schlüssel statt der deutschen Bezeichnungen aus der Oberfläche. Für einen lagergeführten Artikel trägst du in Artikeltyp beispielsweise STORABLE ein, für einen einfachen Grundartikel BASIC, für eine Dienstleistung SERVICE und für eine Verkaufsstückliste SALES_BILL_OF_MATERIAL. Genauso heißen die Vertriebswege technisch NET1 bis NET15 oder GROSS1 bis GROSS15.
Achte beim Verkaufspreis außerdem auf die richtige Datumsspalte: Maßgeblich für den Import ist VERKAUF AB (im Format dd.MM.yyyy), während die benachbarte Spalte Exportpreise gültig ab beim Einlesen ignoriert wird. Sobald ein Artikel später in Belegen oder Lagerbewegungen steckt, lässt sich sein Artikeltyp in weclapp nicht mehr frei umstellen — prüfe insbesondere Lagerführung, Chargen- und Seriennummernpflicht daher vor der ersten Buchung.
Bezugsquellen: Eigene Artikelnummer vs. Lieferantenartikelnummer
In vielen Supporttickets werden zwei Nummern verwechselt: Deine interne ARTIKELNUMMER (in der Bezugsquellen-Vorlage über Verkaufsartikel-Nummer referenziert) und die Lieferantenartikelnummer, unter der dein(e) Lieferant:in das Produkt führt. Beide dürfen völlig unterschiedlich lauten, und ein Verkaufsartikel kann problemlos mehrere Bezugsquellen verschiedener Lieferant:innen besitzen.
Wichtig für Updates ohne Dubletten: Die Zuordnung reagiert empfindlich auf Schreibweise sowie Groß- und Kleinschreibung. Willst du zusätzlich die Herstellerartikelnummer (MPN) oder EAN pflegen, kläre vorab, ob diese Information am Verkaufsartikel selbst geführt wird, damit Einkauf und Verkauf auf denselben Stamm schauen.
Preisstaffeln und Einkaufspreise aktualisieren
Mengenstaffeln bildest du in der Vorlage Artikelpreise ab, indem du denselben Artikel mehrfach untereinander aufführst und jeweils den STAFFELWERT erhöhst — etwa 1, 10 und 100. Rechnest du Dienstleistungen, Meterware oder Bruchmengen unterhalb von eins ab, lege die unterste Staffel bei 0,00 an, damit weclapp auch bei einer Menge von 0,5 den Preis zieht.
Besonders tückisch ist die Aktualisierung von Bezugsquellenpreisen über dieselbe Vorlage: Laut Feldbeschreibung von weclapp müssen dafür sowohl Lieferantenname als auch Lieferantennummer in der Zeile stehen. Fehlt eines der beiden Felder, kann der Wizard die Preiszeile nicht eindeutig der Bezugsquelle zuordnen.
Warum bricht der Import ab oder erzeugt Dubletten? Sieben Klassiker
Wenn eine Datei mit Fehlermeldung abgewiesen wird oder nach dem Lauf plötzlich doppelt so viele Artikel im Stamm liegen, liegt es fast immer an einem dieser sieben Punkte:
-
Spalten aus der Vorlage gelöscht oder verschoben: Der weclapp-Wizard liest Spalten positionsgebunden ein — in der Vorlage Verkaufsartikel taucht allein der Spaltenname
Handelssprachesechsmal an verschiedenen Stellen auf. Lass ungenutzte Spalten immer leer stehen, statt sie zu entfernen. -
CSV per Doppelklick in Excel geöffnet und gespeichert: Excel schneidet führende Nullen bei Artikelnummern (
00412wird zu412) stillschweigend ab und wandelt 13-stellige EAN-Nummern in wissenschaftliche Schreibweise (4,01235E+12) um. Beim nächsten Import findet weclapp die alte Nummer nicht mehr und legt eine Dublette an. Lade CSV-Dateien in Excel ausschließlich über den Datenimport mit Format „Text“ oder bearbeite sie in einem Texteditor beziehungsweise Skript. -
Punkt statt Komma oder falsches Trennzeichen: Das deutsche weclapp-CSV-Format erwartet das Semikolon (
;) als Spaltentrenner, das Komma (12,99) für Dezimalzahlen,dd.MM.yyyyfür Datumswerte undja/neinfür Schalter. Abweichungen zu den API-Formaten erklärt Datum, Zahlen und Zusatzfelder. -
Falsche Zeichencodierung bei Umlauten: Die weclapp-Hilfe nennt
ISO-8859-1als Standardcodierung, im Wizard kannst du ebensoUTF-8oderwindows-1252auswählen. Stimmen Dateicodierung und Auswahl im Wizard nicht überein, landen Bezeichnungen als unlesbare Sonderzeichen im System. - Zeilenlimit von 49.999 Zeilen gerissen: Größere Dateien lehnt der Wizard ab. Teile umfangreiche Kataloge in mehrere Dateien mit identischer Kopfzeile auf und trenne bei Preisstaffeln nie mitten in den Zeilen desselben Artikels.
-
Update per API überschreibt bestehende Preiszeilen: Wer Artikel, Bezugsquellen und Staffeln statt per CSV über die weclapp API einspielt, muss wissen, dass
supplySourcesundarticlePricesbei einemPUTals vollständige Ersatzliste behandelt werden — den exakten cURL-Ablauf zeigt Artikel und Bezugsquellen per weclapp-API importieren, weitere Details stehen in Stille Fehler der weclapp API. - Direkt im Produktivmandanten getestet: Ein fehlerhafter Import lässt sich in einem ERP nicht mit einem Klick rückgängig machen, sobald Preise oder Bezugsquellen bestehende Sätze überschrieben haben. Spiele deshalb immer zuerst 5 bis 10 repräsentative Artikel im weclapp-Testsystem ein.
Fazit: Behandle jede CSV-Datei wie Code — als reinen Text ohne Excel-Automatik, mit unveränderter Kopfzeile und Pflichtprobe im Testmandanten.
Wann reicht der CSV-Wizard nicht mehr aus?
- Du erhältst wöchentlich oder täglich neue Preislisten mehrerer Großhändler:innen. Manuelles Umformatieren und Hochladen bindet dann dauerhaft Fachkräfte und führt bei Urlaubsvertretungen zu veralteten Einkaufspreisen.
- Sortimente umfassen zehntausende bis hunderttausende Artikel samt Bildern, Varianten und BMEcat- oder XML-Dateien. Genau dafür haben wir den Katalog-Importer 4 weclapp gebaut: Jede(r) Lieferant:in legt Dateien in einen eigenen FTP-Ordner, Verkaufspreise berechnen sich per Formel je Vertriebsweg und Neuanlagen sowie Änderungen laufen automatisch nach weclapp.
- Deine Artikelstruktur selbst ist noch ungeklärt. Wenn noch offen ist, ob Sets als Verkaufsstückliste oder Produktionsstückliste laufen, wie Varianten geschnitten werden und welche Warengruppen die Buchhaltung braucht, klären wir das vor dem ersten Import im Rahmen der weclapp Einrichtung.
Fazit: Sobald Lieferantendaten regelmäßig, bildreich oder jenseits des 49.999-Zeilen-Limits eintreffen, ersetzt ein automatisierter Katalogabgleich mit festem Lieferantenprofil die manuelle CSV-Pflege.
Quellen und Grenzen
- weclapp-Hilfe, unterstützte Datenimporte im Import/Export-Wizard: doc.weclapp.com/knowledgebase/welche-datenimporte-werden-unterstuetzt (geprüft November 2026)
- weclapp-Hilfe, Daten nach weclapp importieren und CSV-Vorgaben: doc.weclapp.com/knowledgebase/wie-kann-ich-daten-in-weclapp-importieren (geprüft November 2026)
- weclapp-Hilfe, Staffelpreise und Mengen unter eins (Staffel ab
0,00): doc.weclapp.com/knowledgebase/staffelpreise (geprüft Oktober/November 2026) - weclapp Import/Export-Wizard, offizielle Demo-CSV-Vorlagen und PDF-Feldbeschreibungen für Verkaufsartikel (93 Spalten), Bezugsquellen (69 Spalten) und Artikelpreise (28 Spalten), geprüft gegen weclapp-Vorlagenstand November 2026
- weclapp, API-Spezifikation zu
article,articleSupplySourceundarticlePrice: weclapp.com/api/openapi_v2.yaml (geprüft November 2026) - Produktangaben zum Katalog-Importer 4 weclapp und zu wals.pro AI 4 weclapp: Produktdokumentation von wals.pro (eigene Quellen, Stand November 2026)
weclapp kann Spaltenanzahl und Feldnamen der Demo-CSVs mit neuen Releases erweitern, weshalb immer die frisch aus deinem eigenen weclapp-Mandanten heruntergeladene Demo-Datei maßgeblich ist. Der Beitrag deckt Handels-, Dienstleistungs- und Lagerartikel ab, ersetzt aber keine steuerliche Prüfung von Konten- und Steuerschlüssel-Zuordnungen.
Lizenz- oder Einrichtungspreise werden hier nicht genannt. Stand: 16. November 2026.
Häufige Fragen
In welcher Reihenfolge importiere ich Artikel und Lieferantenpreise in weclapp?
Du legst zuerst Einheiten, Warengruppen, aktivierte Vertriebswege und alle Lieferant:innen mit Lieferantennummer in weclapp an. Danach importierst du im ersten CSV-Lauf die Verkaufsartikel, im zweiten Lauf die Bezugsquellen mit Verknüpfung auf die Verkaufsartikel-Nummer und im dritten Lauf gestaffelte Preise über den Importtyp Artikelpreise.
Wie viele Zeilen kann ich im weclapp-CSV-Wizard auf einmal importieren?
Der Import/Export-Wizard von weclapp verarbeitet höchstens 49.999 Datenzeilen pro CSV-Datei. Größere Artikel- oder Preislisten teilst du auf mehrere Dateien mit identischer Original-Kopfzeile auf oder nutzt bei regelmäßigen Großkatalogen den Katalog-Importer 4 weclapp.
Darf ich nicht benötigte Spalten aus der weclapp-Importvorlage löschen?
Nein. Der Wizard ordnet viele Felder über ihre feste Spaltenposition zu, zumal manche Überschriften wie Handelssprache mehrfach in derselben Datei vorkommen. Behalte immer alle Spalten der aktuellen Demo-CSV aus deinem Mandanten in unveränderter Reihenfolge bei und lass ungenutzte Felder leer.
Was ist der Unterschied zwischen Artikelnummer und Lieferantenartikelnummer beim Import?
Die Artikelnummer identifiziert deinen eigenen Verkaufsartikel in weclapp, während die Lieferantenartikelnummer die Bestellnummer bei deinem jeweiligen Lieferanten speichert. In der Vorlage Bezugsquellen ist die Lieferantenartikelnummer ein Pflichtfeld und wird über das Feld Verkaufsartikel-Nummer mit deinem eigenen Artikel verknüpft.
Warum schlägt das Aktualisieren von Einkaufspreisen über die Vorlage Artikelpreise fehl?
Wenn du über den Importtyp Artikelpreise Preise einer Bezugsquelle aktualisieren möchtest, verlangt weclapp in jeder betroffenen Zeile sowohl den Lieferantennamen als auch die Lieferantennummer. Ist nur eines der beiden Felder gefüllt oder existiert die Bezugsquelle noch nicht am Artikel, kann weclapp die Preiszeile nicht zuordnen.
Wie verhindere ich, dass Excel führende Nullen und EAN-Nummern in meiner CSV zerstört?
Öffne eine CSV-Datei niemals per Doppelklick direkt in Excel, weil Excel Nummern wie 00412 automatisch kürzt und 13-stellige EANs in Exponentialzahlen umwandelt. Lade die Datei stattdessen über den Text- beziehungsweise Datenimport von Excel mit dem Spaltenformat Text, arbeite in einem Texteditor oder bereite die Datei per Skript oder über wals.pro AI vor.