Los documentos XBRL e Inline XBRL (iXBRL) son informes comerciales electrónicos estructurados para cumplir con diferentes requisitos comerciales. Un documento XBRL es una colección de hechos que juntos forman un informe comercial. Considerando que, un informe iXBRL es un informe legible por humanos con datos etiquetados incrustados en él. Podemos analizar fácilmente un documento de instancia XBRL o iXBRL mediante programación y leer objetos o elementos como referencia de esquema, contexto, unidad, elementos, etc. En la publicación anterior, vimos cómo crear un documento XBRL. En este artículo, aprenderemos cómo analizar un documento XBRL en Python.
En este artículo se tratarán los siguientes temas:
Biblioteca financiera de Python para analizar XBRL
Para analizar un archivo XBRL o un documento de instancia, usaremos la API Aspose.Finance for Python. Permite crear instancias XBRL, analizar y validar los archivos XBRL o iXBRL.
La clase XbrlDocument de la API representa un documento XBRL que contiene una o más instancias XBRL. Una instancia XBRL es un fragmento XML, cuyo elemento raíz tiene una etiqueta XBRL. La clase XbrlInstance proporciona varios métodos y propiedades para trabajar con instancias XBRL. La clase InlineXbrlDocument de la API representa un documento XBRL en línea.
Descargue el paquete o instale la API desde PyPI usando el siguiente comando pip en la consola:
pip install aspose-finance
Analizar archivo XBRL en Python
Podemos cargar y analizar fácilmente un documento de instancia XBRL siguiendo los pasos que se indican a continuación:
- En primer lugar, cargue un archivo XBRL utilizando la clase XbrlDocument.
- Luego, obtenga todas las instancias usando xbrlinstances.
- Luego, acceda a la instancia XBRL deseada de la colección.
- Después de eso, analice el contenido de la instancia XBRL.
- Finalmente, muestre los datos/información requeridos.
El siguiente ejemplo de código muestra cómo analizar una instancia XBRL en Python.
# Este ejemplo de código demuestra cómo analizar un documento XBRL.
from aspose.finance.xbrl import XbrlDocument
# La ruta al directorio de documentos.
inputFile = "C:\\Files\\Finance\\sample.xbrl"
# Inicializar XbrlDocument
document = XbrlDocument(inputFile)
# Obtener instancias
xbrlInstances = document.xbrl_instances
# Seleccionar instancia específica
xbrlInstance = xbrlInstances[0]
# Analizar gramaticalmente
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units
# Mostrar datos
if contexts.length > 0:
for x in contexts:
print("id: " + x.id)
print("Entity Identifier : " + x.entity.identifier)
Analizar archivo iXBRL en Python
También podemos analizar un documento iXBRL siguiendo los pasos que se indican a continuación:
- En primer lugar, cargue un archivo iXBRL utilizando la clase InlineXbrlDocument.
- Analizar el contenido del documento iXBRL.
El siguiente ejemplo de código muestra cómo analizar un iXBRL en Python.
# Este ejemplo de código demuestra cómo analizar un documento iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument
# La ruta al directorio de documentos.
inputFile = "C:\\Files\\Finance\\Output.html"
# Cargar archivo de entrada
document = InlineXbrlDocument(inputFile)
# Analizar gramaticalmente
inlineFacts = document.facts
contexts = document.contexts
units = document.units
Obtenga una licencia gratis
Puede obtener una licencia temporal gratuita para probar la biblioteca sin limitaciones de evaluación.
Conclusión
En este artículo, hemos aprendido a analizar un documento XBRL o iBXRL en Python. También hemos visto cómo extraer datos de objetos de instancia XBRL mediante programación. Además, puede obtener más información sobre Aspose.Finance for Python API utilizando la documentación. En caso de cualquier ambigüedad, no dude en contactarnos en nuestro foro.