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 :

CodeSignificationImprimé comme
C62Un, une pièceStück, Stk, St., шт., од.
H87PièceVenu des factures électroniques
HURHeureStd., h, год.
DAYJourTag, день
MONMoisMonat, міс.
KGMKilogrammekg, кг
MTRMètrem, lfm, м
MTKMètre carrém², qm, м²
LTRLitrel, л
KWHKilowattheurekWh, кВт·год
SETLotSatz, компл.
LSForfaitpauschal, psch.
E48Unité de serviceпослуга
XCTCartonKarton, Ktn
XPKPaquetPaket, VE, уп.
XPXPalettePalette, 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.

Voir aussi