DESCRIPCIÓN FUNCIONAL API XBRL-PGC2007

Transcripción

1 DESCRIPCIÓN FUNCIONAL API XBRL-PGC2007 ADAPTACIÓN DEL MÓDULO DE SOFTWARE DE TRATAMIENTO DE INFORMES XBRL A LA NUEVA VERSIÓN DE LA TAXONOMÍA PGC2007 (V1.4.1) Noviembre 2011

2 ÍNDICE 1. INTRODUCCIÓN 2. DESCRIPCIÓN DEL PROYECTO 2.1. OBJETIVO 2.2. BENEFICIOS 2.3. ALCANCE 3. DESCRIPCIÓN DEL SISTEMA 3.1. DESCRIPCIÓN DE LOS SERVICIOS Servicio de transformación Definición del Formato Común de Entrada y Salida Transformación desde formato común XML a XBRL Transformación desde XBRL a formato común XML Servicio de validación de informes XBRL Servicio de visualización de informes XBRL Servicio de validación de formato común XML 3.2. CASOS DE USO Actores Descripción de los casos de uso 4. INTEGRACIÓN Y LICENCIA 4.1. INTEGRACIÓN 4.2. LICENCIA 5. VERSIONES DEL API 5.1. VERSIÓN 1.1. VERSIÓN INICIAL DEL API 5.2. VERSIÓN 1.2. VERSIÓN MEJORADA DEL API 5.3. VERSIÓN 1.3. VERSIÓN MEJORADA DEL API 5.4. VERSIÓN 1.4. VERSIÓN MEJORADA DEL API 5.5. VERSIÓN VERSIÓN MEJORADA DEL API

3 ÍNDICE DE FIGURAS Figura 1. Esquema de integración de la información contable con XBRL... 6 Figura 2: Diagrama de actividad para la transformación de formato común XML a XBRL...10 Figura 3: Arquitectura de la transformación de formato común XML a XBRL...11 Figura 4: Diagrama de actividad para la transformación de XBRL a formato común XML...14 Figura 5: Arquitectura de la transformación de XBRL a formato común XML...15 Figura 6: Diagrama de actividad para la validación de informes XBRL...16 Figura 7: Diagrama de actividad para la visualización de informes XBRL...19 Figura 8: Diagrama de casos de uso

4 1. INTRODUCCIÓN El proyecto API XBRL-PGC2007 es una iniciativa que tiene el objetivo global de convertir al lenguaje XBRL (extensible Business Reporting Language) en el estándar de facto de intercambio de información económico-financiera y de negocio en el ámbito de los sectores público y privado nacionales. Este documento describe el alcance funcional del proyecto, concebido para la construcción de un conjunto de librerías de componentes para el tratamiento de instancias XBRL correspondientes a la taxonomía del Plan General Contable 2007 (en adelante, PGC2007). 4

5 2. DESCRIPCIÓN DEL PROYECTO 2.1. OBJETIVO El objetivo principal de este proyecto consiste en asegurar el éxito de implantación del nuevo Plan General de Contabilidad 2007 en formato XBRL, ayudando a las empresas en la labor de realización de informes XBRL, aislándolas de la posible complejidad en el procesamiento del modelo de datos de las taxonomías. Para ello, se han desarrollado un conjunto de librerías de componentes para el tratamiento de informes XBRL (XBRL Instance Documents) correspondientes a la taxonomía PGC2007. Estos componentes de software se han desarrollado con enfoque modular y abierto BENEFICIOS Los beneficios serán, además de contribuir al éxito del PGC2007, la utilización de software libre para la realización de dichos informes, minimizando el gasto de las empresas reportadoras en la implantación del uso de XBRL en sus herramientas de gestión ALCANCE Se desarrollará una librería de componentes que procese informes XBRL de acuerdo a la taxonomía del nuevo Plan General de Contabilidad (PGC2007), exponiendo los siguientes servicios: Servicio de transformación desde un formato común a formato XBRL. Servicio de transformación desde XBRL al formato común. Servicio de validación de instancias. Servicio de visualización de informes XBRL de cuentas anuales de PGC

6 Figura 1. Esquema de integración de la información contable con XBRL 6

7 3. DESCRIPCIÓN DEL SISTEMA El módulo de software desarrollado constituye un conjunto de componentes y utilidades que serán usados, entre otros, por diversos programas de gestión. Estas librerías han sido desarrolladas bajo licencia de código abierto y se apoyan, a su vez, en otras librerías de código abierto. Las librerías y utilidades se usarán dentro del marco constituido para el envío de informes XBRL de PGC2007 por parte de las empresas que están obligadas a ello. El usuario del puesto local, a través del uso del software de gestión habitual, podrá llevar a cabo la realización de dichos informes. Será el software contable, o de gestión, de cada empresa, por tanto, el que se encargue de interactuar con las librerías XBRL para elaborar informes XML en un formato común. Estos informes XML con formato común serán convertidos a XBRL y validados por dichas librerías antes de ser reportados, asegurando que el informe XBRL cumpla con la especificación XBRL 2.1 frente a la taxonomía PGC DESCRIPCIÓN DE LOS SERVICIOS A continuación se detalla cada uno de los servicios que expone la librería para la ejecución de las funcionalidades a cubrir por el sistema Servicio de transformación El servicio de transformación expone los métodos necesarios para llevar a cabo la conversión entre los formatos de entrada y de salida, facilitando en su implementación la manipulación de los modelos de objetos inherentes al estándar XBRL, en concreto en la traducción de acuerdo con la taxonomía PGC2007 de un formato simplificado de los datos de entrada, que se describe a continuación. Este servicio está compuesto por dos funcionalidades simétricas. Por un lado, la conversión del XML en formato común a XBRL y por otro la transformación de XBRL a XML en formato común Definición del Formato Común de Entrada y Salida Para el intercambio de información entre los sistemas de gestión de terceros con las librerías se define un formato que de alguna forma simplifique los datos que representan un informe financiero, pero que contenga información suficiente para elaborar un informe XBRL que permita su validación y consumo por herramientas estándar. Para ello se ha optado por modelar un documento XML. 7

8 Transformación desde formato común XML a XBRL Este servicio se encarga de realizar la transformación de un documento que entra al sistema en formato común (definido en el punto anterior) y de elaborar un informe XBRL valido. Existen dos escenarios diferentes de ejecución del servicio USO1, se indica como entrada la ruta física en la cual se almacenará el documento XBRL resultado de la transformación. Dicha ruta física será accesible dentro del entorno de ejecución del sistema; en caso contrario deberá indicarse un error. USO2, el servicio de transformación devolverá un objeto (por ejemplo DOM) con el documento respuesta. A continuación se describen las interfaces de entrada, de salida y de errores para los dos tipos de uso comentados. Descripción interfaz USO1 Parámetros de entrada: Documento XML que cumple con el esquema del formato común, definido para representar la información que se quiere transformar a formato XBRL. Se especificará la ruta física del sistema local, en la cual se encuentra dicho documento XML. Ruta de Salida, ruta física del sistema local en la cual se guardará el documento XBRL generado. Parámetros de salida: Ninguno explícito. Si la ejecución ha sido correcta, el documento XBRL habrá sido generado y validado sin errores y posteriormente almacenado en la ruta física que fue indicada como parámetro de entrada. Errores: Error en formato de entrada. Valida que el formato de entrada cumple con el esquema XSD definido para ello. Este error refleja los problemas encontrados en la validación del XML de entrada al servicio de transformación. Error creando estructura. Utilizado para describir los problemas que se hayan podido producir en la creación de la estructura XBRL, a partir del XML de entrada. Error generando documento XBRL. Errores que se puedan producir al generar el documento XBRL a partir de la estructura XBRL previamente generada. 8

9 Error de validación XBRL. Posibles problemas encontrados en el proceso de validación del documento XBRL contra la taxonomía del PGC2007. Descripción interfaz USO2 Parámetros de entrada: Documento XML que cumple con el esquema del formato común, definido para representar la información que se quiere transformar a formato XBRL. Se especificará la ruta física, del directorio local, en la cual se encuentra dicho documento XML. Parámetros de salida: Objeto Contenedor, que contendrá un manejador en memoria al documento XBRL generado y validado. Errores: Error en formato de entrada. Valida que el formato de entrada cumple con el esquema XSD definido para ello. Este error reflejará los problemas encontrados en la validación del XML de entrada al servicio de transformación. Error creando estructura. Utilizado para describir los problemas que se hayan podido producir en la creación de la estructura XBRL, a partir del XML de entrada. Error generando documento XBRL. Errores que se puedan producir al generar el documento XBRL a partir de la estructura XBRL previamente generada. Error de validación XBRL. Posibles problemas encontrados en el proceso de validación del documento XBRL contra la taxonomía del PGC2007. A continuación se detalla la secuencia de ejecución del servicio de transformación de formato común de entrada (XML) a un informe XBRL de acuerdo a la taxonomía PGC2007: 9

10 Figura 2: Diagrama de actividad para la transformación de formato común XML a XBRL Cargar y validar XML de formato Común [Error] Devolver Error en formato de entrada Procesa XML, creando estructura XBRL [Error] Devolver Error creando estructura XBRL Genera documento XBRL [Error] Devolver Error generando documento XBRL Valida documento XBRL [Error] Devolver Errores De validación en documento XBRL Como se aprecia en la figura, el proceso de transformación consiste en la carga del documento de entrada XML en el formato común, una primera validación contra el esquema 10

11 XSD, documento que define la estructura y sintaxis que debe cumplir dicho documento. De esta forma se verifica que la entrada no contiene errores. A continuación se cargarán, en base a la identificación del documento de entrada, los mapas e identificadores correspondientes al módulo o módulos que contiene el documento. Una vez cargados los recursos necesarios, y mediante el uso de una API de código abierto para el tratamiento de XBRL, se generará en memoria la estructura con los datos recibidos en el formato común para elaborar el informe XBRL correspondiente a dicha estructura con los valores recibidos. En cada fase se comprueba la posible existencia de errores, en cuyo caso se procedería a su tratamiento y notificación. Figura 3: Arquitectura de la transformación de formato común XML a XBRL XML con formato común Identificadores MAPAS Transformador de XML a XBRL API XBRL (OS) Informe XBRL En la figura anterior se puede apreciar el diagrama de bloques del servicio generador de XBRL. El proceso de generación, el cual ha sido previamente descrito, se basa en una serie de elementos, los cuales son necesarios para definir la relación existente entre los datos de entrada y los conceptos de la taxonomía. Los principales elementos son los siguientes: XML con formato común. Constituye la información del documento de entrada al servicio, el cual debe cumplir con el modelo definido para tal efecto. Los objetos de este modelo son informados mediante datos e identificadores asociados. Estos identificadores indican a qué concepto de negocio se refiere un determinado dato. Identificadores. La tabla de identificadores relaciona el contenido de los mapas con la información contenida en el XML de entrada. Se definirán tantos identificadores como conceptos existan en los informes a representar. 11

12 Mapas. Los mapas son los documentos que permiten realizar la traducción del formato simplificado de los informes del plan contable (documento de formato común XML), donde se reportan conjuntos de pares clave-valor de forma estructurada, en elementos o items pertenecientes a un esquema taxonómico concreto, de forma que se puedan generar informes semánticamente enriquecidos. En esta estructura, junto a Identificadores habrá la información suficiente para poder generar el informe XBRL asociado a cada modelo de reporte. Por tanto, se definirán tantos mapas como modelos de reporte contiene la taxonomía PGC2007: o Estados de Cuentas Anuales según el Modelo Normal, Abreviado y de Pymes o Memoria Normal, Abreviada y de Pymes. Transformador de XML a XBRL. Es el conjunto de clases encargado de procesar todos los elementos necesarios para generar el documento que constituye el informe XBRL. API XBRL (OS). Librería Java en código abierto, sobre la que se apoyará el servicio para simplificar el tratamiento y proceso del modelo de objetos que constituyen las taxonomías e informes XBRL Transformación desde XBRL a formato común XML Este servicio se encarga de realizar la transformación de un informe XBRL, acorde con la taxonomía PGC2007, en un documento con el mismo formato común definido para la entrada al sistema. Existen también dos escenarios posibles de ejecución del servicio USO1, se indica como entrada la ruta física en la cual se almacenará el documento en formato común resultado de la transformación. Dicha ruta física será accesible dentro del entorno de ejecución del sistema, en caso contrario deberá indicarse un error. USO2, el servicio de transformación devolverá un objeto con el documento respuesta. A continuación se describen las interfaces de entrada, de salida y de errores para los dos tipos de uso indicados. Descripción interfaz USO1 Parámetros de entrada: Documento con informe XBRL. Ruta física del sistema local en la cual se encuentra el documento XBRL que se pretende transformar. 12

13 Ruta física del sistema local en la cual se almacenará el documento XML con formato común como resultado del proceso de transformación. Realizar validación: parámetro lógico (verdadero o falso) mediante el cual se indicará si se debe realizar una validación XBRL previa a la transformación. Parámetros de salida: Documento XML en formato común con la información contenida en la instancia XBRL, el cual será guardado en la ruta física indicada como parámetro de entrada. Errores: Errores de validación XBRL. Son los errores encontrados al realizar la validación del XBRL previa a la transformación. Error creando formato común. Errores detectados al crear la estructura correspondiente al formato común. Error generando documento XML. Errores encontrados al convertir la estructura formato común a XML. Errores validación XML. Errores encontrados al realizar la validación del XML generado con formato común contra el XSD que define dicho formato. Descripción interfaz USO2 Parámetros de entrada: Documento con informe XBRL. Ruta física del sistema local en la cual se encuentra el documento XBRL que se pretende transformar. Realizar validación. Parámetro lógico (verdadero o falso) mediante el cual se indicará si se debe realizar una validación XBRL previa a la transformación. Parámetros de salida: Objeto con el documento XML en formato común con la información contenida en la instancia XBRL. Errores: Los errores serán los mismos que para el USO1. 13

14 Figura 4: Diagrama de actividad para la transformación de XBRL a formato común XML Carga de la Instancia XBRL [Requerida validación] Valida instancia XBRL Crea estructura XML con formato común [Validación correcta] [Error] Devolver errores de validación [Error] Devuelve error creando formato común Genera documento XML [Error] Devuelve error Generando documento Validar documento XML contra esquema XSD de formato común Devuelve errores de validación de formato común El uso de esta funcionalidad conlleva el paso de una serie de parámetros; en uno de ellos se indicará la instancia XBRL que se quiere transformar y por otro lado un parámetro booleano que indicará si se debe validar previamente. Si se valida la instancia y se producen errores, estos errores serán notificados y se terminará el proceso. En caso contrario, se continuará con el proceso y se creará en memoria una estructura en formato común correspondiente a la instancia XBRL. Si todo ha ido sin errores, se generará el documento XML en formato común, el cual será finalmente validado contra el esquema XSD que define el formato común, reportando aquellos errores de validación que puedan producirse. 14

15 En siguiente figura se puede apreciar la arquitectura de conversión de informes XBRL a formato común. Consiste en una arquitectura simétrica a la conversión desde XML en formato común a XBRL, dado que el proceso es el opuesto. Figura 5: Arquitectura de la transformación de XBRL a formato común XML Informe XBRL Identificadores MAPAS Transformador XBRL a XML API XBRL (OS) XML con formato común El proceso de transformación de XBRL a XML en formato común también estará basado en los mismos elementos que su proceso inverso, es decir, Identificadores, Mapas y API XBRL (OS), con la diferencia de que la entrada será XBRL y la salida XML con formato común Servicio de validación de informes XBRL Este servicio se encarga de realizar una validación de la sintaxis de los informes XBRL frente a la especificación XBRL 2.1 y de las reglas semánticas definidas por la taxonomía del Plan General de Contabilidad PGC2007, reglas de cálculo simple entre los elementos reportados, valores de los elementos en su tipo de datos y rango definido, elementos permitidos dentro de los cuadros normalizados. A continuación se describen las interfaces de entrada, salida y errores que se controlan: Descripción del interfaz Parámetros de entrada: Documento informe XBRL. Se indicará la ubicación física del sistema local en la cual se encuentra el documento XBRL que se pretende validar. 15

16 Parámetros de salida: Se devolverá un objeto con el resultado de la validación, además de la descripción de los errores de validación en caso de que la validación no sea satisfactoria. Errores: Error resolviendo dependencia. Este error se notificará cuando no se encuentre cualquiera de las dependencias a las cuales hace referencia la Taxonomía utilizada para validar el informe XBRL. Error de validación de esquema. Error que se generará cuando el documento XBRL no pase la validación XSD contra la Taxonomía. Error de validación XBRL. Error que se notificará cuando no se pase la validación XBRL. A continuación se detalla la secuencia de ejecución del servicio: Figura 6: Diagrama de actividad para la validación de informes XBRL Cargar XBRL Resolver referencias de la Taxonomia Validar XBRL contra esquema de Taxonomia [error] Notificar errores de validación de esquema Realizar validación XBRL [error] Notificar errores de validación 16

17 El proceso de validación se realiza con el objetivo de poder asegurar la calidad de los informes XBRL para el PGC2007 y verificando que cumple con las especificaciones XBRL indicadas en los requisitos. En primer lugar, se realiza la carga del documento XBRL de entrada, el cual se requiere validar. Tras la carga del documento XBRL se procede a la carga de la Taxonomía a la cual hace referencia dicho XBRL y todas las dependencias de dicha Taxonomía, generando de este modo el DTS (Discoverable Taxonomy Set: conjunto de dependencias de la taxonomía) correspondiente. Una vez realizada la validación de esquema, se procederá a notificar los errores, en caso de que existan, o bien a realizar el siguiente paso, es decir, la validación XBRL. La validación XBRL se encarga de comprobar que el documento ha sido creado cumpliendo las especificaciones de la taxonomía XBRL de PGC2007. Finalmente, se procesará el resultado del motor de validación. Funcionalmente, el servicio en este resultado indicará de manera global si la validación es correcta o errónea, y en este último supuesto detallará cada uno de los errores de validación encontrados en el proceso, tratando de dar una descripción lo más adaptada funcionalmente para que se pueda detectar y solucionar la incidencia por parte del generador de informes Servicio de visualización de informes XBRL El servicio de visualización consiste en la generación de una vista HTML de los estados de cuentas a partir de una instancia XBRL de PGC2007. Dado un módulo (Normal, Abreviado o Pymes) y un rol (Balance, Pérdidas y Ganancias, etc.), producirá un documento HTML que facilite la consulta visual de los datos. Descripción del interfaz Parámetros de entrada: Documento XBRL: ruta física del sistema local en la cual se encuentra el documento XBRL con la información a visualizar. Módulo: identificador del módulo que contiene el Rol a visualizar, en base a una codificación de cada módulo del plan general de contabilidad (Estados de Cuentas Normal PGC07-EN, Estados de Cuentas Abreviado PGC07-EA, etc.). Rol: identificador del Rol a visualizar, directamente relacionado con los roles extendidos de presentación propios de la taxonomía y detallados en la documentación de la misma que también están codificados (Balance de Situación BAL y su URI, Cuenta de Pérdidas y Ganancias PYG y su URI, etc.). 17

18 Ruta resultado: será la ruta física del sistema local en la cual se dejará el documento HTML generado. Parámetros de salida: Documento HTML resultado: la respuesta se guardará en la ruta especificada en el parámetro de entrada Ruta resultado. Errores: Error en parámetros de entrada. Será el error que se notifique en el caso de que tras comprobar los parámetros, existe alguna incoherencia. Es decir, que no se alimente alguno de los parámetros, que la ruta del resultado no exista o no haya permisos de acceso a la misma. Error en la carga del informe. Se notificará cuando por algún motivo no se pueda leer el informe XBRL desde la ruta indicada en uno de los parámetros de entrada. Error en la carga del módulo. Podría ser que se indicara un identificador de módulo no existente, con lo cual se notificaría el error indicando que ha habido un error cargando el módulo, debido a que no se ha encontrado en el informe. Error en la carga del rol. Igual que ocurre con el módulo, este error se notificaría en caso de que no existiera el módulo que se ha pasado como parámetro de entrada. A continuación se detallan los pasos de ejecución del servicio: 18

19 Figura 7: Diagrama de actividad para la visualización de informes XBRL Verificar parámetros de entrada [error] Devolver error en Parámetros de entrada Cargar Report [error] Devolver error Cargando Report Cargar Module [error] Devolver error Cargando Module Cargar Rol [error] Devolver error cargando Rol Generar HTML La visualización consiste en la generación de un documento HTML con la representación de un Rol perteneciente al módulo de un informe de entrada. Una vez verificados los parámetros de entrada, se realizará la carga del informe. Si el informe se carga correctamente se procederá a la carga del módulo indicado. Tras la carga del módulo, si éste se ha cargado sin problemas, se hará la carga del Rol requerido. Una vez cargado el Rol sin errores, se ejecutará el proceso de generación del documento HTML con la información obtenida para dicho Rol. 19

20 Servicio de validación de formato común XML La librería de componentes ofrece un servicio que valida los documentos de formato común XML para facilitar al software que lo integre su correcta generación y uso. Dicho servicio consiste en la validación de documento XML, con formato común, comprobando que esté bien formado y su estructura sintáctica sea correcta. Para realizar esta validación se ha definido un documento XML de esquema (XSD) que representa el modelo definido por el formato común. El URI del esquema XSD vendrá informado en el propio XML del formato común. El validador resuelve la localización del esquema XSD gracias a su configuración. En dicha configuración se indica la ruta del sistema local en la cual se encuentra el documento XSD con el que se realizará la validación. Descripción del interfaz Parámetros de entrada: Documento en formato común. Se indicará la ubicación física del sistema local en la cual se encuentra el documento XML en formato común que se pretende validar. Parámetros de salida: Se devolverá un objeto con el resultado de la validación, además de la descripción de los errores de validación en caso de que la validación no sea satisfactoria. Errores: Error resolviendo esquema. Este error se notificará cuando no se encuentre el XSD de formato común. Error de validación de esquema. Error que se generará cuando el documento XML en formato común no pase la validación XSD. 20

21 3.2. CASOS DE USO A continuación, se puede ver el diagrama de casos de uso. En dicho diagrama se aprecia de un modo gráfico la relación entre los actores y los servicios del sistema. Figura 8: Diagrama de casos de uso Transformar informe XBRL a XML formato común: USO1 «extends» «extends» Transformar informe XBRL a XML formato común Transformar informe XBRL a XML formato común: USO2 Visualizar informe XBRL Gestión de errores Valida XML con formato común Aplicación de Gestión Valida informe XBRL Transformar formato común a XBRL: USO1 «extends» Transformar formato común a XBRL: USO2 «extends» Transformar formato común a XBRL 21

22 Actores Los actores serán las aplicaciones de gestión de terceros. Estas aplicaciones de gestión son las utilizadas actualmente para generar los informes de estados de cuentas anuales y memorias del Plan General de Contabilidad, que depositan las empresas en el Registro Mercantil de acuerdo a los modelos. Estas aplicaciones deben adaptarse o utilizar software de terceros mediante mecanismos de integración, para permitir la generación de estos informes en el formato electrónico XBRL, utilizando para ello, por ejemplo, los servicios expuestos por las librerías que en este documento se describen, dentro del marco de desarrollo del proyecto Descripción de los casos de uso Transformar formato común a XBRL. Para simplificar la barrera de complejidad directa del lenguaje XBRL, se parte del supuesto en que las herramientas de gestión de terceros trabajarán con un formato común y estructurado con todos los datos necesarios a la hora de realizar la transformación a XBRL. Este caso de uso, a su vez, se desdobla en dos escenarios posibles, según el resultado se devuelva como un objeto contenedor del documento XBRL (USO 1) o se almacene devolviendo la ruta al documento (USO 2). Esta transformación usará la validación de XML con formato común. Transformar XBRL a formato común. Consiste en el paso contrario al anterior. Dado un documento XBRL se podrá obtener el formato común XML, de modo que pueda ser tratado, por ejemplo, para ser modificado y volver a realizar la conversión a XBRL. Esta transformación usa la validación de XML con formato común. Además, igual que en el caso de uso anterior, según se devuelva la respuesta se derivaran dos casos de uso diferentes. Validar informes XBRL. La validación consiste en el proceso de verificar que una instancia XBRL cumple con las especificaciones XBRL y con la taxonomía del PGC2007. Visualizar informe XBRL. Para poder ver de un modo más legible la información de una instancia XBRL, se proporcionará un generador de HTML. Para ello habrá que indicar una serie de parámetros, Module, Report y Rol. El visualizador usa la transformación de XBRL a formato común. Validar XML con formato común. Consiste en la validación de un documento en formato común contra el esquema XSD y verificar así que está correctamente construido. Gestión de errores. Lo usarán todos los módulos para notificar los errores. 22

23 4. INTEGRACIÓN Y LICENCIA 4.1. INTEGRACIÓN El módulo de software construido es capaz de integrarse en un software de contabilidad: De manera nativa si la aplicación está escrita en lenguaje de programación Java. o Un componente capaz de transformar un documento XML que contenga los estados de cuentas Anuales del modelo Normal, Abreviado y de Pymes, las memorias completas del modelo Abreviado y de Pymes del nuevo plan general de contabilidad PGC 2007 en informes XBRL 2.1 válidos. o Un componente capaz de realizar una validación XBRL 2.1 y dimensional XDT 1.0 de cualquier informe de la taxonomía PGC2007 del nuevo plan general de contabilidad, obteniendo un resultado tratable por cualquier aplicación. o Un componente capaz de obtener una vista HTML de los estado de cuentas anuales de los modelos Normal, Abreviado y Pymes XBRL acorde con la taxonomía del nuevo plan general contable PGC2007. o Un componente capaz de transformar un informe XBRL 2.1 construido con la taxonomía del nuevo Plan general de contabilidad 2007 en un documento XML que contiene los pares de clave y valor y que resulta sencillo de integrar con su software de contabilidad. De forma alternativa permite invocar mediante un cliente de servicios web a los anteriores componentes, en caso de no estar escrita en lenguaje de programación Java. o Para ello la librería desarrollada PGC2007 ha sido probada en un servidor de aplicaciones web TOMCAT empaquetando los servicios en una aplicación web (war archive) ofreciendo los métodos de acceso a los componentes a través de un interfaz de acceso WSDL. Una tercera vía de integración es mediante línea de comandos. De esta forma los programas y aplicaciones pueden, de una forma desacoplada, invocar la ejecución de la librería en su runtime de Java sin tener que realizar desarrollos en este lenguaje, ni servicios web. Así, las aplicaciones Windows no Java invocarán un comando ejecutable con los parámetros adecuados para la utilización de cada uno de los servicios que expone la librería API PGCXBRL

24 4.2. LICENCIA Las fuentes del proyecto se incluyen bajo licencia de código abierto LGPL v3.0 que permite su utilización en aplicaciones de terceros, tanto públicas como comerciales. La siguiente tabla muestra el código libre utilizado por el API XBRL PGC2007 y sus licencias de uso: CÓDIGO LICENCIA Log4J Apache License v2.0 Castor Apache License v2.0 Apache Commons Apache License v2.0 ehcache Apache License v2.0 plugin javax.wsdl_1.5.1 (embebida WSDL4J 1.5.1) Eclipse Public License Version 1.0 (EPL) (embebida desarrollado por IBM y liberado bajo licencia Common Public License Version 1.0) Apache Velocity Apache License v2.0 UBmatrix Processing Engine Open Source GNU General Public License v2.0 (GPL) xml-apis Apache License v2.0 saxon-b Mozilla Public License MPL 1.0 xerces Apache License v2.0 24

25 5. VERSIONES DEL API 5.1. VERSIÓN 1.1. VERSIÓN INICIAL DEL API Esta versión incluye todos los servicios descritos en el presente documento. Los dos modos posibles de integración con esta versión son: De forma nativa. Integración del API en un entorno de ejecución Java. Mediante la utilización de servicios web VERSIÓN 1.2. VERSIÓN MEJORADA DEL API Esta nueva versión incluye las siguientes mejoras respecto a la versión inicial del API (versión 1.1): Adaptación del API a la nueva versión de la taxonomía (versión 1.3). Adaptación del API a los requerimientos de la Orden Ministerial JUS/206/2009 relativa a la presentación de las cuentas anuales según el nuevo PGC2007. Generación de una instancia XBRL única para aquellas empresas interesadas en reportar los estados de cuentas y las memorias de forma conjunta. Incorporación de una nueva forma de integración del API. Solución desarrollada para aquellos programas instalados en plataformas finales de usuario Windows corriendo en entornos de ejecución no Java. Para este escenario de intercomunicación de ambos programas se proporcionan una serie de objetos que encapsulan las clases e interfaces expuestas por la librería, para permitir la invocación mediante una shell de Windows, también conocido como cmd, bat o "línea de comandos", de estos métodos de acceso a los servicios VERSIÓN 1.3. VERSIÓN MEJORADA DEL API Esta nueva versión incluye las siguientes mejoras respecto a la versión anterior del API (versión 1.2): Ampliación de las trazas de debug. Modificación del servicio de validación "traduciendo" errores del API VERSIÓN 1.4. VERSIÓN MEJORADA DEL API Esta nueva versión incluye las siguientes mejoras respecto a la versión anterior del API (versión 1.3): 25

26 Adaptación del API a la nueva versión de la taxonomía (versión 1.4) VERSIÓN VERSIÓN MEJORADA DEL API Esta nueva versión incluye las siguientes mejoras respecto a la versión anterior del API (versión 1.4): Adaptación del API a la nueva versión de la taxonomía (versión errata). 26