# Україна
> Українські документи: рахунок, акт і податкова накладна за видом, ЄДРПОУ, РНОКПП та ІПН з їхніми контрольними цифрами, ПДВ, дати і UAH.
>
> Спершу: [Документ](https://ocost.io/docs/uk/document.md)

Що Ocost читає в українському документі і куди записує це в [`ocost.document.v1`](https://ocost.io/docs/uk/document.md). Шаблон не потрібен. Документи російською мовою читаються так само.

## Документи

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

Акт містить ціни, як і рахунок: суми, ПДВ, рядки, період надання послуг і договір у `contract_reference`. Він підтверджує, що роботи виконано. Оплачуєте ви рахунок, тому Ocost ніколи не проводить акт як другий рахунок.

Податкова накладна — це підтвердження ПДВ від продавця, її ніколи не оплачують. `tax_registration` містить її номер і дату в ЄРПН, якщо їх надруковано. `preceding_invoice` називає рахунок або акт, до якого вона належить.

Видаткова накладна містить ціни, ПДВ і підсумки, якщо їх надруковано. Ocost перевіряє їх як суми рахунку. Для товарно-транспортної накладної окремого правила ще немає.

## Ідентифікатори

Ocost записує кожен номер до `identifiers` сторони за `scheme`:

| Надруковано як | `scheme` | `valid` |
| --- | --- | --- |
| код ЄДРПОУ | `UA_EDRPOU` | 8 цифр, перевіряється контрольна цифра |
| РНОКПП фізичної особи або ФОП | `UA_RNOKPP` | 10 цифр, перевіряється контрольна цифра |
| ІПН платника ПДВ | `UA_IPN` | 12 цифр. Контрольної цифри немає, тому за правильної довжини значення `null`. |

Номер, що не пройшов перевірку, зберігається з `valid: false`, а перевірка `identifier` не проходить, і її `at` називає схему. Ocost ніколи не шукає за таким номером компанію. `tax_registration_id` може повторювати один із цих номерів, тому читайте `identifiers`.

IBAN, що починається з `UA`, перевіряється за контрольними цифрами, у `iban`.

## ПДВ

Ocost читає ставки ПДВ, надруковані в документі, наприклад 20 %, 14 %, 7 % або 0 %. Кожна ставка — одна група `vat_breakdown`. Перевірка `vat` проходить, коли ПДВ групи дорівнює її сумі нетто, помноженій на ставку.

Продавець, який не є платником ПДВ, друкує «Без ПДВ». Тоді Ocost не читає ПДВ, а перевірка `gross` порівнює суму нетто із сумою брутто.

`tax_check` заповнюється для вашої української компанії, коли реєстр каже, що постачальник не платник ПДВ, а рахунок чи квитанція все ж нараховує ПДВ. `missing` тоді містить `vat_non_payer` з `law` п. 198.6 ст. 198 ПКУ: такий ПДВ не дає податкового кредиту. `at_stake` дорівнює `true`, коли ваша компанія відносить ПДВ до податкового кредиту. Інакше `tax_check` дорівнює `null`. Інших українських правил для рахунків Ocost не перевіряє, але перевіряє суми, рядки, дати, IBAN та ідентифікатори.

## Електронні рахунки

Ocost поки не читає жодного українського XML-формату. Надішліть PDF або скан, і `read_with` буде `reader`.

## Дати, суми і мова

Українські документи друкують `03.11.2026` і `1 200,00`. Ocost пише `2026-11-03` і `1200`. `sources` зберігає цитату так, як її надруковано.

`currency` дорівнює `UAH`, якщо документ друкує `UAH`, `₴` або `грн`. Якщо валюту не надруковано зовсім, Ocost бере звичну валюту постачальника, а якщо її немає, то валюту вашої компанії.

Одиниці стають кодами UNECE: шт. — це `C62`, кг — `KGM`, год. — `HUR`, послуга — `E48`. Їх перелічує сторінка [Одиниці та коди](https://ocost.io/docs/uk/units.md). Назви й рядки залишаються словами документа.

## Ваша компанія

Ocost відрізняє вхідні документи від вихідних за вашими даними в [Налаштуваннях › Реквізити](https://app.ocost.io/settings/company). Українській компанії потрібні її ЄДРПОУ і адреса, ФОП — РНОКПП і адреса. ІПН додайте, лише коли станете платником ПДВ.

Ocost заповнює порожні ЄДРПОУ, ІПН чи адресу з ваших документів і документів групи, де вас називає точний ідентифікатор. Наявне значення він ніколи не перезаписує.

Пошта на `belege@<name>.ocost.io` надходить до Ocost. Ім’я — ваша назва без ТОВ чи ФОП, латиницею за офіційною транслітерацією України (КМУ № 55, 2010): ТОВ «Охорона-Київ» отримує `okhorona-kyiv`.

## Приклад

Уривок акта наданих послуг:

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

## Див. також

- [Документ](https://ocost.io/docs/uk/document.md): Схема ocost.document.v1 у термінах EN 16931 (відображається на UBL і CII): приклад, вид і напрям, джерела, перевірки, версії, кожне поле і значення.
- [Одиниці та коди](https://ocost.io/docs/uk/units.md): Списки кодів документа: одиниці UNECE з їхніми друкованими словами, валюти й країни ISO, категорії ПДВ, способи оплати, види документів, коди, ECLASS.
- [Групи компаній](https://ocost.io/docs/uk/groups.md): Групи компаній: яких компаній сягає ключ, заголовок Ocost-Business, перенаправлення за кодами документа, needs_company і файли в групі.
- На ocost.io: [Invoice processing](https://ocost.io/en/product/invoice-processing)
