Deutschland
Was Ocost auf einem deutschen Beleg liest und wo es das in ocost.document.v1 schreibt.
| Deutschland | Ukraine | |
|---|---|---|
| Belege | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Kennungen | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Steuersätze | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| E-Rechnungen | XRechnung, ZUGFeRD, Factur-X, ohne Modell | Noch kein XML-Format: PDF oder Scan schicken |
| Export für die Buchhaltung | DATEV | 1С / BAS |
Belege
| Gedruckt als | kind | kind_detail |
|---|---|---|
| Rechnung | invoice | invoice |
| Abschlagsrechnung, Teilrechnung | invoice | partial_invoice |
| Schlussrechnung | invoice | final_invoice |
| Anzahlungsrechnung | invoice | advance_payment_invoice |
| Gutschrift im Gutschriftverfahren | invoice | credit_invoice |
| Gutschrift, Storno | credit_note | credit_note |
| Rechnungskorrektur | invoice_correction | invoice_correction |
| Proforma-Rechnung | pro_forma | pro_forma_invoice |
| Quittung, Kassenbon | receipt | receipt |
| Lieferschein | delivery_note | delivery_note |
| Bestellung, Auftrag | order | order |
| Auftragsbestätigung | order_confirmation | order_confirmation |
| Angebot | quote | offer |
| Vertrag, Mietvertrag | contract | contract, lease_contract |
| Mahnung, Zahlungserinnerung | payment_reminder | payment_reminder |
| Nebenkostenabrechnung | other | cost_statement |
Eine Gutschrift kann zweierlei sein. Eine, die eine Rechnung zurücknimmt, ist eine credit_note. Eine, die der Kunde statt der Rechnung des Lieferanten schreibt, ist eine credit_invoice, und attention enthält self_billed.
Kennungen
| Gedruckt als | Feld | Prüfung |
|---|---|---|
USt-IdNr. (DE und neun Ziffern) | vat_id, identifiers als EU_VAT | Prüfung vat_id: ihr Format. Ocost fragt nicht bei VIES an. |
| Steuernummer | tax_registration_id, identifiers als DE_STNR | Keine |
| Handelsregister: HRB oder HRA mit Gericht | legal_registration_id, identifiers als COMMERCIAL_REGISTER | Keine. Nur behalten, wenn er ein Register und eine Nummer nennt. |
| Leitweg-ID | buyer_reference | Nur aus einer XRechnung gelesen |
| IBAN | payment.iban | Prüfung iban: ihre Prüfziffern |
Umsatzsteuer
Ocost liest die Sätze, die ein Beleg druckt, meist 19 % und 7 %. Jeder Satz ist eine Gruppe in vat_breakdown. Die Prüfung vat hält, wenn die Steuer einer Gruppe ihr Netto mal ihr Satz ist.
| Kategorie | Auf einem deutschen Beleg |
|---|---|
S | 19 % oder 7 % |
Z | 0 % |
E | Steuerfrei (§ 4 UStG), mit gedrucktem Grund |
AE | § 13b UStG: „Steuerschuldnerschaft des Leistungsempfängers“ |
K | Innergemeinschaftliche Lieferung |
G | Ausfuhr aus der EU |
O | Nicht steuerbar |
Die Rechnungsprüfung
tax_check enthält, was einer Eingangsrechnung für den Vorsteuerabzug fehlt. Ocost füllt es, wenn Ihr Unternehmen und der Lieferant in Deutschland sind. Das Land des Lieferanten liest Ocost aus seiner Anschrift, sonst aus seiner USt-IdNr. Es gilt für zu zahlende Rechnungen und Quittungen bis 250 €. Sonst ist es null.
case | Was Ocost verlangt |
|---|---|
standard | § 14 Abs. 4 UStG: Namen und Anschriften beider Parteien, Ihr Unternehmen als Empfänger, Steuernummer oder USt-IdNr. des Lieferanten, Datum, Nummer, Waren oder Leistungen, Leistungsdatum und Netto. Dann Satz und Steuer. |
small | § 33 UStDV, bis 250 € brutto: Name und Anschrift des Lieferanten, Datum, Waren oder Leistungen und der Satz |
reverse_charge | Die Angaben des Standards bis zum Netto und der Hinweis, dass Sie die Steuer schulden |
intra_eu | Die Angaben des Standards bis zum Netto, der Hinweis und beide USt-IdNr. |
exempt | Die Angaben des Standards bis zum Netto und der Grund der Befreiung |
Jede Angabe in missing nennt ihr law. at_stake ist true, wenn sie den Abzug kostet. vat_charged meldet deutsche Umsatzsteuer, die Sie nach § 13b selbst schulden. Sie ist nicht abziehbar, und wer sie zahlt, zahlt sie doppelt. Ocost hält eine solche Rechnung an, bis ein Mensch entscheidet.
E-Rechnungen
Ocost liest XRechnung in UBL und CII sowie ZUGFeRD und Factur-X ohne Modell. Es nimmt das XML als eigene Datei oder aus dem PDF. read_with ist e_invoice, und jeder Wert ist checked.
Datum, Beträge und Sprache
Deutsche Belege drucken 03.11.2026 und 1.270,92 €. Ocost schreibt 2026-11-03, 1270.92 und EUR. sources behält das Zitat wie gedruckt. Skonto steht in early_payment_discounts. Namen und Positionen bleiben in den Worten des Belegs.
Ihr Unternehmen
Ocost unterscheidet Eingang und Ausgang an Ihren Angaben in Einstellungen › Unternehmen. Ein deutsches Unternehmen braucht seine Anschrift und seine USt-IdNr. oder Steuernummer. Eine GmbH, UG, AG, KG, OHG oder ein e.K. nennt dazu Registergericht und Nummer.
Ocost füllt ein leeres Feld aus Ihren Belegen und denen der Gruppe, wo eine exakte Kennung Sie nennt. Einen Wert überschreibt es nie.
Post an belege@<name>.ocost.io erreicht Ocost. Der Name ist Ihrer ohne Rechtsform, Umlaute ausgeschrieben, etwa mueller-bau.
Beispiel
Ein Auszug einer Eingangsrechnung:
{
"kind": "invoice",
"kind_detail": "invoice",
"type_code": "380",
"number": "RE-2026-0412",
"currency": "EUR",
"seller": {
"name": "Beispiel Werkstatt GmbH",
"identifiers": [
{ "scheme": "EU_VAT", "value": "DE123456788", "valid": null },
{ "scheme": "DE_STNR", "value": "21/815/08150", "valid": null },
{ "scheme": "COMMERCIAL_REGISTER", "value": "Amtsgericht Köln HRB 12345", "valid": null }
],
"vat_id": "DE123456788",
"tax_registration_id": "21/815/08150",
"legal_registration_id": "Amtsgericht Köln HRB 12345"
},
"totals": { "net": 500, "tax": 95, "gross": 595, "payable": null, "prices_include_vat": false },
"vat_breakdown": [
{ "category": "S", "rate": 19, "taxable_amount": 500, "tax_amount": 95, "exemption_reason": null }
],
"early_payment_discounts": [
{ "days": 10, "percent": 2, "base_amount": null, "due_date": "2026-11-13" }
],
"tax_check": { "case": "standard", "missing": [] },
"read_with": "reader"
}