Ukraine
What Ocost reads on a Ukrainian document and where it writes it in ocost.document.v1. No template is needed. Documents in Russian are read the same way.
| Germany | Ukraine | |
|---|---|---|
| Documents | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Identifiers | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| VAT rates | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| E-invoices | XRechnung, ZUGFeRD, Factur-X, without a model | No XML format yet: send the PDF or a scan |
| Accountant's export | DATEV | 1С / BAS |
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 lists them. Names and lines stay in the document's words.
Your company
Ocost tells incoming from outgoing by your details in 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 акт наданих послуг:
{
"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"
}