Україна

Що Ocost читає в українському документі і куди записує це в ocost.document.v1. Шаблон не потрібен. Документи російською мовою читаються так само.

Що Ocost читає в Німеччині та в Україні
НімеччинаУкраїна
ДокументиRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
КодиUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
Ставки ПДВ19 %, 7 %20 %, 14 %, 7 %, 0 %
Електронні рахункиXRechnung, ZUGFeRD, Factur-X, без моделіФормату XML ще немає: надішліть PDF чи скан
Експорт для бухгалтераDATEV1С / BAS

Документи

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

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

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

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

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

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

Надруковано якschemevalid
код ЄДРПОУUA_EDRPOU8 цифр, перевіряється контрольна цифра
РНОКПП фізичної особи або ФОПUA_RNOKPP10 цифр, перевіряється контрольна цифра
ІПН платника ПДВUA_IPN12 цифр. Контрольної цифри немає, тому за правильної довжини значення 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.

Приклад

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

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

Див. також