Bilanz der italienischen Unternehmen

Der Service ermöglicht es, eine Kopie des offiziellen Jahresabschlusses, der bei der Handelskammer hinterlegt ist, zu erhalten. Der Jahresabschluss wird auch im XBRL-Format und mit dem Protokoll der Gesellschafterversammlung bereitgestellt.

Es ist möglich, den Jahresabschluss über die API Handelsregisterauszüge anzufordern, und der entsprechende Endpunkt ist POST / visurecamerali.openapi.it/bilancio-ottico

ANFRAGE EINES JAHRESABSCHLUSSES

POST /bilancio-ottico

Um einen Jahresabschluss anzufordern, benötigen Sie eine der folgenden Angaben:

Die ID kann über die beiden kommerziellen Suchdienste anhand des Namens (oder einiger Kriterien wie Wirtschaftsaktivitätscode und Umsatz) oder über die USt-IdNr. / Steuer-ID ermittelt werden. In der Antwort auf Anfragen an beide Endpunkte werden neben der ID und Informationen wie dem vollständigen Namen auch die verfügbaren Abfragen für das Unternehmen bereitgestellt.

BEISPIEL ANFRAGE

POST /bilancio-ottico

Dies ist ein Beispiel für eine Anfrage des Jahresabschlusses für das Unternehmen mit der USt-IdNr. 12485671007.

{
    "cf_piva_id": "12485671007"
    }

Es ist auch möglich, den historischen Jahresabschluss anzufordern, indem das Jahr der Hinterlegung angegeben wird. In diesem Fall muss der optionale Parameter anno_chiusura in die Anfrage aufgenommen werden. Fehlt der Parameter, wird der zuletzt verfügbare Abschluss zurückgegeben.

Bei der Anfrage empfehlen wir, eine Callback-URL einzurichten, um benachrichtigt zu werden, wenn das Dokument verfügbar ist.

BEISPIEL ANTWORT

POST /bilancio-ottico

Die Antwort enthält das Abschlussjahr, den Status der Anfrage, ob eine Callback-URL angegeben wurde und insbesondere die benötigte ID zum späteren Herunterladen des Dokuments.

{ "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 diesem Fall ist das Abschlussjahr null, da es nicht als Parameter übermittelt wurde und daher in der Antwort der zuletzt verfügbare Abschluss zurückgegeben wird.

JAHRESABSCHLUSS HERUNTERLADEN

GET /bilancio-ottico/{id}/allegati

Sobald die Anfrage den Status „erledigt“ erreicht hat, kann das Dokument über den Endpunkt GET /bilancio-ottico/{id}/allegati heruntergeladen werden.

BEISPIEL ANFRAGE

POST /bilancio-ottico/{id}/allegati

Die Anfrage muss die ID enthalten, auf die wir uns zuvor bezogen haben.

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

BEISPIEL ANTWORT

POST /bilancio-ottico/{id}/allegati

Die Antwort enthält den Dateinamen, die Größe und die Datei.

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

Der Inhalt der Datei ist base64-kodiert und enthält auch die XBRL-Version des Jahresabschlusses.

Die im Antwort-zip enthaltenen Dokumente sind:

ANFRAGE ZUM JAHRESABSCHLUSS ÜBERPRÜFEN

GET /bilancio-ottico/{id}

Nach der Anfrage kann jederzeit der Status des Jahresabschlusses überprüft werden.

BEISPIEL ANFRAGE

GET /bilancio-ottico/{id}

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

BEISPIEL ANTWORT

GET /bilancio-ottico/{id}

Die Antwort enthält:

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

Mit dem Bilanzservice können Sie den wirtschaftlichen und finanziellen Status eines Unternehmens einsehen und dessen Entwicklung und Stabilität im letzten Jahr oder in einem bestimmten Jahr überprüfen.