Украина

Что 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"
}

См. также