Kürzung: Parameter definieren

Interne ID: agorum.accounting.cut.prepare

Mit diesem Knoten definieren Sie die Parameter, die für die Durchführung von Kürzungen auf Rechnungen notwendig sind.

Das Kürzen der Dokumente basiert dabei auf den durch agorum core docform ausgelesenen Werten der Rechnung. Sie können Positionen sowie globale Rechnungsbeträge kürzen. Die Kürzungen an sich nimmt ein Benutzer über eine Bedienoberfläche und entsprechende Felder vor, in der er diese zu kürzenden Werte einträgt. Eine solche Bedienoberfläche stellen Sie etwa über die Knoten ui oder metadata collection form dar.

Die Kürzungen werden optisch auf der Rechnung dargestellt, in dem an den jeweiligen Positionen die betroffenen Werte durchgestrichen und die jeweils gekürzten Werte darüber geschrieben werden. Die Darstellung der gestrichenen Werte können Sie bei Bedarf mithilfe von Parametern im Knoten anpassen.

Darstellung gekürzter Werte auf der Rechnung

Zudem werden in Abhängigkeit der jeweiligen Angaben die Beziehungen zueinander automatisch berechnet.

Beispiel

Sie kürzen den Netto-Einzelbetrag einer Position. Daraus errechnet sich automatisch sowohl der Gesamtnettobetrag der Position sowie der Bruttobetrag der Position als auch die Netto- und Bruttobeträge der Gesamtrechnung.

Bei der Berechnung der Kürzung werden jeweils nur die definierten Werte betrachtet. Gibt es etwa auf Positionsebene keinen Bruttobetrag, wird dieser auch nicht neu berechnet. Auch muss der Parameter für den Steuersatz angegeben sein, um den Bruttobetrag für die Position und die Gesamtsummen neu zu berechnen.

Die optische Streichung auf dem Dokument selbst kann nur erfolgen, wenn die Daten zuvor vollständig durch agorum core docform erfasst worden sind. Manuell erfasste Werte kann das System optisch nicht gestrichen darstellen, da dem System nicht bekannt ist, wo sich diese Werte auf dem Dokument befinden. Findet das System einen zu streichenden Wert auf dem Dokument nicht, ignoriert es diesen Wert.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten, prüft es die hinterlegten Parameter. Es nimmt die Originalwerte der Rechnung in Form von Variablen entgegen. Die gekürzten Beträge sowie die neuen berechneten Werte speichert das System in jeweils separate Variablen ab, die Sie als Parameter im Knoten angeben.

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
Datenvariable	Definiert, wo das Ergebnis des Knotens gespeichert werden soll. Dabei wird ein Datenobjekt erzeugt, das von den anderen Kürzen-Knoten verwendet wird. Die Angabe einer Datenvariable ist Pflicht. Hinweis: Unterhalb dieser Variable erstellt das System nach dem Anwenden des Kürzens (apply) eine Untervariable mit dem Namen _origin. Diese enthält alle Informationen des Kürzens, u. a. auch den Originalwert, bevor gekürzt wurde, damit Sie auf diese Art ggf. nachträglich nochmals darauf zugreifen können.	Datenvariable
Variablen Gesamtbetrag Netto	Definiert die Variablen für den gesamten Nettobetrag der Rechnung. Folgende Variablen müssen Sie angeben: Variable, die den Originalwert enthält. Variable, die den gekürzten Wert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird.	–
Variable globaler Steuersatz	Definiert die Variable für den globalen Steuersatz der Rechnung. Diese Variable wird nur für die Berechnung des Steuerbetrags verwendet, wenn keine unterschiedlichen Steuersätze definiert sind. Verwenden Sie ansonsten den Parameter Variable für jeweilige Steuersätze.	–
Variablen für globalen Steuerbetrag	Definiert die Variablen für den globalen Steuerbetrag. Folgende Variablen können Sie angeben: Variable, die den Originalwert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird. Weitere Informationen: Diese Variablen werden nur für die Berechnung des Steuerbetrags verwendet, wenn keine unterschiedlichen Steuersätze definiert sind. Verwenden Sie ansonsten den Parameter Variable für jeweilige Steuersätze.	–
Variablen Gesamtbetrag Brutto	Definiert die Variablen für den gesamten Bruttobetrag der Rechnung. Folgende Variablen müssen Sie angeben: Variable, die den Originalwert enthält. Variable, die den gekürzten Wert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird.	–
Variable, die die Positionen beinhaltet	Definiert die Variable, die die Rechnungspositionen enthält.	–
Variable für Position:Menge	Definiert die Variablen für die Mengenangabe der Rechnungspositionen. Folgende Variablen müssen Sie angeben: Variable, die den Originalwert enthält. Variable, die den gekürzten Wert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird. Die Variablennamen müssen jeweils ein Element der Positionsvariable sein.	–
Variablen für Position:Einzelpreis Netto	Definiert die Variablen für den einzelnen Nettobetrag der Rechnungspositionen. Folgende Variablen müssen Sie angeben: Variable, die den Originalwert enthält. Variable, die den gekürzten Wert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird. Die Variablennamen müssen jeweils ein Element der Positionsvariable sein.	–
Variable für Position:Gesamtpreis Netto	Definiert die Variablen für den gesamten Nettobetrag der Rechnungspositionen. Folgende Variablen müssen Sie angeben: Variable, die den Originalwert enthält. Variable, die den gekürzten Wert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird. Die Variablennamen müssen jeweils ein Element der Positionsvariable sein.	–
Variablen für Position:Steuerbetrag	Definiert die Variablen für den Steuerbetrag der Rechnungspositionen. Folgende Variablen müssen Sie angeben: Variable, die den Originalwert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird. Die Variablennamen müssen jeweils ein Element der Positionsvariable sein.	–
Variable für Position:Steuersatz	Definiert die Variable für den Steuersatz der Rechnungspositionen. Der Variablenname muss ein Element der Positionsvariable sein.	–
Variable für jeweilige Steuersätze	Definiert für einzelne Steuersätze der Rechnung die jeweilige Variable. Damit ordnen Sie die jeweiligen Steuersätze den jeweiligen ausgewiesenen Nettobeträgen der Rechnung zu. Über fügen Sie einzelne Steuersätze hinzu. Folgende Variablen können Sie angeben: Variable, die den Originalwert enthält. Variable, in die das gekürzte Ergebnis gespeichert wird.	–
Kommentare	Setzt einen Kommentar oder mehrere Kommentare auf das Dokument.	Kommentare
Gekürztes Dokument erstellen	Aktiviert (Standard) Das System erzeugt ein Dokument, auf dem die Kürzungen dargestellt werden. Deaktiviert Das System erzeugt kein Dokument, auf dem die Kürzungen dargestellt werden.	–
Originaldokument überschreiben	Aktiviert Das System überschreibt beim Erstellen des gekürzten Dokuments das vorhandene Originaldokument. Der Parameter Gekürztes Dokument erstellen muss dazu aktiviert sein. Das System erzeugt dabei eine neue Version des Dokuments, sodass das Originaldokument erhalten bleibt. Deaktiviert (Standard) Das System erzeugt ein weiteres Dokument und hängt es dem Workflow als Anhang an.	–
Name des neu erzeugten Dokuments	Definiert den Namen des neu erzeugten Dokuments, das die Kürzungen enthält. Sie können Platzhalter verwenden. Standard ${baseName}.pdf Der Parameter Originaldokument überschreiben muss deaktiviert und der Parameter Gekürztes Dokument erstellen aktiviert sein.	–
Eingangsvariable	Definiert eine Eingangsvariable, die Objekte (Arrays) enthält. Alle Objekte werden mit diesem Knoten abgearbeitet. 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 Datenvariable. Hinweis: Das Kürzen funktioniert ausschließlich mit 1 Anhang. Sind 2 Anhänge vorhanden, geht das System davon aus, dass der erste Anhang das gekürzte Dokument und der zweite das Original-Dokument ist.	–
Ausgangsvariable	Definiert eine Ausgangsvariable als Array, die das Ergebnis des Knotens enthält, sobald das System den Knoten verarbeitet hat. Der Aufbau einer Ausgangsvariable ist identisch zum Aufbau einer Eingangsvariable oder Datenvariable.	–
Textgröße	Definiert die Größe des Textes in Pixel für den gekürzten Betrag. Standard 20 Pixel	–
Textfarbe	Definiert die Farbe für den Text des gekürzten Betrags. Standard #FF0000 (rot)	–
Farbe für Streichung	Definiert die Farbe für die Streichung des ursprünglichen Betrags. Standard #FF0000 (rot)	–
Textausrichtung	Wahl der Ausrichtung des gekürzten Textes relativ zum bezogenen Wert auf dem Dokument. Standard Oben	–
Versatz horizontal	Definiert den Versatz des Textes relativ zum jeweiligen Wert auf dem Dokument. Die Angabe ist in % und bezieht sich auf die Gesamtbreite des Dokuments. Standard 0	–
Versatz vertikal	Definiert den Versatz des Textes relativ zum jeweiligen Wert auf dem Dokument. Die Angabe ist in % und bezieht sich auf die Gesamthöhe des Dokuments. Standard 0	–
Farbe des Hintergrunds (Text)	Definiert die Hintergrundfarbe des Textes für den gekürzten Betrag, um den Text vom normalen Dokumenttext abzuheben. Standard #FFFFFF (weiß)	–
Deckkraft des Hintergrunds	Definiert in %, wie durchsichtig der Hintergrund des Textes für den gekürzten Betrag sein soll. 0 bedeutet komplett durchsichtig, 100 nicht durchsichtig. Standard 75	–
Abstand des Hintergrunds zum Text	Definiert den Abstand des Hintergrunds zum Text für den gekürzten Betrag in Pixeln. Standard 5	-

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

Datenvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Eingangsvariable oder Ausgangsvariable.

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

Im Editor

Angabe einer Datenvariable im Editor:

dataVariable

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.nameOfDataVariable'

Kommentare

Pro Kommentar können Sie diese Werte angeben:

Wert	Beschreibung
Text	Definiert den anzuzeigenden Text im Kommentarfeld
X	Definiert die X-Koordinate in %.
Y	Definiert die Y-Koordinate in %.
Breite	Definiert die Breite in %.
Relativ zu	Definiert ein docform-Feld, auf dessen Seite das System den Kommentar angezeigt. Das System verwendet die Angabe von Seite, wenn es das Feld nicht findet.
Seite	Definiert die Seite, auf der das System den Kommentar angezeigt. Mögliche Werte first last
Ursprung	Definiert den Ursprung. Mögliche Werte oben links oben rechts unten links unten rechts Details siehe JavaScript-Bibliothek common/pdf: create() (Parameter origin).
Textgröße	Definiert die Textgröße in Pixel Standard 20
Farbe	Definiert die Farbe in Hexadezimal-Code. Standard rot: #FF0000
Deckkraft	Definiert die Deckkraft in %. Standard 75
Abstand	Definiert den Abstand zum Text in Pixel. Standard 5