Produkte

Überblick
Der Katalog führt drei Arten in einer Liste: Leistung, Produkt und Lizenz. Das ist kein Sammelsurium, sondern der Punkt: Ein Angebot enthält typischerweise alle drei, und drei getrennte Kataloge hießen drei Stellen, an denen dieselbe Position gepflegt wird.
Kernaufgaben
Produkt anlegen. Zu den Stammdaten gehören Typ, Status, SKU, Einheit, Leitkategorie, Zusatzkategorien, Hersteller und Herstellernummer, Steuersatz sowie die Kennzeichen eigenes Produkt, abrechenbar und lagergeführt.
Die Detailseite nutzen. Sie gliedert sich in Reiter:
| Reiter | Inhalt |
|---|---|
| Übersicht | Stammdaten, Beschreibung, zusätzliche Felder |
| Varianten | die aus variantenbildenden Eigenschaften aufgespannten Ausprägungen |
| Versionen · Eigenschaften · Medien | Pflege des Artikels |
| Übersetzungen/SEO | mehrsprachige Texte und Metadaten |
| Beziehungen/Bundle | Zubehör, Alternativen, Sets |
| Bestand | Lagerzahlen, sofern lagergeführt |
| Gefahrgut | UN-Nummer, offizielle Benennung und Verpackungsart — mit Versand-Modul, siehe Versand |
| Verkaufte Lizenzen | Lizenzen, die zu diesem Artikel verkauft sind, mit Monatsumsatz — mit Lizenz-Modul |
| Shop-Sync | Stand des Artikels in jedem Verkaufskanal — mit Kanal-Modul, siehe unten |
Shop-Sync prüfen. Der Reiter Shop-Sync zeigt je Verkaufskanal, wie das Angebot dort steht: Zustand (Entwurf, Im Kanal, Fehlerhaft, Zurückgezogen), Zuletzt übertragen und Letzter Fehler — was der Kanal zuletzt gemeldet hat. Am Container stehen die Angebote seiner Varianten mit der Spalte Variante — der Container selbst wird in keinem Kanal angeboten. Der Reiter erscheint nur mit aktivem Kanal-Modul und dem Recht channels.channel.view; Sie sehen nur Kanäle der Marken, für die Sie dieses Recht haben. Gepflegt und übertragen wird im Kanal selbst.
„ab-Preis" am Container. Liste und Detail eines Containers zeigen statt des Standardpreises den ab-Preis — den kleinsten Preis seiner aktiven Varianten, so wie die Preisfindung ihn ohne Kunde ergibt: Listenpreis, laufende Aktion oder eine Staffel ab Menge 1. Inaktive Varianten zählen nicht. Im Verkaufskanal trägt jedes Varianten-Angebot den ab-Preis seines Containers in Kanal-Währung mit; über die Schnittstelle steht er im Feld fromPriceAmount des Artikels (nur lesend, nur Container).
Varianten aufspannen. Varianten entstehen aus variantenbildenden Eigenschaftsgruppen — etwa Farbe und Größe. Welche Gruppen das sind, steht in den Produkt-Eigenschaften.
Gemeinsames am Container pflegen. Eine Variante erbt vom Container die Beschreibung, die Kurz- und Langbeschreibung sowie SEO-Titel und -Beschreibung je Sprache und die Medien — solange sie selbst keinen Wert dafür führt. Das gilt überall: auf der Detailseite, in Belegen und in den Verkaufskanälen. Name, abweichender Belegtext und URL-Kürzel bleiben je Variante. Auf der Detailseite einer Variante zeigt die Karte Vom Container geerbt je Feld, ob es geerbt ist oder einen eigenen Wert hat: Überschreiben übernimmt den Wert des Containers als eigenen Wert, den Sie danach wie gewohnt bearbeiten; Zurücksetzen leert den eigenen Wert, und der Container-Wert gilt wieder. Über die Schnittstelle steht dasselbe im Feld inheritance des Artikels (nur Varianten, nur lesend).
Nach Hersteller und Eigenschaften filtern. Der Knopf Hersteller & Eigenschaften über der Liste öffnet die Facetten: je Hersteller und je Wert einer filterbaren Eigenschaft steht dort, wie viele Artikel der aktuellen Auswahl passen. Mehrere Werte derselben Eigenschaft gelten als oder (rot oder blau), Werte verschiedener Eigenschaften als und (rot und Größe M). Die Zahl einer Eigenschaft rechnet ohne ihre eigene Auswahl — so bleibt sichtbar, wie viele Artikel ein weiterer Wert dazubrächte. Suche, Marke und die übrigen Listenfilter gelten mit. Eigenschaften ohne den Schalter filterbar erscheinen hier nicht. Über die Schnittstelle filtert die Artikelliste mit manufacturerUlid und propertyOptionUlids (Kommaliste); die Zahlen liefert /v1/product-facets.
Sammelaktionen nutzen. Aus der Liste heraus lassen sich Artikel aktivieren, deaktivieren, auf Entwurf setzen, auf EOL setzen sowie Kategorie und Steuersatz vergeben.
Duplizieren. Duplizieren legt einen Artikel als Kopie an — der schnellste Weg zu einer Variante desselben Zuschnitts.
Die UVP verstehen. Die unverbindliche Preisempfehlung des Herstellers ist nur zur Anzeige — sie geht nie in die Preisfindung ein. Leer lassen heißt: kein Streichpreis.
Felder im Detail
Die Spalte Was es bewirkt beantwortet, was sich im System ändert — nicht, wie das Feld heißt. Der graue Name dahinter ist das Feld der API: unter ihm läuft dasselbe über Automation, Import und KI-Werkzeuge.
Grunddaten
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Name name | ja | Text | Die einzige Pflichtangabe. Steht auf jedem Beleg, in Suche, Katalog und Auswertung. |
Art type | nein | Dienstleistung, Ware, Lizenz, Set | Was verkauft wird. Entscheidet über Bestandsführung, Lieferschein und die Frage, ob überhaupt etwas versandt wird. |
Artikelnummer sku | nein | Text | Ihre eigene Nummer. Sie ist der Schlüssel für Import, Bestandsführung und Fremdsysteme — nicht mehr ändern, sobald sie im Umlauf ist. |
Beschreibung description | nein | formatierter Text | Die Beschreibung für Beleg und Katalog. |
Status status | nein | Entwurf, aktiv, ausgelaufen | Wo der Artikel steht. Ausgelaufen lässt sich nicht mehr neu verkaufen, bleibt aber auf alten Belegen und im Bestand sichtbar. |
Aktiv active | nein | Ja/Nein | Aus heißt: nicht mehr wählbar. Der schnelle Schalter, wenn ein Artikel vorübergehend raus soll. |
Eigenes Produkt isOwnProduct | nein | Ja/Nein | Ob Sie es selbst herstellen oder handeln. Trennt Handelsware von Eigenfertigung in der Auswertung. |
Marke brandId | nein | eine Ihrer Marken | Unter welcher Marke der Artikel geführt wird. |
Preis und Steuer
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Preis defaultPriceAmount | nein | Betrag, 0 oder mehr | Der Standardpreis. Er ist der Ausgangspunkt, nicht das letzte Wort: Kundenpreise, Staffeln und Aktionen setzen sich davor. |
UVP rrpAmount | nein | Betrag, 0 oder mehr | Die unverbindliche Preisempfehlung. Reine Anzeige — gerechnet wird mit dem Preis. |
ab-Preis fromPriceAmount | – | Betrag, nur lesend | Nur am Container: der kleinste Preis der aktiven Varianten über die Preisfindung ohne Kunde. Liste und Detail zeigen ihn als „ab …". |
Einkaufspreis purchasePriceAmount | nein | Betrag, 0 oder mehr | Was der Artikel Sie kostet. Grundlage der Marge; wird bei Wareneingängen fortgeschrieben, wenn die Bewertung das vorsieht. |
Steuersatz taxRateId | nein | Stammdaten „Steuersätze" | Der Satz, der auf dem Beleg ausgewiesen wird — sofern nicht der Steuerfall des Kunden etwas anderes verlangt. |
Erlöskonto revenueAccount | nein | Ziffern und Buchstaben, max. 20 Zeichen | Auf welches Sachkonto der Umsatz dieses Artikels gebucht wird. Leer = die Kontenfindung entscheidet anhand von Steuersatz und Beleg. |
Kostenstelle costCenter | nein | Text, max. 36 Zeichen | KOST1 als Vorbelegung für Belegpositionen mit diesem Artikel. Leer = keine Vorbelegung. |
Einheit unit | nein | Stammdaten-Einheit | Stück, Stunde, Kilogramm … Bestimmt auch, wie viele Nachkommastellen die Menge auf dem Beleg haben darf. |
Grundpreis: Inhalt basePriceContent / Einheit basePriceUnit | nein | Zahl, Text max. 20 Zeichen | Für die Grundpreisangabe („4,50 € je 100 ml"). Im Handel mit Endverbrauchern ist sie Pflicht — hier entsteht sie, statt in jeder Beschreibung von Hand. |
Abrechnungsart billingMode | nein | einmalig oder wiederkehrend | Ob der Artikel einmal oder laufend berechnet wird. |
Intervall recurringInterval | bei „wiederkehrend" | Monat, Quartal, Jahr | Der Takt der wiederkehrenden Berechnung. |
Abrechenbar billable | nein | Ja/Nein | Ob der Artikel überhaupt auf eine Rechnung darf. Aus für Innenleistungen, die erfasst, aber nie berechnet werden. |
Einordnung und Katalog
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Kategorie categoryUlid | nein | bestehende Kategorie | Die Hauptkategorie. Bestimmt den Platz im Katalog. |
Weitere Kategorien additionalCategoryUlids | nein | mehrere Kategorien | Zusätzliche Einhängepunkte, ohne die Hauptzuordnung zu verlieren. |
Hersteller manufacturerUlid | nein | bestehender Hersteller | Wer es herstellt. Trägt zugleich die gesetzlich geforderten Herstellerangaben. |
EAN ean | nein | Text, max. 20 Zeichen | Die Strichcode-Nummer. Sie macht den Artikel scanbar — im Lager, an der Kasse und beim Wareneingang. |
Herstellernummer manufacturerNumber | nein | Text, max. 64 Zeichen | Die Nummer des Herstellers. Hilft beim Nachbestellen und beim Abgleich mit Lieferantenlisten. |
Eigenschaften properties | nein | Werte aus Eigenschaftsgruppen | Farbe, Größe, Material … Filterbar im Katalog und Grundlage von Varianten. |
Medien media | nein | Bilder und Dateien | Bilder für Katalog und Beleg, Datenblätter zum Herunterladen. |
Übersetzungen translations | nein | Name, abweichender Belegtext und Beschreibung je Sprache | Wie der Artikel in anderen Sprachen heißt. Belege lesen sie in ihrer Sprache: Wählen Sie den Artikel in einem englischen Angebot, kommt die Bezeichnung aus dem abweichenden Belegtext der englischen Übersetzung, sonst aus ihrem Namen, und die Beschreibung aus ihrer Lang-, sonst Kurzbeschreibung. Fehlt die Übersetzung, gilt die Standardsprache — ihr abweichender Belegtext, sonst der Stammname und die Stammbeschreibung —, statt leer zu bleiben. Ein Text, den Sie an der Belegposition selbst schreiben, gewinnt immer. |
Beziehungen relations | nein | je Zeile verknüpfter Artikel und Typ: Cross-Sell (cross_sell, passt dazu), Up-Sell (up_sell, höherwertige Alternative), Zubehör (accessory), Ähnlich (similar) | Verbindungen zu anderen Artikeln, die im Verkauf vorgeschlagen werden. Die Richtung zählt: eine Up-Sell-Beziehung vom Basis- zum Premium-Artikel schlägt beim Basis-Artikel den Premium-Artikel vor, nicht umgekehrt. Derselbe Artikel kann mit mehreren Typen verknüpft sein. Gepflegt im Reiter Beziehungen/Bundle. |
Varianten und Sets
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
Artikel-Bauform productKind | eigenständig, Container, Variante | Ob der Artikel für sich steht, Varianten trägt oder selbst eine ist. Ein Container wird nicht verkauft — verkauft werden seine Varianten. |
Variantenachsen variantAxes | Eigenschaftsgruppen | Welche Eigenschaften Varianten aufspannen, etwa Farbe × Größe. |
Set-Inhalt bundle | Artikel mit Menge | Woraus ein Set besteht. Ein Set ist eine Verkaufs-Zusammenstellung: der Bestand bleibt an den Einzelteilen, nicht am Set. |
Konfigurator configurator | Auswahlgruppen mit Mindest- und Höchstmenge; je Option Komponente, Menge und Aufpreis | Macht den Artikel zum Konfigurationsartikel: am Auftrag wird je Gruppe gewählt, der Aufpreis kommt auf den Einzelpreis, und reserviert, versandt und zurückgenommen werden genau die gewählten Komponenten. Die Auswahl steht eingefroren an der Position — spätere Änderungen am Konfigurator ändern keinen Auftrag. Nur an nicht lagergeführten Artikeln, nie am Container und nie zugleich als Set. |
Variante
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Artikel productId | ja | der Container-Artikel | Zu welchem Artikel die Variante gehört. Wird beim Anlegen aus dem Container gesetzt und nicht von Hand gewechselt — ein Wechsel risse die Variante aus ihrer Merkmalsachse. |
Name name | ja | Text | Wie die Variante heißt, meist die Merkmalskombination. |
Artikelnummer sku | nein | Text | Eigene Nummer der Variante. Sie wird bestellt und gescannt, nicht die des Containers. |
Abweichender Preis priceOverrideAmount | nein | Betrag | Nur setzen, wenn die Variante anders kostet. Leer heißt: Preis des Containers. |
Merkmale attributes | nein | Werte der Variantenachsen | Was diese Variante ausmacht — etwa Farbe „blau", Größe „L". |
Standard isDefault | nein | Ja/Nein | Welche Variante vorausgewählt ist. |
Reihenfolge sortOrder / Aktiv active | nein | Zahl, Ja/Nein | Position in der Auswahl und ob die Variante noch angeboten wird. |
Logistik und Zoll
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
Bestandsgeführt stockManaged | Ja/Nein | Ob für den Artikel Bestand geführt wird. Aus für Dienstleistungen; an bedeutet, dass jede Bewegung gebucht wird. |
Gewicht weightGrams | Gramm, 0 oder mehr | Versandgewicht. Grundlage der Versandkosten-Ermittlung. |
Länge / Breite / Höhe lengthMm, widthMm, heightMm | Millimeter | Maße für Verpackung und Versandart. |
Lieferzeit deliveryTimeCode | Stammdaten „Lieferzeiten" | Was dem Kunden als Lieferzeit angezeigt wird — und womit gerechnet wird: die Spanne der Stufe (Mindest- und Höchstwert in Tagen) ergibt am Angebot und am Auftrag das voraussichtliche Lieferdatum (Belegdatum plus Höchstwert der längsten Position, gezählt in Werktagen ohne die Feiertage der Marke) und geht an die Verkaufskanäle: Shopware bekommt die Spanne, Otto den Höchstwert, Amazon und Kaufland den Höchstwert als Bearbeitungszeit. „Auf Anfrage" (ohne Tage) verspricht kein Datum. |
Verfügbar ab availableFrom | Datum | Ab wann bestellbar. Davor lässt sich der Artikel zeigen, aber nicht verkaufen. |
Zolltarifnummer customsTariffNumber | Text, max. 20 Zeichen | Die Warennummer für die Ausfuhr. Ohne sie bleibt eine Auslandssendung an der Zollanmeldung hängen. |
Ursprungsland countryOfOrigin | Land | Woher die Ware stammt. Zusammen mit der Zolltarifnummer die Pflichtangabe der Ausfuhr. |
Altersgrenze minimumAge | keine, ab 16, ab 18 | Für Ware mit Jugendschutz (Alkohol, Tabak, Medien). Der Versand bucht bei einem solchen Artikel den Altersnachweis beim Dienstleister selbst mit — und weist einen Dienstleister ohne Altersprüfung ab, bevor Bestand gebucht wird. |
Katalogleistung (§ 3a Abs. 4 UStG) catalogService | Ja/Nein | Für Beratung, Werbung, Datenverarbeitung und die übrigen Katalogleistungen. An einen Privatkunden im Drittland ist die Leistung dann im Inland nicht steuerbar: die Rechnung weist 0 % mit Hinweis aus (E-Rechnung: steuerbefreit mit Klartext-Grund). Ohne den Schalter bleibt es bei der deutschen Umsatzsteuer. |
Leistungsart serviceKind | Allgemeine Leistung (general), Elektronisch/Telekommunikation/Rundfunk (electronic) | Wo eine Leistung an Privatkunden im Ausland versteuert wird: eine allgemeine Leistung (Beratung, Programmierung vor Ort) am Sitz des Leistenden — mit deutscher Umsatzsteuer, nicht im OSS; eine elektronische Leistung (Hosting, Software-Abo, Download) im Land des Kunden — in der EU über das OSS-Verfahren, im Drittland nicht steuerbar. Eine elektronische Leistung zählt als sonstige Leistung, auch wenn der Artikel eine Lizenz ist. |
Steuerklasse (Ausland) taxClass | Schlüssel einer Steuerklasse, leer = keine | Nur mit aktivem International-Modul: Gruppe mit eigenem Satz je Land (z. B. Bücher). Im EU-Fernverkauf gilt der Satz dieser Klasse im Bestimmungsland (gepflegt bei den Länder-Steuersätzen); ohne Zeile für das Land der Satz der Satzart. |
Nur über Schnittstelle und Automation
| Feld | Werte / Format | Was es bewirkt |
|---|---|---|
lexofficeArticleRef | Kennung im Fremdsystem | Verbindet den Artikel mit seinem Gegenstück in der angebundenen Buchhaltung. |
Konfigurations-Vorschau: productId · selections | Artikel-Id und Auswahl [{optionUlid, qty}] | Prüft eine Auswahl gegen den Konfigurator, rechnet den Aufpreis und nennt jeden Verstoß — ohne etwas zu speichern (POST /v1/product-configurations/preview). Verbindlich prüft erst der Auftrag. |
Konfigurations-Vorschau: customerId · brandId · qty | Kunden-Id, Marken-Id, Menge — alle optional | Rechnet den Grundpreis über die Preis-Engine (Kundenpreisliste, Staffel, Marke) und liefert ihn als basePriceAmount sowie den vorgerechneten Einzelpreis unitPriceAmount = Grundpreis + Aufpreise. Die Belegmaske übernimmt ihn mit Übernehmen; an der Position bleibt er überschreibbar. Ein Beleg ohne mitgegebenen Einzelpreis bekommt denselben Wert vom Server. |
Konfigurations-Vorschau: fxRate | Kurs des Belegs (Fremdwährung je 1 EUR), optional | Für Belege in Fremdwährung: der am Beleg eingefrorene Kurs. Dann steht unitPriceAmount in der Belegwährung — Grundpreis und Aufpreise werden als EINE Summe umgerechnet; basePriceAmount und die Aufpreise bleiben die Euro-Werte aus dem Katalog. Ein Beleg in Fremdwährung ohne mitgegebenen Einzelpreis bekommt denselben umgerechneten Wert vom Server. Keine positive Zahl wird abgewiesen. |
Konfigurations-Vorschau: currency | Belegwährung (ISO 4217) zu fxRate, optional | Bestimmt die Nachkommastellen des umgerechneten Einzelpreises: Yen ohne, Bahrain-Dinar mit drei, sonst zwei. Ohne Angabe gelten zwei Stellen. |
Konfigurations-Vorschau: cartQty | belegweite Menge desselben Artikels, optional | Für Staffelpreise mit der Mengenbasis Warenkorb gesamt: die Menge dieses Artikels auf dem GANZEN Beleg, nicht die der Position. Drei Positionen à vier Stück erreichen damit zusammen die Zehner-Stufe, die keine von ihnen allein erreicht. Ohne die Angabe zählt qty — nie günstiger als die Positionsmenge, nie eine erfundene Zahl. |
Einstellungen & Rechte
- Modul
module.products. products.catalog.viewzum Sehen,products.catalog.managezum Pflegen — der Preis am
Artikel gehört zu den Stammdaten und wird mit demselben Recht gepflegt.
- Preisregeln haben eigene Rechte. Staffel-, Kunden- und Gruppenpreise liegen in ihren eigenen
Modulen, siehe Preise & Einheiten. products.pricing.manage ist für einen eigenen Preis-Zuschnitt vorgemerkt und erzwingt heute keine Operation.
- Bestand erscheint nur bei lagergeführten Artikeln — das Kennzeichen ist der Schalter, siehe
- Hersteller tragen GPSR-Angaben, siehe Hersteller.
FAQ & Fehlerbilder
Ein Artikel taucht im Bestand nicht auf. Dann ist er nicht als lagergeführt markiert. Leistungen und Lizenzen sind es üblicherweise nicht.
Varianten lassen sich nicht anlegen. Es fehlt eine variantenbildende Eigenschaftsgruppe. Ohne Achse gibt es nichts aufzuspannen.
Die UVP wirkt sich nicht auf den Preis aus. Richtig — sie ist reine Anzeige und niemals Teil der Preisfindung.
Ein Artikel soll nicht mehr verkauft werden. Setzen Sie ihn auf EOL oder deaktivieren Sie ihn, statt zu löschen — Belege verweisen darauf.