Artikel-Import (BAS05, BAS13, BAS22)

Transaktionen: BAS05 Artikel Import Vorlagen · BAS13 Artikel Import Wizard · BAS22 Artikel Bilder Import

Business-Zweck

Artikel-Importe ermöglichen wiederkehrende Massenaktualisierungen aus CSV, FTP/SFTP oder Marktplatz-Quellen – ohne jeden Datensatz einzeln über die UI zu pflegen.

Transaktion	Fokus
BAS05	Import-Vorlagen definieren (Quelle, Mapping, Modus)
BAS13	Wizard – geführter Import inkl. Spaltenabgleich
BAS22	Bilder zu Artikeln/Varianten zuordnen

Typische Partner-Szenarien

Nächtlicher Vollabgleich aus PIM

1. Partner legt CSV auf FTP ab
2. Import-Vorlage (MaterialImport) liest Datei
3. doMaterialImportFromCsv oder Job importMaterialsPerJob verarbeitet asynchron
4. Protokoll in MaterialImportLog prüfen

Delta-Update Preis & Bestand

Oft effizienter über direkte Material-API (/material/materialPrices, /material/materialStocks) – siehe Artikelstamm.

Marktplatz-Rückimport

Import aus Marktplatz-Katalog (importMaterialsFromMarketplace) – Überschneidung mit OMP, Konfiguration in Import-Maske.

Import-Modi (fachlich)

Die Mandanten-Konfiguration (materialImportMode) steuert, ob bestehende Artikel aktualisiert, übersprungen oder neu angelegt werden. Partner-Onboarding definiert den Modus pro Projekt.

Zusätzliche Modi pro Connector-Call:

• nameImportMode, descriptionImportMode, stockImportMode, priceImportMode, imageImportMode

Bildimport (BAS22)

• Bilder per URL oder Upload
• Zuordnung zu Material oder Variante
• Endpoints: importMaterialPicture, saveMaterialPicture

Voraussetzungen

• Artikelgruppen, Einheiten in Prüftabellen
• Bei FTP: erreichbarer Server (checkFtpConnection)
• Schreibrecht auf Material

Ergebnis & Qualitätssicherung

• Import-Log mit Fehlerzeilen (SKU, matCode, message)
• Report: materialImportReport
• Abbruch laufender Jobs über MaterialImportLog

Weiterlesen

• Artikelstamm