DATEV-Buchungsstapel erstellen

Interne ID: agorum.datev.export.csv

Mit diesem Knoten erstellen Sie einen ASCII-Buchungsstapel für eine Rechnung.

Aussehen des Knotens

Voraussetzungen

Folgende Voraussetzungen müssen erfüllt sein, damit Sie diesen Knoten in der Toolbox des Workflow-Editors sehen können:

Die DATEV-Schnittstelle muss aktiviert sein.

Die DATEV-Schnittstelle aktivieren Sie über das agorum core support tool.

Folgende Einträge müssen Sie im agorum core support tool aktivieren:

DATEV CSV interface
DATEV CSV interface (with positions)
DATEV XML interface online
DATEV XML interface online (with positions)

Verhaltensweise

Erreicht das System den Knoten im Workflow, prüft es die gesetzten Parameter. Anschließend transformiert das System die in der Datenvariable hinterlegten Daten gemäß dem eingegebenen Mapping und erzeugt einen ASCII-Buchungsstapel. Dabei ist es möglich, ein Mapping für Rechnungen mit Positionsdaten und ein Mapping für Rechnungen ohne Positionsdaten anzugeben. Abhängig davon, ob die übergebenen Metadaten die Positionsvariable beinhalten, verwendet das System anschließend das jeweilige Mapping und erzeugt die CSV-Datei für die Übergabe an DATEV. Diese Datei gibt der Knoten in der Ausgangsvariable zur Weiterverarbeitung zurück.

Falls die Berater- und / oder die Mandantennummer oder das Kürzel für den Beleglink nicht im Mapping enthalten sind, können Sie diese direkt in den Parametern des Knotens hinterlegen.
Wenn weder der Parameter Beleglink noch das Mapping ein Beleglinkkürzel enthalten, erzeugt das System keinen Beleglink.
Falls Sie weder die Berater- und / oder noch die Mandantennummer übergeben (eines von beiden ist Pflicht), wirft das System einen Fehler.

Suchfilter

Für diesen Knoten existiert der Filter Fehlgeschlagene Exportdateien (siehe Übersicht vorhandener Knoten).

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, in der sich die zu verarbeitende Rechnung befinden. Das System verwendet nur das erste Objekt des Arrays. 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 und Ausgangsvariable.	Eingangsvariable
Datenvariable	Definiert die Variable, in der sich die Metadaten zur Rechnung aus dem Parameter Eingangsvariable befinden. Die angegebene Variable muss eine Datenstruktur mit Metadaten enthalten. Die Metadaten zur Rechnung müssen Sie zuvor bereits aufbereitet und zur Verfügung gestellt haben, etwa über den Knoten Metadaten laden.	–
Mapping für Dokumente ohne Positionen	Definiert die Mappingdefinition, die das System dazu verwendet, um die Inhalte des Buchungsstapels zu erzeugen. Das Ziel-Mapping muss zwingend DATEV ASCII Buchungsstapel lauten, damit das System die Daten korrekt transformieren kann. Für das Definieren von Mappings siehe metadata-collection.yml definieren.	Mapping für Dokumente ohne Positionen
Mapping für Dokumente mit Positionen		Mapping für Dokumente mit Positionen
Metadatum mit Positionen	Definiert, wie das Metadatum lautet, in dem die Buchungspositionen gespeichert sind. Diese Angabe benötigt der Knoten für das Zusammenführen der positionsbezogenen Daten und die Unterscheidung, welches Mapping der Knoten verwenden soll. Falls das Metadatum in der Datenvariable enthalten ist, verwendet das System das positionsbezogene Mapping, ansonsten das Mapping ohne Positionen.	Metadatum mit Positionen
Beraternummer	Definiert die DATEV-Beraternummer. Diese Angabe finden Sie später in der CSV-Datei in der 1. Headerzeile (siehe DATEV-Dokumentation). Die DATEV-Beraternummer können Sie entweder hier im Parameter oder innerhalb der Mappingdefinition angeben. Wenn Sie im Mapping eine Beraternummer angeben, ignoriert das System die hier im Parameter angegebene Beraternummer.	Beraternummer
Mandantennummer	Definiert die DATEV-Mandantennummer. Diese Angabe finden Sie später in der CSV-Datei in der 1. Headerzeile (siehe DATEV-Dokumentation). Die DATEV-Mandantennummer können Sie entweder hier im Parameter oder innerhalb der Mappingdefinition angeben. Falls Sie die DATEV-Mandantennummer im Mapping angeben, ignoriert das System die im Parameter angegebene Mandantennummer.	Mandantennummer
Beleglink	Definiert das DATEV-Beleglinkkürzel an. Diese Angabe finden Sie später innerhalb der einzelnen Einträge des Buchungsstapels (siehe DATEV-Dokumentation). Das DATEV-Beleglinkkürzel können Sie entweder hier im Parameter oder innerhalb der Mappingdefinition angeben. Falls Sie das DATEV-Beleglinkkürzel im Mapping angeben, ignoriert das System das im Parameter angegebene DATEV-Beleglinkkürzel. Die Eingangsvariable muss zwingend die Rechnung enthalten, für die das System den Beleglink erzeugen soll, da das System die UUID des in der Eingangsvariable liegenden Objekts verwendet.	Beleglink
Buchungsperiode	Definiert die Buchungsperiode. Diese Angabe finden Sie später in der CSV-Datei in der 1. Headerzeile (siehe DATEV-Dokumentation). Im Standard verwendet das System eine monatliche Buchungsperiode.	Buchungsperiode
Fehlerhafte Rechnungen überspringen	Aktiviert Schreibt Fehler in eine Log-Datei. Die Log-Datei befindet sich unter: /agorum/roi/workspace/agorum.datev/log-files Die fehlgeschlagenen Dateien können Sie über die beiden Filter Zum Sammeln markierte Dokumente und Fehlgeschlagene Exportdateien im agorum core information center einsehen. Dabei hängt das System die abgelegte Log-Datei zusätzlich an die betroffenen Dokumente an. Deaktiviert Wirft Fehler direkt aus.	Fehlerhafte Rechnungen überspringen
Ausgangsvariable für die erstellte CSV-Datei	Definiert die Variable, in der sich die generierte CSV-Datei befindet.	–

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

Eingangsvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Datenvariable und eine Ausgangsvariable.

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'

Mapping für Dokumente ohne Positionen

Im Editor

Im Editor wählen Sie das gewünschte Mapping.

agorum.datev.csv.with.positions
agorum.datev.csv.without.positions

Über öffnen Sie den Mapping -Editor und können dort das Mapping bearbeiten und neue Mappings anlegen.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variablen an, in der das zu verwendende Mapping hinterlegt ist.

token.variables.mappingDefinition

Mapping für Dokumente mit Positionen

Im Editor

siehe Mapping für Dokumente ohne Positionen

Als Expression

siehe Mapping für Dokumente ohne Positionen

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 hinterlegt ist.

token.variables.positionVariable
'agorum_accounting_document_item_list'

Beraternummer

Im Editor

Im Editor geben Sie die DATEV-Beraternummer ein.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der die DATEV-Beraternummer enthalten ist.

token.variables.consultantNumber

Mandantennummer

Im Editor

Im Editor geben Sie die DATEV-Mandantennummer an.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der die DATEV-Mandantennummer enthalten ist

token.variables.consultantNumber

Beleglink

Im Editor

Im Editor geben Sie das DATEV-Beleglinkkürzel an.

Beleglink

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der das DATEV-Beleglinkkürzel enthalten ist.

token.variables.documentLink

Buchungsperiode

Im Editor

Im Editor wählen Sie die gewünschte Buchungsperiode.

monatlich

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der die Buchungsperiode hinterlegt ist.

Sie können diese Zahlenwerte übergeben:

Zahlenwert	Beschreibung
0	monatlich
1	wöchentlich
2	täglich

token.variables.bookingPeriod
0

Fehlerhafte Rechnungen überspringen

Im Editor

Im Editor wählen Sie die Funktion per Anhaken oder entfernen den Haken.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der der boolsche Wert hinterlegt ist.

token.variables.failSilent
true