# Ucraina
> Documente ucrainene: рахунок, акт și податкова накладна după tip, ЄДРПОУ, РНОКПП și ІПН cu cifrele lor de control, ПДВ, date și UAH.
>
> Înainte: [Documentul](https://ocost.io/docs/ro/document.md)

Ce citește Ocost pe un document ucrainean și unde scrie în [`ocost.document.v1`](https://ocost.io/docs/ro/document.md). Nu este nevoie de niciun șablon. Documentele în limba rusă se citesc la fel.

## 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](https://ocost.io/docs/ro/units.md) 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](https://app.ocost.io/settings/company). 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 акт наданих послуг:

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

## Vezi și

- [Documentul](https://ocost.io/docs/ro/document.md): Schema ocost.document.v1 în termenii EN 16931 (se mapează pe UBL și CII): un exemplu, tip și direcție, surse, verificări, versiuni și fiecare câmp și valoare.
- [Unități și coduri](https://ocost.io/docs/ro/units.md): Listele de coduri ale documentului: unități UNECE cu cuvintele lor tipărite, monede și țări ISO, categorii de TVA, modalități de plată, tipuri de documente, identificatori, ECLASS.
- [Grupuri de firme](https://ocost.io/docs/ro/groups.md): Grupuri de firme: la ce societăți ajunge o cheie, antetul Ocost-Business, redirecționarea după identificatorii documentului, needs_company și fișierele din grup.
- Pe ocost.io: [Invoice processing](https://ocost.io/en/product/invoice-processing)
