Rechnungslotse: deutsche E-Rechnung

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'properties': {'regel': {'type': 'string', 'description': 'Die Kennung aus der Fehlermeldung, z. B. BR-08. Groß-/Kleinschreibung egal.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['umsatz_vorjahr', 'umsatz_laufendes_jahr'], 'properties': {'umsatz_vorjahr': {'type': 'number', 'description': 'Gesamtumsatz des Vorjahres in Euro.'}, 'umsatz_laufendes_jahr': {'type': 'number', 'description': 'Bisheriger Umsatz des laufenden Jahres in Euro.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'Höchstzahl der Treffer, 1 bis 100. Vorgabe 20.'}, 'suche': {'type': 'string', 'description': 'Teil des Namens, der Stadt oder der E-Mail-Adresse.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['kunde_id'], 'properties': {'bis': {'type': 'string', 'description': 'Spätestes Leistungsdatum, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Frühestes Leistungsdatum, JJJJ-MM-TT.'}, 'datum': {'type': 'string', 'description': 'Rechnungsdatum, JJJJ-MM-TT. Ohne Angabe heute.'}, 'kunde_id': {'type': 'string', 'description': 'Wessen Leistungen abgerechnet werden.'}, 'verdichten': {'type': 'boolean', 'description': 'VORGABE JA. Die Rechnung zeigt dann eine Position je Leistungsart und die Anlage „Leistungsnachweis“ die Aufschlüsselung je Tag – so macht es jedes CRM. Auf false gesetzt trägt jede Leistung ihre eigene Position mit Datum; dann entfällt die Anlage, weil sie dieselben Zeilen doppelt zeigte.'}, 'leistung_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Genau diese Posten. Ohne Angabe alle offenen des Kunden im Zeitraum.'}, 'vorgangsnummer': {'type': 'string', 'description': 'Eure Vorgangsnummer als Wiederholungsschutz.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'bis': {'type': 'string', 'description': 'Spätestes Leistungsdatum, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Frühestes Leistungsdatum, JJJJ-MM-TT.'}, 'kunde_id': {'type': 'string', 'description': 'Nur die Leistungen dieses Kunden.'}, 'gruppiert': {'type': 'boolean', 'description': 'true = Summe je Kunde (die Monatsabschluss-Sicht), false = Einzelposten.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['datum', 'bezeichnung', 'menge'], 'properties': {'datum': {'type': 'string', 'description': 'Tag der LEISTUNG (nicht der Erfassung), JJJJ-MM-TT.'}, 'kunde': {'type': 'string', 'description': 'Name des Kunden, genau wie in der Kartei. Alternativ kunde_id aus kunden_suchen.'}, 'menge': {'type': 'number', 'description': 'Dezimal, z. B. 1.5 für anderthalb Stunden.'}, 'notiz': {'type': 'string', 'description': 'Optional: erscheint nur im Leistungsnachweis, nicht auf der Position.'}, 'artikel': {'type': 'string', 'description': 'Name aus der Artikelliste – liefert Preis, Einheit und Steuersatz.'}, 'einheit': {'type': 'string', 'description': 'stunde, tag, stueck, pauschale, meter, m2, kg, liter, km. Ohne Angabe: Stunde.'}, 'kunde_id': {'type': 'string', 'description': 'Kennung aus kunden_suchen – eindeutiger als der Name.'}, 'bezeichnung': {'type': 'string', 'description': 'Was geleistet wurde. Steht später auf der Rechnung.'}, 'einzelpreis': {'type': 'number', 'description': 'Netto in Euro. Ohne Angabe der Preis des Artikels.'}, 'ust_prozent': {'type': 'number', 'description': '19, 7 oder 0. Ohne Angabe 19 bzw. der Satz des Artikels.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['leitweg_id'], 'properties': {'leitweg_id': {'type': 'string', 'description': 'Die Leitweg-ID, z. B. 991-33333-62'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'Höchstzahl der Treffer, 1 bis 100. Vorgabe 25.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'iban': {'type': 'string'}, 'netto': {'type': 'number', 'description': 'Nettobetrag in Euro, z. B. 1190.00'}, 'leistung': {'type': 'string', 'description': 'Bezeichnung der Leistung oder Ware.'}, 'aussteller': {'type': 'object', 'properties': {'ort': {'type': 'string'}, 'plz': {'type': 'string'}, 'name': {'type': 'string'}, 'strasse': {'type': 'string'}, 'steuernummer': {'type': 'string', 'description': 'Steuernummer oder USt-IdNr. des Ausstellers.'}}, 'description': 'Wer die Rechnung stellt.', 'additionalProperties': False}, 'empfaenger': {'type': 'object', 'properties': {'ort': {'type': 'string'}, 'plz': {'type': 'string'}, 'name': {'type': 'string'}, 'ust_id': {'type': 'string'}, 'strasse': {'type': 'string'}}, 'additionalProperties': False}, 'ust_prozent': {'type': 'number', 'description': '19, 7 oder 0.'}, 'leistungsdatum': {'type': 'string', 'description': 'JJJJ-MM-TT – Liefer- oder Leistungszeitpunkt.'}, 'rechnungsdatum': {'type': 'string', 'description': 'JJJJ-MM-TT'}, 'reverse_charge': {'type': 'boolean', 'description': 'Steuerschuldnerschaft des Leistungsempfängers?'}, 'rechnungsnummer': {'type': 'string'}, 'kleinunternehmer': {'type': 'boolean', 'description': 'Gilt § 19 UStG?'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['unternehmer', 'kunden', 'umsatz', 'kleinunternehmer', 'betraege'], 'properties': {'kunden': {'enum': ['b2b', 'b2c', 'beides'], 'type': 'string', 'description': 'An wen wird fakturiert?'}, 'umsatz': {'enum': ['bis800k', 'ueber800k'], 'type': 'string', 'description': 'Gesamtumsatz 2026 über oder bis 800.000 €?'}, 'betraege': {'enum': ['alle_unter_250', 'gemischt'], 'type': 'string', 'description': 'Liegen alle Rechnungen unter 250 € (Kleinbetragsrechnungen)?'}, 'unternehmer': {'enum': ['ja', 'nein'], 'type': 'string', 'description': 'Ist die Person Unternehmer im Sinne des UStG?'}, 'kleinunternehmer': {'enum': ['ja', 'nein'], 'type': 'string', 'description': 'Gilt § 19 UStG (Kleinunternehmer)?'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['rechnung_id', 'format'], 'properties': {'format': {'enum': ['zugferd', 'xrechnung', 'pdf'], 'type': 'string', 'description': 'zugferd = E-Rechnung als PDF/A-3 mit eingebettetem Datensatz (der Regelfall für „PDF-Rechnung"). xrechnung = nur der XML-Datensatz, für Behörden und zur Prüfung. pdf = Sichtdokument OHNE Datensatz, nur wenn ausdrücklich keine E-Rechnung gewünscht ist.'}, 'rechnung_id': {'type': 'string', 'description': 'Die id aus rechnung_erstellen.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'bis': {'type': 'string', 'description': 'Spätestes Rechnungsdatum, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Frühestes Rechnungsdatum, JJJJ-MM-TT.'}, 'limit': {'type': 'number', 'description': 'Höchstzahl der Treffer, 1 bis 100. Vorgabe 25.'}, 'suche': {'type': 'string', 'description': 'Teil einer Rechnungsnummer oder eines Empfängernamens.'}, 'status': {'enum': ['draft', 'open', 'paid', 'overdue', 'cancelled'], 'type': 'string', 'description': 'Zustand: draft Entwurf, open offen, paid bezahlt, overdue überfällig, cancelled storniert.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['empfaenger', 'positionen'], 'properties': {'empfaenger': {'type': 'object', 'required': ['name', 'strasse', 'plz', 'ort', 'email'], 'properties': {'ort': {'type': 'string'}, 'plz': {'type': 'string'}, 'name': {'type': 'string'}, 'email': {'type': 'string', 'description': 'E-Mail des Empfängers. PFLICHT für eine XRechnung (BT-49) – ohne sie weist der Normprüfer ab. Steht sie in der Kundenkartei, kommt sie aus kunden_suchen.'}, 'ust_id': {'type': 'string', 'description': 'USt-IdNr. des Empfängers, z. B. bei Reverse Charge.'}, 'strasse': {'type': 'string'}, 'leitweg_id': {'type': 'string', 'description': 'Leitweg-ID des öffentlichen Auftraggebers (BT-10), z. B. 991-33333-62. Pflicht bei Rechnungen an Behörden; die Prüfziffer wird nachgerechnet.'}}, 'description': 'Der Rechnungsempfänger.', 'additionalProperties': False}, 'positionen': {'type': 'array', 'items': {'type': 'object', 'required': ['bezeichnung', 'menge', 'einzelpreis', 'ust_prozent'], 'properties': {'menge': {'type': 'number', 'description': 'Dezimal, z. B. 2 oder 1.5'}, 'einheit': {'type': 'string', 'description': 'stueck, stunde, tag, pauschale, meter, m2, kg, liter, km – oder direkt ein UN/ECE-Code wie C62/HUR.'}, 'bezeichnung': {'type': 'string'}, 'einzelpreis': {'type': 'number', 'description': 'Netto in Euro, z. B. 95.00'}, 'ust_prozent': {'type': 'number', 'description': '19, 7 oder 0.'}, 'steuerkategorie': {'enum': ['S', 'Z', 'E', 'AE', 'K', 'G', 'O'], 'type': 'string', 'description': 'Nur bei 0 % nötig: E befreit, AE Reverse Charge, K innergemeinschaftlich, G Ausfuhr, Z Nullsatz, O nicht steuerbar.'}}, 'additionalProperties': False}, 'minItems': 1}, 'bestellnummer': {'type': 'string', 'description': 'Eure Vorgangsnummer. Dient als Idempotency-Key und als Käuferreferenz auf der Rechnung.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'xml': {'type': 'string', 'description': 'Der XML-Inhalt der E-Rechnung als Text (XRechnung/UBL oder CII). Entweder dieses Feld ODER datei_base64.'}, 'dateiname': {'type': 'string', 'description': 'Dateiname mit Endung (.xml oder .pdf) – daraus wird der Typ bestimmt. Vorgabe: rechnung.xml'}, 'datei_base64': {'type': 'string', 'description': 'Die Datei Base64-kodiert – nötig für ZUGFeRD-PDF, geht auch für XML.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'xml': {'type': 'string', 'description': 'Der XML-Inhalt der E-Rechnung als Text (XRechnung/UBL oder CII). Entweder dieses Feld ODER datei_base64.'}, 'dateiname': {'type': 'string', 'description': 'Dateiname mit Endung (.xml oder .pdf) – daraus wird der Typ bestimmt. Vorgabe: rechnung.xml'}, 'datei_base64': {'type': 'string', 'description': 'Die Datei Base64-kodiert – nötig für ZUGFeRD-PDF, geht auch für XML.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['von', 'bis'], 'properties': {'bis': {'type': 'string', 'description': 'Letzter Tag des Zeitraums, JJJJ-MM-TT.'}, 'von': {'type': 'string', 'description': 'Erster Tag des Zeitraums, JJJJ-MM-TT.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['rechnung_id'], 'properties': {'datum': {'type': 'string', 'description': 'Tag des Geldeingangs laut Kontoauszug, JJJJ-MM-TT. Ohne Angabe heute.'}, 'betrag': {'type': 'number', 'description': 'Betrag in Euro, z. B. 119.00. Ohne Angabe der offene Rest.'}, 'vorgang': {'type': 'string', 'description': 'Eigene Vorgangsnummer zur Wiederholungssicherung: Derselbe Wert verbucht die Zahlung KEIN zweites Mal.'}, 'rechnung_id': {'type': 'string', 'description': 'Die id aus rechnungen_suchen oder rechnung_erstellen.'}}, 'additionalProperties': False}