← Zurück zur Startseite

Datenformate und Datenexport

Diese Seite ist das Online-Register der DokuVio UG (haftungsbeschränkt) nach Ziffer 3.2 des Annex zu unseren AGB (Regelungen zum Anbieterwechsel). Sie beschreibt, wie Sie Ihre Daten aus DokuVio exportieren können, in welchen Strukturen und Formaten die Daten vorliegen und welche Standards dabei verwendet werden.

Stand: 13.11.2026 · Exportformat Version 2

1) Überblick

DokuVio bietet zwei Exportwege:

  • Vollständiger Datenexport: alle Daten Ihres Kontos einschließlich der Originaldateien als ZIP-Archiv. Abrufbar im Dashboard unter „Datenexport“ durch den Administrator des Kontos, jederzeit während der Vertragslaufzeit und bis zu 30 Tage nach Vertragsende.
  • Steuerberater-Export: eine Belegübersicht als CSV-Datei mit den zugehörigen Originalbelegen, erstellt in der Desktop-Software während der Vertragslaufzeit. Bereits erstellte Steuerberater-Exporte sind auch im vollständigen Datenexport enthalten.

Im Tarif „Local“ liegen die Daten auf Ihrem eigenen Rechner; dort steht zusätzlich ein Backup-Archiv des gesamten Datenordners zur Verfügung (siehe Ziffer 7).

Für Datenexporte und für einen Anbieterwechsel berechnen wir keine Gebühren.

2) Vollständiger Datenexport (ZIP-Archiv)

Der Export wird als Datei DokuVio-Datenexport-JJJJ-MM-TT.zip heruntergeladen und hat folgenden Aufbau:

LIESMICH.txt                      Erklärung des Aufbaus, lesbar ohne DokuVio
backup.json                       alle strukturierten Daten (siehe Ziffer 3)
dokumente/                        Originaldateien der Dokumente und Belege
papierkorb/                       Originaldateien der Dokumente im Papierkorb
arbeitsprotokolle/                Sprachaufnahmen der Arbeitsberichte (M4A, siehe Ziffer 3)
vorschaubilder/                   Vorschaubilder zu Fotos
steuerberater-exporte/            erstellte Steuerberater-Exporte
mobile-uploads/                   noch nicht verarbeitete Uploads der Handy-App
anmerkungen/                      Anmerkungen zu Dokumenten (siehe Ziffer 3)
briefpapier/briefpapier.pdf       Briefpapier der Belegvorlage (falls vorhanden)
FEHLENDE_DATEIEN.txt              nur vorhanden, wenn einzelne Dateien nicht geladen werden konnten
  • Das Archiv entspricht dem ZIP-Format (PKWARE APPNOTE); die Dateien sind unkomprimiert gespeichert.
  • Dateinamen im Archiv sind in UTF-8 kodiert und für Windows, macOS und Linux bereinigt (nicht zulässige Zeichen werden durch _ ersetzt, höchstens 120 Zeichen). Bei gleichen Namen wird durchnummeriert, z. B. „Rechnung (2).pdf“.
  • Textdateien (LIESMICH.txt, FEHLENDE_DATEIEN.txt) sind UTF-8-kodiert.
  • Der direkte Download ist bis zu einer Größe von 2 GiB bzw. 60.000 Dateien möglich. Größere Exporte stellen wir auf Anfrage an info@dokuvio.de bereit.

3) Strukturierte Daten (backup.json)

Alle Daten außer den Dateien selbst stehen in der Datei backup.json im Format JSON (RFC 8259), kodiert in UTF-8.

Die oberste Ebene enthält:

  • version: Version des Exportformats (derzeit 2)
  • exportedAt: Zeitpunkt des Exports
  • organization: Stammdaten des Kontos (Firmenname, Tarif, Vertragsdaten, Rechnungsdaten)
  • counts: Anzahl der Einträge je Datenkategorie
  • data und tables: die eigentlichen Daten, gegliedert nach Kategorien
  • missingFiles: Liste der Dateien, die nicht geladen werden konnten

Datenkategorien

KategorieInhalt
data.documentsDokumente und Belege: Originalname, Dateityp, Größe, Art (Dokument/Foto), Dokumenttyp, Kunde, Belegdatum, Betrag, Rechnungsnummer, Fälligkeit, Zahlungsstatus, Richtung (Eingang/Ausgang), Schlagwörter, Zusammenfassung, erkannter Text, Ordner, Verweis auf die Datei im Archiv (zipPath, thumbnailZipPath)
data.workReportsArbeitsberichte (Arbeitsprotokoll per Sprache): Vorgang, Mitarbeiter, Zeitpunkt und Dauer der Aufnahme, Status, wer den Bericht zuletzt geändert hat (updatedByName; leer bei automatischer Löschung), Verweis auf das erstellte Protokoll (protocolDocumentId), die Sprachaufnahmen (audio, mit Beginn je Abschnitt in startedAt, Datei im Ordner arbeitsprotokolle/ über zipPath) und die Fotos (photos, Bezug über dokumentId auf data.documents). Sprachaufnahmen werden nach festen Fristen automatisch gelöscht; danach ist audio leer. Die Anzahl steht in counts.workReports.
data.trashedDocumentsDokumente und Belege, die im Papierkorb lagen: dieselben Angaben wie bei data.documents, zusätzlich das Löschdatum (deletedAt). Die Dateien liegen im Ordner papierkorb/ (zipPath, thumbnailZipPath), Anmerkungen im Ordner anmerkungen/ (annotationsZipPath). Die Anzahl steht in counts.trashedDocuments.
tables.annotationsAnmerkungen zu Dokumenten: Zeitpunkt der letzten Änderung und Benutzername des Bearbeiters; der Inhalt steht als JSON-Datei je Dokument im Ordner anmerkungen/, Bezug zum Dokument über docId, Verweis auf die Datei im Archiv (zipPath)
data.processesVorgänge: Name, Nummer, Status; customerId: zugeordneter Kunde, optional
data.processAssignmentsZuordnung von Dokumenten zu Vorgängen
data.tasksAufgaben: Titel, Beschreibung, Priorität, Status, Fälligkeit, Bezug zu Dokument, Vorgang oder E-Mail, Zuständigkeit
data.emailThreadsE-Mail-Verläufe: Betreff, Absender, Empfänger, Datum, Textinhalt, Namen der Anhänge, Bezug zu Vorgängen
data.approvals, data.activities, data.groups, data.merklisteFreigaben, Aktivitätsprotokoll, Gruppen, Merkliste
data.datevExports, data.datevDocStatuses, data.exportHistoryVerlauf der Steuerberater-Exporte und Exportstatus je Beleg
data.mobileUploadsUploads aus der Handy-App
tables.customersKunden: Kundennummer, Firma, Ansprechpartner, Anschrift, Steuernummer, USt-IdNr., Bankverbindung, Kontaktdaten, Zahlungsziel, weitere Kontakte
tables.appointments, tables.appointmentCategoriesTermine mit Datum, Uhrzeit, Kunde, Vorgang, Kategorie, Zuständigkeit
tables.timeEntries, tables.timeEntryRevisionsZeiterfassung (Arbeitszeit und Pausen, Beginn, Ende, Vorgang, abrechenbar, Stundensatz) sowie die Änderungshistorie. Abgerechnete Zeiten verweisen über billedInDocumentId auf die erstellte Rechnung oder, wenn sie vor dem Wechsel in die Cloud abgerechnet wurden, über billedInDokumentId auf das hochgeladene Rechnungsdokument (data.documents).
tables.generatedDocuments, tables.numberSequencesErstellte Rechnungen, Lieferscheine und weitere Belege mit Nummer, Kunde, Positionen und Stornobezug sowie die Nummernkreise
tables.companies, tables.companyNotes, tables.processNotesFirmen und Notizen; migrated: beim Wechsel in die Cloud übernommen, Verfasser (createdBy) und Zeitpunkt (createdAt) stammen dann aus der bisherigen lokalen Datenbank
tables.companyProfile, tables.documentTemplateEigene Firmendaten (inklusive Logo als Base64) und Belegvorlage
tables.membersMitarbeiter: Benutzername, Name, Rolle, Status, Funktion, Stundensatz
tables.timeFavorites, tables.processFavoritesFavoriten

Formate

  • Zeitstempel: ISO 8601 in UTC, z. B. 2026-11-11T13:23:00.000Z
  • Termine: Datum als JJJJ-MM-TT, Uhrzeit als HH:MM
  • Stundensätze: ganze Cent (Felder mit der Endung Cents)
  • Belegdatum und Fälligkeit von Dokumenten (documentDate, dueDate): Text im Format JJJJ-MM-TT, leer, wenn nicht vorhanden
  • Betrag von Dokumenten (invoiceAmount): Bruttobetrag als Text mit Punkt als Dezimalzeichen und zwei Nachkommastellen, ohne Währungszeichen, z. B. 1234.56; leer bedeutet „kein Betrag“. Ältere Einträge können abweichende Schreibweisen enthalten, z. B. 1.234,56 €.
  • Positionen erstellter Belege: im Feld positionsJson als JSON-Text (siehe unten)

Aufbau von positionsJson

Jeder erstellte Beleg hat ein JSON-Objekt. Alle Beträge sind in Euro mit Punkt als Dezimalzeichen angegeben; Preise sind Nettopreise. Summen sind nicht gespeichert, sondern ergeben sich aus den Positionen; der Bruttobetrag steht im Feld invoiceAmount des zugehörigen Dokuments.

  • Positionen (positionen): je Position id (UUID), description, quantity, unit (stk, std, pauschal, m, m2, m3, kg, tag), unitPrice (netto), optional steuersatz (19, 7 oder 0), rabattProzent, steuerbefreiungGrund
  • Rechnung: rechnungsnummer, positionen, steuersatz, faelligkeitsdatum, leistung (Datum oder Zeitraum), anschrift (name, name2, zusatz1, zusatz2, strasse, hausnummer, plz, ort, land), gesamtrabatt, skonto (prozent, tage), einleitung, schluss, bemerkungen, Kennzeichen umkehrSteuerschuld, kleinunternehmer, aufbewahrungshinweis sowie Bezüge auf Angebot bzw. Storno
  • Angebote und Lieferscheine sind entsprechend aufgebaut.
  • Mahnungen enthalten keine Positionen, sondern mahnstufe, rechnungsbetrag, mahngebuehr und verzugszinsen.
  • Das Feld rechenweise mit dem Wert cent kennzeichnet Belege, die mit der aktuellen Rundungslogik berechnet wurden.

Kennungen und Beziehungen

  • Jeder Eintrag hat eine eindeutige Kennung (id) als Text. Verweise auf andere Einträge stehen in Feldern mit der Endung Id, z. B. processId, customerId, dokumentId.
  • Dokumente sind über data.processAssignments Vorgängen zugeordnet.
  • Termine verweisen über customerId und processId auf Kunde und Vorgang; erstellte Belege über dokumentId und customerId auf Dokument und Kunde.
  • Dokumente nennen den Kunden als Namen im Feld kunde, nicht als Kennung.
  • Mitarbeiter werden über tables.members aufgelöst, z. B. für uploadedBy oder userId.

4) Originaldateien

  • Dokumente und Fotos werden in ihrem ursprünglichen Format und unverändert exportiert. In unserem Speicher verschlüsselte Dateien werden für den Export entschlüsselt.
  • Vorkommende Formate sind insbesondere PDF, JPEG, PNG, WebP, HEIC, TIFF, E-Mails im Format EML sowie Textdateien. Sprachaufnahmen des Arbeitsprotokolls liegen als M4A (MPEG-4 Audio) vor. Vorschaubilder liegen als JPEG, PNG oder WebP vor.
  • Die Zuordnung einer Datei zu ihrem Datensatz ergibt sich aus dem Pfad in backup.json (zipPath, thumbnailZipPath, beim Briefpapier letterheadZipPath, bei Anmerkungen zipPath in tables.annotations).

5) Nicht enthaltene Daten

Folgende Daten sind nicht Teil des Exports:

DatenGrund
Gelöschte Kunden, Vorgänge und Termine sowie endgültig gelöschte DokumenteGelöschte Einträge werden nicht exportiert. Dokumente im Papierkorb sind dagegen enthalten (siehe Ziffer 3).
Bereits gelöschte Sprachaufnahmen des ArbeitsprotokollsSprachaufnahmen werden nach festen Fristen automatisch gelöscht. Bericht, Fotos und Protokoll bleiben enthalten (siehe Ziffer 3).
Passwörter, PINs, Geheimnisse der Zwei-Faktor-Anmeldung, Anmelde- und Bestätigungs-Tokens, E-Mail-Adressen der MitarbeiterzugängeZugangsdaten; aus Sicherheitsgründen ausgeschlossen
Lizenzschlüssel, interne Kennungen des ZahlungsdienstleistersInterne Daten zum Betrieb des Dienstes
Technische Protokolle (u. a. Anmeldungen, Löschprotokoll, Einladungen)Interne Daten zum Betrieb des Dienstes
Dateien bereits verarbeiteter Handy-UploadsDie Dateien sind nach der Verarbeitung als Dokument im Export enthalten; zum Upload selbst bleiben nur die Angaben in backup.json
Daten im Tarif „Local“Diese liegen auf Ihrem eigenen Rechner (siehe Ziffer 7)

6) Steuerberater-Export

Der Steuerberater-Export ist ein ZIP-Archiv mit einer Belegübersicht als CSV-Datei und den Originalbelegen. Er ist kein Buchungsstapel im DATEV-Format und enthält keine Konten oder Steuerschlüssel.

Archiv

  • Dateiname beim Download: DokuVio_Belegübersicht_<JJJJ-MM-TT>_<Auswahl>.zip; enthält die Auswahl Eingangs- und Ausgangsbelege, entstehen zwei Archive mit den Endungen _Eingang und _Ausgang
  • Dateiname beim Versand per E-Mail: DokuVio_Belegübersicht_<Monat>_<Jahr>.zip
  • Beim Versand per E-Mail darf das Archiv höchstens 11 MB groß sein; größere Auswahlen laden Sie herunter und geben sie selbst weiter.
  • Belegübersicht.csv und die Belege liegen ohne Unterordner im Archiv. Die Belege sind die Originaldateien unter ihrem Dateinamen in DokuVio; bei gleichen Namen wird _2, _3 usw. angehängt, ohne Namen heißt die Datei Beleg_<id>.pdf.
  • Optional können Notizen mitexportiert werden; betroffene Belege werden dann als PDF mit eingefügten Notizen unter demselben Namen abgelegt.

Belegübersicht (Belegübersicht.csv)

  • Zeichenkodierung UTF-8 mit Byte Order Mark (BOM), Semikolon als Trennzeichen, Zeilenende LF
  • Erste Zeile ist immer die Kopfzeile mit 13 Spalten in dieser Reihenfolge: Datum; Geschäftspartner; Kategorie; Richtung; Belegnr.; Betrag; Netto; USt gesamt; USt 19 %; USt 7 %; Steuerfall; Fällig am; Dateiname
  • Datumsangaben: TT.MM.JJJJ, leer, wenn nicht vorhanden
  • Beträge: Dezimalkomma, zwei Nachkommastellen, ohne Tausendertrennzeichen und ohne Währungszeichen, negatives Vorzeichen vorangestellt, z. B. -1121,00. Netto und Umsatzsteuer sind nur bei in DokuVio erstellten Belegen gefüllt.
  • Richtung: Eingang oder Ausgang
  • Steuerfall: REGEL, 13B, KU19, NULL_PV, IGL, AUSFUHR oder NULL_SONST; mehrere Steuerfälle in einem Beleg sind mit + verbunden
  • Textfelder stehen nur in Anführungszeichen, wenn sie ein Semikolon, ein Anführungszeichen oder einen Zeilenumbruch enthalten; Anführungszeichen im Feld werden verdoppelt. Zahlen und Datumsangaben stehen nie in Anführungszeichen.
  • Beginnt ein Textfeld mit =, +, -, @, Tabulator oder Wagenrücklauf, wird zum Schutz vor Formeln in Tabellenprogrammen ein Hochkomma (') vorangestellt; es ist Teil des Inhalts.

7) Tarif „Local“

Im Tarif „Local“ liegen Ihre Daten nicht auf unseren Servern, sondern in einem Datenordner auf Ihrem Rechner oder Ihrer Netzwerkfreigabe (standardmäßig C:\Users\<Name>\Documents\DokuVio). Sie haben jederzeit unmittelbaren Zugriff darauf.

  • Datenbank: documents.db im Format SQLite 3, lesbar mit jedem SQLite-Werkzeug
  • Belegdateien: Originaldateien in Unterordnern nach Firma, Kategorie und Jahr, z. B. 2026-03-14_Rechnung_Müller_GmbH.pdf
  • Einstellungen: JSON-Dateien im Datenordner
  • Die Felder für Belegdatum, Betrag und Positionen haben dasselbe Format wie in Ziffer 3 beschrieben.

Exportmöglichkeiten in der Desktop-Software:

  • Backup-Archiv DokuVio_Backup_<Datum_Uhrzeit>.zip mit dem vollständigen Datenordner (Datenbank, Belegdateien, Einstellungen); automatisch alle 24 Stunden sowie jederzeit manuell
  • Steuerberater-Export wie in Ziffer 6 beschrieben
  • PDF-Export einzelner oder mehrerer Belege

Die optionale Cloud-Sicherung lädt dieses Backup-Archiv nach ausdrücklicher Freigabe durch den Administrator auf unsere Server hoch. Das Archiv wird vor dem Upload auf Ihrem Rechner verschlüsselt (AES-256-GCM). Es werden bis zu elf Sicherungsstände vorgehalten; wird die Cloud-Sicherung beendet, werden alle Stände gelöscht.

Nach Vertragsende bleiben der Datenexport und eine vorhandene Cloud-Sicherung bis zu 30 Tage abrufbar. Auch die Desktop- und Handy-App bleiben in dieser Zeit für den Export und — im Tarif Local — für den Abruf der Cloud-Sicherung angemeldet nutzbar.

8) Verwendete Standards

  • ZIP (PKWARE APPNOTE) für Archive
  • JSON (RFC 8259) für strukturierte Daten
  • UTF-8 (RFC 3629) als Zeichenkodierung
  • ISO 8601 für Datums- und Zeitangaben
  • CSV in Anlehnung an RFC 4180 für den Steuerberater-Export (Abweichungen: Semikolon als Trennzeichen, UTF-8 mit BOM, Zeilenende LF, Formelschutz durch Hochkomma)
  • SQLite 3 für die Datenbank im Tarif „Local“
  • PDF (ISO 32000), JPEG, PNG, WebP, HEIC und TIFF für Dokumente und Bilder
  • Internet Message Format (RFC 5322) für E-Mails im Format EML

9) Anbieterwechsel

Ein automatisiertes Werkzeug zur Übertragung an einen anderen Anbieter bieten wir nicht an. Die exportierten Daten liegen in offenen, verbreiteten Formaten vor und können ohne DokuVio gelesen und weiterverarbeitet werden. Bei einem Wechsel unterstützen wir Sie nach den Regelungen im Annex zu unseren AGB, insbesondere mit Informationen zum Datenformat. Ihre Wechselmitteilung und Fragen zum Export richten Sie bitte an info@dokuvio.de.

10) Bekannte Einschränkungen

  • Dokumente verweisen auf Kunden nur über den Namen, nicht über eine Kennung.
  • Die Positionen erstellter Belege stehen als JSON-Text in einem Feld und nicht als eigene Tabelle.
  • Der Export kann nur vom Administrator des Kontos abgerufen werden.
  • Exporte über 2 GiB oder 60.000 Dateien sind nur auf Anfrage möglich.