# Ukraine
> Ukrainische Belege: рахунок, акт und податкова накладна nach Art, ЄДРПОУ, РНОКПП und ІПН mit ihren Prüfziffern, ПДВ, Datum und UAH.
>
> Vorher: [Der Beleg](https://ocost.io/docs/de/document.md)

Was Ocost auf einem ukrainischen Beleg liest und wo es das in [`ocost.document.v1`](https://ocost.io/docs/de/document.md) schreibt. Eine Vorlage braucht es nicht. Belege auf Russisch liest Ocost genauso.

## Belege

| Gedruckt als | `kind` | `kind_detail` |
| --- | --- | --- |
| рахунок, рахунок на оплату, рахунок-фактура | `invoice` | `invoice` |
| акт виконаних робіт, акт наданих послуг, акт приймання-передачі | `other` | `acceptance_protocol` |
| видаткова накладна, товарна накладна | `delivery_note` | `delivery_note` |
| податкова накладна | `tax_invoice` | `tax_invoice` |
| квитанція | `receipt` | `receipt` |
| договір | `contract` | `contract` |

Ein акт hat Preise wie eine Rechnung: Beträge, Steuer, Positionen, den Leistungszeitraum und den Vertrag in `contract_reference`. Er belegt, dass die Arbeit getan ist. Bezahlt wird der рахунок, also bucht Ocost den акт nie als zweite Rechnung.

Eine податкова накладна ist der Steuernachweis des Verkäufers und wird nie bezahlt. `tax_registration` enthält ihre Nummer und ihr Datum im ЄРПН, wo gedruckt. `preceding_invoice` nennt den рахунок oder акт, zu dem sie gehört.

Eine видаткова накладна trägt Preise, Steuer und Summen, wo gedruckt. Ocost prüft sie wie die Summen einer Rechnung. Für eine товарно-транспортна накладна gibt es noch keine eigene Regel.

## Kennungen

Ocost schreibt jede Nummer nach `scheme` in die `identifiers` der Partei:

| Gedruckt als | `scheme` | `valid` |
| --- | --- | --- |
| код ЄДРПОУ | `UA_EDRPOU` | 8 Ziffern und ihre Prüfziffer |
| РНОКПП, einer Person oder eines ФОП | `UA_RNOKPP` | 10 Ziffern und ihre Prüfziffer |
| ІПН платника ПДВ | `UA_IPN` | 12 Ziffern. Eine Prüfziffer gibt es nicht, die richtige Länge ist also `null`. |

Eine Nummer, die durchfällt, bleibt mit `valid: false`, und die Prüfung `identifier` schlägt fehl, `at` ihr Schema. Ocost findet nie eine Firma an ihr. `tax_registration_id` kann eine dieser Nummern wiederholen, lesen Sie also `identifiers`.

Eine IBAN mit `UA` prüft Ocost an ihren Prüfziffern, in `iban`.

## Umsatzsteuer

Ocost liest die Sätze der ПДВ, die ein Beleg druckt, etwa 20 %, 14 %, 7 % oder 0 %. 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.

Ein Verkäufer, der kein Steuerzahler der ПДВ ist, druckt „Без ПДВ“. Ocost liest dann keine Steuer, und die Prüfung `gross` vergleicht Netto und Brutto.

`tax_check` ist für Ihr ukrainisches Unternehmen gefüllt, wenn Ukraines Register den Lieferanten als keinen ПДВ-Zahler führt, die Rechnung oder Quittung aber ПДВ berechnet. `missing` enthält dann `vat_non_payer` mit `law` п. 198.6 ст. 198 ПКУ: Diese ПДВ ist kein Steuerkredit. `at_stake` ist `true`, wenn Ihr Unternehmen Vorsteuer abzieht. Sonst ist `tax_check` `null`. Andere ukrainische Rechnungsregeln prüft Ocost nicht, wohl aber die Summen, die Positionen, die Daten, die IBAN und die Kennungen.

## E-Rechnungen

Ein ukrainisches XML-Format liest Ocost noch nicht. Schicken Sie das PDF oder einen Scan, `read_with` ist dann `reader`.

## Datum, Beträge und Sprache

Ukrainische Belege drucken `03.11.2026` und `1 200,00`. Ocost schreibt `2026-11-03` und `1200`. `sources` behält das Zitat wie gedruckt.

`currency` ist `UAH`, wo der Beleg `UAH`, `₴` oder `грн` druckt. Wo er gar keine Währung druckt, nimmt Ocost die übliche des Lieferanten, sonst die Ihres Unternehmens.

Einheiten werden UNECE-Codes: шт. ist `C62`, кг `KGM`, год. `HUR`, послуга `E48`. [Einheiten und Codes](https://ocost.io/docs/de/units.md) listet sie. Namen und Positionen bleiben in den Worten des Belegs.

## Ihr Unternehmen

Ocost unterscheidet Eingang und Ausgang an Ihren Angaben in [Einstellungen › Unternehmen](https://app.ocost.io/settings/company). Ein ukrainisches Unternehmen braucht seinen ЄДРПОУ, ein ФОП seinen РНОКПП, und seine Anschrift. Die ІПН tragen Sie erst ein, wenn Sie Steuerzahler der ПДВ sind.

Ocost füllt einen leeren ЄДРПОУ, eine leere ІПН oder Anschrift 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 ТОВ oder ФОП, in lateinischen Buchstaben nach der amtlichen ukrainischen Transliteration (КМУ № 55, 2010): ТОВ «Охорона-Київ» erhält `okhorona-kyiv`.

## Beispiel

Ein Auszug eines акт наданих послуг:

```json
{
  "kind": "other",
  "kind_detail": "acceptance_protocol",
  "number": "А-7",
  "issue_date": "2026-10-31",
  "invoicing_period_start": "2026-10-01",
  "invoicing_period_end": "2026-10-31",
  "currency": "UAH",
  "contract_reference": "Д-2026/3",
  "seller": {
    "name": "ТОВ «Приклад Сервіс»",
    "identifiers": [
      { "scheme": "UA_EDRPOU", "value": "42135797", "valid": true },
      { "scheme": "UA_IPN", "value": "421357926541", "valid": null }
    ],
    "vat_id": null
  },
  "buyer": {
    "name": "ФОП Зразок Олена",
    "identifiers": [
      { "scheme": "UA_RNOKPP", "value": "3141592650", "valid": true }
    ],
    "vat_id": null
  },
  "totals": { "net": 10000, "tax": 2000, "gross": 12000, "payable": null, "prices_include_vat": false },
  "vat_breakdown": [
    { "category": "S", "rate": 20, "taxable_amount": 10000, "tax_amount": 2000, "exemption_reason": null }
  ],
  "lines": [
    { "id": "1", "name": "Консультаційні послуги", "quantity": 40, "unit": "HUR", "price": 250, "net_amount": 10000, "vat_rate": 20 }
  ],
  "checks": [
    { "name": "vat", "passed": true, "sums": true, "fields": ["totals.net", "totals.tax"], "at": "20" },
    { "name": "identifier", "passed": true, "sums": false, "fields": [], "at": "UA_EDRPOU" },
    { "name": "identifier", "passed": true, "sums": false, "fields": [], "at": "UA_RNOKPP" }
  ],
  "tax_check": null,
  "read_with": "reader"
}
```

## Siehe auch

- [Der Beleg](https://ocost.io/docs/de/document.md): Das Schema ocost.document.v1 in den Begriffen der EN 16931 (auf UBL und CII abbildbar): ein Beispiel, Art und Richtung, Quellen, Prüfungen, Versionen und jedes Feld und jeder Wert.
- [Einheiten und Codes](https://ocost.io/docs/de/units.md): Die Codelisten des Belegs: UNECE-Einheiten mit ihren gedruckten Wörtern, ISO-Währungen und -Länder, Steuerkategorien, Zahlungsarten, Belegarten, Kennungen, ECLASS.
- [Unternehmensgruppen](https://ocost.io/docs/de/groups.md): Unternehmensgruppen: welche Gesellschaften ein Schlüssel erreicht, der Header Ocost-Business, das Umleiten nach den Kennungen des Belegs, needs_company und Dateien in der Gruppe.
- Auf ocost.io: [Rechnungsverarbeitung](https://ocost.io/produkt/rechnungsverarbeitung)
