Altova RaptorXML+XBRL Server 2024

En el siguiente ejemplo explicaremos cómo validar un archivo XBRL. Uno de los posibles problemas es que podrían faltar una o varias taxonomías. En estos casos, RaptorXML+XBRL Server indicará cuál es el problema y cómo podría solucionarlo.

Validar XBRL desde la línea de comandos

Si faltan taxonomías puede que la validación de error. Por ejemplo, al usar PowerShell para ejecutar un comando de validación, podría ocurrir lo siguiente:

PS C:\temp\Nanonull> raptorxmlxbrl valxbrl nanonull.xbrl

 
file:///C:/temp/Nanonull/nanonull.xbrl: runtime="141ms" result="Failed"
Error: file:///C:/temp/Nanonull/nanonull.xsd:52:

  No se puede cargar el esquema con el espacio de nombres de destino 'http://fasb.org/us-types/2013-01-31'

  de 'http://xbrl.fasb.org/us-gaap/2013/elts/us-types-2013-01-31.xsd'.
FatalError: Error en la operación I/O en el archivo 'http://xbrl.fasb.org/us-gaap/2013/elts/us-types-2013-01-31.xsd'.
Detalles: Error I/O 1001: El archivo 'us-types-2013-01-31.xsd' forma parte de la taxonomía 'US GAAP 2013.01’ que falta.

  Llame 'C:\ProgramData\Altova\SharedBetweenVersions\taxonomymanager.exe install us-gaap-2013.0'.

En este caso, ejecute el comando sugerido del Gestor de Taxonomías de Altova:

PS C:\temp\Nanonull> C:\ProgramData\Altova\SharedBetweenVersions\taxonomymanager.exe instalar us-gaap-2013.0
Instalar ratings-2015.0.0, us-gaap-2013.0.0.
Crear la carpeta C:\ProgramData\Altova\pkgs\xbrl\atings\.
Descargar de la tienda de taxonomías de Altova: ratings-2015-03-31_0.zip.
Crear la carpeta C:\ProgramData\Altova\pkgs\xbrl\us-gaap\.
Descargar de la tienda de taxonomías de Altova: country-2012-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: country-2013-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: edgartaxonomies-2013_0.xml.
Descargar de la tienda de taxonomías de Altova: dei-2012-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: currency-2011-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: dei-2013-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: currency-2012-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: invest-2012-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: rr-2010-02-28_0.zip.
Descargar de la tienda de taxonomías de Altova: exch-2013-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: invest-2013-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: naics-2011-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: rr-2012-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: sic-2011-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: stpr-2011-01-31_0.zip.
Descargar de la tienda de taxonomías de Altova: us-gaap-2013-01-31_0.zip.
Aceptar.

Confirme las taxonomías instaladas usando el Gestor de taxonomías:

PS C:\temp\Nanonull> taxonomymanager list -i
PKGID             NAME VERSION      STATUS
ratings-2015.0    "Ratings 2015"    instalado: ratings-2015.0.0 "2015.03"
us-gaap-2013.0    "US GAAP 2013"    instalado: us-gaap-2013.0.0 "2013.01"
2 paquetes, 0 actualizable
Aceptar.

Una vez haya instalado correctamente las taxonomías mediante el Gestor de taxonomías, la validación debería ejecutarse con éxito:

PS C:\temp\Nanonull> raptorxmlxbrl valxbrl nanonull.xbrl
file:///C:/temp/Nanonull/nanonull.xbrl: runtime="787ms" result="OK"

Probar solicitudes POST con CURL

Ahora es posible hacer las pruebas de solicitudes POST con CURL:

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", ["args\":[\"file:///C:/temp/Nanonull/nanonull.xbrl\"], \"options\":{}};type=application/json' http://localhost:8087/v1/queue

El resultado es:

"state": "OK"

Use POST para cargar el archivo instalado usando el esquema additional-files:

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"additional-files:///nanonull.xbrl\"], \"options\":{}};type=application/json'

-F "additional-files=@nanonull.xbrl;type=application/xml" http://localhost:8087/v1/queue

Asumimos que la taxonomía nanonull.xsd no se encuentra. Recibiremos el siguiente resultado:

Error: additional-files:///nanonull.xbrl:3: El valor 'nanonull.xsd' del atributo 'xlink:href’ en el elemento <link:schemaRef> debe hacer referencia a un esquema de taxonomía válido.

Error: Error en la operación I/O en el archivo 'additional-files:///nanonull.xsd’.

Detalles: Error de sistema 2: El sistema no encuentra el archivo especificado.

  Error I/O 400: No hay información sobre cómo gestionar el URI relativo (falta el nombre del esquema).

FatalError: additional-files:///nanonull.xbrl:2: El DTS encontrado en la instancia XBRL <xbrli:xbrl> no es válido.

Entonces incluimos la taxonomía y sus archivos asociados en la solicitud POST tal y como está enumerado a continuación:

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"additional-files:///nanonull.xbrl\"], \"options\":{}};type=application/json' -F "additional-files=@nanonull.xbrl;type=application/xml" -F "additional-files=@nanonull.xsd;type=application/xml" -F "additional-files=@nanonull_cal.xml;type=application/xml" -F "additional-files=@nanonull_def.xml;type=application/xml" -F "additional-files=@nanonull_for.xml;type=application/xml" -F "additional-files=@nanonull_lab.xml;type=application/xml" -F "additional-files=@nanonull_pre.xml;type=application/xml" -F "additional-files=@nanonull_tab.xml;type=application/xml" http://localhost:8087/v1/queue

Por último, podemos enviar el archivo entero Nanonull.zip:

PS C:\temp\Nanonull> curl.exe -F 'msg={\"command\": \"xbrl\", \"args\":[\"additional-files:///Nanonull.zip%7Czip/nanonull.xbrl\"], \"options\":{}};type=application/json' -F "additional-files=@Nanonull.zip;type=application/octet-stream" http://localhost:8087/v1/queue