Zum Inhalt
Reiter Zubehör

Zubehörartikel

Aktualisiert am 30. September 2026

So legen Sie Zubehör an, das zu einer Artikelposition auf einem Beleg automatisch oder auf Wunsch mit erfasst werden kann.

Vorgehen

  1. Legen Sie in der Artikelliste zwei Artikel an: den Hauptartikel und den Zubehörartikel. Der Zubehörartikel ist ein normaler Artikel, es gibt dafür keinen besonderen Artikeltyp.
  2. Öffnen Sie den Hauptartikel und wechseln Sie in den Bereich Zubehör. Dort verknüpfen Sie den Zubehörartikel und pflegen die Einstellungen der Zubehörkonfiguration.

Bedeutung der Einstellungen

Typ

Einfach – aktuell die vorgesehene Variante. Weitere Typen können später ergänzt werden.

Mengentyp

  • Unabhängig – Die Menge des Zubehörs am Beleg entspricht der Menge, die Sie in der Zubehörkonfiguration eintragen.
  • Multipliziert mit Produktanzahl – Die Zubehörmenge am Beleg ergibt sich aus: Menge der Hauptposition × Menge laut Zubehörkonfiguration.
  • Jsonata

Mengenausdruck (optional, für erweiterte Anwendungsfälle)

In diesem Feld kann – wenn Ihr Unternehmen das nutzt – eine Formel hinterlegt werden, die festlegt, wie viele Stück Zubehör erfasst werden (oder ob Zubehör in einem Fall gar nicht erfasst wird).

  • Ist das Feld leer, gilt ausschließlich der Mengentyp und die Menge wie oben beschrieben.
  • Ist eine Formel hinterlegt, wertet PHX diese aus, sobald Zubehör automatisch ergänzt wird (und in den gleichen Regeln, wenn das System die Zubehörmenge für eine Position ermittelt). Eine Vorschau im Artikelstamm ist dafür nicht vorgesehen; die gesamte Menge sehen Sie an der Zubehörposition auf dem Beleg nach dem Speichern.
  • Jsonata kann über https://try.jsonata.org/ getestet werden

Ergebnis der Formel – was passiert am Beleg?

  • Leeres Ergebnis / „nichts“ – In diesem Fall wird keine Zubehörposition angelegt (das Zubehör wird übersprungen).
  • Zahl – Diese Zahl wird als Menge der Zubehörposition übernommen.
  • Anderes Ergebnis (z. B. Text, der keine Zahl ist) – Dann greift das System wie ohne Mengenausdruck auf Mengentyp und Menge zurück.

Einfügemodus

  • Automatisch – Das Zubehör wird ergänzt, sobald der Hauptartikel zur passenden Belegposition hinzugefügt wurde (sofern Belegrichtung und übrige Einstellungen passen und die Formel das Zubehör nicht ausdrücklich auslässt).
  • Manuell – Das Zubehör wird nur erfasst, wenn Sie es aus der Auswahl selbst hinzufügen.
  • Auf Nachfrage – Sie wählen das Zubehör selbst; beim Hinzufügen des Hauptartikels kann sich das Auswahlfenster für Zubehör von alleine öffnen.

Menge, Preis, mit Steuer

Menge und Preis steuern die Standardwerte der Zubehörposition. Ist kein Preis eingetragen, kann das System den Preis je nach Beleg und Preislisten automatisch ermitteln. Mit Steuer bezieht sich auf die Preisangabe.

Aktualisieren bei Produktänderung

Ist diese Option aktiv, passt das System die Menge der Zubehörposition an, wenn Sie später die Menge der Hauptposition ändern. Ist sie nicht aktiv, bleibt die Zubehörmenge unverändert.

Belegrichtung

Legt fest, ob das Zubehör nur bei Ausgangsbelegen, nur bei Eingangsbelegen oder bei beiden Richtungen zur Verfügung steht bzw. automatisch eingefügt werden darf.

Daten für den Mengenausdruck (nur bei Formeln)

Wenn Sie oder Ihre Fachabteilung einen Mengenausdruck pflegen, stehen der Formel typischerweise vier Bereiche zur Verfügung. In der Formel heißen sie (fachlich, auf Englisch) so:

Was Sie inhaltlich ansprechen Name in der Formel
Der Beleg (Kopfdaten wie Belegart, Datum, Partner, Steuerart, …) document
Die Hauptposition auf dem Beleg, zu der das Zubehör gehört lineItem
Die Verknüpfung zwischen Hauptartikel und dieser Zubehörkonfiguration accessoryConfigProductLink
Die Zubehörkonfiguration selbst (Mengentyp, Menge, Zubehörartikel, Richtung, …) accessoryConfig

Damit lassen sich z. B. die Menge der Hauptposition, Felder am Beleg oder Angaben aus der Konfiguration in eine Bedingung oder Rechnung einbeziehen.

Hinweis: Aus Performance- und Übersichtsgründen enthält der Beleg in diesem Kontext nicht die vollständige Liste aller anderen Positionen; an der Hauptposition fehlen außerdem einige technische Verknüpfungen (z. B. Lagerbuchungen). Üblich nutzbare Felder (Artikel, Mengen, Bezeichnungen, benutzerdefinierte Felder, …) sind dennoch in der Regel verfügbar, soweit sie zu der Position bzw. zu dem Beleg gespeichert sind.

Beispiele (nur als Idee, Formeln müssen zu Ihren Feldern passen):

  • Zubehörmenge gleich Hauptpositionsmenge: Inhalt der Formel in Richtung lineItem.quantity
  • Zubehör nur bei großer Hauptmenge: z. B. nur wenn die Hauptmenge größer als ein Grenzwert ist, eine Zahl liefern, sonst „nichts“, damit kein Zubehör angelegt wird.

Wenn Sie unsicher sind, wenden Sie sich an Ihre PHX-Betreuung oder an die Fachverantwortung – falsch gesetzte Formeln können dazu führen, dass Zubehör fehlt oder in unerwarteter Menge erscheint.