DATEV-Buchungsstapel für mehrere Rechnungen erstellen

Interne ID: agorum.datev.export.csvs

Sie erstellen mit diesem Knoten einen ASCII-Buchungsstapel für mehrere Rechnungen. Dabei können Sie festlegen, ob das System die Rechnungen bündeln soll, d. h. nach Buchungsperiode und Wirtschaftsjahr, oder ob es für jede Rechnung einen einzelnen ASCII-Buchungsstapel erstellt.

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 prüft das System, ob es die Rechnungen bündeln soll. Je nach hinterlegter Option transformiert das System die in der Datenvariable hinterlegten Daten gemäß dem eingegebenen Mapping, erzeugt die CSV-Dateien und legt sie in dem angegebenen Pfad ab, optional mit Verlinkung in einen anderen Ordnerpfad.

Suchfilter

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

Endpoints

Parameter

/agorum/roi/workspace/agorum.datev/log-files

Datenvariable

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, die das zu verwendende Array enthält. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

document.data

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

UUID pro Dokument übergeben

[
  {
    uuid: 'ersteDokumentenUUID',
    agorum_accounting_document_number: 12345,
    ... weitere Metadaten des ersten Dokuments für das Mapping.

  },
  {
    uuid: 'zweiteDokumentenUUID',
    agorum_accounting_document_number: 14592,
    ... weitere Metadaten des zweiten Dokuments für das Mapping.
  }
]

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

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. 

12345

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. 

12345

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:

token.variables.bookingPeriod
0

Rechnungen bündeln

Im Editor

Im Editor aktivieren oder deaktivieren Sie diese Funktion, indem Sie diese anhaken oder den Haken entfernen. Im Standard ist diese Option deaktiviert.

Als Expression

Wenn Sie diesen Parameter als Expression übergeben, muss das Ergebnis einen Boolean-Wert (true = wahr oder false = nicht wahr) enthalten. Dabei können Sie sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden.

Basisordner (Ordner-ID oder Suche)

Ordner-ID

Angabe eines Basisordners als ID im Editor (Haken die obige Eingabe ist eine Suche nicht gesetzt):

/agorum/roi/Files/Lieferantenakten/${test_lieferantennummer}

In diesem Beispiel wurde eine feste ID / ein fester Ordner inklusive Workflow-Variable als Platzhalter angegeben (${test_lieferantennummer}). Die Variable muss zuvor existieren, etwa können Sie die Variable in einem Skript-Knoten erstellen und befüllen:

/*global sc, sca, token, instance, outlets, inlet, parameters */

token.variables.test_lieferantennummer = '123456';

token.leave('');

Der Ordner /Lieferantenakten/123456 muss ebenfalls zu diesem Zeitpunkt schon bestehen, er wird also durch diesen Knoten nicht angelegt.
 

Suche

Angabe eines Basisordners im Editor (Haken die obige Eingabe ist eine Suche gesetzt):

identifier:lieferantenakte test_lieferantennummer:(${test_lieferantennummer})

In diesem Beispiel wurde die Suche aktiviert. Das System sucht nach allen Objekten, die den identifier lieferantenakte gesetzt haben. Außerdem wird der Ordner test_lieferantennummer mit der Nummer aus der Variablen test_lieferantennummer gefüllt. Der identifier und test_lieferantennummer sind Metadaten auf einem Objekt.

Sie können des Weiteren beliebige agorum core smart search-Anfragen beim Basisordner angeben.

Pfad

Im Editor

Im Editor geben Sie den Pfad an.

Ordner1/Unterordner1

In diesem Beispiel legt das System die Ordner Ordner1/Unterordner unterhalb des Basisordners an oder sucht dort nach der angegebenen CSV-Datei.

Der vollständige Pfad lautet:

<Basisordner>/Ordner1/Unterordner1

Datum als Platzhalter verwenden

Sie können im Editor das aktuelle Datum als Platzhalter verwenden:

Ordner1/${date:yyyy/MM/dd}

In diesem Beispiel legt das System folgende Ordnerstruktur an (am Beispiel 17.09.2020)

Ordner1/2020/09/17

Workflow-Variable als Platzhalter verwenden

Sie können im Editor Workflow-Variablen als Platzhalter verwenden:

Ordner1/${nameDerVariable:f}

Wenn die Workflow-Variable nameDerVariable etwa den Inhalt Test: Ein Ordner enthält, legt das System diesen Ordner an:

Ordner1/Test_ Ein Ordner

Die Funktion :f ersetzt automatisch nicht erlaubte Pfad-Zeichen durch _. Für die Variablen-Ersetzung verwendet das System die Standardfunktion der JavaScript-Bibliothek common-templates.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, muss das Ergebnis den Pfad als String enthalten. Sie können dabei auch eine Berechnung durchführen.

'Ordner1/' + new Date().getFullYear()

Das Ergebnis dieser Expression lautet (im Jahr 2020):

Ordner1/2020

In diesem Beispiel legt das System die Ordner Ordner1/2020 unterhalb des Basisordners an oder sucht dort nach der angegebenen CSV-Datei.

Der vollständige Pfad lautet:

${Basisordner}/Ordner1/2020

Basisordner für zusätzliche Verlinkung der Ergebnis-Datei(en)

Im Editor

siehe Basisordner (Ordner-ID oder Suche)

Als Expression

siehe Basisordner (Ordner-ID oder Suche)

Pfad für die Verlinkung

Im Editor

siehe Pfad

Als Expression

siehe Pfad

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