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.

Co Ocost odczytuje w Niemczech i na Ukrainie
NiemcyUkraina
DokumentyRechnung, Gutschrift, Lieferschein, Auftragsbestätigungрахунок, акт, видаткова накладна, податкова накладна
IdentyfikatoryUSt-IdNr., Steuernummer, HRBЄДРПОУ, РНОКПП, ІПН
Stawki VAT19 %, 7 %20 %, 14 %, 7 %, 0 %
E-fakturyXRechnung, ZUGFeRD, Factur-X, bez modeluJeszcze bez formatu XML: wyślij PDF lub skan
Eksport dla księgowegoDATEV1С / BAS

Dokumenty

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

акт 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 jakoschemevalid
код ЄДРПОУUA_EDRPOU8 cyfr i cyfra kontrolna
РНОКПП, osoby lub ФОПUA_RNOKPP10 cyfr i cyfra kontrolna
ІПН платника ПДВUA_IPN12 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 акт наданих послуг:

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

Zobacz też