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.

What Ocost reads in Germany and in Ukraine
GermanyUkraine
DocumentsRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
IdentifiersUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
VAT rates19 %, 7 %20 %, 14 %, 7 %, 0 %
E-invoicesXRechnung, ZUGFeRD, Factur-X, without a modelNo XML format yet: send the PDF or a scan
Accountant's exportDATEV1С / BAS

Documents

Printed askindkind_detail
рахунок, рахунок на оплату, рахунок-фактураinvoiceinvoice
акт виконаних робіт, акт наданих послуг, акт приймання-передачіotheracceptance_protocol
видаткова накладна, товарна накладнаdelivery_notedelivery_note
податкова накладнаtax_invoicetax_invoice
квитанціяreceiptreceipt
договірcontractcontract

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 asschemevalid
код ЄДРПОУUA_EDRPOU8 digits and its check digit
РНОКПП, of a person or ФОПUA_RNOKPP10 digits and its check digit
ІПН платника ПДВUA_IPN12 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 акт наданих послуг:

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