Anti Geldwäsche (AML) - Italien

Der Anti Geldwäsche (AML)  Service ist Teil von API Company und richtet sich an alle Unternehmen, die zertifizierte Daten für Anti-Geldwäsche-Verifizierung abrufen möchten.

Mit nur der Umsatzsteuernummer ermöglicht Ihnen der AML Company Service, in wenigen Sekunden über 300 angereicherte Informationen zu allen Einzelpersonen (privat oder juristisch) im Unternehmen zu erhalten. Die verfügbaren Daten für jede Einzelperson umfassen Name, Vorname, Rolle, Beginn der Rolle, Geburtsdatum und -ort, Alter und ob sie der gesetzliche Vertreter sind. Außerdem können Sie Informationen wie:

• Unternehmensdaten (Name, USt-IdNr., Steuer-ID, CCIAA und REA)
• Gesellschafter und Geschäftsführer
• Rechtlicher Sitz
• Unternehmensmitgliedschaften
• Finanzdaten (Ebitda, Ebit, Cashflow mit 2-Jahres-Historie, Umsatz, Umsatztrend, Gewinne, Kapital, Schulden mit Art und Betrag)
• Exporter / Importeur
• Unternehmensgröße
• Teilnahme an öffentlichen Ausschreibungen

Der Service ist derzeit sowohl im synchronen als auch im asynchronen Modus verfügbar.

In Zeiten hoher Auslastung können offizielle Datenquellen Verzögerungen bei den Antwortzeiten erfahren. Falls nicht unbedingt erforderlich, empfehlen wir die Implementierung der POST-Methode.
Diese Methode ermöglicht es Ihnen, eine Callback-URL festzulegen, wodurch die Notwendigkeit entfällt, den Status zu überprüfen, und Sie die Fähigkeit unseres Systems nutzen können, Sie proaktiv über den Abschluss der Anfrage zu benachrichtigen.

Der Referenzendpunkt ist https://company.openapi.com/IT-aml/{vatCode_or_taxCode}

BEISPIELANFRAGE

POST /IT-aml

Dies ist ein Beispiel für eine Anfrage mit dem Umsatzsteuer-Nummer-Parameter: 12485671007

https://company.openapi.com/IT-aml/12485671007

Wie bereits erwähnt, ist es auch möglich, einen Callback über das Payload zu setzen:

{
  "callback": {
    "url": "https://your_domain.it/your_callback.php",
    "method": "JSON",
    "headers": {
      "session_id": "oiwejdf89453urf945jfg"
    }
  }

ANTWORTBEISPIEL

POST /IT-AML

Die Antwort enthält die Anforderungs-ID und den Status

{
  "callback": {
  "data": {
    "state": "PENDING",
    "id": "66a8ed9b82cf2ae627012068"
  },
  "success": true,
  "message": "",
  "error": null
}

ÜBERPRÜFEN SIE DEN ANFORDERUNGSSTATUS

Sie können den Anforderungsstatus jederzeit über den Endpunkt /IT-check_id/{id} überprüfen. Wenn ein Callback festgelegt ist, benachrichtigt Sie das System direkt, sobald die Antwort verfügbar ist.

BEISPIELANFRAGE

GET/IT-check_id/{id}

https://company.openapi.com//IT-check_id/66a8ed9b82cf2ae627012068

ANTWORTBEISPIEL

Wenn der Anforderungsstatus abgeschlossen ist, d.h. auf done, enthält die Antwort alle Daten:

{
  "data": {
    "publicTenders": [
      {
        "year": "2021",
        "applied": 41,
        "won": 42,
        "value": 13812.52
      },
      {
        "year": "2020",
        "applied": 48,
        "won": 51,
        "value": 10274.94
      }
    ],
    "managers": [
      {
        "name": "LUCA",
        "surname": "SCURIATTI",
        "roles": [
          {
            "role": {
              "code": "AUN",
              "description": "Geschäftsführer"
            },
            "roleStartDate": "2020-03-19T00:00:00"
          }
        ],
        "gender": {
          "code": "M",
          "description": "Mann"
        },
        "taxCode": "DSNSMN75C13H501T",
        "birthDate": "1975-03-13T00:00:00",
        "age": 49,
        "birthTown": "ROM (RM)",
        "isLegalRepresentative": false
      }
    ],
    "shareholders": [
      {
        "name": "LUCA",
        "surname": "SCURIATTI",
        "taxCode": "SCRLCU73R02H501H",
        "shareAmount": "3,000.00",
        "percentage": "15.00"
      }
    ]
  },
  "success": true,
  "message": "",
  "error": null
}

Wie angegeben, ist AML auch im synchronen Modus verfügbar. Der zu verwendende Endpunkt ist /IT-aml/{vatCode_or_taxCode}, jedoch wird in diesem Fall die Methode GET verwendet. Die Antwort wird im Durchschnitt innerhalb weniger Sekunden zurückgegeben.

Während Zeiten mit hohem Verkehr können offizielle Datenquellen Verzögerungen bei den Antwortzeiten erfahren. In diesen Spitzenlast- oder Wartungszeiten haben wir eine Zeitüberschreitung von 30 Sekunden für synchrone Anfragen vorgesehen. Nach der Zeitüberschreitung wird eine eindeutige ID generiert, die es den Kunden ermöglicht, Statusaktualisierungen anzufordern und die Antwort zu erhalten, sobald sie verfügbar ist, über den speziellen GET-Endpunkt company.openapi.com/IT-check_id.

Der Dienst ist ideal und wird von Finanzinstituten und -intermediären, Versicherungsunternehmen, Zahlungsdiensten, juristischen und buchhalterischen Fachleuten, Luxusgüterhändlern, Online-Glücksspielbetreibern und Immobilienprofis genutzt.