The AMANA XBRL Portal has a SOAP Webservice, that can be used to:

• Process XBRL files (validation, KPI/CVE evaluation)
• Get the status information and validation results of processed XBRL files
• Get processed XBRL files or its Excel visualizations
• Get server status
• Execute Data Source Queries and generate XBRL files
• Other internally used methods

The webservice WSDL file can be found in the System Settings → System Info menu (usage of single file WSDL is recommended).

AMANA recommends to implement a call for this webservice using tools that will auto-generate coresponding client code, like JAX-WS, Apache AXIS2 or Visual Studio "Add Reference" WCF (.NET). It is possible to test the webservice with SOAP UI.

Tjhe webservices uses basic authentification to authorize requests. All users that are authorized in the XBRL Portal can use the webservice. However, AMANA recommends to use a technical user, that exists by default:

• Username: xbrlServerUser
• Default Password: will be provided by the AMANA Support and can be changed in the User management.
• WSS-Password Type: PasswordText

Method ProcessFiling

The async ProcessFiling method can be used to process an XBRL file (ZIP) to the XBRL Portal. An MD5 hash will be calculated on the XBRL files, and duplicates will be rejected. If the XBRL file can't be mapped to an entity or reporting requirement, or if an unexpected error appeared, the XBRL file will be stored in the rejected filings. 

Parameters

Returns

The ProcessFiling Method returns an ProcessingResult, that has the following properties. It is also returned by the GetProcessingResult method documented below.

Method GetProcessingResult

The method returns a processing result for a given processing identified by its GUID. If the processing is still any status other then RanToCompletition (5), it won't return any property other then Status.

Parameters

Returns

Method GetXbrlFile

Returns the XBRL file and optional the Excel visualization file of a created or processed filing, based on the ProcessingID or Filing Version ID.

Parameters

Returns

Method ExcecuteQueriesAndGenerateXbrl

Runs a set of queries defined in the Data Source Queries and generates the XBRL file accordingly.

Parameters

Sample request

<?xml version="1.0" encoding="UTF-8"?>
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://amana.xbrl.service/version/1003" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
   <soapenv:Header/>
   <soapenv:Body>
      <ns:ExcecuteQueriesAndGenerateXbrl>
         <!--Required:-->
         <ns:entityXbrlIdentifier>IYKCAVNFR8QGF00HV840</ns:entityXbrlIdentifier>
         <!--Required:-->
         <ns:reportingDueDate>2018-12-31T00:00:00</ns:reportingDueDate>
         <!--Required:-->
         <ns:taxonomyEntryPoint>http://www.eba.europa.eu/eu/fr/xbrl/crr/fws/ae/cir-680-2014/2018-03-31/mod/ae_con.xsd</ns:taxonomyEntryPoint>
         <!--Required:-->
         <ns:isoCurrencyCode>CZK</ns:isoCurrencyCode>
         <!--Required:-->
         <ns:keepLastFilingVersionData>false</ns:keepLastFilingVersionData>
         <!--Required:-->
         <ns:queryVariables>
            <!--Queries to execute, Key = Query ID:-->
            <arr:KeyValueOfintArrayOfKeyValueOfstringstringty7Ep6D1>
               <arr:Key>6</arr:Key>
               <arr:Value>
                  <!--Zero or more repetitions:-->
                  <arr:KeyValueOfstringstring>
                     <arr:Key>ShowEmptyValueMessages</arr:Key>
                     <arr:Value>false</arr:Value>
                  </arr:KeyValueOfstringstring>
               </arr:Value>
            </arr:KeyValueOfintArrayOfKeyValueOfstringstringty7Ep6D1>
			<arr:KeyValueOfintArrayOfKeyValueOfstringstringty7Ep6D1>
               <arr:Key>3</arr:Key>
               <arr:Value>
                  <!--Zero or more repetitions:-->
                  <arr:KeyValueOfstringstring>
                     <arr:Key>ShowEmptyValueMessages</arr:Key>
                     <arr:Value>false</arr:Value>
                  </arr:KeyValueOfstringstring>
               </arr:Value>
            </arr:KeyValueOfintArrayOfKeyValueOfstringstringty7Ep6D1>
         </ns:queryVariables>
      </ns:ExcecuteQueriesAndGenerateXbrl>
   </soapenv:Body>
</soapenv:Envelope>

Returns