Ukraina
Co Ocost odczytuje z ukraińskiego dokumentu i gdzie to zapisuje w ocost.document.v1. Żaden szablon nie jest potrzebny. Dokumenty po rosyjsku są odczytywane tak samo.
| Niemcy | Ukraina | |
|---|---|---|
| Dokumenty | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Identyfikatory | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Stawki VAT | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| E-faktury | XRechnung, ZUGFeRD, Factur-X, bez modelu | Jeszcze bez formatu XML: wyślij PDF lub skan |
| Eksport dla księgowego | DATEV | 1С / BAS |
Dokumenty
| Drukowany jako | kind | kind_detail |
|---|---|---|
| рахунок, рахунок на оплату, рахунок-фактура | invoice | invoice |
| акт виконаних робіт, акт наданих послуг, акт приймання-передачі | other | acceptance_protocol |
| видаткова накладна, товарна накладна | delivery_note | delivery_note |
| податкова накладна | tax_invoice | tax_invoice |
| квитанція | receipt | receipt |
| договір | contract | contract |
акт ma ceny jak faktura: kwoty, VAT, pozycje, okres usługi i umowę w contract_reference. Potwierdza, że praca została wykonana. Płacisz рахунок, więc Ocost nigdy nie księguje акт jako drugiej faktury.
податкова накладна to dowód VAT sprzedawcy i nigdy nie jest płacona. tax_registration zawiera jej numer i datę w ЄРПН, jeśli je wydrukowano. preceding_invoice wskazuje рахунок lub акт, którego dotyczy.
видаткова накладна niesie ceny, VAT i sumy, jeśli je wydrukowano. Ocost sprawdza je jak sumy faktury. товарно-транспортна накладна nie ma jeszcze własnej reguły.
Identyfikatory
Ocost zapisuje każdy numer w identifiers strony według scheme:
| Drukowany jako | scheme | valid |
|---|---|---|
| код ЄДРПОУ | UA_EDRPOU | 8 cyfr i cyfra kontrolna |
| РНОКПП, osoby lub ФОП | UA_RNOKPP | 10 cyfr i cyfra kontrolna |
| ІПН платника ПДВ | UA_IPN | 12 cyfr. Nie ma cyfry kontrolnej, więc przy prawidłowej długości jest null. |
Numer, który nie przechodzi kontroli, zostaje zachowany z valid: false, a kontrola identifier kończy się niepowodzeniem z at równym jego schematowi. Ocost nigdy nie szuka po nim firmy. tax_registration_id może powtarzać jeden z tych numerów, więc czytaj identifiers.
IBAN zaczynający się od UA jest sprawdzany po cyfrach kontrolnych, w iban.
VAT
Ocost odczytuje stawki ПДВ wydrukowane na dokumencie, na przykład 20 %, 14 %, 7 % lub 0 %. Każda stawka to jedna grupa vat_breakdown. Kontrola vat przechodzi, gdy VAT grupy równa się jej kwocie netto razy stawka.
Sprzedawca, który nie jest płatnikiem VAT, drukuje „Без ПДВ”. Ocost nie odczytuje wtedy VAT, a kontrola gross porównuje kwotę netto z kwotą brutto.
tax_check jest wypełniany dla Twojej ukraińskiej firmy, gdy ukraiński rejestr podaje, że dostawca nie jest płatnikiem ПДВ, a faktura lub paragon nalicza ПДВ. missing zawiera wtedy vat_non_payer z law п. 198.6 ст. 198 ПКУ: taki ПДВ nie daje kredytu podatkowego. at_stake ma wartość true, gdy Twoja firma odlicza VAT naliczony. W innych przypadkach tax_check ma wartość null. Ocost nie sprawdza innych ukraińskich przepisów o fakturach, ale sprawdza sumy, pozycje, daty, IBAN i identyfikatory.
E-faktury
Ocost nie odczytuje jeszcze żadnego ukraińskiego formatu XML. Wyślij PDF lub skan, a read_with będzie miało wartość reader.
Daty, kwoty i język
Ukraińskie dokumenty drukują 03.11.2026 i 1 200,00. Ocost zapisuje 2026-11-03 i 1200. sources zachowuje cytat tak, jak wydrukowano.
currency to UAH, gdy dokument drukuje UAH, ₴ lub грн. Gdy nie drukuje żadnej waluty, Ocost bierze zwykłą walutę dostawcy, a w przeciwnym razie walutę Twojej firmy.
Jednostki stają się kodami UNECE: шт. to C62, кг KGM, год. HUR, послуга E48. Jednostki i kody je wymieniają. Nazwy i pozycje zostają w słowach dokumentu.
Twoja firma
Ocost odróżnia dokumenty przychodzące od wychodzących po Twoich danych w Ustawienia › Firma. Ukraińska firma potrzebuje swojego ЄДРПОУ, ФОП swojego РНОКПП, a obie adresu. ІПН dodaj dopiero wtedy, gdy jesteś płatnikiem VAT.
Ocost uzupełnia pusty ЄДРПОУ, ІПН lub adres z Twoich dokumentów i dokumentów grupy, gdy wskazuje Cię dokładny identyfikator. Nigdy nie nadpisuje wartości.
Poczta na belege@<name>.ocost.io trafia do Ocost. Nazwa to Twoja nazwa bez ТОВ lub ФОП, łacinką według oficjalnej ukraińskiej transliteracji (КМУ № 55, 2010): ТОВ «Охорона-Київ» dostaje okhorona-kyiv.
Przykład
Fragment акт наданих послуг:
{
"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"
}