Deutschland

Was Ocost auf einem deutschen Beleg liest und wo es das in ocost.document.v1 schreibt.

Was Ocost in Deutschland und in der Ukraine liest
DeutschlandUkraine
BelegeRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
KennungenUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
Steuersätze19 %, 7 %20 %, 14 %, 7 %, 0 %
E-RechnungenXRechnung, ZUGFeRD, Factur-X, ohne ModellNoch kein XML-Format: PDF oder Scan schicken
Export für die BuchhaltungDATEV1С / BAS

Belege

Gedruckt alskindkind_detail
Rechnunginvoiceinvoice
Abschlagsrechnung, Teilrechnunginvoicepartial_invoice
Schlussrechnunginvoicefinal_invoice
Anzahlungsrechnunginvoiceadvance_payment_invoice
Gutschrift im Gutschriftverfahreninvoicecredit_invoice
Gutschrift, Stornocredit_notecredit_note
Rechnungskorrekturinvoice_correctioninvoice_correction
Proforma-Rechnungpro_formapro_forma_invoice
Quittung, Kassenbonreceiptreceipt
Lieferscheindelivery_notedelivery_note
Bestellung, Auftragorderorder
Auftragsbestätigungorder_confirmationorder_confirmation
Angebotquoteoffer
Vertrag, Mietvertragcontractcontract, lease_contract
Mahnung, Zahlungserinnerungpayment_reminderpayment_reminder
Nebenkostenabrechnungothercost_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 alsFeldPrüfung
USt-IdNr. (DE und neun Ziffern)vat_id, identifiers als EU_VATPrüfung vat_id: ihr Format. Ocost fragt nicht bei VIES an.
Steuernummertax_registration_id, identifiers als DE_STNRKeine
Handelsregister: HRB oder HRA mit Gerichtlegal_registration_id, identifiers als COMMERCIAL_REGISTERKeine. Nur behalten, wenn er ein Register und eine Nummer nennt.
Leitweg-IDbuyer_referenceNur aus einer XRechnung gelesen
IBANpayment.ibanPrü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.

KategorieAuf einem deutschen Beleg
S19 % oder 7 %
Z0 %
ESteuerfrei (§ 4 UStG), mit gedrucktem Grund
AE§ 13b UStG: „Steuerschuldnerschaft des Leistungsempfängers“
KInnergemeinschaftliche Lieferung
GAusfuhr aus der EU
ONicht 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.

caseWas 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_chargeDie Angaben des Standards bis zum Netto und der Hinweis, dass Sie die Steuer schulden
intra_euDie Angaben des Standards bis zum Netto, der Hinweis und beide USt-IdNr.
exemptDie 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:

JSON
{
  "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"
}

Siehe auch