Berechtigte Benutzer lösen den vollständigen Export jederzeit selbst in RIFA aus und erhalten das ZIP-Archiv per Download.
EU DATA ACT · EXPORTFORMAT 1.0.0
Datenportabilität.
Nachvollziehbar beschrieben.
Als RIFA-Kunde können Sie Ihre exportierbaren Daten und digitalen Vermögenswerte lokal weiterverwenden oder zu einem anderen Anbieter übertragen.
Den automatischen Export starten entsprechend berechtigte Benutzer nach der Anmeldung in RIFA unter „Datenexport (Data Act)“. Hierfür ist das Benutzerrecht „Datenexport“ erforderlich. Der Export wird als ZIP-Archiv bereitgestellt. Für den Export erhebt ESHO derzeit kein gesondertes Entgelt.
01 · UMFANG
Exportierbare Datenkategorien
Der automatische Export umfasst derzeit:
- Kunden einschließlich Adressen und Ansprechpartnern
- Angebote, Aufträge, Rechnungen, Gutschriften und Lieferscheine
- Verträge
- Bestellungen, Wareneingänge und Eingangsrechnungen
- Buchungen und Journalinformationen
- Materialstamm einschließlich Verkaufs- und Einkaufspreisen
- Lieferantenstamm einschließlich Ansprechpartnern
- Sachkonten und Grunddaten, etwa Länder, Einheiten, Zahlungsbedingungen, Gruppen und Lagerorte
- Serviceaufträge
- Dateianhänge im Rahmen der Größenregel sowie Metadaten archivierter externer Dokumente
- Zugehörige Identifikations-, Verknüpfungs-, Status- und Zeitinformationen, soweit sie durch die Nutzung von RIFA erzeugt wurden
Wird RIFA um weitere vom Kunden eingegebene oder durch seine Nutzung erzeugte Datenkategorien erweitert, werden diese in das Verzeichnis aufgenommen und exportierbar bereitgestellt. Bis zur Integration in den automatischen Export erfolgt die Bereitstellung auf Anfrage durch ESHO in einem strukturierten, gängigen und maschinenlesbaren Format.
02 · FORMAT
Formate und Datenstruktur
Die Daten werden innerhalb eines ZIP-Archivs bereitgestellt. Die einzelnen Datenkategorien liegen im JSON-Format vor:
ZeichenkodierungUTF-8 ohne BOM
StandardRFC 8259
SchemaJSON Schema Draft 2020-12
Datum und ZeitISO 8601 · UTC
Die Struktur ist hierarchisch; Kopf- und Positionsdaten bleiben zusammenhängend. Zahlen verwenden einen Dezimalpunkt. Buchungsdaten werden zusätzlich als DATEV-EXTF-Datei bereitgestellt – CSV, Windows-1252 und Semikolon als Trennzeichen –, sofern die DATEV-Stammdaten des Mandanten hinterlegt sind.
Eine manifest.json verzeichnet enthaltene Dateien, Datenkategorien und Datensatzzahlen. Eine README.html erläutert den Aufbau. Die maschinenlesbaren JSON-Schemata liegen im Verzeichnis schema/.
03 · DOKUMENTATION
Technischer Feldkatalog
Eine aktuelle, feldgenaue Beschreibung der exportierbaren Daten steht angemeldeten und entsprechend berechtigten Benutzern in RIFA unter „Datenexport (Data Act)“ zur Verfügung und bleibt auch während der vertraglichen Datenabrufphase erreichbar.
- Feldnamen, Datentypen und Bedeutung
- Pflicht- und optionale Felder
- Beziehungen und Referenzschlüssel
- Datums-, Zahlen- und Währungsformate
- Standards und Interoperabilitätsspezifikationen
- Versionsstand des Exportformats
ÖFFENTLICHES BEISPIELJSON-Schema für Verkaufsbelege
JSON öffnen ↗Illustratives Schema für Angebote, Aufträge, Rechnungen, Gutschriften und Lieferscheine. Der vollständige aktuelle Schemasatz liegt jedem Export bei.
04 · ABGRENZUNG
Nicht exportierte interne Daten
Nicht Bestandteil des Exports sind ausschließlich:
- Kennwort-Prüfwerte und Zwei-Faktor-Geheimnisse
- Private Verschlüsselungs- und Signaturschlüssel
- Interne Sicherheitskonfigurationen, deren Offenlegung die Sicherheit oder Integrität des Dienstes gefährden würde
- Interne Überwachungs- und Diagnoseprotokolle, soweit sie keine durch den Kunden erzeugten Geschäfts-, Bearbeitungs- oder Auditinformationen enthalten
- Ausschließlich interne Lizenzierungs- und Abrechnungsinformationen von ESHO
- Daten, Geschäftsgeheimnisse und geschützte Vermögenswerte von ESHO oder Dritten
Kundenspezifische Einstellungen, Bearbeitungshistorien und sonstige Metadaten werden nicht allein deshalb ausgeschlossen, weil sie technisch in System- oder Protokolldaten gespeichert sind. Die Ausschlüsse verhindern oder verzögern den Anbieterwechsel nicht. Daten anderer Kunden sind keine Datenkategorie Ihres Mandanten und werden durch die Mandantentrennung geschützt.
05 · ABLAUF
Export- und Wechselverfahren
Ein öffentlicher Programmierschnittstellen- oder Direktübertragungszugang wird derzeit nicht angeboten. Die Ausleitung erfolgt über die Oberfläche oder auf Anfrage durch ESHO.
Besteht kein aktiver RIFA-Zugang mehr, stellt ESHO den Export innerhalb der vertraglich vereinbarten Datenabrufphase auf Anfrage bereit.
Der Export umfasst den vollständigen aktuellen Datenbestand des Mandanten. Die DATEV-Datei umfasst den gesamten Buchungszeitraum.
Das Archiv wird in einem Vorgang erzeugt. Binärdaten von Anhängen werden bis insgesamt 100 MB eingebettet. Darüber hinausgehende Anhänge bleiben vollständig als Metadaten verzeichnet und werden auf Anfrage separat bereitgestellt.
Die aktuelle Dateiversion liegt in attachments/files/; vollständige Metadaten einschließlich Dateiname, Typ, Größe und Prüfsumme liegen in attachments/attachments.json. Inhalte des revisionssicheren Belegarchivs werden als Metadaten geführt und auf Anfrage bereitgestellt.
Unterstützung zum Export erhalten Sie unter support@esho.de.
06 · VERTRAG
Vertragliche Regelungen
Wechselrechte, Fristen, Dauer der Datenabrufphase, Löschung nach Ablauf sowie etwaige Wechselentgelte richten sich nach den RIFA-Vertragsbedingungen und AGB von ESHO. Diese Seite beschreibt das technische Verfahren und ersetzt die vertraglichen Regelungen nicht.
Die technische Beschreibung dokumentiert den aktuellen Exportstand. Gesetzliche Aufbewahrungspflichten und eine gegebenenfalls erforderliche revisionssichere Archivierung sind von der technischen Datenportabilität zu unterscheiden.
Fragen zum Datenexport?
Wir erläutern Exportumfang, Verfahren und die für Ihren Betrieb relevanten Formate.