Positionen zu einem Beleg hinzufügen

Positionen tragen die Beträge eines Belegs. Dieser Artikel zeigt Ihnen, wie Sie sie hinzufügen, was jedes Feld bedeutet und welche Grenzen gelten. Das Hinzufügen von Positionen erfordert die Berechtigung belege:transition und einen Beleg in einem bearbeitbaren Status (Entwurf oder Rückfrage erforderlich).

Eine Position hinzufügen

Öffnen Sie den Beleg im Status Entwurf oder Rückfrage erforderlich.
Fügen Sie im Positionsraster eine Zeile hinzu.
Geben Sie Beschreibung, Menge und Einzelpreis ein. Legen Sie optional den Umsatzsteuersatz, die Kostenstelle, die Sachkonto-Zuordnung und den Positionstyp fest.
Speichern Sie den Beleg. Alle Positionen werden gemeinsam gesendet, und die Beträge und Kopfsummen werden beim Speichern neu berechnet.

Hinweis: Positionen werden als ein einziges Array zusammen mit dem Beleg übermittelt, nicht einzeln. Das Speichern wendet den gesamten Satz auf einmal an und berechnet jeden Betrag neu.

Positionsfelder

Feld	Erforderlich	Hinweise
Beschreibung	Ja	Was die Position umfasst, zum Beispiel "Diesel" oder "AdBlue". Bis zu 500 Zeichen; führende/nachfolgende Leerzeichen werden entfernt.
Menge	Ja	Muss größer als null sein. Auf 4 Dezimalstellen gespeichert.
Einzelpreis	Ja	Muss null oder größer sein. Auf 2 Dezimalstellen gespeichert.
Umsatzsteuersatz (USt)	Nein	Prozentwert, zum Beispiel 19. Validiert gegen Ihre aktiven Umsatzsteuersatz-Optionen.
Kostenstelle	Nein	Validiert gegen Ihre aktiven Kostenstellen-Optionen (ohne Berücksichtigung der Groß-/Kleinschreibung).
Sachkonto-Zuordnung	Nein	Kontocode des Hauptbuchs, validiert gegen Ihre aktiven Sachkonto-Zuordnungs-Optionen.
Positionstyp	Nein	Kategorie der Position, zum Beispiel fuel, washing, toll, maintenance_repair oder other.
Kraftstoffart	Nein	Verweist auf den Kraftstoffart-Katalog; relevant, wenn der Positionstyp fuel ist.
Sortierreihenfolge	Nein	Steuert die Zeilenreihenfolge. Wird sie weggelassen, werden Zeilen in der Reihenfolge nummeriert, in der Sie sie eingeben.

Die Grenze von 20 Positionen

Ein Beleg kann höchstens 20 Positionen enthalten. Das Senden von mehr wird mit BELEG_LINE_ITEM_LIMIT_EXCEEDED ("Maximum of 20 line items reached") abgelehnt, und nichts wird gespeichert. In der Benutzeroberfläche ist die Hinzufügen-Aktion deaktiviert, sobald Sie 20 Zeilen erreichen.

Welche Validierung Sie erwarten sollten

Eine leere Beschreibung wird abgelehnt: "Line item {n} description is required".
Eine Menge von null oder weniger wird abgelehnt: "Quantity must be greater than zero".
Ein negativer Einzelpreis wird abgelehnt: der Einzelpreis muss null oder größer sein.
Ein Umsatzsteuersatz, eine Kostenstelle oder eine Sachkonto-Zuordnung, die keine aktive Referenzoption ist, wird mit FINANCIAL_REFERENCE_NOT_ACTIVE abgelehnt.

Wenn Sie einen Beleg aktualisieren (statt einen zu erstellen), ist mindestens eine Position erforderlich — eine Aktualisierung mit null Positionen wird abgelehnt.

Tipp: Zeilen werden beim Speichern automatisch nach Sortierreihenfolge von 1 bis n neu nummeriert, sodass Sie die Nummerierung nicht selbst lückenlos halten müssen. Ordnen Sie Zeilen um, und die Plattform sequenziert sie für Sie neu.

Was beim Speichern passiert

Für jede Position berechnet die Plattform den Netto-, Umsatzsteuer- und Bruttobetrag und summiert sie anschließend zu den Kopfsummen des Belegs. Sie wertet die anwendbaren Regeln neu aus und zeichnet Prüfereignisse für die Positionsänderung und die Neuberechnung der Summen auf, alles innerhalb einer einzigen Transaktion.