The service allows you to obtain a copy of the official financial statement deposited at the Chamber of Commerce. The financial statement will also be provided in XBRL format along with the minutes of the shareholders' meeting.

1) REQUEST A FINANCIAL STATEMENT (POST /bilancio-ottico)

One of the following is required to request a balance:

• VAT Number / Tax Code of the Company/li>
• Company ID

The ID can be obtained through the two business search services based on the name (or some criteria such as activity code and turnover) or through the VAT number / tax code. In the response to requests from both endpoints, in addition to the ID and information such as the complete name, a list of obtainable extracts for that company is also provided.

SAMPLE REQUEST POST /bilancio-ottico

This is an example of a budget request for a company with a VAT number 12485671007.

{
    "cf_piva_id": "12485671007"
    }

It is also possible to request the historical financial statement, meaning specifying the deposition year. In this case, it will be necessary to include the optional parameter 'anno_chiusura' in the request. In the absence of the parameter, the latest available financial statement will be returned

During the request, we suggest setting up a callback to be notified when the document is available.

SAMPLE RESPONSE POST /bilancio-ottico

The response will include the closing year, the status of the request, whether a callback has been indicated, and especially the request ID necessary for downloading the document later.

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "anno_chiusura": null,
     "tipo": "bilancio-ottico",
     "stato_richiesta": "In ricerca",
     "timestamp_creation": 1701095027,
     "timestamp_last_update":1701095027,
     "allegati": [],
     "callback": false,
     "owner": "[email protected]",
     "id": "6564a6739b25c29e4f0dab34"
      },
        "message": "",
        "success": true,
        "error": null
      }

In this case, the closing year is null because it was not passed as a parameter. Therefore, in the response, the latest available financial statement will be returned

2) DOWNLOAD THE FINANCIAL STATEMENT(GET /bilancio-ottico/{id}/allegati)

Once the request has transitioned to the 'fulfilled' status, it is possible to download the document through the endpoint GET /bilancio-ottico/{id}/allegati

SAMPLE REQUEST POST /bilancio-ottico/{id}/allegati

The request must include the id we have previously referred to.

https://visurecamerali.openapi.it/6564a6739b25c29e4f0dab34/allegati

SAMPLE RESPONSE POST POST/bilancio-ottico/{id}/allegati

The response will indicate name, size and file.

{ "data": 
    {
    "nome": "6564a673ccfa313352066377.zip",
    "dimensione": 1728,
    "file": "UEsDBBQAAAAlNnVTBs6lJ1vIIAJthCQAcABwANjI2OTFjNGY5N2UwOTQ0NzU0MDI3ADU/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
      }

The content of the file is encoded in base64 and includes the XBRL version of the financial statement.

In the zip file provided in the response, the following documents will be available:

• Income Statement
• XBRL Balance Sheet
• Minutes of the shareholders' meeting

3) VERIFY FINANCIAL STATEMENT REQUEST (GET /optical-balance/{id})

Once the request is made, it is possible to check the status of the financial statement at any time.

SAMPLE REQUEST GET /bilancio-ottico/{id}

https://visurecamerali.openapi.it/6564a6739b25c29e4f0dab34

SAMPLE RESPONSE POST GET /bilancio-ottico/{id}

The response will include:

• The status of the request
• The timestamp of the request
• The timestamp of the request status update
• The closing year

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "anno_chiusura": null,
     "tipo": "bilancio-ottico",
     "stato_richiesta": "Dati Disponibili",
     "timestamp_creation": 1701095027,
     "timestamp_last_update":1701095027,
     "allegati": [],
     "callback": false,
     "owner": "[email protected]",
     "id": "6564a6739b25c29e4f0dab34"
      },
        "success": true,
        "message": "",
        "error": null
      }

With the Bilancio service, it is possible to understand the economic and financial status of a company, as well as verify its performance and stability in the last year or a specific year.