← Zurück zu Zetaro

Datenexport: Aufbau und Formate

Register der Datenstrukturen und Datenformate · Stand: 09.10.2026

Alles, was Sie in Zetaro eingeben, hochladen oder dort erzeugen, können Sie jederzeit in einer Datei mitnehmen. Diese Seite beschreibt, wie diese Datei aufgebaut ist — für Sie selbst und für jeden, der Ihre Daten in eine andere Anwendung übernehmen soll. Sie ist zugleich das Register nach Artikel 26 Buchstabe b der Verordnung (EU) 2023/2854 („Data Act“); die vertraglichen Regeln zum Wechsel stehen in § 5a der AGB.

Diese Seite wird aus dem Datenmodell der Anwendung erzeugt, nicht von Hand geschrieben. Ändert sich das Datenmodell, schlägt ein Prüflauf an, bis die Seite neu gebaut ist.

1. So bekommen Sie den Export

In der Anwendung unter Profil → Daten & Recht → „Alle Daten exportieren“ — in jedem Tarif, beliebig oft, ohne Kosten und ohne zu kündigen. Die Datei entsteht in Ihrem Browser und wird auf Ihrem Gerät gespeichert; sie heißt zetaro_export_JJJJ-MM-TT.zip. Eine Schnittstelle für den maschinellen Abruf gibt es nicht.

2. Was in der ZIP-Datei liegt

EintragInhalt
daten.jsonAlle Angaben Ihres Kontos als JSON, je Bereich eine Liste von Zeilen (Abschnitte 4 und 5).
dokumente/Die abgelegten Dateien im Original, unverändert. Je Objekt ein Ordner mit dem Namen des Objekts; Belege ohne Objekt liegen unter Posteingang. Der Dateiname ist <erste acht Zeichen der Kennung>_<Dateiname> — die Kennung ist das Feld id der Zeile im Bereich dokumente.
objektbilder/Die Bilder Ihrer Objekte, soweit hinterlegt: <erste acht Zeichen der Kennung des Objekts>_<Name des Objekts>.<Endung>.
LIESMICH.txtEine kurze Beschreibung mit dem Verweis auf diese Seite und der Angabe, ob der Export vollständig ist.

In Ordner- und Dateinamen stehen nur Buchstaben von A bis Z, Ziffern, Punkt, Unterstrich, Bindestrich und Leerzeichen; jedes andere Zeichen — auch ein Umlaut — ist durch einen Unterstrich ersetzt. Der ursprüngliche Dateiname steht unverändert in dokumente[].original_filename.

3. Formate und Normen

WasFormatNorm oder Spezifikation
ArchivZIP, die Einträge unkomprimiert, Dateinamen in UTF-8.ZIP File Format Specification (PKWARE)
daten.jsonJSON, Zeichensatz UTF-8, eingerücktRFC 8259, RFC 3629
ZeitpunktText wie 2026-10-09T08:15:30.123456+00:00, immer in koordinierter Weltzeit (UTC)ISO 8601, RFC 3339
DatumText wie 2026-10-09ISO 8601
Zahl, BetragJSON-Zahl mit Punkt als Dezimaltrenner, ohne Währungszeichen. Die Währung eines Mietverhältnisses steht in dessen Feld waehrung (drei Buchstaben, Vorgabe EUR).RFC 8259; Währungscode nach ISO 4217
Ja/Neintrue oder falseRFC 8259
Leeres FeldnullRFC 8259
KennungUUID als Text, etwa 3f2b6c1e-8a4d-4c1b-9e57-2d6a0c9b1f44; im Bereich zeitstempel_laeufe eine laufende ganze ZahlRFC 9562
PrüfsummeSHA-256, 64 hexadezimale ZeichenFIPS 180-4
Belegdateienim Original, wie abgelegt — in der Regel PDF, XML, JPEG oder PNG; Objektbilder als JPEG, PNG oder WebP—
E-Rechnungenunverändert als XML (XRechnung in UBL 2.1 oder UN/CEFACT CII) oder als PDF mit eingebetteter XML (ZUGFeRD, Factur-X)EN 16931
Zeitstempelsignierte Antwort des Zeitstempeldienstes (DER) als Base64-Text; der Weg dorthin als Liste von HashwertenRFC 3161; Hash-Baum nach RFC 6962

4. Aufbau von daten.json

Ein JSON-Objekt. Zuerst vier allgemeine Schlüssel, danach je Bereich ein Schlüssel in der Reihenfolge der Tabelle unten.

{
  "exportiert_am": "2026-10-09T08:15:30.123Z",
  "hinweis": "…",
  "nicht_enthalten": { "bereiche": [], "dateien": [] },
  "profil": { … },
  "objekte": [ { … }, { … } ],
  "einheiten": [ … ],
  …
}
SchlüsselInhalt
exportiert_amZeitpunkt des Exports (UTC).
hinweisEin Satz zum Aufbau, mit dem Verweis auf diese Seite.
nicht_enthaltenWas sich beim Export nicht lesen ließ: bereiche (je Eintrag was und grund) und dateien (je Eintrag id, datei, grund). Sind beide Listen leer, ist der Export vollständig. Ein Bereich, der sich nicht lesen ließ, steht in der Datei als null — nicht als leere Liste.

Die 36 Bereiche mit zusammen 420 Feldern:

SchlüsselInhaltFormFelder
profilProfilein Objekt32
objekteObjekteListe12
einheitenEinheitenListe8
mietverhaeltnisseMietverhältnisseListe22
mieterMietparteien und BewohnerListe9
mietstufenMietänderungenListe8
mietzahlungenZahlungenListe8
belegungenBelegungenListe6
dokumenteBelegeListe23
zeitstempel_nachweiseZeitstempel-NachweiseListe6
zeitstempel_laeufeZeitstempel-LäufeListe6
vorgaengeVorgängeListe12
handwerker_anfragenHandwerker-AnfragenListe24
handwerker_nachrichtenHandwerker-NachrichtenListe5
mieter_anliegenMieteranliegenListe12
kontakteKontakteListe12
kundenKundenListe14
rechnungsversandVersand von RechnungenListe9
interessentenInteressentenListe13
nebenkosten_zeitraeumeNebenkosten: AbrechnungszeiträumeListe14
nebenkosten_positionenNebenkosten: KostenpositionenListe11
nebenkosten_schreibenNebenkosten: SchreibenListe15
belegeinsichtenBelegeinsichtListe10
kautionsabrechnungenKautionsabrechnungenListe11
uebergabeprotokolleÜbergabeprotokolleListe14
schreiben_an_mietparteienSchreiben an MietparteienListe10
zahlungserinnerungen_und_mahnungenZahlungserinnerungen und MahnungenListe9
wiederkehrende_pflichtenWiederkehrende PflichtenListe9
zaehlerZählerListe13
zaehlerstaendeZählerständeListe10
eigentuemerEigentümerListe9
verwaltervertraegeVerwalterverträgeListe11
protokollÄnderungsprotokollListe11
posteingang_protokollEmpfangsprotokollListe11
versandprotokollVersandprotokollListe5
erinnerungen_an_fristenErinnerungen an FristenListe6

Verweise zwischen den Bereichen laufen über Kennungen: steht in einer Zeile etwa lease_id, ist das die id einer Zeile im Bereich mietverhaeltnisse. In den Tabellen unten steht bei jedem solchen Feld, wohin es zeigt. Enthalten sind nur Zeilen Ihres eigenen Kontos.

5. Die Bereiche im Einzelnen

Feldnamen sind teils deutsch, teils englisch — sie stehen in der Datei genau so wie hier. „Kann leer sein“ heißt: der Wert darf null sein. Wo ein Feld nur bestimmte Werte annimmt, sind sie aufgezählt.

profil — Profil

Ihre Angaben zum Konto: Name, Anschrift, Steuerangaben, Bankverbindung, Tarif und der Nachweis über den Auftragsverarbeitungsvertrag. Ein einzelnes Objekt, keine Liste.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
display_nameText
kann leer sein
Anzeigename
created_atZeitpunktangelegt am
addressText
kann leer sein
Anschrift, wie sie auf Schreiben steht
phoneText
kann leer sein
 
tax_numberText
kann leer sein
Steuernummer
tax_officeText
kann leer sein
Finanzamt
vat_idText
kann leer sein
Umsatzsteuer-Identifikationsnummer
inbox_aliasText
kann leer sein
Teil vor dem @ Ihrer Posteingangsadresse (…@inbox.zetaro.de)
first_nameText
kann leer sein
 
last_nameText
kann leer sein
 
ibanText
kann leer sein
Bankverbindung für Schreiben
onboarding_seenJa/NeinBedienmerker
tour_seenJa/NeinBedienmerker
tierTextbezahlter Tarif; Werte: kostenlos, rechnungen, plus, pro
stripe_customer_idText
kann leer sein
Kundenkennung beim Zahlungsdienst Stripe
stripe_subscription_idText
kann leer sein
Kennung des Abos bei Stripe
subscription_statusText
kann leer sein
Stand des Abos, wie Stripe ihn zuletzt gemeldet hat
email_signatureText
kann leer sein
Signatur für Nachrichten
tenant_auto_notifyJa/NeinStatusmeldungen an Mietparteien von selbst senden
is_adminJa/NeinVerwaltungsrecht (nur beim Betreiber)
tier_overrideText
kann leer sein
freigeschalteter Tarif; geht dem bezahlten vor; Werte: kostenlos, rechnungen, plus, pro
tier_override_grundText
kann leer sein
Anlass der Freischaltung
avv_versionText
kann leer sein
angenommene Fassung des Auftragsverarbeitungsvertrags
avv_accepted_atZeitpunkt
kann leer sein
Zeitpunkt der Annahme
abo_gekuendigtJa/NeinAbo gekündigt, wie Stripe es zuletzt gemeldet hat
abo_endet_amZeitpunkt
kann leer sein
Ende des bezahlten Zeitraums, wie Stripe es zuletzt gemeldet hat
bereicheListe von Textengewählte Bereiche von Zetaro (immobilien, rechnungen) — steuert die Ansicht
kleinunternehmerJa/NeinSie stellen als Kleinunternehmer aus (§ 19 UStG) — Ihre Rechnungen weisen keine Umsatzsteuer aus
mitglieder_plaetzeGanze Zahl 
fristen_erinnerungJa/NeinErinnerung an Fristen per E-Mail eingeschaltet (Migration 096)
fristen_erinnerung_amDatum
kann leer sein
Tag, an dem Zetaro das Konto zuletzt auf neue Fristen geprüft hat

objekte — Objekte

Ihre Objekte („Mappen“) mit Anschrift, Wohnfläche und den Angaben zur 15-%-Grenze.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
nameTextName des Objekts
kindTextArt des Objekts; Werte: wohnung, haus, nebengebaeude, aussenanlage, sonstiges
addressText
kann leer sein
 
created_atZeitpunktangelegt am
tenant_tokenText
kann leer sein
Zugangscode des Mieterkanals dieses Objekts
image_pathText
kann leer sein
Speicherort des Objektbilds bei Zetaro; das Bild liegt im Ordner „objektbilder/“
wohnflaeche_gesamtZahl, bis 2 Nachkommastellen
kann leer sein
Wohnfläche des Objekts in Quadratmetern
eigentuemer_idKennung (UUID)
kann leer sein
verweist auf eigentuemer.id
kaufdatumDatum
kann leer sein
Übergang von Besitz, Nutzen und Lasten
anschaffungskosten_gebaeudeZahl, bis 2 Nachkommastellen
kann leer sein
Anschaffungskosten des Gebäudes ohne Grund und Boden

einheiten — Einheiten

Die Wohnungen oder Gewerbeeinheiten eines Objekts. Jedes Objekt hat mindestens eine.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
bezeichnungText 
lageText
kann leer sein
 
wohnflaeche_qmZahl, bis 2 Nachkommastellen
kann leer sein
Fläche der Einheit in Quadratmetern
zimmerZahl, bis 1 Nachkommastelle
kann leer sein
 
created_atZeitpunktangelegt am

mietverhaeltnisse — Mietverhältnisse

Je Vertrag eine Zeile: Zeitraum, Anfangsmiete, Vorauszahlung, Kaution, Vertragsart. Ein Mieterwechsel ist eine neue Zeile.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
unit_idKennung (UUID)verweist auf einheiten.id
beginnDatum 
endeDatum
kann leer sein
leer heißt: läuft
kaltmieteZahl, bis 2 Nachkommastellen
kann leer sein
Miete je Monat bei Vertragsbeginn; spätere Änderungen stehen unter „mietstufen“
nk_vorauszahlungZahl, bis 2 Nachkommastellen
kann leer sein
Vorauszahlung je Monat bei Vertragsbeginn
waehrungTextWährung der Beträge dieses Mietverhältnisses
kaution_betragZahl, bis 2 Nachkommastellen
kann leer sein
 
kaution_artText
kann leer sein
Werte: barkaution, buergschaft, sparbuch, versicherung, sonstiges
umlageschluesselTextWerte: wohnflaeche, personen, einheiten, verbrauch
notizText
kann leer sein
 
created_atZeitpunktangelegt am
dauerauftrag_betragZahl, bis 2 Nachkommastellen
kann leer sein
hinterlegter Dauerauftrag: Betrag je Monat
dauerauftrag_abDatum
kann leer sein
erster Monat des Dauerauftrags (Monatserster)
dauerauftrag_bisDatum
kann leer sein
letzter Monat des Dauerauftrags (Monatserster)
vertragsartTextWerte: wohnraum, gewerbe
nutzungszweckText
kann leer sein
nur bei Gewerbe
wgb_bestaetigt_amDatum
kann leer sein
Wohnungsgeberbestätigung ausgestellt am
mieterkuendigung_amDatum
kann leer sein
Kündigung der Mietpartei zugegangen am
mieterkuendigung_formText
kann leer sein
Form dieser Kündigung; Werte: schriftlich, teilweise, textform, muendlich
umsatzsteuer_optionJa/Neinzur Umsatzsteuer optiert (§ 9 UStG); die Beträge enthalten dann die Umsatzsteuer

mieter — Mietparteien und Bewohner

Die Personen eines Mietverhältnisses mit ihrer Rolle.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
nameText 
emailText
kann leer sein
 
telefonText
kann leer sein
 
created_atZeitpunktangelegt am
rolleTextWerte: mietpartei, bewohner, untermieter
untermiete_erlaubt_amDatum
kann leer sein
nur bei Untermietern: Erlaubnis erteilt am

mietstufen — Mietänderungen

Jede Änderung der Miete oder der Vorauszahlung mit ihrem Stichtag. Für einen Monat gilt die letzte Stufe, die am Monatsersten schon galt; davor gilt, was am Mietverhältnis steht.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
gueltig_abDatumMonatserster, ab dem die Stufe gilt
kaltmieteZahl, bis 2 Nachkommastellen 
nk_vorauszahlungZahl, bis 2 Nachkommastellen
kann leer sein
leer heißt: unverändert
grundText
kann leer sein
 
created_atZeitpunktangelegt am

mietzahlungen — Zahlungen

Eingegangene Mietzahlungen. Das Soll wird nicht gespeichert, sondern aus Mietverhältnis und Mietänderungen gerechnet.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
monatDatumMonatserster des Monats, für den gezahlt wurde
betragZahl, bis 2 Nachkommastellenein negativer Betrag ist eine Gegenbuchung
gezahlt_amDatumTag des Eingangs
notizText
kann leer sein
 
created_atZeitpunktangelegt am

belegungen — Belegungen

Wie viele Personen ab welchem Tag in einem Mietverhältnis leben — nur die Zahl; die Personentage rechnet Zetaro daraus.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
created_atZeitpunktangelegt am
abDatumTag, ab dem die Zahl gilt
personenGanze ZahlZahl der Personen — keine Namen

dokumente — Belege

Je abgelegter Datei eine Zeile — auch Belege im Papierkorb. Die Datei selbst liegt im Ordner „dokumente/“ der ZIP-Datei.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)
kann leer sein
verweist auf objekte.id
case_idKennung (UUID)
kann leer sein
verweist auf vorgaenge.id
doc_typeTextBelegart; an ihr hängt die Aufbewahrungsfrist; Werte: rechnung, angebot, auftragsbestaetigung, lieferschein, vertrag, foto, bescheid, ausgangsrechnung, sprachnachricht, sonstiges
original_filenameTextDateiname bei der Ablage
storage_pathTextSpeicherort bei Zetaro — nicht der Pfad in der ZIP-Datei
mime_typeText
kann leer sein
Medientyp der Datei
size_bytesGanze Zahl
kann leer sein
Größe in Bytes
sourceTextWeg, auf dem der Beleg kam; Werte: upload, inbox, handwerker, mieterkanal
uploaded_atZeitpunktZeitpunkt der Ablage
einvoiceObjekt oder Liste
kann leer sein
Zusammenfassung einer Rechnung, ausgelesen oder von Hand eingetragen: format, number, seller (Text), gross, net, tax, currency, issue (Rechnungsdatum); hand: true, wenn die Angaben von Hand stammen
deleted_atZeitpunkt
kann leer sein
im Papierkorb seit — leer heißt: nicht im Papierkorb
contractor_request_idKennung (UUID)
kann leer sein
verweist auf handwerker_anfragen.id
tenant_request_idKennung (UUID)
kann leer sein
verweist auf mieter_anliegen.id
sha256Text
kann leer sein
SHA-256 der Originaldatei, hexadezimal; bei der Ablage gebildet und danach unveränderlich
volltextText
kann leer sein
ausgelesener Text für die Suche
betriebskostenartText
kann leer sein
Schlüssel einer Kostenart
bezahlt_amDatum
kann leer sein
Tag der Zahlung
lease_idKennung (UUID)
kann leer sein
verweist auf mietverhaeltnisse.id
bescheid_vomDatum
kann leer sein
Datum eines Bescheids
bescheid_erledigt_amDatum
kann leer sein
Einspruch eingelegt oder Bescheid geprüft am
ausgangsrechnungObjekt oder Liste
kann leer sein
Angaben einer ausgestellten oder abgelegten Ausgangsrechnung, unter anderem Nummer, Rechnungsdatum, Leistungsbeginn und Beträge

zeitstempel_nachweise — Zeitstempel-Nachweise

Je Beleg der Weg von seiner Prüfsumme zur signierten Wurzel eines Hash-Baums.

FeldFormatBedeutung
document_id SchlüsselKennung (UUID)verweist auf dokumente.id
user_idKennung (UUID)Kennung Ihres Kontos
zeitstempel_idGanze Zahlverweist auf zeitstempel_laeufe.id
sha256TextPrüfsumme des Belegs zum Zeitpunkt des Laufs
pfadObjekt oder ListeSchritte vom Blatt zur Wurzel des Hash-Baums: Liste aus { s: „l“ oder „r“, h: Hashwert }
created_atZeitpunktangelegt am

zeitstempel_laeufe — Zeitstempel-Läufe

Die signierten Antworten des Zeitstempeldienstes, auf die Ihre Nachweise zeigen.

FeldFormatBedeutung
id SchlüsselGanze ZahlKennung der Zeile
created_atZeitpunktangelegt am
wurzelTextWurzel des Hash-Baums, hexadezimal
tsaTextZeitstempeldienst; Werte: sectigo-qualifiziert, sectigo
tokenTextsignierte Antwort des Dienstes nach RFC 3161 (DER), als Base64
zeitpunktZeitpunktZeitpunkt laut Zeitstempel

vorgaenge — Vorgänge

Reparaturen, Schäden und andere Vorgänge an einem Objekt, mit Frist der Gewährleistung.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
titleText 
categoryText
kann leer sein
 
statusTextWerte: offen, in_arbeit, abgeschlossen
warranty_untilDatum
kann leer sein
Ende der Gewährleistung
created_atZeitpunktangelegt am
completed_atDatum
kann leer sein
 
descriptionText
kann leer sein
 
case_noGanze Zahllaufende Vorgangsnummer je Konto (angezeigt als V-0007)
deleted_atZeitpunkt
kann leer sein
im Papierkorb seit — leer heißt: nicht im Papierkorb

handwerker_anfragen — Handwerker-Anfragen

Je angefragtem Betrieb eine Zeile, mit Termin, Angebot und Zuschlag.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
case_idKennung (UUID)verweist auf vorgaenge.id
contact_idKennung (UUID)
kann leer sein
verweist auf kontakte.id
firm_nameText
kann leer sein
 
emailText
kann leer sein
 
tradeText
kann leer sein
Gewerk
task_textText
kann leer sein
Beschreibung des Auftrags für den Betrieb
access_noteText
kann leer sein
Hinweis zum Zugang
tokenTextZugangscode des Rückkanals dieser Anfrage
statusTextWerte: offen, termin, abgelehnt, erledigt
appointment_atZeitpunkt
kann leer sein
 
appointment_noteText
kann leer sein
 
last_contractor_atZeitpunkt
kann leer sein
letzte Meldung des Betriebs
owner_seen_atZeitpunkt
kann leer sein
zuletzt von Ihnen gelesen
revoked_atZeitpunkt
kann leer sein
Link gesperrt am
created_atZeitpunktangelegt am
angebot_betragZahl, bis 2 Nachkommastellen
kann leer sein
Angebotspreis, wie der Betrieb ihn genannt hat
angebot_gueltig_bisDatum
kann leer sein
 
angebot_notizText
kann leer sein
 
angebot_amZeitpunkt
kann leer sein
 
beauftragt_atZeitpunkt
kann leer sein
Zuschlag erteilt am
abgesagt_atZeitpunkt
kann leer sein
abgesagt am

handwerker_nachrichten — Handwerker-Nachrichten

Der Gesprächsfaden einer Handwerker-Anfrage.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
request_idKennung (UUID)verweist auf handwerker_anfragen.id
senderTextwer geschrieben hat; Werte: handwerker, vermieter
bodyTextText der Nachricht
created_atZeitpunktangelegt am

mieter_anliegen — Mieteranliegen

Was Mietparteien über den Mieterkanal gemeldet haben.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
nameText
kann leer sein
 
contactText
kann leer sein
Rückrufnummer oder E-Mail-Adresse der meldenden Person
categoryText
kann leer sein
 
messageTextText der Meldung
statusTextWerte: neu, in_arbeit, erledigt
created_atZeitpunktangelegt am
case_idKennung (UUID)
kann leer sein
verweist auf vorgaenge.id
notified_statusText
kann leer sein
Stand, über den die Mietpartei zuletzt benachrichtigt wurde
deleted_atZeitpunkt
kann leer sein
im Papierkorb seit — leer heißt: nicht im Papierkorb

kontakte — Kontakte

Handwerksbetriebe, Versorger und andere Kontakte.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
nameText 
categoryTextWerte: handwerker, makler, hausverwaltung, sonstiges
tradeText
kann leer sein
Gewerk
phoneText
kann leer sein
 
emailText
kann leer sein
 
addressText
kann leer sein
 
ratingGanze Zahl
kann leer sein
 
notesText
kann leer sein
 
created_atZeitpunktangelegt am
betriebskostenart_vorgabeText
kann leer sein
vorgeschlagene Kostenart für Rechnungen dieses Kontakts; Schlüssel einer Kostenart

kunden — Kunden

Empfänger Ihrer ausgestellten Rechnungen: Name, Anschrift, E-Mail-Adresse, USt-IdNr. und Leitweg-ID.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
created_atZeitpunktangelegt am
nameText 
artTextWerte: unternehmen, behoerde, privat
strasseText
kann leer sein
 
plzText
kann leer sein
 
ortText
kann leer sein
 
landText 
emailText
kann leer sein
 
ust_idText
kann leer sein
 
leitweg_idText
kann leer sein
Leitweg-ID einer Behörde, an die Sie XRechnungen stellen
referenzText
kann leer sein
was der Kunde auf der Rechnung verlangt, etwa eine Kostenstelle
notizText
kann leer sein
 

rechnungsversand — Versand von Rechnungen

Wann welche ausgestellte Rechnung an welche Adresse ging — mit der Prüfsumme der gesendeten Datei.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
document_idKennung (UUID)verweist auf dokumente.id
gesendet_vonKennung (UUID)
kann leer sein
 
anText 
betreffText 
sha256Text 
brevo_idText
kann leer sein
 
gesendet_atZeitpunkt 

interessenten — Interessenten

Anfragen von Mietinteressenten zu einer Einheit.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
unit_idKennung (UUID)verweist auf einheiten.id
nameText 
emailText
kann leer sein
 
telefonText
kann leer sein
 
quelleText
kann leer sein
 
einzug_abDatum
kann leer sein
 
besichtigung_atZeitpunkt
kann leer sein
 
standTextWerte: neu, besichtigung, engere_wahl, zugesagt, abgesagt
notizText
kann leer sein
 
eingegangen_atZeitpunktEingang der Anfrage
created_atZeitpunktangelegt am

nebenkosten_zeitraeume — Nebenkosten: Abrechnungszeiträume

Je Objekt und Zeitraum eine Abrechnung, mit den Angaben zur CO2-Kostenaufteilung.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
vonDatum 
bisDatum 
statusTextWerte: entwurf, abgeschlossen
abgeschlossen_atZeitpunkt
kann leer sein
 
notizText
kann leer sein
 
created_atZeitpunktangelegt am
co2_verfahrenText
kann leer sein
CO2-Kostenaufteilung: Verfahren; leer heißt: nicht angegeben; Werte: wohngebaeude, nichtwohngebaeude, messdienst, entfaellt
co2_kgZahl, bis 1 Nachkommastelle
kann leer sein
CO2-Ausstoß des Zeitraums in Kilogramm
co2_kostenZahl, bis 2 Nachkommastellen
kann leer sein
CO2-Kosten des Zeitraums
co2_flaecheZahl, bis 2 Nachkommastellen
kann leer sein
Wohnfläche für die Einstufung; leer heißt: Summe der Einheiten
co2_einschraenkungTextEinschränkung nach § 9 des Kohlendioxidkostenaufteilungsgesetzes; Werte: keine, haelfte, keine_aufteilung

nebenkosten_positionen — Nebenkosten: Kostenpositionen

Die Kosten eines Abrechnungszeitraums je Kostenart, mit Verteilerschlüssel.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
period_idKennung (UUID)verweist auf nebenkosten_zeitraeume.id
artTextSchlüssel einer Kostenart
betrag_gesamtZahl, bis 2 NachkommastellenKosten der Position für das ganze Objekt
schluesselTextVerteilerschlüssel; Werte: wohnflaeche, einheiten, personen, direkt, verbrauch
lease_idKennung (UUID)
kann leer sein
gesetzt heißt: der Betrag gehört diesem Mietverhältnis allein; verweist auf mietverhaeltnisse.id
document_idKennung (UUID)
kann leer sein
verweist auf dokumente.id
notizText
kann leer sein
 
created_atZeitpunktangelegt am
zaehler_artText
kann leer sein
bei Verteilung nach Verbrauch: nach welchen Zählern; Werte: wasser, kaltwasser, strom, gas

nebenkosten_schreiben — Nebenkosten: Schreiben

Je Mietverhältnis das abgeschlossene Schreiben mit festgehaltenem Rechenweg.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
period_idKennung (UUID)verweist auf nebenkosten_zeitraeume.id
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
vonDatum 
bisDatum 
tageGanze ZahlTage des Mietverhältnisses im Zeitraum
anteil_kostenZahl, bis 2 NachkommastellenAnteil des Mietverhältnisses an den Kosten
vorauszahlungZahl, bis 2 Nachkommastellengeleistete Vorauszahlungen
saldoZahl, bis 2 Nachkommastellen 
inhaltObjekt oder Listefestgehaltener Rechenweg des Schreibens
zugestellt_atZeitpunkt
kann leer sein
als zugestellt vermerkt am
created_atZeitpunktangelegt am
vz_neuZahl, bis 2 Nachkommastellen
kann leer sein
angepasste Vorauszahlung je Monat
vz_angepasst_abDatum
kann leer sein
Monatserster, ab dem sie gilt

belegeinsichten — Belegeinsicht

Freigaben von Belegen einer Abrechnung über einen Link.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
statement_idKennung (UUID)verweist auf nebenkosten_schreiben.id
tokenTextZugangscode des Links
belegeListe von KennungenKennungen der freigegebenen Belege (dokumente.id)
gueltig_bisDatum 
widerrufen_atZeitpunkt
kann leer sein
gesperrt am
zuerst_geoeffnet_atZeitpunkt
kann leer sein
 
zuletzt_geoeffnet_atZeitpunkt
kann leer sein
 
created_atZeitpunktangelegt am

kautionsabrechnungen — Kautionsabrechnungen

Je Mietverhältnis höchstens eine Abrechnung der Kaution.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
created_atZeitpunktangelegt am
kaution_betragZahl, bis 2 Nachkommastellen 
zinsenZahl, bis 2 Nachkommastellen 
positionenObjekt oder ListeListe der Abzüge
einbehalt_nkZahl, bis 2 NachkommastellenEinbehalt für eine ausstehende Nebenkostenabrechnung
notizText
kann leer sein
 
abgeschlossen_atZeitpunkt
kann leer sein
 
inhaltObjekt oder Liste
kann leer sein
festgehaltene Abrechnung, sobald abgeschlossen

uebergabeprotokolle — Übergabeprotokolle

Einzugs- und Auszugsprotokoll eines Mietverhältnisses.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
created_atZeitpunktangelegt am
artTextWerte: einzug, auszug
datumDatum 
anwesendeObjekt oder ListeListe der Anwesenden
raeumeObjekt oder ListeListe der Räume mit Zustand; je Raum unter fotos die zugehörigen Fotos (id des Belegs unter dokumente, sha256, name)
zaehlerObjekt oder ListeListe der Zählerstände
schluesselObjekt oder ListeListe der übergebenen Schlüssel
maengelObjekt oder ListeListe der Mängel; je Mangel unter fotos die zugehörigen Fotos (id des Belegs unter dokumente, sha256, name)
notizText
kann leer sein
 
abgeschlossen_atZeitpunkt
kann leer sein
 
inhaltObjekt oder Liste
kann leer sein
festgehaltenes Protokoll, sobald abgeschlossen

schreiben_an_mietparteien — Schreiben an Mietparteien

Abmahnungen, Kündigungen und Mieterhöhungsverlangen, so wie sie gedruckt wurden, mit Zugang.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
created_atZeitpunktangelegt am
artTextWerte: abmahnung, mieterhoehung, kuendigung_zahlungsverzug, kuendigung_eigenbedarf
datumDatum 
inhaltObjekt oder Listedas Schreiben, wie es gedruckt wurde (Betreff, Text, Termin, Fassung)
zustellwegText
kann leer sein
Werte: persoenlich, bote, einwurf_einschreiben, einschreiben_rueckschein, gerichtsvollzieher, email, sonstiges
zugegangen_amDatum
kann leer sein
Tag des Zugangs
notizText
kann leer sein
 

zahlungserinnerungen_und_mahnungen — Zahlungserinnerungen und Mahnungen

Die abgelegten Schreiben, so wie sie hinausgingen.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
lease_idKennung (UUID)verweist auf mietverhaeltnisse.id
created_atZeitpunktangelegt am
artTextWerte: erinnerung, mahnung
datumDatum 
fristDatum
kann leer sein
gesetzte Zahlungsfrist
summeZahl, bis 2 Nachkommastellenoffener Betrag zum Zeitpunkt des Schreibens
inhaltObjekt oder Listedas Schreiben, wie es hinausging (Betreff, Text, offene Monate, Fassung)

wiederkehrende_pflichten — Wiederkehrende Pflichten

Wartungen und Prüfungen an einem Objekt mit Intervall und letztem Termin.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
created_atZeitpunktangelegt am
artTextWerte: rauchmelder, legionellen, schornstein, energieausweis, aufzug, heizung, gasleitung, sonstiges
bezeichnungText
kann leer sein
eigener Name der Pflicht
intervall_monateGanze ZahlAbstand zwischen zwei Terminen in Monaten
zuletzt_amDatum
kann leer sein
zuletzt erledigt am
notizText
kann leer sein
 

zaehler — Zähler

Die Zähler eines Objekts — je Einheit oder für das ganze Haus — mit Art, Nummer, Ein- und Ausbau und Eichfrist.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
property_idKennung (UUID)verweist auf objekte.id
unit_idKennung (UUID)
kann leer sein
Kennung der Einheit — leer bei einem Hauszähler; verweist auf einheiten.id
created_atZeitpunktangelegt am
artTextKaltwasser, Warmwasser, Strom, Gas, Wärme oder sonstiger Zähler; Werte: kaltwasser, warmwasser, strom, gas, waerme, sonstig
nummerText
kann leer sein
 
bezeichnungText
kann leer sein
 
einheitTextEinheit des Stands, etwa m³ oder kWh
eingebaut_amDatum
kann leer sein
 
ausgebaut_amDatum
kann leer sein
 
eichfrist_jahrGanze Zahl
kann leer sein
Jahr, mit dessen Ablauf die Eichfrist endet
notizText
kann leer sein
 

zaehlerstaende — Zählerstände

Jede Ablesung mit Tag, Stand, Anlass und wer abgelesen hat; den Verbrauch rechnet Zetaro daraus.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
zaehler_idKennung (UUID)verweist auf zaehler.id
created_atZeitpunktangelegt am
abgelesen_amDatum 
standZahl, bis 3 Nachkommastellenabgelesener Stand in der Einheit des Zählers
anlassTextAblesung, Einzug, Auszug, Einbau, Ausbau oder Schätzung; Werte: ablesung, einzug, auszug, einbau, ausbau, schaetzung
abgelesen_vonText
kann leer sein
wer abgelesen hat — eine Rolle, kein Name; Werte: vermieter, mietpartei, messdienst, versorger, hausmeister, sonstige
document_idKennung (UUID)
kann leer sein
Kennung des Fotos als Beleg, wenn eines abgelegt ist; verweist auf dokumente.id
notizText
kann leer sein
 

eigentuemer — Eigentümer

Eigentümer, für die Sie Objekte verwalten.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
created_atZeitpunktangelegt am
nameText 
artTextWerte: natuerliche_person, gemeinschaft, juristische_person
anschriftText
kann leer sein
 
emailText
kann leer sein
 
telefonText
kann leer sein
 
notizText
kann leer sein
 

verwaltervertraege — Verwalterverträge

Die Verträge mit einem Eigentümer, mit Vergütung und Vollmacht.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
eigentuemer_idKennung (UUID)verweist auf eigentuemer.id
created_atZeitpunktangelegt am
beginnDatum 
endeDatum
kann leer sein
 
verguetung_betragZahl, bis 2 Nachkommastellen
kann leer sein
 
verguetung_basisText
kann leer sein
worauf sich die Vergütung bezieht; Werte: je_einheit_monat, pauschal_monat, prozent_miete
kuendigungsfristText
kann leer sein
Kündigungsfrist als Text
vollmacht_vomDatum
kann leer sein
Datum der Vollmacht
notizText
kann leer sein
 

protokoll — Änderungsprotokoll

Was wann angelegt, geändert oder gelöscht wurde. Das Protokoll schreibt die Datenbank selbst.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
document_idKennung (UUID)
kann leer sein
verweist auf dokumente.id
actionTextwas geschah
detailText
kann leer sein
Bezeichnung des betroffenen Eintrags
created_atZeitpunktangelegt am
entityText
kann leer sein
betroffene Tabelle
entity_idKennung (UUID)
kann leer sein
Kennung der betroffenen Zeile — bleibt stehen, auch wenn die Zeile gelöscht ist
lease_idKennung (UUID)
kann leer sein
Bezug zum Mietverhältnis, ohne Verweis: der Eintrag überlebt die Zeile
property_idKennung (UUID)
kann leer sein
Bezug zum Objekt, ohne Verweis
eigentuemer_idKennung (UUID)
kann leer sein
Bezug zum Eigentümer, ohne Verweis

posteingang_protokoll — Empfangsprotokoll

Was der Posteingang mit eingegangenen E-Mails getan hat.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)
kann leer sein
Kennung Ihres Kontos
aliasText
kann leer sein
angeschriebene Posteingangsadresse
from_addrText
kann leer sein
Absender der E-Mail
subjectText
kann leer sein
 
attachments_foundGanze ZahlAnhänge in der E-Mail
attachments_storedGanze Zahldavon abgelegt
statusTextWerte: ok, fehler, unbekannter_alias
errorText
kann leer sein
 
created_atZeitpunktangelegt am
noteText
kann leer sein
was mit den Anhängen geschah

versandprotokoll — Versandprotokoll

Welche E-Mails Zetaro in Ihrem Auftrag verschickt hat — ohne deren Inhalt.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
to_addrTextEmpfänger
subjectText
kann leer sein
 
created_atZeitpunktangelegt am

erinnerungen_an_fristen — Erinnerungen an Fristen

Welche Frist Zetaro in welcher Stufe per E-Mail gemeldet hat — damit keine Erinnerung doppelt kommt. Die E-Mails selbst stehen im Versandprotokoll.

FeldFormatBedeutung
id SchlüsselKennung (UUID)Kennung der Zeile
user_idKennung (UUID)Kennung Ihres Kontos
schluesselTextArt der Frist und Kennung des Datensatzes (etwa bescheid:<Kennung>); bei der Verjährung dazu das Jahr der Forderung
stufeTextwarn: bald fällig gemeldet; ab: abgelaufen gemeldet; Werte: warn, ab
fristDatum
kann leer sein
Datum der Frist zum Zeitpunkt der Meldung
gesendet_atZeitpunktZeitpunkt der E-Mail

6. Kostenarten

Belege, Kostenpositionen und Kontakte nennen eine Kostenart nur mit ihrem Schlüssel. Die Liste dazu gehört zu keinem Konto und steht deshalb nicht in der Export-Datei, sondern hier:

SchlüsselBezeichnungGrundlageumlagefähig
grundsteuerGrundsteuer und laufende öffentliche Lasten§ 2 Nr. 1 BetrKVja
wasserWasserversorgung§ 2 Nr. 2 BetrKVja
entwaesserungEntwässerung§ 2 Nr. 3 BetrKVja
heizungHeizung§ 2 Nr. 4 BetrKVja
warmwasserWarmwasser§ 2 Nr. 5 BetrKVja
heizung_warmwasserVerbundene Heizungs- und Warmwasseranlage§ 2 Nr. 6 BetrKVja
aufzugAufzug§ 2 Nr. 7 BetrKVja
strassenreinigungStraßenreinigung und Müllbeseitigung§ 2 Nr. 8 BetrKVja
gebaeudereinigungGebäudereinigung und Ungezieferbekämpfung§ 2 Nr. 9 BetrKVja
gartenpflegeGartenpflege§ 2 Nr. 10 BetrKVja
beleuchtungBeleuchtung§ 2 Nr. 11 BetrKVja
schornsteinSchornsteinreinigung§ 2 Nr. 12 BetrKVja
versicherungSach- und Haftpflichtversicherung§ 2 Nr. 13 BetrKVja
hauswartHauswart§ 2 Nr. 14 BetrKVja
antenneGemeinschaftsantenne und Breitbandnetz§ 2 Nr. 15 BetrKVja
waschraumEinrichtungen für die Wäschepflege§ 2 Nr. 16 BetrKVja
sonstigeSonstige Betriebskosten§ 2 Nr. 17 BetrKVja
nicht_umlagefaehigNicht umlagefähig (Instandhaltung, Verwaltung)nein

7. Was nicht im Export steht

8. Bekannte Einschränkungen

9. Daten zu Zetaro übernehmen

Für den umgekehrten Weg gibt es diese Möglichkeiten:

10. Fragen

Zum Export, zu dieser Beschreibung oder zu einem Wechsel: kontakt@zetaro.de. Unterstützung beim Wechsel kostet nichts (§ 5a der AGB).