Україна
Що Ocost читає в українському документі і куди записує це в ocost.document.v1. Шаблон не потрібен. Документи російською мовою читаються так само.
| Німеччина | Україна | |
|---|---|---|
| Документи | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Коди | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Ставки ПДВ | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| Електронні рахунки | XRechnung, ZUGFeRD, Factur-X, без моделі | Формату XML ще немає: надішліть PDF чи скан |
| Експорт для бухгалтера | DATEV | 1С / BAS |
Документи
| Надруковано як | 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. Їх перелічує сторінка Одиниці та коди. Назви й рядки залишаються словами документа.
Ваша компанія
Ocost відрізняє вхідні документи від вихідних за вашими даними в Налаштуваннях › Реквізити. Українській компанії потрібні її ЄДРПОУ і адреса, ФОП — РНОКПП і адреса. ІПН додайте, лише коли станете платником ПДВ.
Ocost заповнює порожні ЄДРПОУ, ІПН чи адресу з ваших документів і документів групи, де вас називає точний ідентифікатор. Наявне значення він ніколи не перезаписує.
Пошта на belege@<name>.ocost.io надходить до Ocost. Ім’я — ваша назва без ТОВ чи ФОП, латиницею за офіційною транслітерацією України (КМУ № 55, 2010): ТОВ «Охорона-Київ» отримує okhorona-kyiv.
Приклад
Уривок акта наданих послуг:
{
"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"
}