Artikelstamm (BAS02)

Transaktion: BAS02 Artikelstamm
UI-Pfad: /materials

Business-Zweck

Der Artikelstamm ist das zentrale Produkt- und Leistungsverzeichnis in reybex. Jeder verkaufbare oder lagerrelevante Gegenstand wird als Material geführt – mit Artikelnummer (matCode), optional SKU/GTIN, Preisen, Einheiten, Varianten, Bildern und Lagerbezug.

Partner nutzen den Artikelstamm, um:

• Produktdaten aus PIM/ERP anzulegen oder zu aktualisieren
• Bestände und Preise zu synchronisieren
• Varianten (Größe, Farbe) für Shop und Marktplatz bereitzustellen
• Referenzen für Vertriebsbelege (SAL) und Lagerbuchungen (INV) zu schaffen

Kernbegriffe

Begriff	Bedeutung
Material	Stammsatz eines Artikels (Kopf)
matCode	Interne Artikelnummer in reybex
sku	Externe/partnerseitige SKU (oft identisch mit matCode)
MaterialVariant	Variante eines Artikels (z. B. Farbe M)
matGroup	Artikelgruppe (Warengruppe, Steuerlogik)
matStatus	Status (aktiv, gesperrt, Auslauf …)

Fachlicher Lebenszyklus

1. Anlage – manuell in der UI oder per API (POST /api/material/) / Connector (POST /api/material/connector)
2. Pflege – Preise, Texte, Bilder, Attribute, Lagerdaten
3. Nutzung – Referenz in Angeboten, Aufträgen, Bestellungen, Marktplatz-Listings
4. Sperre/Löschung – isDelete / Status; Löschung nur wenn keine harten Referenzen

Partner-Szenarien

Initialer Katalog-Load

Großer Erstimport über Artikel Import Wizard (BAS13) oder direkt Connector-API mit Material-Array.

Delta-Sync (täglich/stündlich)

• Preise: POST /api/material/materialPrices
• Bestände: POST /api/material/materialStocks
• Stammdaten: Connector mit Update-Modus (importMode aus Mandanten-Konfiguration)

Einzelartikel-On-Demand

POST /api/material/ zum Anlegen, GET /api/material/{id} zum Lesen.

Voraussetzungen

• Prüftabellen: Artikelgruppe, Einheiten, MwSt-Schlüssel, ggf. Lager (Prüftabellen)
• Partner-User mit Recht auf BAS02
• Authentifizierter API-Zugriff

Auswirkungen im ERP

Aktion	Auswirkung
Neues Material	Suchindex wird aktualisiert; optional Agent-Events (material.created)
Preisänderung	VK-Preislisten, Angebote (je nach Konfiguration)
Bestandsbuchung	Lagerbestand, Verfügbarkeit in SAL/INV
Varianten	Marktplatz-Attribute, Pick-Listen

Typische Fehlerquellen

• Doppelte matCode/sku – Import bricht für betroffene Zeilen ab, Fehler in response-Array
• Fehlende Einheit/Gruppe – Validierung schlägt fehl oder Default aus Material-Template
• Hardcodierte IDs – Gruppen/DocTypes sind mandantenspezifisch

Weiterlesen

• Technisch: Material API
• Import: Artikel-Import
• Export: Material-Export