Unités et codes
Les listes de codes qu'utilise ocost.document.v1, 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 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. 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, comme DE, UA ou GB.
Catégories de TVA
vat_breakdown[].category et lines[].vat_category suivent UNCL 5305 comme dans l'EN 16931 : S, Z, E, AE, K, G, O, et L, M, B propres à l'Espagne et l'Italie. Valeurs explique chacune. Chaque page pays montre comment elles y sont imprimées.
Moyens de paiement
payment.means_code suit UNCL 4461 : 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, 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 les liste tous. Les pages pays disent comment chacun est contrôlé.
Catégories
Recherche filtre par category, un code ECLASS 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 dit comment les lire.