Il service consente di ottenere copia del bilancio ufficiale depositato presso la Camera di Commercio. Il bilancio sarà fornito anche in formato XBRL e con verbale assemblea soci.

1) RICHIEDERE UN BILANCIO (POST /bilancio-ottico)

Per richiedere un bilancio è necessario uno dei seguenti dati:

• Partita IVA / Codice Fiscale dell'Azienda
• ID azienda

L'ID è ottenibile tramite i due servizi di ricerca commerciale a partire dal nome (o da alcuni criteri come codice ateco e fatturato) oppure dalla partita IVA / codice fiscale. Nella risposta alle richieste di entrambi gli endpoint oltre all'id e ad informazioni come denominazione completa viene fornito anche l'elenco delle visure richiedibili per quell'azienda.

ESEMPIO RICHIESTA POST /bilancio-ottico

Questo è un esempio di richiesta di bilancio per la società con partita IVA 12485671007.

{
    "cf_piva_id": "12485671007"
    }

E' possibile richiedere anche il bilancio storico, cioè indicare l'anno di deposito. In questo caso sarà necessario inserire nella richiesta il parametro facoltativo anno_chiusura. In assenza del parametro verrà restituito l'ultimo disponibile. 

In fase di richiesta suggeriamo di impostare una callback per essere aggiornati quando il documento è disponibile. 

ESEMPIO RISPOSTA POST /bilancio-ottico

La risposta includerà l'anno di chiusura, lo stato della richiesta, se è stata indicata una callback e soprattutto l'id richiesta necessario per scaricare successivamente il documento

{ "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 questo caso l'anno di chiusura è null, perché non è stato passato come parametro e quindi nella risposta verrà restituito l'ultimo disponibile.

2) SCARICARE IL BILANCIO (GET /bilancio-ottico/{id}/allegati)

Una volta che la richiesta è passata in stato di "evaso", è possibile scaricare il documento tramite l'endpoint GET /bilancio-ottico/{id}/allegati

ESEMPIO RICHIESTA POST /bilancio-ottico/{id}/allegati

La richiesta dovrà includere l'id a cui abbiamo precedentemente riferimento.

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

ESEMPIO RISPOSTA POST/bilancio-ottico/{id}/allegati

La risposta indicherà nome del file, dimensione e file.

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

Il contenuto del file è codificato in base64 ed include anche la versione XBRL del bilancio.

Nel file zip presente nella risposta saranno disponiibili i seguenti documenti:

• Bilancio di Esercizio
• Bilancio in XBRL
• Verbale dell’assemblea dei soci

3) VERIFICARE RICHIESTA BILANCIO (GET /bilancio-ottico/{id})

Una volta effettuata la richiesta è possibile in qualsiasi momento verificare lo stato del bilancio. 

ESEMPIO RICHIESTA GET /bilancio-ottico/{id}

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

ESEMPIO RISPOSTA GET /bilancio-ottico/{id}

La risposta includerà:

• lo stato della richiesta
• il timestamp della richiesta
• il timestamp dell'aggiornamento dello stato della richiesta
• l'anno di chiusura

{ "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
      }

Con il service Bilancio è possibile conoscere lo stato economico e finanziario di un'impresa e verificarne l'andamento e la stabilità nell'ultimo anno o di un anno in particolare.