# Единицы и коды
> Списки кодов документа: единицы UNECE с их печатными словами, валюты и страны ISO, категории НДС, способы оплаты, виды документов, коды, ECLASS.
>
> Сначала: [Документ](https://ocost.io/docs/ru/document.md)

Списки кодов, которые использует [`ocost.document.v1`](https://ocost.io/docs/ru/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/ru/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/ru/document.md#значения) перечисляет их все. Страницы стран говорят, как проверяется каждый.

## Категории

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

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

Суммы и количества — точные числа JSON, ставки — проценты, даты — ISO 8601. [Документ](https://ocost.io/docs/ru/document.md#как-записываются-значения) объясняет, как их читать.

## См. также

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