Attraverso un endpoint dedicato è possibile abilitare un servizio di monitoraggio sui servizi Company, per ricevere notifiche in caso di aggiornamenti relativi ai dati aziendali di interesse.
Impostando una callback, il sistema trasmetterà automaticamente una notifica ogni volta che verranno rilevate modifiche. La periodicità delle verifiche varia in base al servizio selezionato; di seguito alcuni esempi:
- Ogni 7 giorni per i servizi: IT-aml, IT-marketing, IT-stakeholders, IT-full, IT-closed, IT-vatgroup, IT-sdicode
- Ogni 30 giorni per i servizi: IT-Start, IT-Advanced, IT-shareholders, IT-address, IT-pec, IT-name, IT-ubo, FR-Start, FR-Advanced, DE-Start, DE-Advanced, ES-Start, ES-Advanced, PT-Start, PT-Advanced, GB-start, GB-Advanced, BE-Start, BE-Advanced, AT-Start, AT-Advanced, CH-Start, CH-Advanced, PL-Start, PL-Advanced, WW-Start, WW-Advanced, WW-Top
Il monitoraggio ha una durata di 12 mesi.
- Se autorenew = false, il servizio scadrà automaticamente alla fine del periodo.
- Se autorenew = true, il monitoraggio verrà rinnovato automaticamente, a condizione che sia disponibile credito sufficiente.
Una soluzione ideale per integrare controlli continuativi, processi di onboarding, antiriciclaggio (AML) e compliance direttamente nei tuoi flussi applicativi.
ESEMPIO RICHIESTA
POST /monitor
Con questo endpoint è possibile creare una nuova richiesta di monitoraggio su un'azienda azienda. Se si è impostato un callback, si riceverà una notifica al primo controllo e ogni volta che uno o più campi, che si è impostato per essere monitorati, cambiano.
{
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"activityStatus"
],
"callback": {
"url": "https://webhook.site/f24cec85-22e3-4f7c-8ec0-227b240daa42"
}
}Per tutti i dataset diversi da IT e FR, se al momento della richiesta non viene trovata alcuna azienda con il codice passato nel payload, oltre all'errore 404, è previsto anche un addebito per la ricerca effettuata al costo del dataset scelto.
ESEMPIO DI RISPOSTA
POST /monitor
{
"data": {
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"pec"
],
"callback": {
"method": "JSON",
"url": "https://webhook.site/28a4dddf-eca1-47f2-88d8-94878995e4d8",
"user_id": "",
"username": "",
"field": "data",
"headers": {},
"data": {},
"retry": 0,
"scope": null,
"domain": null,
"custom": null
},
"owner": "[email protected]",
"createdOn": "2026-02-03",
"companyId": "60d1bfc731177b0a092cdfc1",
"vatCode": "12485671007",
"taxCode": "12485671007",
"companyName": "OPENAPI S.P.A.",
"updatedFields": null,
"latestDataset": null,
"previousDataset": null,
"checkedOn": null,
"nextOn": "2026-03-05",
"expiresOn": "2027-02-03",
"autorenew": true,
"id": "6981e3571a222556460af532"
},
"success": true,
"message": "",
"error": null
}ESEMPIO RICHIESTA SPECIFICA
GET/monitor/{id}
Endpoint che restituisce la richiesta contrassegnata dall'identificatore passato nel percorso.
In un ambiente di test, è possibile effettuare una chiamata sincrona che simuli il controllo del sistema sui campi dell'azienda che si desidera monitorare. È sufficiente eseguire una GET su questo URL: https://test.company.openapi.com/monitor/{id}?callback
{
"data": {
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"pec"
],
"callback": {
"method": "JSON",
"url": "https://webhook.site/28a4dddf-eca1-47f2-88d8-94878995e4d8",
"user_id": "",
"username": "",
"field": "data",
"headers": {},
"data": {},
"retry": 0,
"scope": null,
"domain": null,
"custom": null
},
"owner": "[email protected]",
"createdOn": "2026-02-03",
"companyId": "60d1bfc731177b0a092cdfc1",
"vatCode": "12485671007",
"taxCode": "12485671007",
"companyName": "OPENAPI S.P.A.",
"updatedFields": {
"pec": "[email protected]"
},
"latestDataset": {
"taxCode": "12485671007",
"vatCode": "12485671007",
"companyName": "OPENAPI S.P.A.",
"address": {
"registeredOffice": {
"toponym": "VIALE",
"street": "F TOMMASO MARINETTI",
"streetNumber": "221",
"streetName": "VIALE F TOMMASO MARINETTI 221",
"town": "ROMA",
"hamlet": null,
"province": "RM",
"zipCode": "00143",
"gps": {
"coordinates": [
12.47843,
41.8071
]
},
"region": {
"code": "12",
"description": "LAZIO"
},
"townCode": "H501"
}
},
"activityStatus": "ATTIVA",
"reaCode": "1378273",
"cciaa": "RM",
"atecoClassification": {
"ateco": {
"code": "6201",
"description": "Produzione di software non connesso all'edizione"
}
},
"detailedLegalForm": {
"code": "SP",
"description": "SOCIETÀ PER AZIONI"
},
"startDate": "2013-10-20",
"registrationDate": "2013-07-19",
"endDate": null,
"pec": "[email protected]",
"taxCodeCeased": false,
"taxCodeCeasedTimestamp": 1708699396,
"vatGroup": {
"vatGroupParticipation": false,
"isVatGroupLeader": false,
"registryOk": true
},
"sdiCode": "USAL8PV",
"sdiCodeTimestamp": 1709049141,
"creationTimestamp": 1624358855,
"lastUpdateTimestamp": 1708705000,
"balanceSheets": {
"last": {
"year": 2022,
"employees": 14,
"balanceSheetDate": "2022-12-31",
"turnover": 4043407,
"netWorth": 166491,
"shareCapital": 50000,
"totalStaffCost": 604997,
"totalAssets": 1483126,
"avgGrossSalary": 43214
},
"all": [
{
"year": 2024,
"employees": 15,
"balanceSheetDate": null,
"turnover": null,
"netWorth": null,
"shareCapital": 50000
},
{
"year": 2023,
"employees": 15,
"balanceSheetDate": null,
"turnover": null,
"netWorth": null,
"shareCapital": 50000
},
{
"year": 2022,
"employees": 14,
"balanceSheetDate": "2022-12-31",
"turnover": 4043407,
"netWorth": 166491,
"shareCapital": 50000,
"totalStaffCost": 604997,
"totalAssets": 1483126,
"avgGrossSalary": 43214
},
{
"year": 2021,
"employees": 15,
"balanceSheetDate": "2021-12-31",
"turnover": 4432761,
"netWorth": 469366,
"shareCapital": 50000
},
{
"year": 2020,
"employees": 14,
"balanceSheetDate": "2020-12-31",
"turnover": 4192138,
"netWorth": 170234,
"shareCapital": 10000
},
{
"year": 2019,
"employees": 14,
"balanceSheetDate": "2019-12-31",
"turnover": 1799587,
"netWorth": 111309,
"shareCapital": 10000
},
{
"year": 2018,
"employees": null,
"balanceSheetDate": "2018-12-31",
"turnover": 1325358,
"netWorth": 826,
"shareCapital": null
},
{
"year": 2017,
"employees": null,
"balanceSheetDate": "2017-12-31",
"turnover": 1120176,
"netWorth": 2928,
"shareCapital": null
}
]
},
"shareHolders": [
{
"companyName": "OPEN HOLDING S.R.L.",
"name": null,
"surname": null,
"taxCode": "16935371001",
"percentShare": 100
}
],
"id": "60d1bfc731177b0a092cdfc1"
},
"previousDataset": null,
"checkedOn": "2026-02-03",
"nextOn": "2026-03-05",
"expiresOn": "2027-02-03",
"autorenew": true,
"id": "6981e3571a222556460af532"
},
"success": true,
"message": "",
"error": null
}CANCELLARE LA RICHIESTA
Tramite l'endpoint DELETE/monitor/{id} è possibile eliminare un monitoraggio su un'azienda
{
"data": [],
"success": true,
"message": "1 deleted monitor",
"error": null
}
Hai bisogno di aiuto?
Non hai trovato la risposta che cercavi?
Compila tutti i campi, ti ricontatteremo al più presto!
Il servizio di monitoraggio Company consente di tenere sotto controllo nel tempo le informazioni aziendali di interesse. Tramite un endpoint dedicato, il sistema verifica periodicamente eventuali aggiornamenti dei dati e notifica automaticamente il cliente in caso di variazioni.
È possibile configurare una URL di callback. Quando il sistema rileva una modifica rispetto ai dati precedentemente disponibili, invia una notifica automatica alla callback configurata, senza che sia necessario effettuare controlli manuali o interrogazioni periodiche.
La frequenza dei controlli dipende dal servizio di monitoraggio attivato. Attualmente sono previste due finestre temporali:
Controllo ogni 7 giorni
I seguenti servizi vengono verificati settimanalmente:
- IT-aml
- IT-marketing
- IT-stakeholders
- IT-full
- IT-closed
- IT-vatgroup
- IT-sdicode
Controllo ogni 30 giorni
I seguenti servizi vengono verificati mensilmente:
- IT-Start
- IT-Advanced
- IT-shareholders
- IT-address
- IT-pec
- IT-name
- IT-ubo
- FR-Start
- FR-Advanced
- DE-Start
- DE-Advanced
- ES-Start
- ES-Advanced
- PT-Start
- PT-Advanced
- GB-start
- GB-Advanced
- BE-Start
- BE-Advanced
- AT-Start
- AT-Advanced
- CH-Start
- CH-Advanced
- PL-Start
- PL-Advanced
- WW-Start
- WW-Advanced
- WW-Top
Il servizio di monitoraggio ha una durata standard di un anno.
- Se il parametro autorenew è impostato su false, il monitoraggio termina automaticamente dopo un anno.
- Se il parametro autorenew è impostato su true, il servizio viene rinnovato automaticamente alla scadenza, a condizione che sia disponibile credito sufficiente sull’account.
Sì. È sufficiente impostare il parametro autorenew su false al momento dell’attivazione o durante la gestione del monitoraggio. In questo caso, il servizio resterà attivo fino alla naturale scadenza annuale senza rinnovo.
No. Grazie alla callback, il sistema invia notifiche proattive in caso di aggiornamenti, eliminando la necessità di controllare manualmente lo stato o i risultati del monitoraggio.
Energia pulita per il nostro cloud 
Low CO2
Openapi SpA Unipersonale - Società sottoposta a direzione e controllo della Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Roma - REA 1378273 Cap. Soc. € 50.000,00 i.v. – P.I. IT12485671007 - CODICE DESTINATARIO 'USAL8PV' - PEC: 
Openapi è certificata: Sistema qualità UNI EN ISO 9001:2015 - Qualità dei Dati ISO 25012:2014 - Gestione della Sicurezza ISO/IEC 27001:2022 - Parità di Genere UNI PdR 125:2022
Tutti i prezzi sono da considerarsi al netto di eventuale IVA, eventuali imposte di bollo, diritti di segreteria e/o imposte o tasse altrimenti denominate se dovute. Tutti i loghi elencati nel portale sono coperti da copyright e di proprietà dei rispettivi proprietari.
