Bericht über Aktuelle Unternehmensvertreter - Italien

• Informationen über das Unternehmen wie CCIAA, REA, Rechtsform, ATECO-Code, Betriebsstatus, Hauptsitz
• Informationen über die Vertreter wie Name, Steuer-ID, Geburtsort und -datum, Wohnsitz, Ämter

Die Liste der aktiven Vertreter ermöglicht es, den Vertreterblock für Kapitalgesellschaften zu erhalten, mit Ergänzungen für Personengesellschaften.

Die Informationen sind in Echtzeit über die Openapi Visengine API verfügbar und können im PDF-, JSON- oder XML-Format heruntergeladen werden.

Hier sind die Schritte zum Erhalt des Berichts.

Hash-Bericht anfordern

GET /visure

Für die Anforderung von Berichten mit Visengine muss zunächst der Hash identifiziert werden, der jedes Dokument oder Verfahren eindeutig identifiziert.

https://visengine2.altravia.com/visure/

Dies ist möglich über den Endpunkt GET /visure, der keine Parameter benötigt und die vollständige Liste der über Visengine verfügbaren Dokumente und Verfahren sowie deren Hash zurückgibt.

Überprüfen der Daten und Kosten für die Berichtsanfrage

GET /visure/{hash_visura}

Um die Informationen, die benötigten Dokumente und die Kosten des Berichts zu überprüfen, muss eine Anfrage über den Endpunkt GET /visure/{hash_visura} gestellt und der zuvor erhaltene Hash des Berichts übergeben werden.

BEISPIELANFRAGE

GET /visure/{hash_visura}

Um die Felder und Kosten zur Vervollständigung der Anfrage zu überprüfen, verwenden Sie den zuvor erhaltenen Hash.

https://visengine2.altravia.com/visure/95cb552053977ca50c9e9b37532edd20

BEISPIELANTWORT

GET /visure/{hash_visura}

Die Antwort enthält alle erforderlichen Informationen zur Vervollständigung der Anfrage, wie z.B. die obligatorischen Felder.

{
  "data": {
    "nome_visura": "Aktive Vertreter des Unternehmens",
    "ricerca": false,
    "nome_categoria": "Kammer",
    "json_struttura": {
      "campi": {
        "$0": {
          "nome": "Steuer-ID",
          "tipo": "steuer_id",
          "null": false,
          "istruzioni": "Geben Sie die Steuer-ID des Unternehmens ein",
          "ordine": "1"
        }
      },
      "validazione": "$0  ",
      "istruzioni": "",
      "istruzioni_ricerca": ""
    },
    "hash_visura": "95cb552053977ca50c9e9b37532edd20",
    "prezzo_visura": 2.3,
    "prezzo_ricerca": 0,
    "sincrona": false,
    "opzioni": null,
    "fornitori": []
  },
  "success": true,
  "message": "",
  "error": null
}

In der Validierung werden die obligatorischen Daten angegeben, um die Anfrage erfolgreich abzuschließen.

Bericht anfordern

POST/richiesta

Für die Anforderung des Berichts wird die Steuer-ID der betreffenden Person übergeben.

BEISPIELANFRAGE

POST/richiesta

{
    "hash_visura": "95cb552053977ca50c9e9b37532edd20",
    "json_visura": {
      "$1": 12485671007
      }
  }

BEISPIELANTWORT

POST/richiesta

Die Antwort enthält verschiedene Informationen, einschließlich des Status, des Callbacks (falls festgelegt) und der Anfrage-ID, die später zum Herunterladen des Dokuments benötigt wird.

{ "data": 
    {
      "_id": "5f2829ce065afc21cc60ad0e",
    "state": 1,
    "hash_visura": 95cb552053977ca50c9e9b37532edd20",
    "nome": "Aktive Vertreter des Unternehmens ",
    "ricerca": false,
    "id_ricerca": null,
    "prezzo_visura": 2.3,
    "prezzo_ricerca": 0,
    "indice_ricerca": null,
    "stato_richiesta": "In Bearbeitung",
    "email_target": null,
    "allegati": [],
    "timestamp_creation": 1596467662,
    "timestamp_last_update": 1596467663,
    "timestamp_stati": {
      "in_ricerca": 1596467663,
      "in_erogazione": 1596467663
    },
    "callback_data": false,
    "opzioni": null,
    "owner": "[email protected]",
    "sincrona": false,
    "ricerche": [
      {
        "id_ricerca": "5f2829ce065afc21cc60ad0e_0",
        "stato_ricerca": "Forschung abgeschlossen",
        "json_ricerca": "{\"$1\":\"12485671007\"}",
        "json_mappato": {
          "NRea": "1378273",
          "Cciaa": "RM"
        },
        "json_risultato": null
      }
    ],
    "esito": {
      "codice": "0",
      "info": "OK"
    }

Bericht herunterladen

GET /documento/{_id}

Sobald der Status der Anfrage "abgeschlossen" ist, kann das Dokument über die Methode GET /documento/{_id} heruntergeladen werden.

BEISPIELANFRAGE

GET /documento/{_id}

Dies ist ein Beispiel für eine Anfrage, die mit der zuvor erhaltenen ID durchgeführt wurde.

https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e

BEISPIELANTWORT

GET /documento/{_id}

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

{
  data{
    "nome":"5f22f5b5065afc21cc60a27a.zip",
    "dimensione"10206",
    "file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
    },
    "success": true,
    "message": "",
    "error": null
  }

Das herunterzuladende Dokument ist in einer ZIP-Datei enthalten, die die Datei im PDF-, JSON- oder XML-Format enthält.