# Niemcy
> Niemieckie dokumenty: od Rechnung do Lieferschein według rodzaju, USt-IdNr. i Steuernummer, kategorie VAT, kontrola według § 14 UStG, XRechnung i ZUGFeRD.
>
> Najpierw: [Dokument](https://ocost.io/docs/pl/document.md)

Co Ocost odczytuje z niemieckiego dokumentu i gdzie to zapisuje w [`ocost.document.v1`](https://ocost.io/docs/pl/document.md).

## Dokumenty

| Drukowany jako | `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 może oznaczać dwie rzeczy. Taka, która cofa fakturę, to `credit_note`. Taka, którą klient wystawia zamiast faktury dostawcy, to `credit_invoice`, a `attention` zawiera `self_billed`.

## Identyfikatory

| Drukowany jako | Pole | Kontrola |
| --- | --- | --- |
| USt-IdNr. (`DE` i dziewięć cyfr) | `vat_id`, `identifiers` jako `EU_VAT` | Kontrola `vat_id`: jego format. Ocost nie pyta VIES. |
| Steuernummer | `tax_registration_id`, `identifiers` jako `DE_STNR` | Brak |
| Handelsregister: HRB lub HRA z sądem | `legal_registration_id`, `identifiers` jako `COMMERCIAL_REGISTER` | Brak. Zachowywany tylko wtedy, gdy wskazuje rejestr i numer. |
| Leitweg-ID | `buyer_reference` | Odczytywany tylko z XRechnung |
| IBAN | `payment.iban` | Kontrola `iban`: jego cyfry kontrolne |

## VAT

Ocost odczytuje stawki wydrukowane na dokumencie, zwykle 19 % i 7 %. Każda stawka to jedna grupa `vat_breakdown`. Kontrola `vat` przechodzi, gdy VAT grupy równa się jej kwocie netto razy stawka.

| Kategoria | Na niemieckim dokumencie |
| --- | --- |
| `S` | 19 % lub 7 % |
| `Z` | 0 % |
| `E` | Steuerfrei (§ 4 UStG), z wydrukowanym powodem |
| `AE` | § 13b UStG: „Steuerschuldnerschaft des Leistungsempfängers” |
| `K` | Innergemeinschaftliche Lieferung |
| `G` | Eksport poza UE |
| `O` | Nicht steuerbar |

## Sprawdzenie faktury

`tax_check` zawiera to, czego fakturze przychodzącej brakuje do odliczenia VAT naliczonego. Ocost wypełnia go, gdy Twoja firma i dostawca są w Niemczech. Kraj dostawcy Ocost bierze z jego adresu, a gdy go brak, z numeru VAT UE. Obejmuje faktury do zapłaty i paragony do 250 €. Dla wszystkiego innego ma wartość `null`.

| `case` | Czego Ocost wymaga |
| --- | --- |
| `standard` | § 14 Abs. 4 UStG: nazwy i adresy obu stron, Twoja firma jako odbiorca, numer podatkowy lub NIP UE dostawcy, data, numer, towary lub usługi, data wykonania usługi i kwota netto. Do tego stawka i VAT. |
| `small` | § 33 UStDV, do 250 € brutto: nazwa i adres dostawcy, data, towary lub usługi oraz stawka |
| `reverse_charge` | Standardowe elementy aż do kwoty netto i adnotacja, że VAT jesteś winien Ty |
| `intra_eu` | Standardowe elementy aż do kwoty netto, adnotacja i oba numery NIP UE |
| `exempt` | Standardowe elementy aż do kwoty netto i powód zwolnienia |

Każdy element w `missing` podaje swoje `law`. `at_stake` ma wartość `true`, gdy brak kosztuje odliczenie. `vat_charged` oznacza niemiecki VAT, który zgodnie z § 13b jesteś winien sam. Nie podlega odliczeniu, a kto go zapłaci, płaci go dwa razy. Ocost wstrzymuje taką fakturę do decyzji człowieka.

## E-faktury

Ocost odczytuje XRechnung w UBL i CII oraz ZUGFeRD lub Factur-X bez modelu. Bierze sam XML albo XML z wnętrza pliku PDF. `read_with` ma wartość `e_invoice`, a każda wartość jest `checked`.

## Daty, kwoty i język

Niemieckie dokumenty drukują `03.11.2026` i `1.270,92 €`. Ocost zapisuje `2026-11-03`, `1270.92` i `EUR`. `sources` zachowuje cytat tak, jak wydrukowano. Warunki Skonto trafiają do `early_payment_discounts`. Nazwy i pozycje zostają w słowach dokumentu.

## Twoja firma

Ocost odróżnia dokumenty przychodzące od wychodzących po Twoich danych w [Ustawienia › Firma](https://app.ocost.io/settings/company). Niemiecka firma potrzebuje adresu oraz USt-IdNr. lub Steuernummer. GmbH, UG, AG, KG, OHG lub e.K. podaje też sąd rejestrowy i numer.

Ocost uzupełnia puste pole z Twoich dokumentów i dokumentów grupy, gdy wskazuje Cię dokładny identyfikator. Nigdy nie nadpisuje wartości.

Poczta na `belege@<name>.ocost.io` trafia do Ocost. Nazwa to Twoja nazwa bez formy prawnej, z umlautami rozpisanymi na dwie litery, na przykład `mueller-bau`.

## Przykład

Fragment faktury przychodzącej:

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

## Zobacz też

- [Dokument](https://ocost.io/docs/pl/document.md): Schemat ocost.document.v1 w pojęciach EN 16931 (odwzorowywalny na UBL i CII): przykład, rodzaj i kierunek, źródła, kontrole, wersje oraz każde pole i każda wartość.
- [Jednostki i kody](https://ocost.io/docs/pl/units.md): Listy kodów dokumentu: jednostki UNECE z drukowanymi słowami, waluty i kraje ISO, kategorie VAT, sposoby płatności, rodzaje dokumentów, identyfikatory, ECLASS.
- [Grupy spółek](https://ocost.io/docs/pl/groups.md): Grupy spółek: do których spółek sięga klucz, nagłówek Ocost-Business, przekierowanie po identyfikatorach dokumentu, needs_company i pliki w grupie.
- Na ocost.io: [E-invoicing](https://ocost.io/en/product/e-invoicing), [DATEV export](https://ocost.io/en/product/datev-export)
