Les codes pays et devise dans les données : ISO 3166-1 et ISO 4217 sans surprises

Ce que c'est

ISO 3166-1 attribue à chaque pays ou territoire un code à deux lettres (CH), un code à trois lettres (CHE) et un numéro à trois chiffres (756). La liste M49 de l'ONU (citée) publie des codes de zone numériques aux côtés des codes alpha-3 ISO, et BCP 47 (RFC 5646, citée) utilise les codes alpha-2 et les chiffres M49 comme sous-étiquettes de région. La RFC 5646 relève aussi deux pièges : ISO 3166-1 comporte des codes « réservés à titre exceptionnel », dont UK, qui n'est qu'un synonyme du code attribué GB, et AA, QM à QZ, XA à XZ ainsi que ZZ, réservés à un usage privé. ISO 4217 attribue aux devises un code à trois lettres, un code numérique et un exposant d'unité mineure. La liste actuelle est publiée au format XML par l'agence de maintenance SIX (citée) : CHF et EUR comptent 2 unités mineures, JPY 0, BHD 3, CLF 4 ; les métaux précieux, le code de test XTS et XXX (« aucune devise ») n'en ont aucune ; et le fichier porte une date de publication, car les entrées évoluent.

Pourquoi c'est important

Les codes paraissent stables et explicites, ce qui pousse à les coder en dur. Mais les devises sont redénominées et remplacées, les territoires changent de statut, et un code qui suppose deux décimales arrondit mal les montants en yens ou en dinars. Un code pays ne dit non plus rien de fiable sur la langue, le fuseau horaire ou la devise d'une personne ou d'un compte ; ce sont des attributs distincts.

Comment l'appliquer

• Stocker le code pays alpha-2 et le code devise alpha-3 en texte majuscule, avec une contrainte de vérification ou une clé étrangère vers une table de codes ; ne pas stocker les libellés d'affichage, les traduire en périphérie.
• Conserver les tables de codes comme des données, avec des colonnes valid_from et valid_to et une version source, et les réimporter périodiquement depuis la liste de l'agence de maintenance.
• Stocker l'exposant d'unité mineure avec chaque devise et l'utiliser pour l'arrondi et pour convertir entre montants décimaux et entiers en unité mineure ; le lire depuis la liste, jamais en supposer 2.
• N'utiliser les codes numériques que lorsqu'un partenaire l'exige ; de nombreuses devises nationales partagent le code numérique de leur pays (CHF et la Suisse portent toutes deux 756), ce qui est pratique dans des jointures et illisible dans des journaux.
• Traiter XXX (aucune devise concernée) et XTS (test) comme des états explicites de la logique métier, et non comme des erreurs de validation.

Pièges

UK n'est pas un code pays attribué et fera échouer une recherche stricte. Des codes en minuscules ou en casse mixte cassent les jointures d'égalité et les contraintes d'unicité. Les codes pays et les codes de langue ISO 639 se recoupent orthographiquement (de désigne à la fois l'allemand et, en majuscules, l'Allemagne ; be désigne le biélorusse et la Belgique), mais vivent dans des colonnes distinctes. Une liste de devises n'est pas une liste de ce qu'accepte un prestataire de paiement ; conserver cela comme une configuration séparée.

Clés étrangères et codes retirés

La table vers laquelle pointe une clé étrangère et la table qui valide les nouvelles saisies n'ont pas la même forme. Conserver une ligne par code ayant jamais existé, avec un status (current, withdrawn), un valid_from, un valid_to et la version source ; la clé étrangère des lignes de données référence uniquement code, de sorte que les enregistrements historiques en NLG ou en AN restent chargeables après chaque réimportation. Valider les nouvelles saisies avec une contrainte de vérification ou une règle applicative qui n'admet que les codes dont le statut est courant à la date de la transaction, et non via la clé étrangère. Les réimportations ajoutent alors des lignes et en clôturent d'autres, mais ne les suppriment jamais, et un rapport portant sur d'anciennes données peut toujours traduire chaque code qu'il rencontre.