# Ukraina
> Ukraińskie dokumenty: рахунок, акт i податкова накладна według rodzaju, ЄДРПОУ, РНОКПП i ІПН z cyframi kontrolnymi, ПДВ, daty i UAH.
>
> Najpierw: [Dokument](https://ocost.io/docs/pl/document.md)

Co Ocost odczytuje z ukraińskiego dokumentu i gdzie to zapisuje w [`ocost.document.v1`](https://ocost.io/docs/pl/document.md). Żaden szablon nie jest potrzebny. Dokumenty po rosyjsku są odczytywane tak samo.

## 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](https://ocost.io/docs/pl/units.md) 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](https://app.ocost.io/settings/company). 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ż

- [Dokument](https://ocost.io/docs/pl/document.md): Schemat ocost.document.v1 w pojęciach EN 16931 (odwzorowywalny na UBL i CII): przykład, rodzaj i kierunek, źródła, kontrole, wersje oraz każde pole i każda wartość.
- [Jednostki i kody](https://ocost.io/docs/pl/units.md): Listy kodów dokumentu: jednostki UNECE z drukowanymi słowami, waluty i kraje ISO, kategorie VAT, sposoby płatności, rodzaje dokumentów, identyfikatory, ECLASS.
- [Grupy spółek](https://ocost.io/docs/pl/groups.md): Grupy spółek: do których spółek sięga klucz, nagłówek Ocost-Business, przekierowanie po identyfikatorach dokumentu, needs_company i pliki w grupie.
- Na ocost.io: [Invoice processing](https://ocost.io/en/product/invoice-processing)
