DATEV XML-Schnittstelle online

Interne ID: agorum.datev.xml.online

Mit diesem Knoten erzeugen Sie eine ZIP-Datei für die DATEV XML-Schnittstelle online, die Rechnungen und XMLs enthält. Sie können über das Mapping steuern, ob Sie Eingangsrechnungen (accountsPayableLedger), Ausgangsrechnungen (accountsReceivableLedger) oder Kassendaten (cashLedger) exportieren möchten.

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
• lädt es die angegebenen Metadaten für die in der Eingangsvariable hinterlegten Objekte gemäß dem Filter
• transformiert die Objekte mit dem jeweiligen Mapping

Aus den transformierten Ergebnissen erzeugt das System die jeweilige XML-Datei für die Rechnung und speichert die XML-Datei zusammen mit der Rechnung in einer ZIP-Datei. Diese ZIP-Datei legt das System unter dem zuvor angegebenen Pfad ab und stellt sie in der Ausgangsvariable zur Verfügung. Optional ist eine Verlinkung dieser Datei in einen zusätzlichen Ordnerpfad möglich.

Suchfilter

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

Endpoints

Parameter

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

Eingangsvariable

Die nachfolgenden Beispiele gelten ebenfalls für 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'

Zu ladende Metadaten der Rechnung

Im Editor

Im Editor geben Sie einen String für das Filtern an, wenn ein Array mitgegeben wird. Bei Angabe eines Strings muss der Name vollständig sein.

#{/^name_/}
DocFormType

Als Expression

Wenn Sie diesen Parameter als Expression angeben, verwenden Sie diese Schreibweise:

/^ac_/

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, können 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'

Anzahl der in einem Paket zu bündelnden Rechnungen

Im Editor

Im Editor tragen Sie die gewünschte Anzahl an zu bündelnden Rechnungen ein. Wenn Sie nichts angeben, bündelt das System im Standard 5 Rechnungen in eine ZIP-Datei.

5

Als Expression

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

token.variables.chunkSize

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, Sie können die Variable etwa im Knoten Skript 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:lieferanten test_lieferantennummer:(${test_lieferantennummer})

In diesem Beispiel wurde die Suche aktiviert. Das System sucht nach allen Objekten, die den identifier lieferanten 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:

Metadatum identifier im 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 boolesche Wert hinterlegt ist.

token.variables.failSilent
true