public class DatevExportAdapter extends Object implements org.imixs.workflow.SignalAdapter
Der DATEVExportAdapter fasst die Funktion der CSV und XML Schnittstelle in einem Prozesschritt zusammen und überträgt die Daten auf einen FTP Server.
*************************************************************************** HINTERGRUND FÜR DATEV Modul "Belege Online" ***************************************************************************
Die vom Workflowsystem so generierte ZIP Datei kann anschließend über das DATEV Modul "Unternehmen Online" importiert werden.
Der DATEV Import über "Unternehmen Online" bietet dem Anwender keine oder unzureichende Möglichkeiten zu überpüfen, ob alle Datensätze importiert wurden bzw. ob beim Import einzelner Datensätze ein Fehler auftrat. Um den Prozess zu verbessern und gleichzeitig zu vereinfachen, sollten künftig die Buchungssätze direkt mit dem DATEV Modul "Belege Online" importiert werden. Der Umweg über das Modul "Unternehmen Online" soll vermieden werden und dadurch der Improt beschleunigt werden.
Eine wesentliche Funktion dieses neuen DATEV Imports besteht darin, dass DATEV ein zuvor definiertes Import Verzeichnis überwachen kann und den Import automatisch anstößt. Dies hilft den Ablauf innerhalb der Steuerkanzlei zu beschleunigen.
Damit das neue Verfahren genutzt werden kann sind folgende Änderungen notwendig:
Die bisherige XML Datei document.xml wird um zusätzliche Attribute ergänzt, welche einen Import über "Unternehmen Online" ermöglichen Es wird ein neues ZIP Format festgelegt in dem nur noch die Belege und die Document.xml Datei zusammengefasst werden Der Export des Buchunsstapel wird von XML auf CSV zurückgestellt. Die CSV Datei wird mit einer neuen Information GUID für das Belegabbild ergänzt. Die DATEV Export Files sollen nicht mehr in die Aufgabe im Workflow angehängt werden (bisheriger Workflow) sondern künftig direkt auf einem FTP Server abgelegt werden. Dieser FTP Server wird von der KRIEGER GmbH bereitgestellt.
1.) Anpassung der Document.xml
Für das neue Exportformat muss die bisherige document.xml datei erweitert und angepasst werden. Es wird die sogenannte GUID ergänzt. Diese ID kann von DATEV dazu verwendet werden, Buchungssätze, welche aus einer CSV Datei importiert werden, einem Beleg zuzuordnen, welcher in der Document.xml Datei beschreiben ist. Die generierte GUID ist eindeutig und basiert auf dem Format der in Imixs verwenden Document UniqueID (UID).
Des weiteren werden die Attribute 'processID' und ''type' mit statischen Werten ergänzt. Die processID bestimmt, wie der Beleg verarbeitet werden soll.
„1“ steht für „zu buchen“ (damit wird der Beleg als noch zu buchender Beleg in Kanzlei Rechnungswesen angezeigt) „2“ steht für „festzuschreiben“ (der Beleg wird von DATEV damit sofort nach dem Import festgeschrieben).
Für die ProzessID wird der Wert „2“ festgeschrieben, da der Beleg nicht mehr verändert werden soll, sobald er in Belege Online imprtiert wurde.
Der document type bestimmt die Art des Dokuments.
„1“ steht für Eingangsrechnung „2“ steht für Ausgangsrechnung.
Der Typ wird auf "1" gesetzt.
Das zusätzlch optionale Feld 'keywords' wird mit dem Inhalt des Feldes "_subject' aus dem Workflow belegt.
2.) Zusammenfassung der Belege in einer ZIP Datei
Abweichend zum bisherigen Verfahren werden die Belege zusammen mit der Document.xml Datei in einer ZIP Datei zusammengefasst. Die XML Buchunsbelege werden hierbei nicht erzeugt. Das bestehende Exportverfahren wird an dieser Stelle angepasst.
3.) Generierung der CSV Datei
Anstelle der beim bisherigen Verfahren erzeugten einzelnen Buchunsdateien im XML Format wird das bereits implementierte CSV Format verwendet, um den Buchungsstapel zu generieren.
Die GUID aus der zuvor generierten Document.xml Datei muss dabei zusätzlich in das Feld „Beleglink“ in der CSV eingetragen werden (BEDI „GUID“). Die beiden Exportverfahren werden dazu in einem Prozessschritt gekoppelt.
4.) Export der CSV Datei und ZIP Datei an einen FTP Server
Die generierte ZIP Datei mit den Belegdaten sowie die CSV Datei mit dem Buchunsstapel muss auf einen FTP Server übertragen werden. Für diesen Export muss die Konfiguration erweitert werden, so dass die Verbindungsdaten zu einem FTP Server mit UserID/Passwort sowie entsprechende Zielordner angeben werden können.
Der DATEV Scheduler wird angepasst, so dass künftig die ZIP Datei und die CSV Datei in einer Transaktion generiert und in getrennnte Verzeichnisse auf dem FTP Server übertragen werden. Die beiden Verzeichnisse sind konfigurierbar.
Das Ergebnis des Export Prozesses wird dabei weiterhin in einer Aufgabe innerhalb des Workflows protokolliert und archiviert. Die Dateien selbst werden dabei nicht mehr an die Aufgabe angehangen.
Änderung: Die Gruppierung der Daten erfolgt nun nach Buchungsperiode (Jahr/Monat)
DatevSchedulerXML| Modifier and Type | Field and Description |
|---|---|
static String |
DATEV_CONFIGURATION |
static String |
DATEV_EXPORT_ERROR |
static int |
EVENT_INVOICE_COMPLETED |
| Constructor and Description |
|---|
DatevExportAdapter() |
| Modifier and Type | Method and Description |
|---|---|
org.imixs.workflow.ItemCollection |
execute(org.imixs.workflow.ItemCollection datevExport,
org.imixs.workflow.ItemCollection event)
This method finds or create the Zahlungsavis and adds a reference
($workitemref) to the current invoice.
|
public static final String DATEV_EXPORT_ERROR
public static final String DATEV_CONFIGURATION
public static final int EVENT_INVOICE_COMPLETED
public org.imixs.workflow.ItemCollection execute(org.imixs.workflow.ItemCollection datevExport,
org.imixs.workflow.ItemCollection event)
throws org.imixs.workflow.exceptions.AdapterException,
org.imixs.workflow.exceptions.PluginException
execute in interface org.imixs.workflow.Adapterorg.imixs.workflow.exceptions.PluginExceptionorg.imixs.workflow.exceptions.AdapterExceptionCopyright © 2022 Imixs Software Solutions GmbH. All rights reserved.