Zum Inhalt
Integrationen (API / 3rd Party)

Belegpositionen-API

Belegpositionen über die Schnittstelle anlegen: Aufruf saveLineItem, automatisches Zubehör und die Reihenfolge bei der Lagerzuordnung.

Aktualisiert am 4. Oktober 2026

Über die Admin-API lassen sich Belegpositionen einzeln anlegen und ändern. Der Aufruf saveLineItem verhält sich dabei wie die Oberfläche: Preise werden ermittelt, Zubehör eingefügt und Lagerplätze zugeordnet.

Grundlagen

  • Positionen gehören zu einem gespeicherten Beleg; der Beleg muss zuerst über die Belegs-API existieren.
  • Pflichtangaben je Position: Belegbezug, Artikel oder Positionstyp, Menge; Preis und Steuer werden aus Artikel und Beleg ermittelt, wenn sie nicht übergeben werden.
  • Positionen ohne Artikel brauchen Steuersatz und Mengeneinheit, sonst wird mit 0 Prozent gerechnet.

Unterartikel

  • Zubehör-Artikel: wie automatisches Zubehör über die API entsteht (Einfügemodus AUTO, Option skipAutoAccessory).
  • Lagerung: Reihenfolge, in der der Lagerplatz einer Position bestimmt wird.

Hinweise

  • Jede gespeicherte Position löst Preis- und Rabattermittlung aus; übergeben Sie Preise nur, wenn sie bewusst abweichen sollen.
  • Große Belege mit vielen Positionen brauchen Zeit; wiederholen Sie Aufrufe nicht blind, sonst entstehen doppelte Positionen. Nutzen Sie eine eigene Referenz je Position.

Unterartikel

Verwandte Artikel