El Consejo de Estándares Internacionales (XSB) de XBRL aprobó la promoción de las nuevas taxonomías Código de país y Código de moneda al estado de Recomendación candidata. Estas taxonomías proporcionan listas de códigos ISO para países y monedas, lo que facilita el uso de estos códigos estándar en informes XBRL, como se requiere en una amplia gama de presentaciones regulatorias. Ahorrarán a los reguladores la tarea de definir y mantener manualmente estas listas en sus propias taxonomías y mejorarán la coherencia y comparabilidad de los informes XBRL.
Se realizó una mejora estructural significativa desde que las taxonomías se publicaron inicialmente como un borrador de trabajo público, con la introducción de una taxonomía separada de ‘definiciones comunes’. Además de permitir la reutilización de componentes comunes entre las taxonomías de códigos de país y moneda, este cambio desacopla el control de versiones de estos componentes técnicos de las actualizaciones de las listas de códigos en sí. Más cambios menores en la Recomendación candidata incluyen correcciones para nombres de moneda y códigos de moneda duplicados que aparecían tanto en las listas retiradas como en las válidas.
Actualizaremos las taxonomías de códigos de país y moneda cada vez que se actualice la lista de códigos de país o moneda ISO subyacente. Cuando se producen tales cambios, los reguladores deben realizar actualizaciones rápidas. Tanto la taxonomía de país como de moneda están disponibles en dos versiones, lo que ofrece dos enfoques para estas actualizaciones. Las versiones «actuales» permiten a los usuarios actualizar automática e inmediatamente sus taxonomías sin realizar ningún cambio de versión al final, ya que las URL de los archivos de taxonomía permanecerán constantes para todas las versiones. Por otro lado, las versiones «anticuadas» requerirán que los usuarios realicen actualizaciones manuales, lo que permitirá un control total del proceso. Actualmente estamos preparando algunas orientaciones sobre cómo seleccionar entre estas opciones, así que esté atento a más noticias al respecto pronto.
Las taxonomías de moneda y país de XBRL International representan códigos de moneda y país ISO a los que los implementadores pueden hacer referencia en sus taxonomías.
Los códigos ISO de moneda y país se utilizan comúnmente en los informes XBRL en todo el mundo. Estos códigos se utilizan en los informes por una variedad de razones, incluyendo:
- especificar la moneda de medición para los valores monetarios;
- calificar los desgloses de la exposición en categorías de divisas o países; y
- Identificar el país de las contrapartes y partes vinculadas
Esta guía taxonómica analiza los siguientes aspectos de las taxonomías de moneda y país, incluyendo:
- La arquitectura de las taxonomías
- Plan de desarrollo y mantenimiento
- Asignación de archivos XML ISO de origen a artefactos de taxonomía
Moneda ISO y códigos de país
La Organización Internacional de Normalización (ISO) mantiene el estándar para las representaciones de moneda y país. ISO, a su vez, designa una Autoridad de Mantenimiento (MA) para mantener las listas de códigos resultantes. Estas listas de códigos están disponibles gratuitamente en formato digital y son un conjunto importante de listas utilizadas para evitar confusiones al referirse a monedas o países. Las listas de códigos ISO se centran particularmente en ISO2022 mensajes y usos transaccionales similares de los códigos. Son actualizados rápidamente por la MA.
Código de moneda ISO
ISO 4217 especifica la estructura de un código alfabético de tres letras y un código numérico equivalente de tres dígitos para representar monedas. SIX Financial Information AG es la agencia oficial de mantenimiento de códigos de moneda bajo ISO 4217. SIX mantiene las listas de códigos de moneda, las actualiza y las pone a disposición en línea.
Código de país ISO
ISO 3166 proporciona representaciones codificadas universalmente aplicables de nombres de países (actuales y no actuales), dependencias y otras áreas de interés geopolítico y sus subdivisiones. La propia secretaría central de ISO es la Agencia de Mantenimiento (ISO 3166/MA) para esta norma y actualiza, mantiene y publica los cambios en los códigos de país.
Contenido de la taxonomía
Las taxonomías definen los códigos ISO de moneda y país como miembros del dominio. Los miembros del dominio están asociados con etiquetas y referencias.
Las taxonomías que importan las taxonomías de moneda y país pueden usar los códigos de moneda y país como miembros del dominio en un desglose dimensional o como valores de enumeración.
Estructura taxonómica
Estructura taxonómica de la moneda
La taxonomía de la moneda contiene los dos puntos de entrada siguientes:
- Currency: Punto de entrada para acceder a los códigos de moneda como miembros del dominio para los autores de taxonomía que desean usar solo la lista de monedas dimensionalmente o como valores de enumeración en sus propios conceptos (es decir, listas desplegables). Este punto de entrada no contiene etiquetas para nombres de moneda y proporciona flexibilidad para proporcionar nombres de moneda específicos en cualquier idioma.
- Currency-en: Este punto de entrada incluye todos los componentes de taxonomía del punto de entrada ‘currency’ y proporciona etiquetas en inglés para los nombres de moneda.
- currency: el punto de entrada incluye los siguientes componentes.
- currency-elts: definición del esquema para los códigos de moneda como miembros del dominio
- currency-definition – define la jerarquía de miembros de dominio para los códigos de moneda
- currency-label-code – especifica códigos alfanuméricos y numéricos para las monedas. Las etiquetas utilizan roles de etiqueta personalizados definidos en la taxonomía de definiciones comunes de la lista de códigos ISO.
- currency-reference: especifica referencias para los códigos de moneda. Las referencias de propiedad con piezas personalizadas definidas en la taxonomía de definiciones comunes de la lista de códigos ISO se utilizan para los códigos obsoletos.
- currency-es – El punto de entrada importa ‘currency’ e incluye las etiquetas en inglés para los códigos de moneda.
- currency-label-es: especifica el nombre de la moneda en inglés según lo proporcionado por ISO. La etiqueta de documentación especifica la(s) entidad(es) geográfica(s) asociada(s) para la moneda definida por ISO
- Se pueden contribuir etiquetas de idioma adicionales como una extensión modular de la taxonomía, como se muestra en el ejemplo currency-label-fr.
Estructura taxonómica del país
La taxonomía de país contiene los dos puntos de entrada siguientes:
- país: Punto de entrada para acceder a los códigos de país como miembros del dominio para los autores de taxonomía que desean usar solo la lista de países dimensionalmente o como valores de enumeración en sus propios conceptos (es decir, listas desplegables). Este punto de entrada no contiene etiquetas para nombres de países y proporciona flexibilidad para nombres de países específicos en cualquier idioma.
- country-en: Este punto de entrada incluye todos los componentes de taxonomía del punto de entrada ‘país’ y proporciona etiquetas en inglés para los nombres de países.
- país – El punto de entrada incluye los siguientes componentes:
- Country-ELTS – Definición del esquema para códigos de país como miembros del dominio
- Definición de país: define la jerarquía de miembros de dominio para los códigos de país
- country-label-code: especifica los códigos alfanuméricos y numéricos de los países. Las etiquetas utilizan roles de etiqueta personalizados definidos en la taxonomía de definiciones comunes de la lista de códigos ISO.
- country-reference: especifica las referencias de los códigos de país. Las referencias de propiedad con piezas personalizadas definidas en la taxonomía de definiciones comunes de la lista de códigos ISO se utilizan para los códigos obsoletos.
- country-es – El punto de entrada importa ‘country’ e incluye las etiquetas en inglés para los códigos de país.
- country-label-en – especifica las etiquetas de país (nombre corto + nombre completo) en inglés según lo proporcionado por ISO. 1
- Se pueden agregar etiquetas de idioma adicionales como una extensión modular a la taxonomía, como se muestra en el ejemplo country-label-fr.
Lista de códigos ISO definiciones comunes taxonomía
La taxonomía define roles de etiquetas personalizadas y partes de propiedad utilizadas por taxonomías de lista de códigos ISO de país y moneda.
- Común: punto de entrada para acceder a roles de etiqueta y partes de propiedad. El punto de entrada incluye los siguientes componentes:
- property-part: definición de esquema para elementos de referencia de propiedades personalizados utilizados en códigos obsoletos
- role-label-code: definición de esquema para roles de etiqueta personalizados para especificar códigos alfabéticos y numéricos para elementos
Desuso
Desuso de códigos de moneda
Las monedas históricas están disponibles en la lista tres de la norma ISO 4217. La taxonomía de la moneda también incluirá códigos históricos para facilitar la presentación de informes utilizando códigos históricos (si es necesario). Para dichos códigos de moneda históricos:
- La etiqueta estándar tiene una fecha entre paréntesis para indicar la fecha de retirada ISO del código. Por ejemplo, la etiqueta estándar para ‘AFA’ es ‘Afgani (antes de 2003-01)’2.
- Los siguientes metadatos adicionales se adjuntan mediante «referencias de propiedad»:
- Elemento en desuso: se establece en true
- Fecha obsoleta YM: especifica la fecha de retirada del elemento en formato año-mes
- Descripción de fecha obsoleta: especifica la descripción del período de retiro donde la fecha de retiro no está en AAAA-MM
Desuso de códigos de país
Los antiguos códigos de país se reservan durante un período transitorio mientras se utilizan nuevos elementos de código que pueden sustituirlos. Dichos códigos reservados por traducción se incluirán en la taxonomía del país para facilitar la presentación de informes históricos.
Para dichos códigos de país reservados transitoriamente:
- La etiqueta estándar tiene una fecha entre paréntesis para indicar que el código era válido antes de la fecha especificada. Por ejemplo, la etiqueta estándar para ‘AN’ es ‘Antillas Neerlandesas (antes de 2010-12-15)’.
- Los siguientes metadatos adicionales se adjuntan mediante «referencias de propiedad»:
- Elemento en desuso: se establece en true
- Fecha obsoleta: especifica la fecha de finalización de validez del elemento en formato aaaa-mm-dd
- Observación de estado – descripción textual del período de reserva
Control de versiones
Las taxonomías de moneda y país se publican en dos formatos diferentes: «fechado» y «actual». Estas dos taxonomías tienen diferentes enfoques de versionado.
Versión fechada
Taxonomía de moneda Versión fechada
La taxonomía de la moneda se versionará en función de la fecha de emisión ISO de la actualización de la moneda. Por ejemplo, la taxonomía que refleja los cambios para el código de moneda actualizado por ISO en ‘2023-01-01’ y se versionará como ‘2023-01-01’.
El código de moneda ISO se publica como dos listas: lista uno y lista tres. ‘Lista uno’ tiene códigos de moneda válidos, y ‘lista tres’ tiene códigos históricos. Las dos listas se combinan en una sola lista en la taxonomía de moneda. Es posible que estas listas se actualicen de forma independiente. En este caso, la fecha de versión de la taxonomía de la moneda reflejará la última fecha de actualización de cualquiera de las listas.
La información de control de versiones se reflejará en la dirección URL de los archivos de taxonomía y los metadatos del paquete de taxonomía. Ejemplos de URL para la taxonomía de moneda basada en la fecha de actualización de la moneda ISO ‘2023-01-01
Taxonomía de países Versión fechada
La taxonomía del país se versionará en función de la fecha de emisión ISO de la actualización del país. Por ejemplo, la taxonomía que refleja los cambios para el código de país actualizada por ISO en ‘2023-04-04’ y se versionará como ‘2023-04-04’.
La información de control de versiones se refleja en la dirección URL de los archivos de taxonomía y los metadatos del paquete de taxonomía. Ejemplos de URL para la taxonomía del país basadas en la fecha de actualización del país ISO ‘2023-04-04
Consulta pública sobre el control de versiones
Las publicaciones de taxonomía que contienen cambios estructurales para revisión pública se identifican por su estado (PWD/CR/PR) y fecha de publicación. Por ejemplo, la URL del archivo de taxonomía de país publicado el 31 de marzo de 2023 como borrador de trabajo público (PWD) basado en la fecha de emisión ISO ‘2022-11-29’
Versión ‘actual’
Las taxonomías de países y monedas también se proporcionarán como versiones actuales / actualizadas que reflejen los códigos ISO en cualquier momento. Los códigos históricos están en desuso, pero nunca se eliminan y siempre estarán disponibles para su presentación de informes; Por lo tanto, las actualizaciones de la lista de códigos no deben invalidar los informes preparados contra versiones anteriores de la taxonomía.
Lista de códigos ISO definiciones comunes taxonomía
La taxonomía de definiciones comunes de la lista de códigos ISO se publicará como un paquete de taxonomía separado y se versionará independientemente de la taxonomía de la moneda y el país. El control de versiones se basará en la fecha de actualización de la taxonomía. La información de control de versiones se refleja en la dirección URL de los archivos de taxonomía y los metadatos del paquete de taxonomía.
La URL de la taxonomía de definiciones comunes de la lista de códigos ISO reflejará el año en que se finalizó.
Los borradores públicos de la taxonomía incluirán el estado y la fecha completa de publicación.
Componentes de la taxonomía
Roles de etiquetas personalizadas
Las taxonomías de moneda y país utilizan los siguientes roles de etiqueta personalizados definidos en la taxonomía de definiciones comunes de la lista de códigos ISO:role-label-code.xsd
- alpha3CodeLabel: roles de etiqueta utilizados para especificar ‘Código alfabético de 3 caracteres’ para el código de moneda/país.
- alpha2CodeLabel: roles de etiqueta utilizados para especificar ‘Código alfabético de 2 caracteres’ para el código de país.
- numericCodeLabel: roles de etiqueta utilizados para especificar ‘Código numérico’ para el código de moneda/país.
Piezas de referencia personalizadas
Las taxonomías de moneda y país utilizan las siguientes partes de referencia personalizadas definidas en la taxonomía de definiciones comunes de la lista de códigos ISO:property-part.xsd
- ElementDeprecated: parte de referencia con un valor booleano para indicar si el código se ha retirado del uso (códigos de moneda) o si su validez ha finalizado (códigos de país).
- DeprecatedDateYM: parte de referencia para indicar la fecha de retiro del elemento en formato año-mes. Esto se utiliza en la taxonomía de la moneda.
- DeprecatedDate – Parte de referencia para indicar la fecha de finalización de validez del elemento en formato aaaa-mm-dd. Esto se utiliza en la taxonomía del país.
- DeprecatedDateDescription – Parte de referencia para proporcionar una descripción textual del período de retiro donde la fecha de retiro no está en AAAA-MM. Esto se utiliza en la taxonomía de la moneda.
- StatusRemark: parte de referencia para proporcionar información textual adicional período de reserva para códigos. Esto se utiliza en la taxonomía de países.
Espacios de nombres
La taxonomía de moneda utiliza los siguientes espacios de nombres, donde AAAA-MM-DD es la fecha de actualización ISO en la que se basa la taxonomía:
- currency-elts.xsd
- currency.xsd
- currency-en.xsd
La taxonomía de país utiliza los siguientes espacios de nombres, donde AAAA-MM-DD son la fecha de actualización ISO en la que se basa la taxonomía:
- country-elts.xsd
- country.xsd
- country-en.xsd
La taxonomía de definiciones comunes de la lista de códigos ISO utiliza los siguientes espacios de nombres, donde AAAA es el año en que se finalizó la taxonomía:
- property-part.xsd
- role-label-code.xsd
URL absolutas de punto de entrada de taxonomía
En la tabla siguiente se muestran las direcciones URL absolutas de los puntos de entrada de la taxonomía, donde es la fecha de actualización ISO en la que se basa la taxonomía: YYYY-MM-DD
Plan de mantenimiento de la taxonomía
XBRL International se suscribe a las notificaciones sobre actualizaciones de la ISO, Autoridad de Mantenimiento (MA) y ha implementado un mecanismo para implementar automáticamente estos cambios, junto con los metadatos de soporte relevantes en una taxonomía XBRL. Un ejemplo de notificación de actualización de código ISO se puede ver en estos enlaces: código de moneda y código de país.
La notificación de actualización de moneda ISO y código de país iniciará el proceso de actualización de taxonomías de moneda o país. La actualización de las taxonomías será llevada a cabo por el personal de XBRL International.
La taxonomía inicial y las actualizaciones que proponen cambios estructurales seguirán el ciclo de gobernanza y madurez aplicable para el desarrollo de especificaciones técnicas, o (más tarde) la gobernanza específica de la taxonomía según lo definido por el Consejo de Estándares XBRL de vez en cuando. La actualización no estructural de la taxonomía será revisada y aprobada por el Consejo de Normas XBRL.
Los cambios estructurales incluyen cambios en el modelado lógico y físico de la taxonomía o actualizaciones de especificaciones técnicas. Ejemplos de cambios no estructurales incluyen actualizaciones de código según cambios de código ISO o actualizaciones de etiquetas.
Etiquetas de idioma adicionales
Si bien las taxonomías predeterminadas de moneda y país incluyen etiquetas en inglés, las jurisdicciones o reguladores XBRL pueden contribuir con etiquetas de idioma adicionales. Las etiquetas de idioma adicionales estarán disponibles como un archivo de taxonomía modular y un paquete de taxonomía para ser referenciados en la taxonomía que desee utilizarlas.
El archivo de etiqueta francés (country-label-fr.xml) para la taxonomía del país 2022-11-29 estaría disponible en la ubicación oficial, y como un paquete de taxonomía separado. http://www.xbrl.org/taxonomy/int/country/2022-11-29/fr/country-label-fr.xml
De forma predeterminada, se utilizarán códigos de idioma de dos letras para identificar la etiqueta de idioma adicional, pero se considerará agregar subcódigos si se solicita. Los códigos regionales se reflejarán en la URL del archivo de taxonomía y el nombre del archivo de taxonomía como se ve arriba.
Asignación de códigos a taxonomía
ISO publica códigos de moneda y país en formatos XML, que se utilizan para generar taxonomía. La asignación entre el XML ISO de origen y los artefactos de taxonomía se proporciona en la sección
En esta sección se describe la asignación de XML de moneda ISO y código de país a artefactos de taxonomía XBRL. El elemento XML indica el elemento en el archivo XML de código ISO.
Código de moneda – Mapeo
Se puede acceder al código de moneda ISO XML desde los siguientes enlaces:
- Código de moneda válido
- Código de moneda retirado
Los códigos de fondo no se incluyen (cuando se omite el código). Los metales preciosos y otros códigos no monetarios que comienzan con «ZZ**_» también están excluidos de la taxonomía monetaria. <CcyNm IsFund=»true»>
Lista uno de los códigos de moneda, incluye la siguiente moneda especial que están excluidos de la taxonomía de moneda.
- DEG (Derechos Especiales de Giro) – FONDO MONETARIO INTERNACIONAL (FMI)
- Unidad de Cuenta del BAD – PAÍSES MIEMBROS DEL GRUPO DEL BANCO AFRICANO DE DESARROLLO
La asignación de campos XML de código ISO a artefactos de taxonomía para cada miembro de dominio de moneda es la siguiente:
- Nombre del elemento: <Ccy>
- Etiqueta estándar para las monedas de la lista uno – <CcyNm>
- Etiqueta estándar para enumerar tres monedas – (antes <CcyNm><WthdrwlDt>)
- La fecha de caducidad en la etiqueta estándar es para distinguir la moneda de retiro. Esto es útil cuando las monedas históricas y válidas tienen el mismo nombre. Por ejemplo, ‘MXP’ y ‘MXN’ tienen como ‘Peso mexicano’. ‘MXP’ fue retirado en 1993; su nombre estándar sería ‘Peso mexicano (antes de 1993-01)’.<CcyNm>
- Etiqueta de documentación – Entidad(es) geográfica(s) asociada(s) con la moneda es/son (n)<Ccy><CtryNm>
- alpha3CodeLabel (rol de etiqueta personalizada) – (repitiendo la moneda de 3 letras como una etiqueta adicional además de capturarla en el nombre del elemento, lo que puede ser útil en algunos casos) <Ccy>
- numericCodeLabel (rol de etiqueta personalizada) – (códigos numéricos) <CcyNbr>
Información de referencia
Para todos los códigos:
- Editor: Organización Internacional de Normalización
- Nombre: ISO
- Número: 4217
- Párrafo: Lista
- Inciso: Lista uno O Lista tres (Códigos retirados)
- URI: https://www.iso.org/iso-4217-currency-codes.html
Detalles de los códigos retirados en la referencia de la propiedad (piezas personalizadas):
- Fecha obsoleta: <WthdrwlDt>
- Elemento en desuso: true
Cuando no está en formato, se supone que el mes es diciembre del período final. Por ejemplo, ‘ARY’ se retiró durante el período ‘1989 a 1990’, la fecha obsoleta es este caso especificado en la taxonomía como 1990-12. Para tales casos, el período de retiro se captura como una parte de referencia adicional en ‘Descripción de fecha obsoleta'<WthdrwlDt> YYYY-MM
Código de país – Mapeo
Se puede acceder a una muestra de XML de código de país ISO. La taxonomía de país incluye códigos de país que tienen = ‘oficialmente asignado’ o ‘reservado transitoriamente’. <status>
La asignación de campos XML de código ISO a artefactos de taxonomía para cada miembro del dominio de país es la siguiente:
- Nombre del elemento: <alpha-2-code>
- Etiqueta estándar – o cuando el primero no está disponible4. (ISO también proporciona nombres de países en francés; el plan inicial es incluir solo etiquetas en inglés en la taxonomía). <short-name lang3code=»eng» xml:lang=»en»><short-name-upper-case lang3code=»eng» xml:lang=»en»>
- Etiqueta estándar para códigos de país reservados transitoriamente – (antes <short-name lang3code=»eng» xml:lang=»en»><validity-end-date>)
- La fecha anterior de la etiqueta estándar distingue el código de país reservado de los códigos actuales.
- Etiqueta detallada – <full-name lang3code=»eng» xml:lang=»en»>
- alpha2CodeLabel (rol de etiqueta personalizada) – (repetir el país de 2 letras como una etiqueta adicional además de capturarlo en el nombre del elemento puede ser útil en algunos casos) <alpha-2-code>
- alpha2CodeLabel (rol de etiqueta personalizada): código alfabético de 3 caracteres (alfabeto)<alpha-3-code>
- numericCodeLabel (rol de etiqueta personalizada) – (código numérico) <numeric-code>
Información de referencia
Para todos los códigos:
- Editor: Organización Internacional de Normalización
- Nombre: ISO
- Número: 3166-1
- Párrafo: Lista
Detalles de código reservados de forma transitoria en la referencia de propiedades (partes personalizadas). Esto será solo para códigos con = ‘reservado transitoriamente’. <status>
- Fecha obsoleta: <validity-end-date>
- Elemento en desuso: true
- Observación de estado: <status-remark>