Atto Ottico - Italia

  • Openapi Evasione : 5 Minuti
  • Openapi a partire da € 5,50 + iva

Accedi rapidamente agli atti societari depositati presso il Registro delle Imprese con un semplice codice fiscale.

L'Atto Ottico è l'API che, con il solo codice fiscale, offre accesso immediato a tutti gli atti aziendali depositati nel Registro delle Imprese. Perfetto per ottenere rapidamente documenti ufficiali e allegati di imprese individuali e societarie a livello nazionale.

Esempio Atto Ottico - Italia

L'Atto Ottico è l'API che consente, utilizzando esclusivamente il codice fiscale di un'azienda, di accedere a tutti gli atti depositati presso il Registro delle Imprese a livello nazionale. Questo strumento è ideale per ottenere rapidamente documenti ufficiali e allegati obbligatori relativi a imprese individuali e collettive, coprendo una vasta gamma di atti societari.

Funzionalità principali

  • Accesso agli atti di imprese individuali e collettive su tutto il territorio nazionale.
  • Possibilità di richiedere atti costitutivi, modifiche statutarie, nomine, cessazioni, fusioni, scissioni, trasferimenti, cancellazioni e altro.
  • Documenti disponibili in formato PDF entro circa 5 minuti.

Tipologie di Atti Richiedibili

Con l'API ATTO OTTICO, puoi richiedere una vasta gamma di atti societari. Ecco alcuni esempi:

  • ATTO COSTITUTIVO (A01)
  • TRASFERIMENTO SEDE DA ALTRO REGISTRO IMPRESE (A02)
  • ISTITUZIONE/MODIFICA/CESSAZIONE SEDE SECONDARIA (A03)
  • MODIFICHE ATTO COSTITUTIVO/PATTI SOCIALI (società di persone, consorzi, geie) (A04)
  • MODIFICHE ATTO COSTITUTIVO (società di capitali e cooperative) (A05)
  • NOMINA/CONFERMA AMMINISTRATORI (A06)
  • CESSAZIONE AMMINISTRATORI (A07)
  • NOMINA/CONFERMA/CESSAZIONE SINDACI (A08)
  • NOMINA LIQUIDATORI (A09)
  • MODIFICA POTERI/ REVOCA LIQUIDATORI (A10)
  • DELEGA/REVOCA POTERI CONSIGLIO DI AMMINISTRAZIONE (A11)
  • PROCURA (A12)
  • SCIOGLIMENTO CON/SENZA LIQUIDAZIONE (A13)
  • CANCELLAZIONE DAL REGISTRO DELLE IMPRESE (A14)
  • PROCEDURA CONCORSUALE (A15)
  • FUSIONI/SCISSIONI (A16A17)
  • TRASFERIMENTO QUOTE S.R.L. (A18)
  • COMUNICAZIONE SOCIO UNICA DI S.R.L E RICOSTITUZIONE PLURALITA' DEI SOCI (A19)
  • TRASFERIMENTO D'AZIENDA" (A20)
  • PATTI PARASOCIALI" (A22)
  • CONVERSIONE IN EURO DEL CAPITALE SOCIALE (A23)
  • ALTRI ATTI (A99)
  • COMUNICAZIONE ELENCO SOCI (X_5xx)

ESEMPIO RICHIESTA

GET /documents

Per ottenere l'elenco completo dei servizi disponibili tramite le API DocuEngine, è sufficiente inviare una chiamata all'endpoint GET /documents. La risposta includerà anche i dati richiesti per completare la richiesta e il costo relativo a ogni servizio.

 {
  "data": [
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name": "taxCode",
            "nameIT": "codice fiscale",
            "type": "taxCode",
            "required": true,
            "options": null ,
            "help": "Inserire il codice fiscale dell`azienda"
          },
          "field1": {
            "name":"actGroupCode",
            "nameIT":"codice gruppo atto",
            "type": "optionCode",
            "required": false,
            "options": [
              {
                "code": "A01",
                "description": "ATTO COSTITUTIVO"
              },
              {
                "code": "A02",
                "description": "TRASFERIMENTO SEDE DA ALTRO REGISTRO IMPRESE"
              },
              {
                "code": "A03",
                "description": "ISTITUZIONE/MODIFICA/CESSAZIONE SEDE SECONDARIA"
              },
              {
                "code": "A04",
                "description": "MODIFICHE ATTO COSTITUTIVO/PATTI SOCIALI (societa' di persone, consorzi, geie)"
              },
              {
                "code": "A05",
                "description": "MODIFICHE ATTO COSTITUTIVO (societa' di capitali e cooperative)"
              },
              {
                "code": "A06",
                "description": "NOMINA/CONFERMA AMMINISTRATORI"
              },
              {
                "code": "A07",
                "description": "CESSAZIONE AMMINISTRATORI"
              },
              {
                "code": "A08",
                "description": "NOMINA/CONFERMA/CESSAZIONE SINDACI"
              },
              {
                "code": "A09",
                "description": "NOMINA LIQUIDATORI"
              },
              {
                "code": "A10",
                "description": "MODIFICA POTERI/ REVOCA LIQUIDATORI"
              },
              {
                "code": "A11",
                "description": "DELEGA/REVOCA POTERI CONSIGLIO DI AMMINISTRAZIONE"
              },
              {
                "code": "A12",
                "description": "PROCURE"
              },
              {
                "code": "A13",
                "description": "SCIOGLIMENTO CON/SENZA  LIQUIDAZIONE"
              },
              {
                "code": "A14",
                "description": "CANCELLAZIONE DAL REGISTRO DELLE  IMPRESE"
              },
              {
                "code": "A15",
                "description": "PROCEDURE CONCORSUALI"
              },
              {
                "code": "A16A17",
                "description": "FUSIONI/SCISSIONI"
              },
              {
                "code": "A18",
                "description": "TRASFERIMENTO QUOTE S.R.L."
              },
              {
                "code": "A19",
                "description": "COMUNICAZIONE SOCIO UNICO DI S.R.L E RICOSTITUZIONE PLURALITA' DEI SOCI"
              },
              {
                "code": "A20",
                "description": "TRASFERIMENTO D'AZIENDA"
              },
              {
                "code": "A22",
                "description": "PATTI  PARASOCIALI"
              },
              {
                "code": "A23",
                "description": "CONVERSIONE IN EURO DEL CAPITALE SOCIALE"
              },
              {
                "code": "A99",
                "description": "ALTRI ATTI"
              },
              {
                "code": "X_5xx",
                "description": "COMUNICAZIONE ELENCO SOCI"
              }
            ],
            "help":"Inserire il codice del gruppo di atto richiesto"
          },
          "field2": {
            "name":"requestDateSince",
            "nameIT":"data richiesta dal",
            "type": "date",
            "required": false,
            "options": null ,
            "help":"Inserire una data a partire dalla quale filtrare la richiesta di atti"
          },
          "field3": {
            "name":"requestDateTo",
            "nameIT":"data richiesta al",
            "type": "date",
            "required": false,
            "options": null ,
            "help":"Inserire una data fino a cui filtrare la richiesta di atti"
          },
          "field4": {
            "name":"documentDateSince",
            "nameIT":"data documento dal",
            "type": "date",
            "required": false,
            "options": null ,
            "help":"Inserire una data a partire dalla quale filtrare i documenti degli atti"
          },
          "field5": {
            "name":"documentDateTo",
            "nameIT":"data documento al",
            "type": "date",
            "required": false,
            "options": null ,
            "help":"Inserire una data fino a cui filtrare i documenti degli atti"
          }
        },
        "validation": "field0 || (field0 && (field1 || field2 || field3 || field4 || field5))",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Atto Ottico",
      "options": null ,
      "hasSearch": true,
      "isSync": false,
      "id": "6687eea71a241a5d1be0f9f9",
      "searchPrice": 0.6,
      "documentPrice":  4.9,
      "totalPrice": 5.5
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"reaCode",
            "nameIT":"numero rea",
            "type": "rea",
            "required": true,
            "options": null ,
            "help":"Inserire il numero di Rea dell`azienda"
          },
          "field1": {
            "name":"cciaa",
            "nameIT":"cciaa",
            "type": "cciaa",
            "required": true,
            "options": null ,
            "help":"Inserire la provincia della Camera di Commercio dell`azienda"
          }
        },
        "validation": "field0 && field1",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Ordinaria - Societa' Di Persone",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "6671a5549e6f0e447bc2659d",
      "searchPrice": 0,
      "documentPrice":  3.4,
      "totalPrice": 3.4
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"taxCode",
            "nameIT":"codice fiscale",
            "type": "taxCode",
            "required": true,
            "options": null ,
            "help":"Inserire il codice fiscale dell`azienda"
          }
        },
        "validation": "field0",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Bilancio XBRL",
      "options": null ,
      "hasSearch": true,
      "isSync": false,
      "id": "667c131a9e6f0e447bc265c1",
      "searchPrice": 0.1,
      "documentPrice":  4.4,
      "totalPrice": 4.5
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"reaCode",
            "nameIT":"numero rea",
            "type": "rea",
            "required": true,
            "options": null ,
            "help":"Inserire il numero di Rea dell`azienda"
          },
          "field1": {
            "name":"cciaa",
            "nameIT":"cciaa",
            "type": "cciaa",
            "required": true,
            "options": null ,
            "help":"Inserire la provincia della Camera di Commercio dell`azienda"
          }
        },
        "validation": "field0 && field1",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Storica - Societa' Di Persone",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "6671a5bf9e6f0e447bc265a0",
      "searchPrice": 0,
      "documentPrice":  4.4,
      "totalPrice": 4.4
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"reaCode",
            "nameIT":"numero rea",
            "type": "rea",
            "required": true,
            "options": null ,
            "help":"Inserire il numero di Rea dell`azienda"
          },
          "field1": {
            "name":"cciaa",
            "nameIT":"cciaa",
            "type": "cciaa",
            "required": true,
            "options": null ,
            "help":"Inserire la provincia della Camera di Commercio dell`azienda"
          }
        },
        "validation": "field0 && field1",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Storica - Impresa Individuale",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "6671a5d69e6f0e447bc265a1",
      "searchPrice": 0,
      "documentPrice":  3.9,
      "totalPrice": 3.9
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"taxCode",
            "nameIT":"codice fiscale",
            "type": "taxCode",
            "required": true,
            "options": null ,
            "help":"Inserire il codice fiscale dell`azienda"
          }
        },
        "validation": "field0",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Inglese",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "66840ce41a241a5d1be0f9e5",
      "searchPrice": 0,
      "documentPrice":  6.5,
      "totalPrice": 6.5
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"taxCode",
            "nameIT":"codice fiscale",
            "type": "taxCode",
            "required": true,
            "options": null ,
            "help":"Inserire il codice fiscale dell`azienda"
          }
        },
        "validation": "field0",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Bilancio Riclassificato",
      "options": null ,
      "hasSearch": true,
      "isSync": false,
      "id": "669533fe6d4f51cbde8da353",
      "searchPrice": 0.1,
      "documentPrice":  4.9,
      "totalPrice": 5
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"reaCode",
            "nameIT":"numero rea",
            "type": "rea",
            "required": true,
            "options": null ,
            "help":"Inserire il numero di Rea dell`azienda"
          },
          "field1": {
            "name":"cciaa",
            "nameIT":"cciaa",
            "type": "cciaa",
            "required": true,
            "options": null ,
            "help":"Inserire la provincia della Camera di Commercio dell`azienda"
          }
        },
        "validation": "field0 && field1",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Ordinaria - Impresa Individuale",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "6671a5719e6f0e447bc2659e",
      "searchPrice": 0,
      "documentPrice":  2.9,
      "totalPrice": 2.9
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"reaCode",
            "nameIT":"numero rea",
            "type": "rea",
            "required": true,
            "options": null ,
            "help":"Inserire il numero di Rea dell`azienda"
          },
          "field1": {
            "name":"cciaa",
            "nameIT":"cciaa",
            "type": "cciaa",
            "required": true,
            "options": null ,
            "help":"Inserire la provincia della Camera di Commercio dell`azienda"
          }
        },
        "validation": "field0 && field1",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Ordinaria - Societa' Di Capitale",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "663df75d19a52195e23e315c",
      "searchPrice": 0,
      "documentPrice":  4.9,
      "totalPrice": 4.9
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"reaCode",
            "nameIT":"numero rea",
            "type": "rea",
            "required": true,
            "options": null ,
            "help":"Inserire il numero di Rea dell`azienda"
          },
          "field1": {
            "name":"cciaa",
            "nameIT":"cciaa",
            "type": "cciaa",
            "required": true,
            "options": null ,
            "help":"Inserire la provincia della Camera di Commercio dell`azienda"
          }
        },
        "validation": "field0 && field1",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Visura Camerale Storica - Societa' Di Capitale",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "6671a5a29e6f0e447bc2659f",
      "searchPrice": 0,
      "documentPrice":  5.9,
      "totalPrice": 5.9
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"taxCode",
            "nameIT":"codice fiscale",
            "type": "taxCode",
            "required": true,
            "options": null ,
            "help":"Inserire il codice fiscale dell`azienda"
          }
        },
        "validation": "field0",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Bilancio Ottico",
      "options": null ,
      "hasSearch": true,
      "isSync": false,
      "id": "667443c29e6f0e447bc265aa",
      "searchPrice": 0.1,
      "documentPrice":  4.4,
      "totalPrice": 4.5
    },
    {
      "requestStructure": {
        "fields": {
          "field0": {
            "name":"taxCode",
            "nameIT":"codice fiscale",
            "type": "taxCode",
            "required": true,
            "options": null ,
            "help":"Inserire il codice fiscale dell`azienda"
          }
        },
        "validation": "field0",
        "help":null ,
        "searchHelp": null 
      },
      "category":"Camerali",
      "name":"Statuto",
      "options": null ,
      "hasSearch": false,
      "isSync": false,
      "id": "6687eed51a241a5d1be0f9fa",
      "searchPrice": 0,
      "documentPrice":  4.9,
      "totalPrice": 4.9
    }
  ],
  "success": true,
  "message": "",
  "error": null 
} 

 

ESEMPIO DI RICHIESTA

POST/requests

Per richiedere un ATTO OTTICO, è necessario effettuare una richiesta all'endpoint POST /requests, fornendo i seguenti dati:

  • Codice Fiscale dell'Azienda
  • ID DOCUMENTO da richiedere

Nella richiesta possiamo specificare ulteriori informazioni che però non sono obbligatorie:

  • Inserire il codice del gruppo di atto richiesto ES: A01 - field1
  • Inserire una data a partire dalla quale filtrare la richiesta di atti - field2
  • Inserire una data fino a cui filtrare la richiesta di atti - field3
  • Inserire una data a partire dalla quale filtrare i documenti degli atti - field4
  • Inserire una data fino a cui filtrare i documenti degli atti - field5

Con questi dati è possibile identificare correttamente l'azienda e il tipo di documento richiesto. Questo è un esempio di richiesta di Atto Ottico per la società con partita IVA 12485671007.

{
  "documentId": "6687eea71a241a5d1be0f9f9",
  "search": {
    "field0": "12485671007",
    "field1": "A01"
  }
}

 

E' inoltre possibile impostare in questa fase una Callback in modo da essere aggiornati quando la richiesta cambia di stato.

ESEMPIO DI RISPOSTA

POST/requests

La risposta conterrà l'ID del risultato, necessario per procedere con il download del documento.

E' possibile anche selezionare l'opzione "notifyEmail" che ti consentirà di ricevere una email quando il documento è pronto.

 {
  "data": {
    "documentId": "6687eea71a241a5d1be0f9f9",
    "search": {
      "field0": "12485671007",
      "field1": "A01"
    },
    "timestamps": {
      "creation": 1734350610,
      "search": 1734350610,
      "lastUpdate": 1734350614
    },
    "state": "SEARCH",
    "readableSearch": {
      "taxCode": "12485671007",
      "actGroupCode": "A01"
    },
    "optionsPrice": 0,
    "selectedOptions": null,
    "notifyEmail": null,
    "callback": null,
    "name": "Atto Ottico",
    "hasSearch": true,
    "searchPrice": 0.6,
    "documentPrice": 4.9,
    "totalPrice": 5.5,
    "documents": null,
		"resultId": null,
    "results": [
      {
        "id": "3fe48989c167b2a897f8bb4829a56f26",
        "data": {
          "id_atto": "9379307-313466957-GB115RPY1Y2D910224D5-A01-20130711",
          "origine_documento": "Digitale",
          "cciaa_protocollo": "RM",
          "anno_protocollo": 2013,
          "tipo_protocollo": null,
          "numero_protocollo": 291149,
          "data_pratica": "2013-07-18",
          "codice_atto": "A01",
          "descrizione_codice_atto": "ATTO COSTITUTIVO",
          "tipo_documento": null,
          "data_documento": "2013-07-11",
          "sezioni_prospetto": [
            {
              "descrizione": "ATTO COSTITUTIVO",
              "numero_pagine": 8
            },
            {
              "descrizione": "STATUTO",
              "numero_pagine": 17
            },
            {
              "descrizione": "ALTRO DOCUMENTO",
              "numero_pagine": 2
            },
            {
              "descrizione": "ALTRO DOCUMENTO",
              "numero_pagine": 3
            }
          ],
          "numero_pagine": 30
        }
      }
    ],
    "id": "67601716295869d5de0f7702"
  },
  "success": true,
  "message": "",
  "error": null
}

 

AGGIORNARE LA RICHIESTA

PATCH/ request/{id}

Per impostazione predefinita, se il campo "STATE" non viene valorizzato la transazione viene considerata immediatamente chiusa e la tua richiesta verrà gestita ed evasa. Se invece viene impostato, la transazione viene avviata ma rimane aperta e quindi puoi procedere ad aggiornare la richiesta tramite l'endpoint  PATCH / requests.

ESEMPIO DI AGGIORNAMENTO

PATCH/ request/{id}

Questo endpoint permette di aggiornare determinati campi della richiesta e di completarne il processo: chiudendola, se lo stato è "NEW", oppure selezionando un risultato generato dalla ricerca, nel caso in cui il documento abbia il parametro 'hasSearch' impostato su true.

 {
  "data": {
    "documentId": "6687eea71a241a5d1be0f9f9",
    "search": {
      "field0": "12485671007",
      "field1": "A01"
    },
    "timestamps": {
      "WAIT": 1733844894,
      "creation": 1734350610,
      "search": 1734350610,
      "lastUpdate": 1734350614
    },
    "state": "WAIT",
    "readableSearch": {
      "taxCode": "12485671007",
      "actGroupCode": "A01"
    },
    "optionsPrice": 0,
    "selectedOptions": null,
    "notifyEmail": null,
    "callback": null,
    "name": "Atto Ottico",
    "hasSearch": true,
    "searchPrice": 0.6,
    "documentPrice": 4.9,
    "totalPrice": 5.5,
    "documents": null,
		"resultId": 9c167b2a897f8bb482,
    "results": [
      {
        "id": "3fe48989c167b2a897f8bb4829a56f26",
        "data": {
          "id_atto": "9379307-313466957-GB115RPY1Y2D910224D5-A01-20130711",
          "origine_documento": "Digitale",
          "cciaa_protocollo": "RM",
          "anno_protocollo": 2013,
          "tipo_protocollo": null,
          "numero_protocollo": 291149,
          "data_pratica": "2013-07-18",
          "codice_atto": "A01",
          "descrizione_codice_atto": "ATTO COSTITUTIVO",
          "tipo_documento": null,
          "data_documento": "2013-07-11",
          "sezioni_prospetto": [
            {
              "descrizione": "ATTO COSTITUTIVO",
              "numero_pagine": 8
            },
            {
              "descrizione": "STATUTO",
              "numero_pagine": 17
            },
            {
              "descrizione": "ALTRO DOCUMENTO",
              "numero_pagine": 2
            },
            {
              "descrizione": "ALTRO DOCUMENTO",
              "numero_pagine": 3
            }
          ],
          "numero_pagine": 30
        }
      }
    ],
    "id": "67601716295869d5de0f7702"
  },
  "success": true,
  "message": "",
  "error": null
}

 

SCARICARE DOCUMENTO

Quando la richiesta è in stato "evaso", è possibile scaricare il documento in formato PDF. L'endpoint che permette di scaricare i documenti generati dalla richiesta è: GET/requests/{id}/documents

La risposta indicherà nome del file, dimensione e l'URL per il download del file.

{
  "data": [
    {
      "fileName": "5f22f5b5065afc21cc60a27a_0.pdf",
      "mimeType": "application/pdf",
      "fileSize": "34144",
      "md5": "IPJJgdrAt4xrvGR4ve7oTg==",
      "urlExpire": 1724505599,
      "downloadUrl": "https://storage.googleapis.com/test-docuengine-openapi-com/documents/5f22f5b5065afc21cc60a27a_0.pdf?X-Goog-Algorithm=GOOG4-RSA-SHA256&X-Goog-Credential=test-docuengine-openapi-com%40openapi-services-np.iam.gserviceaccount.com%2F20240823%2Fauto%2Fstorage%2Fgoog4_request&X-Goog-Date=20240823T131959Z&X-Goog-Expires=86400&X-Goog-SignedHeaders=host&X-Goog-Signature=234776179911339dcfbe7c6cffc31dc4713c5cf59cd6aa6e64ea824ebb83b3c96fbdf165dc9eb01b3186c4182744ea49e39c246ca3beb0a802733982e1d21ced340ac0a94c5cc99133f7758080a4dc09c45c90760a1293f9183290db298feaa76170cc0bea5b162a61264a5e73ebb01b8955912e25d3154cda719f043f87d6a1e17b7ea6883d8f9339e35da21758cb623248fd42c63e4cdb1917bb1ff9ff0017604000cf91f656ff4d3d60d4d08e07aaf8341a5929338165590318a0004e88d39b26a89838b7632bc58e747773220e875475ae91ed98dbbbaa75f8e6b90fb8a29afb6e9863330c973bae68b6b75d4709383ff165884ed22450ea7f4cd521e18e"
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

Il servizio API Atto Ottico è perfetto per studi professionali, consulenti e aziende che necessitano di documenti aziendali ufficiali in modo rapido e affidabile.

Le nostre tariffe

Listino prezzi a chiamata