Códigos de país y de moneda en los datos: ISO 3166-1 e ISO 4217 sin sorpresas

Qué es

ISO 3166-1 asigna a cada país o territorio un código de dos letras (CH), uno de tres letras (CHE) y un número de tres dígitos (756). La lista M49 de la ONU (citada) publica códigos numéricos de área junto con los códigos ISO alfa-3, y BCP 47 (RFC 5646, citado) usa los códigos alfa-2 y los dígitos M49 como subetiquetas de región. RFC 5646 también documenta dos trampas: ISO 3166-1 tiene códigos "exceptionally reserved" (reservados de forma excepcional), entre los cuales UK es solo un sinónimo del código asignado GB, y AA, QM a QZ, XA a XZ y ZZ están reservados para uso privado. ISO 4217 asigna a las monedas un código de tres letras, un código numérico y un exponente de unidad menor. La lista vigente la publica en XML la agencia de mantenimiento SIX (citada): CHF y EUR tienen 2 unidades menores, JPY 0, BHD 3 y CLF 4; los metales preciosos, el código de pruebas XTS y XXX ("no currency", es decir, sin moneda) no tienen ninguna; y el archivo incluye una fecha de publicación porque las entradas cambian.

Por qué importa

Los códigos parecen estables y autoexplicativos, por lo que se escriben a mano en el código fuente. Sin embargo, las monedas se redenominan y se sustituyen, los territorios cambian de estatus, y el código que da por hecho que siempre hay dos decimales redondea mal los importes en yenes y dinares. Además, un código de país no dice nada fiable sobre el idioma, la zona horaria o la moneda de una persona o de una cuenta; son atributos distintos.

Cómo aplicarlo

• Guarda el código de país alfa-2 y el código de moneda alfa-3 como texto en mayúsculas, con una restricción de comprobación (check) o una clave foránea a una tabla de códigos; no guardes los nombres para mostrar, tradúcelos en el borde del sistema.
• Mantén las tablas de códigos como datos, con las columnas valid_from y valid_to y una versión de la fuente, y vuelve a importar la lista de la agencia de mantenimiento de forma periódica.
• Guarda el exponente de unidad menor con cada moneda y úsalo para redondear y para convertir entre importes decimales y enteros en unidades menores; léelo de la lista y nunca asumas 2.
• Usa los códigos numéricos solo cuando un socio los exija; muchas monedas nacionales comparten el código numérico de su país (CHF y Suiza son ambos 756), lo cual resulta cómodo en los joins pero ilegible en los logs.
• Trata XXX (sin moneda involucrada) y XTS (pruebas) como estados explícitos en la lógica de negocio, no como errores de validación.

Trampas

UK no es un código de país asignado y fallará en una búsqueda estricta. Los códigos en minúsculas o con mayúsculas mezcladas rompen los joins por igualdad y las restricciones de unicidad. Los códigos de país y los códigos de idioma ISO 639 coinciden en su escritura (de es alemán y, en mayúsculas, Alemania; be es bielorruso y también Bélgica), pero pertenecen a columnas distintas. Una lista de monedas no es una lista de las que acepta un proveedor de pagos; mantén eso como configuración aparte.

Claves foráneas y códigos retirados

La tabla a la que apunta una clave foránea y la tabla que valida la nueva entrada no tienen la misma forma. Conserva una fila por cada código que haya existido alguna vez, con status (current, withdrawn), valid_from, valid_to y la versión de la fuente; la clave foránea de las filas de datos referencia solo code, de modo que los registros históricos en NLG o AN siguen siendo cargables tras cada reimportación. Valida la nueva entrada con una restricción de comprobación o una regla de la aplicación que admita solo los códigos cuyo estado sea current en la fecha de la transacción, y no mediante la clave foránea. Así, las reimportaciones añaden y cierran filas, pero nunca las borran, y un informe sobre datos antiguos puede traducir todos los códigos que encuentre.