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 |