# Німеччина
> Німецькі документи: від Rechnung до Lieferschein за видом, USt-IdNr. і Steuernummer, категорії ПДВ, перевірка за § 14 UStG, XRechnung і ZUGFeRD.
>
> Спершу: [Документ](https://ocost.io/docs/uk/document.md)

Що Ocost читає в німецькому документі і куди записує це в [`ocost.document.v1`](https://ocost.io/docs/uk/document.md).

## Документи

| Надруковано як | `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` |

Gutschrift може означати дві речі. Та, що сторнує рахунок, — це `credit_note`. Та, яку клієнт виписує замість рахунку постачальника, — це `credit_invoice`, і `attention` містить `self_billed`.

## Ідентифікатори

| Надруковано як | Поле | Перевірка |
| --- | --- | --- |
| USt-IdNr. (`DE` і дев’ять цифр) | `vat_id`, `identifiers` як `EU_VAT` | Перевірка `vat_id`: формат. Ocost не звертається до VIES. |
| Steuernummer | `tax_registration_id`, `identifiers` як `DE_STNR` | Немає |
| Handelsregister: HRB або HRA із судом | `legal_registration_id`, `identifiers` як `COMMERCIAL_REGISTER` | Немає. Зберігається, лише коли названо реєстр і номер. |
| Leitweg-ID | `buyer_reference` | Читається лише з XRechnung |
| IBAN | `payment.iban` | Перевірка `iban`: контрольні цифри |

## ПДВ

Ocost читає ставки, надруковані в документі, зазвичай 19 % і 7 %. Кожна ставка — одна група `vat_breakdown`. Перевірка `vat` проходить, коли ПДВ групи дорівнює її сумі нетто, помноженій на ставку.

| Категорія | У німецькому документі |
| --- | --- |
| `S` | 19 % або 7 % |
| `Z` | 0 % |
| `E` | Steuerfrei (§ 4 UStG), з надрукованою причиною |
| `AE` | § 13b UStG: "Steuerschuldnerschaft des Leistungsempfängers" |
| `K` | Innergemeinschaftliche Lieferung |
| `G` | Експорт за межі ЄС |
| `O` | Nicht steuerbar |

## Перевірка рахунку

`tax_check` містить те, чого бракує вхідному рахунку для відрахування вхідного ПДВ. Ocost заповнює його, коли ваша компанія і постачальник перебувають у Німеччині. Країну постачальника Ocost бере з його адреси, а якщо її немає, з його номера ПДВ. Він охоплює рахунки до оплати і чеки до 250 €. Для всього іншого він `null`.

| `case` | Чого вимагає Ocost |
| --- | --- |
| `standard` | § 14 Abs. 4 UStG: назви й адреси обох сторін, ваша компанія як отримувач, Steuernummer або USt-IdNr. постачальника, дата, номер, товари чи послуги, дата постачання і сума нетто. Потім ставка і ПДВ. |
| `small` | § 33 UStDV, до 250 € брутто: назва й адреса постачальника, дата, товари чи послуги і ставка |
| `reverse_charge` | Стандартні пункти до суми нетто і примітка, що ПДВ сплачуєте ви |
| `intra_eu` | Стандартні пункти до суми нетто, примітка й обидва номери USt-IdNr. |
| `exempt` | Стандартні пункти до суми нетто і причина звільнення |

Кожен пункт у `missing` називає свою норму в `law`. `at_stake` дорівнює `true`, коли через нього втрачається відрахування. `vat_charged` позначає німецький ПДВ, який за § 13b ви сплачуєте самі. Його не можна відрахувати, а сплативши його, ви сплачуєте його двічі. Ocost залишає такий рахунок на перевірку людині.

## Електронні рахунки

Ocost читає XRechnung в UBL і CII, а також ZUGFeRD або Factur-X, без моделі. Він бере XML окремо або зсередини PDF. `read_with` дорівнює `e_invoice`, і кожне значення має `checked`.

## Дати, суми і мова

Німецькі документи друкують `03.11.2026` і `1.270,92 €`. Ocost пише `2026-11-03`, `1270.92` і `EUR`. `sources` зберігає цитату так, як її надруковано. Умови Skonto потрапляють до `early_payment_discounts`. Назви й рядки залишаються словами документа.

## Ваша компанія

Ocost відрізняє вхідні документи від вихідних за вашими даними в [Налаштуваннях › Реквізити](https://app.ocost.io/settings/company). Німецькій компанії потрібні адреса і USt-IdNr. або Steuernummer. GmbH, UG, AG, KG, OHG чи e.K. додає свій реєстровий суд і номер.

Ocost заповнює порожнє поле з ваших документів і документів групи, де вас називає точний ідентифікатор. Наявне значення він ніколи не перезаписує.

Пошта на `belege@<name>.ocost.io` надходить до Ocost. Ім’я — ваша назва без організаційно-правової форми, з розписаними умлаутами, наприклад `mueller-bau`.

## Приклад

Уривок вхідного рахунку:

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

## Див. також

- [Документ](https://ocost.io/docs/uk/document.md): Схема ocost.document.v1 у термінах EN 16931 (відображається на UBL і CII): приклад, вид і напрям, джерела, перевірки, версії, кожне поле і значення.
- [Одиниці та коди](https://ocost.io/docs/uk/units.md): Списки кодів документа: одиниці UNECE з їхніми друкованими словами, валюти й країни ISO, категорії ПДВ, способи оплати, види документів, коди, ECLASS.
- [Групи компаній](https://ocost.io/docs/uk/groups.md): Групи компаній: яких компаній сягає ключ, заголовок Ocost-Business, перенаправлення за кодами документа, needs_company і файли в групі.
- На ocost.io: [E-invoicing](https://ocost.io/en/product/e-invoicing), [DATEV export](https://ocost.io/en/product/datev-export)
