Convalida XBRL in Python

XBRL sta per XML Linguaggio di reporting aziendale basato. È semplicemente uno schema che aiuta le aziende a organizzare i propri dati in modo che possano condividere le informazioni tra i vari dipartimenti all’interno dell’azienda. I documenti XBRL e Inline XBRL (iXBRL) sono report aziendali elettronici strutturati per soddisfare diversi requisiti aziendali. Non è solo un altro tipo di documento commerciale noioso: i documenti XBRL contengono determinate strutture, formati e caratteristiche che possono essere utilizzati per convalidare i documenti finanziari. Possiamo facilmente convalidare un documento di istanza XBRL o iXBRL a livello di codice. In questo articolo impareremo come convalidare un documento XBRL in Python.

In questo articolo verranno trattati i seguenti argomenti:

  1. API Python XBRL Validator per convalidare il documento XBRL
  2. Convalida file XBRL
  3. Convalida file XBRL in linea

API Python XBRL Validator per convalidare il documento XBRL

Per convalidare un file XBRL o un documento di istanza, utilizzeremo l’API Aspose.Finance for Python. Consente di creare istanze XBRL, analizzare e convalidare i file XBRL o iXBRL.

L’API fornisce la classe XbrlDocument che rappresenta un documento XBRL contenente una o più istanze XBRL. Un’istanza XBRL è un frammento XML, con l’elemento radice che ha un tag XBRL. La classe XbrlInstance fornisce vari metodi e proprietà per lavorare con le istanze XBRL. Il metodo validate() di questa classe convalida l’istanza XBRL selezionata. Abbiamo la classe InlineXbrlDocument dell’API che rappresenta un documento XBRL inline. Inoltre, l’enumerazione ValidationErrorCode dell’API definisce tutti i codici di errore di convalida e il rispettivo messaggio di errore.

Si prega di scaricare il pacchetto o installare l’API da PyPI utilizzando il seguente comando pip nella console:

pip install aspose-finance

Convalida il documento XBRL in Python

Possiamo facilmente caricare e convalidare un documento di istanza XBRL seguendo i passaggi indicati di seguito:

  1. Innanzitutto, carica un file XBRL utilizzando la classe XbrlDocument.
  2. Quindi, ottieni tutte le istanze usando xbrlinstances.
  3. Quindi, accedi all’istanza XBRL desiderata dalla raccolta.
  4. Successivamente, chiama il metodo validate() per convalidare l’istanza XBRL.
  5. Infine, mostra gli eventuali errori.

L’esempio di codice seguente mostra come convalidare un’istanza XBRL in Python.

# Questo esempio di codice mostra come convalidare il documento di istanza XBRL.
from aspose.finance.xbrl import XbrlDocument

# Il percorso del documento di input
inputFile = "C:\Files\sample.xbrl"

# Carica il file XBRL
document = XbrlDocument(inputFile)

# Ottieni istanze
xbrlInstances = document.xbrl_instances

# Seleziona un'istanza specifica
xbrlInstance = xbrlInstances[0]

# Convalidare
xbrlInstance.validate()

# Mostra eventuali errori di convalida
if xbrlInstance.validation_errors.length > 0:
    for validationError in xbrlInstance.validation_errors:
        print(validationError.message)

Convalida il documento XBRL in linea in Python

Possiamo anche convalidare un documento iXBRL seguendo i passaggi indicati di seguito:

  1. Innanzitutto, carica un file iXBRL utilizzando la classe InlineXbrlDocument.
  2. Successivamente, chiama il metodo validate() per convalidare l’istanza XBRL.
  3. Infine, mostra gli eventuali errori.

L’esempio di codice seguente mostra come convalidare un documento XBRL o iXBRL inline in Python.

# Questo esempio di codice mostra come convalidare il documento Inline XBRL.
from aspose.finance.xbrl.inline import InlineXbrlDocument

# Il percorso del documento di input
inputFile = "C:\Files\sample.html"

# Carica il file XBRL
document = InlineXbrlDocument(inputFile)

# Convalidare
document.validate();

# Mostra eventuali errori di convalida
if document.validation_errors.length > 0:
    for validationError in document.validation_errors:
        print(validationError.message)

Ottieni una licenza gratuita

Puoi ottenere una licenza temporanea gratuita per provare la libreria senza limitazioni di valutazione.

Conclusione

In questo articolo, abbiamo imparato come convalidare un documento XBRL in Python. Abbiamo anche visto come convalidare un documento XBRL inline a livello di codice. Inoltre, puoi saperne di più su Aspose.Finance per l’API Python usando documentazione. In caso di ambiguità, non esitare a contattarci sul nostro forum di supporto gratuito.

Guarda anche