Ucraina
Ce citește Ocost pe un document ucrainean și unde scrie în ocost.document.v1. Nu este nevoie de niciun șablon. Documentele în limba rusă se citesc la fel.
| Germania | Ucraina | |
|---|---|---|
| Documente | Rechnung, Gutschrift, Lieferschein, Auftragsbestätigung | рахунок, акт, видаткова накладна, податкова накладна |
| Identificatori | USt-IdNr., Steuernummer, HRB | ЄДРПОУ, РНОКПП, ІПН |
| Cote de TVA | 19 %, 7 % | 20 %, 14 %, 7 %, 0 % |
| Facturi electronice | XRechnung, ZUGFeRD, Factur-X, fără model | Încă niciun format XML: trimiteți PDF-ul sau o scanare |
| Export pentru contabil | DATEV | 1С / BAS |
Documente
| Tipărit ca | kind | kind_detail |
|---|---|---|
| рахунок, рахунок на оплату, рахунок-фактура | invoice | invoice |
| акт виконаних робіт, акт наданих послуг, акт приймання-передачі | other | acceptance_protocol |
| видаткова накладна, товарна накладна | delivery_note | delivery_note |
| податкова накладна | tax_invoice | tax_invoice |
| квитанція | receipt | receipt |
| договір | contract | contract |
Un акт are prețuri ca o factură: sume, TVA, linii, perioada serviciului și contractul în contract_reference. El dovedește că lucrarea a fost făcută. рахунок este ceea ce plătiți, așa că Ocost nu înregistrează niciodată un акт ca a doua factură.
O податкова накладна este dovada de TVA a vânzătorului și nu se plătește niciodată. tax_registration conține numărul și data ei în ЄРПН, unde sunt tipărite. preceding_invoice numește рахунок sau акт pentru care a fost emisă.
O видаткова накладна poartă prețuri, TVA și totaluri, unde sunt tipărite. Ocost le verifică precum sumele unei facturi. O товарно-транспортна накладна nu are încă o regulă proprie.
Identificatori
Ocost scrie fiecare număr în identifiers ale părții, după scheme:
| Tipărit ca | scheme | valid |
|---|---|---|
| код ЄДРПОУ | UA_EDRPOU | 8 cifre și cifra de control |
| РНОКПП, al unei persoane sau al unui ФОП | UA_RNOKPP | 10 cifre și cifra de control |
| ІПН платника ПДВ | UA_IPN | 12 cifre. Nu există cifră de control, deci o lungime corectă dă null. |
Un număr care nu trece verificarea se păstrează cu valid: false, iar verificarea identifier eșuează cu at egal cu schema sa. Ocost nu găsește niciodată o companie după el. tax_registration_id poate repeta unul dintre aceste numere, deci citiți identifiers.
Un IBAN care începe cu UA este verificat după cifrele de control, în iban.
TVA
Ocost citește cotele de ПДВ pe care le tipărește un document, precum 20 %, 14 %, 7 % sau 0 %. Fiecare cotă este un grup vat_breakdown. Verificarea vat trece când TVA-ul unui grup este baza sa netă înmulțită cu cota.
Un vânzător care nu este plătitor de TVA tipărește „Без ПДВ”. Ocost nu citește atunci niciun TVA, iar verificarea gross compară suma netă cu cea brută.
tax_check este completat pentru firma dumneavoastră ucraineană când registrul Ucrainei spune că furnizorul nu este plătitor de ПДВ, dar factura sau bonul percepe ПДВ. missing conține atunci vat_non_payer cu law п. 198.6 ст. 198 ПКУ: acel ПДВ nu dă credit fiscal. at_stake este true când firma dumneavoastră deduce TVA. Altfel tax_check este null. Ocost nu verifică alte reguli ucrainene pentru facturi, dar verifică sumele, liniile, datele, IBAN-ul și identificatorii.
Facturi electronice
Ocost nu citește încă niciun format XML ucrainean. Trimiteți PDF-ul sau o scanare, iar read_with este reader.
Date, sume și limbă
Documentele ucrainene tipăresc 03.11.2026 și 1 200,00. Ocost scrie 2026-11-03 și 1200. sources păstrează citatul așa cum este tipărit.
currency este UAH acolo unde documentul tipărește UAH, ₴ sau грн. Unde nu tipărește nicio monedă, Ocost ia moneda obișnuită a furnizorului, altfel pe cea a firmei dumneavoastră.
Unitățile devin coduri UNECE: шт. este C62, кг KGM, год. HUR, послуга E48. Unități și coduri le listează. Numele și liniile rămân în cuvintele documentului.
Firma dumneavoastră
Ocost deosebește documentele primite de cele emise după datele dumneavoastră din Setări › Datele firmei. O firmă ucraineană are nevoie de ЄДРПОУ, un ФОП de РНОКПП, iar ambele de adresă. Adăugați ІПН doar după ce deveniți plătitor de TVA.
Ocost completează un ЄДРПОУ, un ІПН sau o adresă goală din documentele dumneavoastră și ale grupului, acolo unde un identificator exact vă numește. Nu suprascrie niciodată o valoare.
E-mailul trimis la belege@<name>.ocost.io ajunge la Ocost. Numele este al dumneavoastră fără ТОВ sau ФОП, în litere latine după transliterarea oficială a Ucrainei (КМУ № 55, 2010): ТОВ «Охорона-Київ» primește okhorona-kyiv.
Exemplu
Un extras dintr-un акт наданих послуг:
{
"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"
}