Report aziendale

Restituisce il report più completo di un’azienda: tutto ciò che è nel credit report più i bilanci pluriennali (ogni voce riportata), le sedi secondarie e i titolari effettivi e le controllate. Assetto proprietario e cariche riportano solo i nomi.

Endpoint di esempio. La sua presenza nella tua API dipende dalla configurazione della tua organizzazione - consulta la tua specifica per gli endpoint predisposti per te.

GET /companies/{fiscalCode}/report

Parametri di path

string

obbligatorio

Il codice fiscale italiano dell’azienda - un codice fiscale/partita IVA di 11 cifre oppure un codice fiscale di 16 caratteri. Non distingue tra maiuscole e minuscole.

Utilizzo

Ogni chiamata riuscita registra una misura predefinita di 1 call (addebito per chiamata anziché a crediti). La misura effettivamente addebitata è sempre restituita in meta.usage e può variare in base al tuo piano.

Risposta

L’oggetto data contiene:

boolean

Se le cifre provengono da bilanci consolidati.

number | null

L’esercizio più recente con cifre depositate.

CompanyIdentity

Informazioni descrittive dell’azienda (vedi CompanyIdentity), più:

activityStartDate (string | null) - quando l’azienda ha iniziato l’attività.
dissolutionYear (number | null) - l’anno di scioglimento, se presente.
foreignOwned (boolean | null) - se l’azienda è a controllo estero.
controllingEntity (string | null) - l’entità controllante, se presente.

object | null

Contatti di registro, oppure null: pec, cciaa, rea (ciascuno string | null).

object | null

null, oppure { employees: number, asOf: string }.

RiskIndicators

Flag di rischio. Vedi RiskIndicators.

object | null

Totali degli aiuti di stato, oppure null. Campi count, countLast36Months, amount, amountLast36Months (ciascuno number | null).

object

Assetto proprietario in tre liste, ciascuna un array di { name: string | null, share: number | null }:

shareholders (soci)
beneficialOwners (titolari effettivi)
subsidiaries (controllate)

object[]

Cariche, ciascuna { name: string | null, role: string | null, roleCategory: string }.

CompanyBranch[]

Sedi secondarie. Vedi CompanyBranch.

AnnualSnapshot | null

L’ultimo esercizio di cifre di sintesi. Vedi AnnualSnapshot.

object[]

Esercizi recenti di bilancio, dal più recente. Ciascuno è un AnnualSnapshot esteso con metrics - un array di FinancialMetric che copre ogni voce riportata per quell’anno.

Esempio

curl -H "Authorization: Bearer $SYRTO_API_KEY" \
  https://api.syrto.ai/companies/01654010345/report

{
  "data": {
    "isConsolidated": false,
    "latestFiledYear": 2023,
    "identity": {
      "legalName": "BARILLA G. E R. FRATELLI - SOCIETÀ PER AZIONI",
      "legalForm": "S.p.A.",
      "foundingYear": 1877,
      "incorporationDate": "1877-01-01",
      "isQuoted": false,
      "vatNumber": "01654010345",
      "fiscalCode": "01654010345",
      "naceCode": "10.73",
      "naceSection": "C",
      "address": {
        "line1": "Via Mantova 166",
        "line2": null,
        "locality": "Parma",
        "postalCode": "43122",
        "countryCode": "IT"
      },
      "activityStartDate": "1877-01-01",
      "dissolutionYear": null,
      "foreignOwned": false,
      "controllingEntity": null
    },
    "registry": { "pec": "barilla@pec.example.it", "cciaa": "PR-123456", "rea": "PR-123456" },
    "headcount": { "employees": 8760, "asOf": "2023-12-31" },
    "risk": {
      "protestsOfBill": false,
      "insolvencyProceedings": false,
      "insolvencyApplications": false,
      "assetEncumbrances": false,
      "officersWithRiskIndicators": false
    },
    "stateAids": { "count": 12, "countLast36Months": 3, "amount": 1450000, "amountLast36Months": 320000 },
    "ownership": {
      "shareholders": [ { "name": "Barilla Holding S.p.A.", "share": 0.85 } ],
      "beneficialOwners": [ { "name": "Guido Barilla", "share": 0.28 } ],
      "subsidiaries": [ { "name": "Barilla France S.A.S.", "share": 1.0 } ]
    },
    "officers": [
      { "name": "Guido Barilla", "role": "Chairman", "roleCategory": "board" }
    ],
    "branches": [
      {
        "legalName": "BARILLA G. E R. FRATELLI - SEDE DI PEDRIGNANO",
        "address": { "line1": "Via Emilia", "line2": null, "locality": "Parma", "postalCode": "43122", "countryCode": "IT" }
      }
    ],
    "latest": {
      "year": 2023,
      "isForecasted": false,
      "size": "L",
      "statementDate": "2023-12-31",
      "employees": 8760,
      "employeesYoY": 0.03
    },
    "financials": [
      {
        "year": 2023,
        "isForecasted": false,
        "size": "L",
        "statementDate": "2023-12-31",
        "employees": 8760,
        "employeesYoY": 0.03,
        "metrics": [
          {
            "slug": "revenues_from_sales_and_services",
            "name": "Revenues from sales and services",
            "categories": ["income_statement"],
            "unit": "EUR",
            "value": 4200000000,
            "previousValue": 3900000000,
            "yoyChange": 0.077,
            "marketValue": null,
            "score": null
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_018f9c2e7b7a7c3e9a1b2c3d4e5f6a7b",
    "endpoint": "company-report",
    "usage": { "quantity": 1, "unit": "calls" }
  }
}

Per iniziare

Endpoint di esempio

Riferimento interattivo

Riferimento

Report aziendale

Parametri di path

Utilizzo

Risposta

Esempio

​Parametri di path

​Utilizzo

​Risposta

​Esempio

Parametri di path

Utilizzo

Risposta

Esempio