# Jednostki i kody
> 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.
>
> Najpierw: [Dokument](https://ocost.io/docs/pl/document.md)

Listy kodów, których używa [`ocost.document.v1`](https://ocost.io/docs/pl/document.md), standard za każdą z nich i to, jak Ocost przechodzi od wydrukowanego słowa do kodu. Wartość, która nie jest kodem swojej listy, to `null`, nigdy wydrukowany tekst.

## Jednostki

`lines[].unit` to kod z UNECE [Recommendation 20](https://unece.org/trade/uncefact/cl-recommendations) albo opakowanie z Recommendation 21 jako `X` i jego kod. Te Ocost zapisuje najczęściej:

| Kod | Znaczenie | Drukowane jako |
| --- | --- | --- |
| `C62` | Jeden, sztuka | Stück, Stk, St., шт., од. |
| `H87` | Sztuka | Z e-faktur |
| `HUR` | Godzina | Std., h, год. |
| `DAY` | Dzień | Tag, день |
| `MON` | Miesiąc | Monat, міс. |
| `KGM` | Kilogram | kg, кг |
| `MTR` | Metr | m, lfm, м |
| `MTK` | Metr kwadratowy | m², qm, м² |
| `LTR` | Litr | l, л |
| `KWH` | Kilowatogodzina | kWh, кВт·год |
| `SET` | Komplet | Satz, компл. |
| `LS` | Ryczałt | pauschal, psch. |
| `E48` | Jednostka usługi | послуга |
| `XCT` | Karton | Karton, Ktn |
| `XPK` | Paczka | Paket, VE, уп. |
| `XPX` | Paleta | Palette, Pal. |

Ocost prosi model odczytu o kod. Niemieckie, ukraińskie lub rosyjskie słowo, które model poda zamiast kodu, mapuje stała tabela. Słowo, które nie oznacza jednej jednostki, na przykład Kiste, pozostaje nieznane. `unit` ma wtedy wartość `null`, nigdy `C62`. Kod z e-faktury zostaje bez zmian. Samo `PF` to paleta `XPX`.

## Waluty

`currency` to kod [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Wydrukowany znak staje się swoim kodem: € to `EUR`, £ `GBP`, ₴ i грн `UAH`, zł `PLN`. Znak używany w kilku krajach, na przykład $ lub kr, zależy od kraju wystawcy. Bez obu Ocost bierze zwykłą walutę dostawcy, a w przeciwnym razie walutę Twojej firmy.

## Kraje

`country` adresu to kod [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html), na przykład `DE`, `UA` lub `GB`.

## Kategorie VAT

`vat_breakdown[].category` i `lines[].vat_category` to [UNCL 5305](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/) w użyciu EN 16931: `S`, `Z`, `E`, `AE`, `K`, `G`, `O` oraz `L`, `M`, `B` dla własnych kategorii Hiszpanii i Włoch. [Wartości](https://ocost.io/docs/pl/document.md#wartosci) objaśniają każdą. Strona każdego kraju pokazuje, jak się je tam drukuje.

## Sposoby płatności

`payment.means_code` to [UNCL 4461](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4461/): `58` to polecenie przelewu SEPA, `59` polecenie zapłaty SEPA, `48` karta. `payment.means` mówi to samo słowem.

## Typy dokumentów

`kind` i `kind_detail` są własne dla Ocost. `type_code` to [UNCL 1001](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-inv/), na przykład `380` dla faktury lub `381` dla faktury korygującej. Gdy dokument go nie drukuje, Ocost zapisuje kod jego rodzaju.

## Identyfikatory

`identifiers[].scheme` to własna lista Ocost, na przykład `EU_VAT`, `DE_STNR`, `UA_EDRPOU`, `PL_NIP`, `US_EIN` lub `MD_IDNO`. [Wartości](https://ocost.io/docs/pl/document.md#wartosci) wymieniają je wszystkie. Strony krajów mówią, jak sprawdzany jest każdy z nich.

## Kategorie

[Wyszukiwanie](https://ocost.io/docs/pl/search.md) filtruje według `category`, ośmiocyfrowego kodu [ECLASS](https://eclass.eu), na przykład `24000000`.

## Liczby i daty

Kwoty i ilości to dokładne liczby JSON, stawki to procenty, a daty to ISO 8601. [Dokument](https://ocost.io/docs/pl/document.md#jak-zapisywane-sa-wartosci) mówi, jak je czytać.

## 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ść.
- [Wyszukiwanie](https://ocost.io/docs/pl/search.md): Przeszukiwać wszystkie dokumenty po słowach i po znaczeniu: parametry, filtry, wyniki, przykłady.
- [Niemcy](https://ocost.io/docs/pl/germany.md): Niemieckie dokumenty: od Rechnung do Lieferschein według rodzaju, USt-IdNr. i Steuernummer, kategorie VAT, kontrola według § 14 UStG, XRechnung i ZUGFeRD.
