E-Rechnung Konnektor

Der E-Rechnung Konnektor erweitert Syncler um die Möglichkeit, E-Rechnungsformate zu lesen und zu schreiben.
Die verfügbaren Formate sind erweiterbar und umfassen mindestens ZUGFeRD 2.3.3 Basic und EN16931.

E-Rechnungen können direkt aus einer XML-Datei oder indirekt über den Anhang einer PDF-Datei gelesen werden.
Es stehen verschiedene Quellen zur Verfügung: Dateien können aus einem lokalen Verzeichnis oder einem FTP-Server gelesen werden.
Zusätzlich kann über den Endpunkt SaveXML eine XML-Datei direkt per Syncler-API übergeben werden.
Der Konnektor kann zudem mit anderen kombiniert werden, z. B. um Rechnungsdaten aus einer E-Mail zu entnehmen.
Hierfür wird ein Ablauf konfiguriert, der den Dateiinhalt als Filter an den Rechnungssync übergibt.


Funktionen

Der Konnektor kann sowohl das XML-Dokument als auch einen PDF-Seriendruck mit eingebetteter XML erzeugen und in verschiedenen Zielen speichern.

  • Wird das Schreiben über einen Universal-Sync ausgeführt, wird der PDF-Seriendruck auf Basis der XML-Daten (Zieldaten im Sync) erstellt.
  • Mit dem speziellen Sync E-Rechnung mit geschachtelte Daten kann auch der Quelldatensatz direkt für den Seriendruck verwendet werden.
    So können im Seriendruck auch transformierte Felder verwendet werden.

Einstellungen

Verzeichnisse

Einstellung Beschreibung
Lokales Quellverzeichnis Wird für das Lesen von Dateien verwendet; nur bei On-Premises-Installationen.
Lokales Zielverzeichnis Speicherort für erzeugte Dateien; nur bei On-Premises.
Lokales Archivverzeichnis Ablageort für verarbeitete Dateien; nur bei On-Premises.
FTP Verzeichnis für Schriftarten Optionales Verzeichnis für zusätzliche Schriftarten beim PDF-Seriendruck.
FTP Quellverzeichnis Verzeichnis, aus dem Dateien gelesen werden.
FTP Zielverzeichnis Verzeichnis, in das erzeugte Dateien geschrieben werden.
FTP Archivverzeichnis Verzeichnis, in dem verarbeitete Dateien archiviert werden.
Datum an Archivdateinamen anhängen Fügt dem Archivdateinamen ein Zeitstempel hinzu.
Schriftarten löschen Löscht temporär gespeicherte Schriftarten nach dem Seriendruck (bei FTP-Nutzung).

FTP

Hier werden die FTP-Zugangsdaten definiert, über die der Datenaustausch mit entfernten Systemen erfolgt.

Experteneinstellungen

Einstellung Beschreibung
Erweitertes Protokoll Erstellt ein detailliertes Protokoll beim Seriendruck, um Feldersetzungen und Verarbeitungsdetails nachzuvollziehen.

Bei jedem Lese- oder Schreibvorgang kann über den Sync ein zusätzliches Unterverzeichnis angegeben werden.

  • Für das Lesen wird dies über einen Filterparameter konfiguriert.
  • Für das Schreiben wird der Wert in das Feld Ausgabe (Sync-Einstellung oder Schemafeld output) eingetragen.

Schemaobjekte

Die Schemaobjekte des E-Rechnung Konnektors basieren auf XML-Schemadateien, die im Syncler-System für die einzelnen Formate hinterlegt sind.
Der Name des Formats entspricht dabei dem Schemanamen.

Zusätzlich werden automatisch Auswahllisten aus den codedb-Dateien der Formate angelegt.

Jedes Schemaobjekt beinhaltet drei zusätzliche Objektgruppen:

1. MailMergeFile

Enthält alle Steuerparameter für den PDF-Seriendruck.
Wenn bei einem Universal-Sync keine Werte in diesem Abschnitt zugeordnet werden, wird ausschließlich eine XML-Datei erzeugt.
Beim E-Rechnungssync wird dieses Objekt automatisch aus den Sync-Einstellungen generiert.
Wenn MailMergeFile Werte enthält, wird ein PDF-Seriendruck erzeugt und die XML-Datei als Anhang eingebettet. Ohne wird ausschließlich XML erzeugt.

2. Result

Enthält das Ergebnis des Schreibvorgangs entsprechend den Ausgabe-Einstellungen.
Diese sind identisch zu denen des Seriendruck-Konnektors.

3. PdfMetaData

Enthält Felder für Metadaten des PDF-Dokuments. z.B. Titel, Autor, Betreff

Mögliche Ausgabeoptionen:

Ziel Beschreibung
Lokal (On-Premises) Speichert Dateien im lokalen Zielverzeichnis.
FTP Lädt Dateien auf den konfigurierten FTP-Server hoch.
Syncler-Datenbank Speichert Dateien direkt in der Datenbank.
Base64-Antwort Gibt das erzeugte Dokument als Base64-kodierten Inhalt zurück.

Kombination mit anderen Konnektoren

Der E-Rechnung Konnektor lässt sich flexibel mit anderen Konnektoren kombinieren, um automatisierte Rechnungsprozesse zu gestalten.
Beispiele:

  • Kombination mit dem Mail-Konnektor, um eingehende E-Rechnungen automatisch zu verarbeiten.
  • Integration mit dem Datei- oder FTP-Konnektor, um Rechnungen periodisch einzulesen.
  • Nutzung des Universal-Syncs, um transformierte Daten direkt in standardkonforme XML-Formate zu überführen.

Zusammenfassung

Bereich Beschreibung
Formate ZUGFeRD 2.3.3 Basic, EN16931 (erweiterbar)
Quellen XML-Datei, PDF mit eingebetteter XML, Verzeichnis, FTP, Syncler-API
Funktionen Lesen, Schreiben, Seriendruck mit eingebetteter XML
Ausgabeziele Lokal, FTP, Syncler-Datenbank, Base64
Integration Kombinierbar mit E-Mail-, Datei-, FTP- oder Universal-Sync-Konnektoren