El seminario web XBRL Directions analiza en profundidad el control de versiones de taxonomía

El 26 de septiembre, organizamos nuestro seminario web exclusivo para miembros, XBRL Directions, centrado en los aspectos esenciales de la gestión de versiones de taxonomías. Esta sesión de 30 minutos estuvo repleta de información sobre esquemas de versiones, planificación de lanzamientos de taxonomías e implementación de correcciones urgentes. También exploramos cómo comunicar los cambios de taxonomía de manera eficaz a las diferentes partes interesadas.

Dirigida por el Dr. Ben Russell, copresidente del Grupo de trabajo de diseño de taxonomía, y Catalina Ibañez, presidenta del Grupo de trabajo de concientización sobre la implementación, la sesión estuvo repleta de conocimientos prácticos para ayudar a los asistentes a navegar mejor por las complejidades de la gestión de la taxonomía.

Para aquellos que se lo perdieron, ¡no se preocupen! Pueden ver la repetición completa del seminario web aquí. Además, para obtener más información sobre las versiones de taxonomía y las estrategias de comunicación, consulte la guía relevante en nuestro sitio web

Cómo gestionar el control de versiones de la taxonomía

Este documento es un borrador de revisión. Se invita a los lectores a enviar comentarios al Grupo de trabajo de orientación sobre arquitectura de taxonomía.

Editores

  • Revathy Ramanan, XBRL International Inc.
  • Ben Russell, Archivo central
  • Joel Vicente, CoreFiling

Colaboradores

  • Paul Hulst, Banco De Nederlandsche
  • Erwin Kaats, Logius
  • David Shaw, Consejo de Normas de Contabilidad Financiera
  • Paul Warren, XBRL International Inc.

Tabla de contenido

1. Introducción

En un programa de informes XBRL, se publican nuevas taxonomías para reflejar los cambios en los requisitos técnicos y comerciales. Las publicaciones de taxonomías suelen identificarse por su versión. Esta guía describe las mejores prácticas para gestionar el control de versiones de taxonomías, incluidos los detalles sobre la información que se debe proporcionar. Está dirigida a los autores y arquitectos de taxonomías. El alcance de esta guía se limita a los mecanismos de control de versiones de taxonomías para su publicación pública.

2. Versiones de la taxonomía

Las taxonomías se publican como parte de ciclos de actualización regulares o de manera ad hoc para abordar requisitos comerciales, soluciones técnicas o correcciones. No importa cuán pequeño sea, cualquier cambio, incluso un error tipográfico en una etiqueta, se considera una publicación de taxonomía. Es necesario identificar cada publicación de la taxonomía para garantizar de manera única que:

  • Los informes XBRL hacen referencia a la versión correcta de la taxonomía y, por lo tanto, pueden interpretarse correctamente;
  • Los informes XBRL se evalúan en función de un conjunto adecuado de reglas de validación definidas en la taxonomía; por ejemplo, un cambio en la severidad de una regla de validación puede alterar la validación del informe; y
  • Se evitan conflictos entre definiciones de diferentes versiones de taxonomía; por ejemplo, es posible que el software no pueda identificar qué versión utilizar cuando no está identificada de forma única.

Las taxonomías se identifican utilizando esquemas de versiones, que se analizan en detalle a continuación.

3. Esquemas de versiones

El autor de una taxonomía puede elegir entre distintos esquemas de versiones para identificar de forma única cada versión de su taxonomía. Los esquemas de versiones típicos se basan en:

3.1 Fechas

Las versiones de taxonomía se identifican mediante una fecha o año (normalmente la fecha de publicación).

  • Estos esquemas de versiones simples generalmente son fáciles de entender.
  • La fecha de la versión de la taxonomía puede diferir de la fecha a partir de la cual la taxonomía se vuelve aplicable para la elaboración de informes. La guía sobre la comunicación de cambios en la taxonomía recomienda incluir la fecha de entrada en vigor de una taxonomía en el documento de cambio.
  • Es posible que el control de versiones basado en fechas no pueda capturar otra semántica, como el tipo de lanzamiento (por ejemplo, principal o secundario).

Por ejemplo, la taxonomía contable anual de las NIIF se identifica por el año de publicación (por ejemplo, «La taxonomía contable de las NIIF 2022»). La taxonomía refleja los requisitos de presentación y revelación de las Normas de Contabilidad de las NIIF al 1 de enero de ese año. Los nombres de las URL de los archivos de la taxonomía reflejan la fecha de publicación, por ejemplo, https://xbrl.ifrs.org/taxonomy/2022-03-24/full_ifrs_entry_point_2022-03-24.xsd

3.2 Números

Las versiones de taxonomía se identifican mediante números incrementales.

  • Los números se dividen en partes para identificar versiones principales y secundarias u otra semántica.
  • La taxonomía alemana E-Bilanz/HGB utiliza un mecanismo de número de versión. Cada año, la publicación de una nueva taxonomía representa un número de versión único. Por ejemplo, «E-Bilanz / HGB-Taxonomie Version 6.5».
  • El Banco Central de Rusia utiliza tres números de partes (por ejemplo, 4.3.1) para las versiones de taxonomía para identificar versiones para el ciclo de desarrollo, la estructura del modelo de datos y las reglas comerciales.

3.3 Combinación

Las versiones de taxonomía se identifican mediante una combinación de fechas, números o texto estándar (borrador, consulta).

Consideraciones para elegir esquemas de versiones

  • Elija un esquema de control de versiones estrechamente relacionado con el ciclo de publicación de la taxonomía. Por ejemplo, una taxonomía que se planea publicar anualmente puede preferir un control de versiones basado en fechas. Una taxonomía que no tenga publicaciones a intervalos establecidos puede preferir esquemas basados ​​en números.
  • Elija un esquema de versiones que pueda seguirse consistentemente para todo tipo de actualizaciones.
  • Considere cómo indicar las publicaciones de versiones preliminares o de consulta. Por ejemplo, la taxonomía IFRS publicada para consulta se identifica como «Propuesta de actualización 2 de la taxonomía IFRS 2021» y los nombres de archivo de la taxonomía reflejan la fecha de publicación del borrador.
  • Explique la semántica asociada a los esquemas de versiones en el documento de arquitectura de taxonomía.

4. Dónde mostrar los números de versión

El identificador de versiones de taxonomía elegido por el autor se refleja en diferentes artefactos de taxonomía.

4.1 URL de los archivos de taxonomía

La URL de los archivos de taxonomía alojados en su ubicación «oficial» generalmente refleja la versión de la taxonomía. Un ejemplo es la URL de un punto de entrada de taxonomía de IFRS 2021:

http://xbrl.ifrs.org/taxonomy/2021-03-24/full_ifrs_entry_point_2021-03-24.xsd

Esto incluye la fecha de publicación como su identificador de versión. La URL identifica de forma única la taxonomía, por lo que el identificador de versión debe incluirse en la URL.

También se debe considerar cómo se reasignan las URL en los paquetes de taxonomía. El identificador de la versión debe estar en el directorio de nivel más alto posible para que las reasignaciones entre paquetes de taxonomía no entren en conflicto. En el caso de las taxonomías modulares en las que los módulos tienen versiones independientes, el identificador de la versión no debe estar en un directorio de nivel superior al identificador del módulo. Obtenga más información sobre la reasignación en la guía de paquetes de taxonomía.

4.2 Metadatos del paquete de taxonomía

El elemento de versión del paquete de taxonomía se utiliza para identificar la versión de la taxonomía.

El elemento identificador del paquete de taxonomía proporciona un URI que debe identificar de forma única el paquete y, por lo tanto, también debe incorporar la versión de la taxonomía.

Se deben utilizar ambos elementos para que el usuario pueda comprender fácilmente a qué versión de la taxonomía se refiere un paquete.

4.3 El espacio de nombres de los esquemas de taxonomía

En XBRL, los espacios de nombres se utilizan para eliminar la ambigüedad de los nombres de los elementos de taxonomía definidos en las taxonomías. Esto se debe lograr mediante la inclusión de un identificador de versión en el espacio de nombres del esquema de taxonomía.

4.4 Nombre de archivo de taxonomía

En algunas taxonomías, los nombres de archivo también pueden contener una versión de la taxonomía. Por ejemplo, el nombre de archivo de uno de los archivos de etiquetas de la taxonomía IFRS 2021 es lab_full_ifrs-en_2021-03-24.xml. No es necesario incluir el número de versión en el nombre de archivo para identificar de forma única el archivo, ya que el número de versión también se incluye en la jerarquía de URL, pero repetirlo en el nombre de archivo puede ayudar a los usuarios que trabajan con la taxonomía.

5. Gestión de versiones de archivos en una taxonomía modular

Una taxonomía se puede visualizar como un conjunto de bloques de construcción modulares. No todos los bloques de construcción cambian en cada versión de la taxonomía, por lo que es importante comprender qué módulos necesitan una versión diferente. El enfoque más sencillo es crear versiones de la taxonomía a nivel de paquete, garantizando que todos los módulos de la taxonomía tengan el mismo identificador de versión. En este enfoque, las URL de todos los archivos de taxonomía se actualizan para reflejar la nueva versión en cada versión de la taxonomía.

Un enfoque más sofisticado sería crear versiones de la taxonomía a nivel de módulo. Este enfoque requiere un análisis detallado y probablemente solo valga la pena si el ciclo de vida de los módulos es significativamente diferente. Por ejemplo, las taxonomías de EBA y EIOPA contienen marcos que se versionan de forma independiente. Cada paquete de taxonomía publicado contiene solo marcos que han cambiado.

6. Planificación de lanzamientos de taxonomías

El mantenimiento de la taxonomía incluye la planificación del ciclo de cambio de la taxonomía y la gestión de las versiones. El autor de una taxonomía debe tener en cuenta los siguientes aspectos:

  • El ciclo de cambio de taxonomía puede ser periódico (las taxonomías se publican a intervalos de tiempo periódicos regulares) o ágil (las taxonomías se publican a medida que se producen los cambios).
  • Una consideración importante al decidir el ciclo de cambio de la taxonomía es con qué frecuencia cambian los requisitos de informes subyacentes, con qué frecuencia esos cambios afectan a los usuarios y si los cambios se pueden agrupar para reflejar los cambios periódicos.
  • Los cambios periódicos pueden ser preferibles ya que las partes interesadas pueden planificar mejor las actividades de cambio de taxonomía.
  • El autor de la taxonomía debe considerar la duración de la consulta, el flujo de cambio a través del ecosistema y cuánto tiempo lleva esto.
    • Esta comprensión ayudará a programar la publicación de la taxonomía adecuadamente antes de la fecha necesaria para la presentación del informe.

6.1 Versiones con corrección de errores

Existen situaciones en las que es necesario publicar taxonomías para corregir errores. Estas situaciones pueden ocurrir entre las publicaciones planificadas. Las correcciones de errores en las taxonomías son más fáciles y económicas de implementar antes de que se utilice la taxonomía. Las correcciones de errores en las taxonomías en producción deben tener en cuenta los informes ya enviados al recopilador de datos y planificar si se requiere alguna acción correctiva en relación con los informes ya enviados.

Las correcciones de errores a veces se publican como una «revisión urgente» en la que la ubicación oficial de la taxonomía no se modifica, los archivos de taxonomía alojados en su ubicación oficial se reemplazan y se publica un nuevo paquete de taxonomía. Esto se hace generalmente para limitar el esfuerzo de realizar una actualización completa de la versión de la taxonomía. Se debe tener cuidado al realizar una publicación de «revisión urgente» de este tipo porque:

  • Los informes preparados con versiones de taxonomía anteriores pueden quedar invalidados por los cambios realizados en la revisión.
  • Los usuarios de taxonomía pueden seguir usando las copias sin conexión de la versión de taxonomía anterior y pueden intentar consumir informes más nuevos que dependan de un paquete más nuevo, lo que genera que se informen errores inesperados.

Cuando se utilizan versiones de revisión urgente, siempre se les debe asignar un número de versión de taxonomía único. Por ejemplo, se puede utilizar un número de versión de 3 partes: principal, secundaria, parche (por ejemplo, 1.2.3). La última parte debe ser el «parche» (revisión urgente) y se puede omitir de las URL y los espacios de nombres del archivo de taxonomía. Incluya el número de versión de revisión urgente completo en el identificador del paquete de taxonomía y en los elementos de versión y en la documentación que lo acompaña.

La comunicación de la versión de la taxonomía debe indicar explícitamente la necesidad de actualizar el software y los sistemas a la última versión de la taxonomía XBRL. Debe haber un registro de cambios para la revisión urgente que explique el motivo del cambio y su impacto. Para obtener instrucciones detalladas sobre cómo comunicar los cambios entre versiones de la taxonomía, consulte el documento de orientación sobre la comunicación de cambios en la taxonomía

Este documento fue elaborado por el Grupo de trabajo de orientación sobre arquitectura de taxonomía.

Deja una respuesta