aspose.finanzas

Este artículo proporciona información sobre los informes comerciales que utilizan el estándar XBRL, el propósito de XBRL y cómo automatizar el proceso de creación de informes comerciales basados en XBRL en aplicaciones .NET. Además, contiene métodos paso a paso para analizar archivos XBRL e iXBRL y recuperar datos mediante programación usando C#. Por último, pero no menos importante, proporciona algunas formas sencillas de validar archivos XBRL e iXBRL mediante C#.

Lenguaje extensible de informes comerciales (XBRL)

XBRL es un formato de archivo y un estándar basado en XML utilizado globalmente para informes comerciales. Hace que sea más fácil para varias empresas y organizaciones contables organizar, compilar y comunicar de manera eficiente y precisa los estados financieros u otra información/datos relacionados con las finanzas. Dado que XBRL se basa en XML (lenguaje de marcado extensible), utiliza etiquetas para guardar y analizar cada dato financiero. iXBRL (XBRL en línea) es otra variante que permite mantener los datos financieros en un formato legible por humanos y por máquinas al mismo tiempo. A diferencia de XBRL, iXBRL usa el estándar HTML junto con algunas etiquetas adicionales para figuras y declaraciones.

Las etiquetas tanto en XBRL como en iXBRL se analizan mediante un software compatible con XBRL para recuperar los datos. Para automatizar el análisis de XBRL, Aspose ofrece Aspose.Finance for .NET API. Es una biblioteca de clases .NET que facilita aún más la creación de instancias XBRL mediante programación usando C# o VB.NET. Además, le permite analizar y validar los archivos XBRL o iXBRL dentro de las aplicaciones .NET. Aspose.Finance for .NET proporciona las siguientes funciones de manipulación de XBRL/iXBRL que aprenderá en este artículo.

Puede instalar Aspose.Finance for .NET desde NuGet o descargar su archivo DLL para hacer referencia a él manualmente en su proyecto.

Crear una instancia XBRL desde cero en C#

Aspose.Finance for .NET simplifica la creación de instancias XBRL desde cero. También puede agregar la referencia de esquema, el contexto, las unidades, los elementos, los enlaces de notas al pie, las referencias de funciones y las referencias de funciones de arco en la instancia XBRL recién creada. Los siguientes son los pasos para crear una instancia XBRL:

El siguiente ejemplo de código muestra cómo crear una instancia XBRL en C#.

XbrlDocument document = new XbrlDocument();
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[xbrlInstances.Add()];
document.Save(XbrlFilePath + @"output\document1.xbrl");

Una vez que haya creado la instancia de XBRL, puede insertarle objetos que se analizan en los siguientes artículos:

Analizar archivos XBRL o iXBRL en C#

Aspose.Finance for .NET proporciona una forma sencilla de analizar archivos XBRL y recuperar su contenido en unas pocas líneas de código. Las siguientes secciones contienen los pasos y ejemplos de código de cómo analizar archivos XBRL e iXBRL.

Analizar archivos XBRL en C#

Los siguientes son los pasos para analizar un archivo XBRL usando Aspose.Finance for .NET.

El siguiente ejemplo de código muestra cómo analizar un archivo XBRL en C#.

XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
List<Fact> facts = xbrlInstance.Facts;
SchemaRefCollection schemaRefs = xbrlInstance.SchemaRefs;
List<Context> contexts = xbrlInstance.Contexts;
List<Unit> units = xbrlInstance.Units;

Analizar archivos iXBRL en C#

Analizar un archivo iXBRL es comparativamente más fácil y se puede hacer siguiendo los siguientes pasos.

El siguiente ejemplo de código muestra cómo analizar y leer un archivo iXBRL en C#.

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
List<InlineFact> inlineFacts = document.Facts;
List<Context> contexts = document.Contexts;
List<Unit> units = document.Units;

Validar archivos XBRL o iXBRL en C#

Los archivos XBRL e iXBRL deben cumplir con las reglas de validación en la especificación XBRL y especificación iXBRL respectivamente. Desobedecer las reglas de especificación puede invalidar los archivos. Aspose.Finance for .NET también le permite validar archivos XBRL o iXBRL para descubrir los errores. Las siguientes secciones muestran cómo validar archivos XBRL e iXBRL.

Validar archivos XBRL en C#

Los siguientes son los pasos para validar un archivo XBRL:

El siguiente ejemplo de código muestra cómo validar un archivo XBRL en C#.

XbrlDocument document = new XbrlDocument(XbrlFilePath + @"IdScopeContextPeriodStartAfterEnd.xml");
XbrlInstanceCollection xbrlInstances = document.XbrlInstances;
XbrlInstance xbrlInstance = xbrlInstances[0];
xbrlInstance.Validate();
if(xbrlInstance.ValidationErrors.Count > 0)
{
    List<ValidationError> validationErrors = xbrlInstance.ValidationErrors;
}

Validar archivos iXBRL en C#

Los pasos siguientes se utilizan para validar un archivo XBRL en línea.

El siguiente ejemplo de código muestra cómo validar un archivo iXBRL en C#.

InlineXbrlDocument document = new InlineXbrlDocument(XbrlFilePath + @"account_1.html");
document.Validate();
if (document.ValidationErrors.Count > 0)
{
    List<ValidationError> validationErrors = document.ValidationErrors;
}

Obtenga más información sobre los códigos de error de validación y los mensajes de error aquí.

Explora la API

Puede obtener más información sobre cómo crear, analizar y validar archivos XBRL e iXBRL en el siguiente recurso:

Pruebe Aspose.Finance for .NET gratis

Aspose ofrece una licencia temporal para evaluar sus API sin costo alguno. También puede publicar su solicitud y obtener una licencia temporal.

Ver también