Los informes comerciales electrónicos estructurados se componen de documentos XBRL y documentos Inline XBRL (iXBRL). En XBRL, los informes comerciales son colecciones de hechos. Alternativamente, un informe iXBRL es legible por humanos y contiene datos etiquetados. Mediante programación, podemos leer documentos de instancia XBRL o iXBRL y recuperar referencias de esquema, contextos, elementos, etc. En este artículo, aprenderemos a leer archivos XBRL en Python.
En este artículo se tratarán los siguientes temas:
Lector Python XBRL para leer XBRL
Para leer archivos XBRL o documentos de instancia, usaremos la API Aspose.Finance for Python. Permite crear documentos de instancia XBRL, analizar y validar los archivos XBRL o iXBRL.
La API proporciona la clase XbrlDocument que representa un documento XBRL que contiene una o más instancias XBRL. La clase XbrlInstance proporciona varios métodos y propiedades para trabajar con instancias XBRL. Tenemos la clase InlineXbrlDocument que 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
Leer archivos XBRL usando Python
Podemos cargar y leer 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 accediendo usando su índice de la colección.
- Después de eso, lea el contenido de la instancia XBRL.
- Finalmente, muestre los datos/información requeridos.
El siguiente ejemplo de código muestra cómo leer un archivo XBRL en Python.
# Este ejemplo de código demuestra cómo leer un archivo XBRL.
from aspose.finance.xbrl import XbrlDocument
# Cargar documento XBRL
document = XbrlDocument("C:\\Files\\sample.xbrl")
# Obtener instancias
xbrlInstances = document.xbrl_instances
# Seleccionar instancia específica
xbrlInstance = xbrlInstances[0]
# Extraer y leer
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)
Leer archivos iXBRL en Python
También podemos leer un documento iXBRL siguiendo los pasos que se detallan a continuación:
- En primer lugar, cargue un archivo iXBRL usando la clase InlineXbrlDocument.
- Lea el contenido del documento iXBRL.
El siguiente ejemplo de código muestra cómo leer un archivo 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\\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 leer archivos XBRL 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 usando documentación. En caso de cualquier ambigüedad, no dude en contactarnos en nuestro foro de soporte gratuito.