Bruttobetrag für Positionen berechnen

Interne ID: agorum.accounting.items.gross

Mit diesem Knoten berechnen Sie den Bruttobetrag auf Positionsebene und können diesen optional mit dem übergebenen Gesamt-Bruttobetrag gegenprüfen.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten im Workflow, prüft es die gesetzten Parameter. Anschließend berechnet es anhand der übergebenen Parameter den gesamten Bruttobetrag, basierend auf den Positionsdaten. Dazu ist es notwendig, dass jede Position einen Nettobetrag und einen Mehrwertsteuersatz enthält. Rundungsfehler addiert das System auf die Position mit der größten Bruttosumme, sodass die Summe der einzelnen Bruttobeträge der Positionen dem Gesamt-Bruttobetrag der Rechnung entspricht. Falls Sie dem Knoten einen Gesamt-Bruttobetrag übergeben haben und der errechnete Betrag nicht mit diesem übereinstimmt, meldet das System einen Fehler.

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Eingangsvariable	Definiert die Variable, die die Rechnungsdaten enthält. Wenn Sie die Variable nicht angeben, verwendet das System automatisch die Anhänge des Workflows aus der internen Variable sys_acw_attachments Der Aufbau einer Eingangsvariable ist identisch zum Aufbau einer Ergebnisvariable.	Eingangsvariable
Metadatum des globalen Steuersatzes (optional)	Definiert die Variable, die den globalen Steuersatz der Rechnung enthält. Ist der Steuersatz auf Positionsebene nicht definiert, verwendet das System den globalen Steuersatz, falls angegeben.	Metadatum des globalen Steuersatzes
Metadatum des Brutto-Gesamtbetrags (optional)	Definiert die Variable, in der der Brutto-Gesamtbetrag enthalten ist. Wenn Sie die Variable nicht angeben, prüft das System automatisch die errechnete Bruttosumme gegen die hier übergebene Summe gegen. Stimmen diese Summen nicht überein, meldet das System einen Fehler.	Metadatum des Brutto-Gesamtbetrags
Metadatum mit Positionen	Definiert, wie das Metadatum lautet, in dem die Rechnungspositionen gespeichert sind. Diese Angabe benötigt der Knoten für das Zusammenführen der positionsbezogenen Daten.	Metadatum mit Positionen
Metadatum für Position: Netto-Gesamtpreis	Definiert die Variable, die den gesamten Nettobetrag der Rechnungsposition enthält. Der Variablenname muss ein Element der Positionsvariable sein.	Metadatum für Position: Netto-Gesamtpreis
Metadatum für Position: Brutto-Gesamtpreis	Definiert die Variable, die den Gesamt-Bruttobetrag der Rechnungsposition enthält, und in die das System das errechnete Ergebnis speichert. Der Variablenname muss ein Element der Positionsvariable sein.	Metadatum für Position: Brutto-Gesamtpreis
Metadatum für Position: Steuersatz	Definiert die Variable, die den Steuersatz der Rechnungsposition enthält. Der Variablenname muss ein Element der Positionsvariable sein. Wenn Sie die Variable nicht angeben oder sie keinen Wert enthält, verwendet das System automatisch den Gesamtsteuersatz der Rechnung, falls vorhanden.	Metadatum für Position: Steuersatz
Ergebnisvariable	Definiert die Variable, in der das System das Ergebnis der Rechnung speichert. Wenn Sie die Variable nicht angeben, verwendet das System automatisch diejenige Variable als Ergebnisvariable, die Sie als Eingangsvariable angegeben haben.	–

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.

Eingangsvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ergebnisvariable.

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

inputVariable

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfInputVariable'

Metadatum des globalen Steuersatzes

Im Editor

Im Editor tragen Sie den Namen der Variablen ein, die den globalen Steuersatz der Rechnung enthält.

total_tax_rate

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der der Name des globalen Steuersatzes der Rechnung hinterlegt ist.

token.variables.totalTaxRateName
total_tax_rate

Metadatum des Brutto-Gesamtbetrags

Im Editor

Im Editor tragen Sie den Namen der Variable ein, die den Brutto-Gesamtbetrag der Rechnung enthält.

total_gross_amount

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der der Name des Brutto-Gesamtbetrags der Rechnung hinterlegt ist.

token.variables.totalGrossAmountName
total_gross_amount

Metadatum mit Positionen

Im Editor

Im Editor tragen Sie das Metadatum ein, das die Positionen enthält.

agorum_accounting_document_item_list

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der das Metadatum mit den Positionen hinterlegt ist.

token.variables.positionVariable
'agorum_accounting_document_item_list'

Metadatum für Position: Netto-Gesamtpreis

Im Editor

Im Editor tragen Sie die Variable ein, die den Nettobetrag der Rechnungsposition enthält.

net_amount

Die Variable muss ein Element der Positionsvariable sein, d. h. sie muss sich innerhalb der items befinden, wie folgendes Beispiel verdeutlicht:

input_variable: {
    total_tax_rate: 19.0,
    total_gross_amount: 180.6,
    items: [
      {
        net_amount: 30,
        tax_rate: 19,
        gross_amount: 35.7
      },
      {
        net_amount: 70,
        tax_rate: 7,
        gross_amount: 74.9
      }
    ]
  }

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der der Name des Nettobetrags der Positionen hinterlegt ist.

token.variables.netAmountName
net_amount

Metadatum für Position: Brutto-Gesamtpreis

Im Editor

Im Editor tragen Sie die Variable ein, die den Bruttobetrag der Rechnungsposition enthält.

gross_amount

Die Variable muss ein Element der Positionsvariable sein, d. h. sie muss sich innerhalb der items befinden, wie folgendes Beispiel verdeutlicht:

input_variable: {
    total_tax_rate: 19.0,
    total_gross_amount: 180.6,
    items: [
      {
        net_amount: 30,
        tax_rate: 19,
        gross_amount: 35.7
      },
      {
        net_amount: 70,
        tax_rate: 7,
        gross_amount: 74.9
      }
    ]
  }

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der der Name des Bruttobetrags der Positionen hinterlegt ist.

token.variables.grossAmountName
gross_amount

Metadatum für Position: Steuersatz

Im Editor

Im Editor tragen Sie die Variable ein, die den Steuersatz der Rechnungsposition enthält.

tax_rate

Die Variable muss ein Element der Positionsvariable sein, d. h. sie muss sich innerhalb der items befinden, wie folgendes Beispiel verdeutlicht:

input_variable: {
    total_tax_rate: 19.0,
    total_gross_amount: 180.6,
    items: [
      {
        net_amount: 30,
        tax_rate: 19,
        gross_amount: 35.7
      },
      {
        net_amount: 70,
        tax_rate: 7,
        gross_amount: 74.9
      }
    ]
  }

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der der Name des Steuersatzes der Rechnungspositionen hinterlegt ist.

token.variables.taxRateName
tax_rate