Украина
Что 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"
}