Germany

What Ocost reads on a German document and where it writes it in ocost.document.v1.

What Ocost reads in Germany and in Ukraine
GermanyUkraine
DocumentsRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
IdentifiersUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
VAT rates19 %, 7 %20 %, 14 %, 7 %, 0 %
E-invoicesXRechnung, ZUGFeRD, Factur-X, without a modelNo XML format yet: send the PDF or a scan
Accountant's exportDATEV1С / BAS

Documents

Printed askindkind_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

A Gutschrift can mean two things. One that takes back an invoice is a credit_note. One the customer writes instead of the supplier's invoice is a credit_invoice, and attention holds self_billed.

Identifiers

Printed asFieldCheck
USt-IdNr. (DE and nine digits)vat_id, identifiers as EU_VATCheck vat_id: its format. Ocost doesn't ask VIES.
Steuernummertax_registration_id, identifiers as DE_STNRNone
Handelsregister: HRB or HRA with its courtlegal_registration_id, identifiers as COMMERCIAL_REGISTERNone. Kept only when it names a register and a number.
Leitweg-IDbuyer_referenceRead from an XRechnung only
IBANpayment.ibanCheck iban: its check digits

VAT

Ocost reads the rates a document prints, usually 19 % and 7 %. Each rate is one vat_breakdown group. The check vat holds when a group's VAT is its net times its rate.

CategoryOn a German document
S19 % or 7 %
Z0 %
ESteuerfrei (§ 4 UStG), with the reason printed
AE§ 13b UStG: "Steuerschuldnerschaft des Leistungsempfängers"
KInnergemeinschaftliche Lieferung
GExport outside the EU
ONicht steuerbar

The invoice check

tax_check holds what an incoming invoice lacks for the input VAT deduction. Ocost fills it when your business and the supplier are in Germany. Ocost takes the supplier's country from its address, else from its VAT ID. It covers invoices to pay and receipts up to 250 €. For anything else it is null.

caseWhat Ocost asks for
standard§ 14 Abs. 4 UStG: both parties' names and addresses, your business as recipient, the supplier's tax number or VAT ID, date, number, goods or services, service date and net. Then the rate and the VAT.
small§ 33 UStDV, up to 250 € gross: the supplier's name and address, date, goods or services, and the rate
reverse_chargeThe standard items up to the net, and the note that you owe the VAT
intra_euThe standard items up to the net, the note, and both VAT IDs
exemptThe standard items up to the net, and the reason it is exempt

Each item in missing names its law. at_stake is true when it costs the deduction. vat_charged flags German VAT you owe yourself under § 13b. It isn't deductible, and paying it pays it twice. Ocost holds such an invoice for a person.

E-invoices

Ocost reads XRechnung in UBL and CII, and ZUGFeRD or Factur-X, without a model. It takes the XML alone or from inside the PDF. read_with is e_invoice, and every value is checked.

Dates, amounts and language

German documents print 03.11.2026 and 1.270,92 €. Ocost writes 2026-11-03, 1270.92 and EUR. sources keeps the quote as printed. Skonto terms go to early_payment_discounts. Names and lines stay in the document's words.

Your company

Ocost tells incoming from outgoing by your details in Settings › Company. A German company needs its address and its VAT ID or Steuernummer. A GmbH, UG, AG, KG, OHG or e.K. adds its register court and number.

Ocost fills an empty field from your documents and the group's, where an exact identifier names you. It never overwrites a value.

Mail to belege@<name>.ocost.io reaches Ocost: your name without its legal form, umlauts written out, such as mueller-bau.

Example

An excerpt of an incoming invoice:

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

See also