# Одиниці та коди
> Списки кодів документа: одиниці UNECE з їхніми друкованими словами, валюти й країни ISO, категорії ПДВ, способи оплати, види документів, коди, ECLASS.
>
> Спершу: [Документ](https://ocost.io/docs/uk/document.md)

Переліки кодів, які використовує [`ocost.document.v1`](https://ocost.io/docs/uk/document.md), стандарт за кожним і те, як Ocost переходить від надрукованого слова до коду. Значення, яке не є кодом свого переліку, дорівнює `null`, а не надрукованому тексту.

## Одиниці

`lines[].unit` — це код UNECE [Recommendation 20](https://unece.org/trade/uncefact/cl-recommendations) або пакування за Recommendation 21 як `X` і його код. Ці коди Ocost пише найчастіше:

| Код | Значення | Надруковано як |
| --- | --- | --- |
| `C62` | Одиниця, штука | Stück, Stk, St., шт., од. |
| `H87` | Штука | З електронних рахунків |
| `HUR` | Година | Std., h, год. |
| `DAY` | День | Tag, день |
| `MON` | Місяць | Monat, міс. |
| `KGM` | Кілограм | kg, кг |
| `MTR` | Метр | m, lfm, м |
| `MTK` | Квадратний метр | m², qm, м² |
| `LTR` | Літр | l, л |
| `KWH` | Кіловат-година | kWh, кВт·год |
| `SET` | Комплект | Satz, компл. |
| `LS` | Фіксована сума | pauschal, psch. |
| `E48` | Одиниця послуги | послуга |
| `XCT` | Картонна коробка | Karton, Ktn |
| `XPK` | Пакунок | Paket, VE, уп. |
| `XPX` | Палета | Palette, Pal. |

Ocost просить у моделі читання код. Німецьке, українське чи російське слово, яке вона дає натомість, перекладає на код фіксована таблиця. Слово, що не називає жодної окремої одиниці, як-от Kiste, лишається невідомим. Тоді `unit` дорівнює `null`, а не `C62`. Код електронного рахунку зберігається як є. Просте `PF` — це палета `XPX`.

## Валюти

`currency` — це код [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Надрукований знак стає своїм кодом: € — це `EUR`, £ — `GBP`, ₴ і грн — `UAH`, zł — `PLN`. Знак кількох країн, як-от $ чи kr, визначається за країною того, хто виставив документ. Якщо немає ні того, ні іншого, Ocost бере звичну валюту постачальника, а якщо її немає, то валюту вашої компанії.

## Країни

`country` адреси — це код [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html), наприклад `DE`, `UA` або `GB`.

## Категорії ПДВ

`vat_breakdown[].category` і `lines[].vat_category` — це [UNCL 5305](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/) за EN 16931: `S`, `Z`, `E`, `AE`, `K`, `G`, `O`. `L`, `M`, `B` — власні категорії Іспанії та Італії. [Значення](https://ocost.io/docs/uk/document.md#значення) пояснює кожну. Кожна сторінка країни показує, як їх там друкують.

## Способи оплати

`payment.means_code` — це [UNCL 4461](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4461/): `58` — кредитовий переказ SEPA, `59` — пряме дебетування SEPA, `48` — картка. `payment.means` каже те саме словом.

## Типи документів

`kind` і `kind_detail` — власні значення Ocost. `type_code` — це [UNCL 1001](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-inv/), наприклад `380` для рахунку або `381` для кредит-ноти. Якщо документ його не друкує, Ocost пише код його виду.

## Ідентифікатори

`identifiers[].scheme` — власний перелік Ocost, як-от `EU_VAT`, `DE_STNR`, `UA_EDRPOU`, `PL_NIP`, `US_EIN` або `MD_IDNO`. [Значення](https://ocost.io/docs/uk/document.md#значення) перелічує їх усі. Сторінки країн кажуть, як перевіряється кожен.

## Категорії

[Пошук](https://ocost.io/docs/uk/search.md) фільтрує за `category`, кодом [ECLASS](https://eclass.eu) з восьми цифр, наприклад `24000000`.

## Числа і дати

Суми й кількості — точні числа JSON, ставки — відсотки, дати — ISO 8601. [Документ](https://ocost.io/docs/uk/document.md#як-записуються-значення) пояснює, як їх читати.

## Див. також

- [Документ](https://ocost.io/docs/uk/document.md): Схема ocost.document.v1 у термінах EN 16931 (відображається на UBL і CII): приклад, вид і напрям, джерела, перевірки, версії, кожне поле і значення.
- [Пошук](https://ocost.io/docs/uk/search.md): Шукати в усіх документах за словами і за змістом: параметри, фільтри, результати, приклади.
- [Німеччина](https://ocost.io/docs/uk/germany.md): Німецькі документи: від Rechnung до Lieferschein за видом, USt-IdNr. і Steuernummer, категорії ПДВ, перевірка за § 14 UStG, XRechnung і ZUGFeRD.
