Bilan d'Entreprise

Le service permet d'obtenir une copie du bilan officiel déposé auprès de la Chambre de Commerce. Le bilan sera également fourni au format XBRL et avec le procès-verbal de l'assemblée des sociétaires.

DEMANDER UN BILAN

POST /bilancio-ottico

Pour demander un bilan, il est nécessaire de fournir l'une des informations suivantes :

L'ID peut être obtenu via les deux services de recherche commerciale à partir du nom (ou de certains critères tels que le code ATECO et le chiffre d'affaires) ou à partir du numéro de TVA / code fiscal. Dans la réponse aux demandes envoyées aux deux points de terminaison, en plus de l'ID et des informations telles que le nom complet, la liste des documents disponibles pour cette entreprise est également fournie.

EXEMPLE DE DEMANDE

POST /bilancio-ottico

Voici un exemple de demande de bilan pour l'entreprise avec le numéro de TVA 12485671007.

{
    "cf_piva_id": "12485671007"
    }

Il est également possible de demander le bilan historique, c'est-à-dire de spécifier l'année de dépôt. Dans ce cas, il est nécessaire d'inclure le paramètre optionnel anno_chiusura dans la demande. Si le paramètre n'est pas fourni, le bilan le plus récent sera retourné.

Lors de la demande, nous vous suggérons de configurer un callback pour être informé lorsque le document est disponible.

EXEMPLE DE RÉPONSE

POST /bilancio-ottico

La réponse inclura l'année de clôture, le statut de la demande, si un callback a été spécifié et surtout l'ID de la demande nécessaire pour télécharger ultérieurement le document.

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "anno_chiusura": null,
     "tipo": "bilancio-ottico",
     "stato_richiesta": "En recherche",
     "timestamp_creation": 1701095027,
     "timestamp_last_update":1701095027,
     "allegati": [],
     "callback": false,
     "owner": "gcloud-tests@openapi.it",
     "id": "6564a6739b25c29e4f0dab34"
      },
        "message": "",
        "success": true,
        "error": null
      }

Dans ce cas, l'année de clôture est nulle, car elle n'a pas été transmise comme paramètre et donc dans la réponse, le bilan le plus récent sera retourné.

TÉLÉCHARGER LE BILAN

GET /bilancio-ottico/{id}/allegati<

Une fois que la demande a été marquée comme « remplie », vous pouvez télécharger le document via le point de terminaison GET /bilancio-ottico/{id}/allegati<

EXEMPLE DE DEMANDE

POST /bilancio-ottico/{id}/pieces-jointes

La demande doit inclure l'ID auquel nous avons précédemment fait référence.

https://visurecamerali.openapi.it/6564a6739b25c29e4f0dab34/pieces-jointes

EXEMPLE DE RÉPONSE

POST /bilancio-ottico/{id}/pieces-jointes

La réponse inclura le nom du fichier, la taille et le fichier.

{ "data": 
    {
    "nom": "6564a673ccfa313352066377.zip",
    "taille": 1728,
    "fichier": "UEsDBBQAAAAlNnVTBs6lJ1vIIAJthCQAcABwANjI2OTFjNGY5N2UwOTQ0NzU0MDI3ADU/HOUbc+WLQqnnTtt27Zt27Zt25k7bdu2bdvcadv5fnXOqapz655qt9p93x/vW62tFjHnGmv2HiMiZvQxY7RJIi8sSsNAywxFcnA4uwjFgE+Pb2doCcXNTSdqYe1s4kgnam3gbCJsYmRnbEInbWJr5"
      }

Le contenu du fichier est encodé en base64 et comprend également la version XBRL du bilan.

Le fichier zip dans la réponse contiendra les documents suivants :

VÉRIFIER LA DEMANDE DE BILAN

GET /bilancio-ottico/{id}

Après avoir effectué la demande, vous pouvez vérifier à tout moment l'état du bilan.

EXEMPLE DE DEMANDE

GET /bilancio-ottico/{id}

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

EXEMPLE DE RÉPONSE

GET /bilancio-ottico/{id}

La réponse inclura :

{ "data": 
    {
     "cf_piva_id": "12485671007",
     "annee_cloture": null,
     "type": "bilancio-ottico",
     "statut_demande": "Données Disponibles",
     "timestamp_creation": 1701095027,
     "timestamp_derniere_mise_a_jour":1701095027,
     "pieces_jointes": [],
     "callback": false,
     "proprietaire": "gcloud-tests@openapi.it",
     "id": "6564a6739b25c29e4f0dab34"
      },
        "success": true,
        "message": "",
        "error": null
      }

Avec le service Bilancio, vous pouvez connaître la situation économique et financière d'une entreprise et vérifier son évolution et sa stabilité au cours de la dernière année ou d'une année particulière.