# Ukraine
> Ukrainian documents: рахунок, акт and податкова накладна by kind, ЄДРПОУ, РНОКПП and ІПН with their check digits, ПДВ, dates and UAH.
>
> Before: [The document](https://ocost.io/docs/en/document.md)

What Ocost reads on a Ukrainian document and where it writes it in [`ocost.document.v1`](https://ocost.io/docs/en/document.md). No template is needed. Documents in Russian are read the same way.

## Documents

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

An акт is priced like an invoice: amounts, VAT, lines, the service period and the contract in `contract_reference`. It proves the work was done. The рахунок is what you pay, so Ocost never books the акт as a second invoice.

A податкова накладна is the seller's VAT evidence, never paid. `tax_registration` holds its number and date in ЄРПН, where printed. `preceding_invoice` names the рахунок or акт it is for.

A видаткова накладна carries prices, VAT and totals where printed. Ocost checks them as an invoice's sums. A товарно-транспортна накладна has no rule of its own yet.

## Identifiers

Ocost writes each number to the party's `identifiers` by `scheme`:

| Printed as | `scheme` | `valid` |
| --- | --- | --- |
| код ЄДРПОУ | `UA_EDRPOU` | 8 digits and its check digit |
| РНОКПП, of a person or ФОП | `UA_RNOKPP` | 10 digits and its check digit |
| ІПН платника ПДВ | `UA_IPN` | 12 digits. There is no check digit, so a right length is `null`. |

A number that fails is kept with `valid: false`, and the check `identifier` fails with `at` its scheme. Ocost never finds a company by it. `tax_registration_id` may repeat one of these numbers, so read `identifiers`.

An IBAN starting `UA` is checked by its check digits, in `iban`.

## VAT

Ocost reads the ПДВ rates a document prints, such as 20 %, 14 %, 7 % or 0 %. Each rate is one `vat_breakdown` group. The check `vat` holds when a group's VAT is its net times its rate.

A seller who isn't a VAT payer prints "Без ПДВ". Ocost then reads no VAT, and the check `gross` compares the net with the gross.

`tax_check` is filled for your Ukrainian business when Ukraine's register says the supplier is no VAT payer, yet the invoice or receipt charges ПДВ. `missing` then holds `vat_non_payer` with `law` п. 198.6 ст. 198 ПКУ: that ПДВ is no tax credit. `at_stake` is `true` when your business deducts input VAT. Otherwise `tax_check` is `null`. Ocost checks no other Ukrainian invoice rule, but it checks the sums, the lines, the dates, the IBAN and the identifiers.

## E-invoices

Ocost reads no Ukrainian XML format yet. Send the PDF or a scan, and `read_with` is `reader`.

## Dates, amounts and language

Ukrainian documents print `03.11.2026` and `1 200,00`. Ocost writes `2026-11-03` and `1200`. `sources` keeps the quote as printed.

`currency` is `UAH` where the document prints `UAH`, `₴` or `грн`. Where it prints no currency at all, Ocost takes the supplier's usual one, else your business's.

Units become UNECE codes: шт. is `C62`, кг `KGM`, год. `HUR`, послуга `E48`. [Units and codes](https://ocost.io/docs/en/units.md) lists them. Names and lines stay in the document's words.

## Your company

Ocost tells incoming from outgoing by your details in [Settings › Company](https://app.ocost.io/settings/company). A Ukrainian company needs its ЄДРПОУ, a ФОП its РНОКПП, and its address. Add the ІПН only once you are a VAT payer.

Ocost fills an empty ЄДРПОУ, ІПН or address 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. The name is yours without ТОВ or ФОП, in Latin letters by Ukraine's official transliteration (КМУ № 55, 2010): ТОВ «Охорона-Київ» gets `okhorona-kyiv`.

## Example

An excerpt of an акт наданих послуг:

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

## See also

- [The document](https://ocost.io/docs/en/document.md): The ocost.document.v1 schema in EN 16931 terms (maps to UBL and CII): an example, kind and direction, sources, checks, versions, and every field and value.
- [Units and codes](https://ocost.io/docs/en/units.md): The document’s code lists: UNECE units with the words printed for them, ISO currencies and countries, VAT categories, payment means, document types, identifiers, ECLASS.
- [Company groups](https://ocost.io/docs/en/groups.md): Company groups: which companies a key reaches, the Ocost-Business header, routing by the document’s identifiers, needs_company, and files across the group.
- On ocost.io: [Invoice processing](https://ocost.io/en/product/invoice-processing)
