Os documentos XBRL e Inline XBRL (iXBRL) são relatórios de negócios eletrônicos estruturados para atender a diferentes requisitos de negócios. Um documento XBRL é uma coleção de fatos que juntos formam um relatório de negócios. Considerando que, um relatório iXBRL é um relatório legível por humanos com dados marcados incorporados nele. Podemos facilmente analisar um documento de instância XBRL ou iXBRL programaticamente e ler objetos ou elementos como referência de esquema, contexto, unidade, itens, etc. No post anterior, vimos como criar um documento XBRL. Neste artigo, aprenderemos como analisar um documento XBRL em Python.
Os seguintes tópicos serão abordados neste artigo:
Python Finance Library para analisar XBRL
Para analisar um arquivo XBRL ou documento de instância, usaremos a API Aspose.Finance for Python. Ele permite criar instâncias XBRL, analisar e validar os arquivos XBRL ou iXBRL.
A classe XbrlDocument da API representa um documento XBRL contendo uma ou mais instâncias XBRL. Uma instância XBRL é um fragmento XML, com o elemento raiz tendo uma tag XBRL. A classe XbrlInstance fornece vários métodos e propriedades para trabalhar com instâncias XBRL. A classe InlineXbrlDocument da API representa um documento XBRL embutido.
Por favor, faça o download do pacote ou instale a API de PyPI usando o seguinte comando pip no console:
pip install aspose-finance
Analisar arquivo XBRL em Python
Podemos carregar e analisar facilmente um documento de instância XBRL seguindo as etapas abaixo:
- Primeiramente, carregue um arquivo XBRL usando a classe XbrlDocument.
- Em seguida, obtenha todas as instâncias usando o xbrlinstances.
- Em seguida, acesse a instância XBRL desejada da coleção.
- Depois disso, analise o conteúdo da instância XBRL.
- Por fim, mostre os dados/informações necessários.
O exemplo de código a seguir mostra como analisar uma instância XBRL em Python.
# Este exemplo de código demonstra como analisar o documento XBRL.
from aspose.finance.xbrl import XbrlDocument
# O caminho para o diretório de documentos.
inputFile = "C:\\Files\\Finance\\sample.xbrl"
# Inicializar XbrlDocument
document = XbrlDocument(inputFile)
# Obter instâncias
xbrlInstances = document.xbrl_instances
# Selecione uma instância específica
xbrlInstance = xbrlInstances[0]
# Analisar
facts = xbrlInstance.facts
schemaRefs = xbrlInstance.schema_refs
contexts = xbrlInstance.contexts
units = xbrlInstance.units
# Mostrar dados
if contexts.length > 0:
for x in contexts:
print("id: " + x.id)
print("Entity Identifier : " + x.entity.identifier)
Analisar arquivo iXBRL em Python
Também podemos analisar um documento iXBRL seguindo as etapas abaixo:
- Primeiramente, carregue um arquivo iXBRL usando a classe InlineXbrlDocument.
- Analise o conteúdo do documento iXBRL.
O exemplo de código a seguir mostra como analisar um iXBRL em Python.
# Este exemplo de código demonstra como analisar o documento iXBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument
# O caminho para o diretório de documentos.
inputFile = "C:\\Files\\Finance\\Output.html"
# Carregar arquivo de entrada
document = InlineXbrlDocument(inputFile)
# Analisar
inlineFacts = document.facts
contexts = document.contexts
units = document.units
Obtenha uma licença gratuita
Você pode obter uma licença temporária gratuita para experimentar a biblioteca sem limitações de avaliação.
Conclusão
Neste artigo, aprendemos como analisar um documento XBRL ou iBXRL em Python. Também vimos como extrair dados de objetos de instância XBRL programaticamente. Além disso, você pode aprender mais sobre o Aspose.Finance for Python API usando a documentação. Em caso de qualquer ambiguidade, não hesite em contactar-nos no nosso fórum.