# Unités et codes
> Les listes de codes du document : unités UNECE avec leurs mots imprimés, devises et pays ISO, catégories de TVA, moyens de paiement, types de documents, identifiants, ECLASS.
>
> Avant: [Le document](https://ocost.io/docs/fr/document.md)

Les listes de codes qu'utilise [`ocost.document.v1`](https://ocost.io/docs/fr/document.md), la norme derrière chacune et comment Ocost passe du mot imprimé au code. Une valeur qui n'est pas un code de sa liste vaut `null`, jamais le texte imprimé.

## Unités

`lines[].unit` est un code de la [Recommendation 20](https://unece.org/trade/uncefact/cl-recommendations) de l'UNECE, ou un emballage de la Recommendation 21 écrit `X` suivi de son code. Voici ceux qu'Ocost écrit le plus souvent :

| Code | Signification | Imprimé comme |
| --- | --- | --- |
| `C62` | Un, une pièce | Stück, Stk, St., шт., од. |
| `H87` | Pièce | Venu des factures électroniques |
| `HUR` | Heure | Std., h, год. |
| `DAY` | Jour | Tag, день |
| `MON` | Mois | Monat, міс. |
| `KGM` | Kilogramme | kg, кг |
| `MTR` | Mètre | m, lfm, м |
| `MTK` | Mètre carré | m², qm, м² |
| `LTR` | Litre | l, л |
| `KWH` | Kilowattheure | kWh, кВт·год |
| `SET` | Lot | Satz, компл. |
| `LS` | Forfait | pauschal, psch. |
| `E48` | Unité de service | послуга |
| `XCT` | Carton | Karton, Ktn |
| `XPK` | Paquet | Paket, VE, уп. |
| `XPX` | Palette | Palette, Pal. |

Ocost demande le code au modèle de lecture. Un mot allemand, ukrainien ou russe qu'il répond à la place passe par une table fixe. Un mot qui ne nomme aucune unité précise, comme Kiste, reste inconnu. `unit` vaut alors `null`, jamais `C62`. Le code d'une facture électronique est gardé tel quel. Un `PF` seul est la palette `XPX`.

## Devises

`currency` est un code [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html). Un symbole imprimé devient son code : € donne `EUR`, £ `GBP`, ₴ et грн `UAH`, zł `PLN`. Un symbole que plusieurs pays utilisent, comme $ ou kr, suit le pays de l'émetteur. Sans l'un ni l'autre, Ocost prend la devise habituelle du fournisseur, sinon celle de votre entreprise.

## Pays

Le `country` d'une adresse est un code [ISO 3166-1 alpha-2](https://www.iso.org/iso-3166-country-codes.html), comme `DE`, `UA` ou `GB`.

## Catégories de TVA

`vat_breakdown[].category` et `lines[].vat_category` suivent [UNCL 5305](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL5305/) comme dans l'EN 16931 : `S`, `Z`, `E`, `AE`, `K`, `G`, `O`, et `L`, `M`, `B` propres à l'Espagne et l'Italie. [Valeurs](https://ocost.io/docs/fr/document.md#valeurs) explique chacune. Chaque page pays montre comment elles y sont imprimées.

## Moyens de paiement

`payment.means_code` suit [UNCL 4461](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL4461/) : `58` un virement SEPA, `59` un prélèvement SEPA, `48` une carte. `payment.means` dit la même chose en un mot.

## Types de documents

`kind` et `kind_detail` sont propres à Ocost. `type_code` suit [UNCL 1001](https://docs.peppol.eu/poacc/billing/3.0/codelist/UNCL1001-inv/), comme `380` pour une facture ou `381` pour un avoir. Quand le document n'en imprime aucun, Ocost écrit le code de son type.

## Identifiants

`identifiers[].scheme` est la liste propre à Ocost, comme `EU_VAT`, `DE_STNR`, `UA_EDRPOU`, `PL_NIP`, `US_EIN` ou `MD_IDNO`. [Valeurs](https://ocost.io/docs/fr/document.md#valeurs) les liste tous. Les pages pays disent comment chacun est contrôlé.

## Catégories

[Recherche](https://ocost.io/docs/fr/search.md) filtre par `category`, un code [ECLASS](https://eclass.eu) de huit chiffres, comme `24000000`.

## Nombres et dates

Les montants et les quantités sont des nombres JSON exacts, les taux des pourcentages, les dates en ISO 8601. [Le document](https://ocost.io/docs/fr/document.md#comment-les-valeurs-sont-ecrites) dit comment les lire.

## Voir aussi

- [Le document](https://ocost.io/docs/fr/document.md): Le schéma ocost.document.v1 dans les termes de l'EN 16931 (transposable en UBL et CII) : un exemple, type et sens, sources, contrôles, versions, et chaque champ et chaque valeur.
- [Recherche](https://ocost.io/docs/fr/search.md): Rechercher chaque document par ses mots et par son sens : paramètres, filtres, résultats, exemples.
- [Allemagne](https://ocost.io/docs/fr/germany.md): Les documents allemands : de la Rechnung au Lieferschein par type, USt-IdNr. et Steuernummer, catégories de TVA, le contrôle du § 14 UStG, XRechnung et ZUGFeRD.
