Avvisi di verifica aziendale e codici di errore KYB

Verifica aziendale (KYB) segnala avvisi sull’elemento della funzionalità che li ha prodotti. Ogni avviso ha la struttura standard usata in tutta la piattaforma: feature, risk, log_type, short_description, long_description, additional_data (facoltativo) e node_id. In questo modo puoi indirizzare il lavoro di revisione al team operativo giusto.

Panoramica

Le sessioni KYB generano avvisi sotto tre tag di funzionalità principali, che corrispondono agli array dedicati nella risposta della decisione V3:

Tag di funzionalità	Chiave della risposta della decisione	Cosa copre
`KYB_REGISTRY`	`registry_checks[].warnings[]`	Verifiche nei registri ufficiali delle imprese. Stato attivo, restrizioni per paese, assetto proprietario ricavabile, dati mancanti su dirigenti o UBO.
`KYB_DOCUMENTS`	`document_verifications[].warnings[]`	Atti costitutivi, documenti di proprietà, di indirizzo e di azionisti caricati dall’utente. Coerenza tra documenti, OCR, metadati, manipolazione, età e regole sui sottotipi.
`KYB_KEY_PEOPLE`	`key_people_checks[].warnings[]`	Segnali a livello di persona su amministratori, dirigenti, UBO o soggetti inseriti dall’utente, inclusi i riscontri PEP e sanzioni che arrivano da AML e dal riutilizzo di una decisione di rifiuto precedente.

Lo stesso workflow KYB può includere anche le funzionalità condivise qui sotto, che generano avvisi nei rispettivi array:

Tag di funzionalità	Chiave della risposta della decisione
`AML`	`aml_screenings[].warnings[]`
`PHONE`	`phone_verifications[].warnings[]`
`EMAIL`	`email_verifications[].warnings[]`
`QUESTIONNAIRE`	`questionnaire_responses` (gli avvisi si trovano nel log della sessione)
`LOCATION`	`ip_analyses[].warnings[]`

Avvisi del registro KYB

Gli avvisi del registro usano feature: "KYB_REGISTRY" e compaiono in registry_checks[].warnings[].

Tag	Descrizione
`KYB_COUNTRY_RESTRICTED`	Il paese dell’azienda non rientra tra i paesi consentiti configurati per il workflow.
`KYB_OFFICERS_DATA_NOT_FOUND`	I dati sui dirigenti non sono disponibili nel registro.
`KYB_OWNERSHIP_DATA_NOT_FOUND`	I dati sull’assetto proprietario non sono disponibili nel registro.
`KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE`	Non è stato possibile stabilire la titolarità effettiva finale a partire dai dati del registro.
`KYB_COMPANY_NOT_ACTIVE`	Secondo il registro, l’azienda non è attiva.
`KYB_COMPANY_NOT_FROM_REGISTRY`	L’azienda è stata inserita manualmente e non è stato possibile verificarla con un registro delle imprese.
`KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED`	Il numero di registrazione dell’azienda ricavato dal registro non corrisponde a `expected_details.registration_number` inviato alla creazione della sessione.
`KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED`	Il numero di registrazione ricavato dal registro corrisponde solo in parte a quello atteso, per esempio per un suffisso di filiale o di controllata.
`KYB_COMPANY_VAT_INVALID`	Il registro fiscale ufficiale non ha alcuna registrazione attiva per il numero di partita IVA o per l’identificativo fiscale dell’azienda, oppure il numero di partita IVA non rispetta il formato o le regole della cifra di controllo del suo paese. Si applica l’azione `kyb_vat_invalid_action` configurata (predefinito: In revisione).
`KYB_COMPANY_VAT_COULD_NOT_VALIDATE`	Non è stato possibile convalidare il numero di partita IVA o l’identificativo fiscale perché il registro ufficiale era temporaneamente non disponibile. Si applica l’azione `kyb_vat_unverified_action` configurata (predefinito: nessun effetto).
`KYB_COMPANY_VAT_NAME_MISMATCH`	Il nome registrato presso il registro ufficiale per questo numero è diverso dal nome dell’azienda inviato. Informativo: include `registry_name`, `registry_source` e `submitted_name` in `additional_data`, più `vies_name` quando il registro è VIES.

Gli avvisi sulla partita IVA si applicano ovunque sia possibile convalidare il numero di partita IVA o l’identificativo fiscale dell’azienda. Per i paesi e le fonti, consulta Convalida della partita IVA e dell’identificativo fiscale.

Avvisi sui documenti KYB

Gli avvisi sui documenti usano feature: "KYB_DOCUMENTS" e compaiono in document_verifications[].warnings[].

Tag	Descrizione
`KYB_DOCUMENT_MISSING_REQUIRED_FIELD`	Un campo aziendale obbligatorio, come il nome dell’azienda o il numero di registrazione, non è stato trovato nel documento.
`KYB_DOCUMENT_NAME_MISMATCH`	Il nome dell’azienda nel documento non corrisponde a quello nel registro delle imprese.
`KYB_DOCUMENT_REG_NUMBER_MISMATCH`	Il numero di registrazione nel documento non corrisponde a quello nel registro delle imprese.
`KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH`	La data di costituzione nel documento non corrisponde a quella nel registro delle imprese.
`KYB_DOCUMENT_ADDRESS_MISMATCH`	La sede legale nel documento non corrisponde a quella nel registro delle imprese.
`KYB_CROSS_DOCUMENT_MISMATCH`	I dati dell’azienda differiscono tra i documenti societari caricati.
`KYB_DOCUMENT_METADATA_MISMATCH`	La firma, i metadati o la struttura del file del documento indicano un possibile problema.
`KYB_ASSOCIATED_PARTY_MISMATCH`	Gli amministratori o gli azionisti indicati nel documento non corrispondono al registro delle imprese.
`KYB_DOCUMENT_GRAPHIC_EDITOR`	Il documento sembra essere stato elaborato con un software di editing grafico.
`KYB_DOCUMENT_SUSPECTED_MANIPULATION`	Il sistema ha rilevato segnali di una possibile manipolazione del documento societario.
`KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT`	Un campo di testo del documento societario è stato cancellato e riscritto con un font diverso, e il file non consente di stabilire se il contenuto sia cambiato. Viene generato anche per un file che non è stato possibile verificare integralmente, con `additional_data.detection_method` impostato su `analysis_incomplete`, perché la parte non verificata potrebbe contenere un campo di questo tipo. È regolato da `kyb_document_unproven_text_replacement_action` (predefinito Revisione; un workflow che non prevede revisioni usa il proprio `kyb_document_tampering_action` quando è impostato su Rifiuto, altrimenti Nessuna azione).
`KYB_ADDITIONAL_DATA_NOT_FOUND`	Un campo del documento non può essere verificato perché i corrispondenti dati del registro non sono disponibili.
`KYB_DOCUMENT_EXPIRED`	Il documento societario supera l’età massima configurata.
`KYB_DOCUMENT_UNSUPPORTED_SUBTYPE`	Il sottotipo di documento caricato è disabilitato per il workflow.
`KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED`	È stato superato il numero massimo di tentativi di caricamento dei documenti societari.

Per la manipolazione del testo sovrapposto nei PDF, KYB_DOCUMENT_SUSPECTED_MANIPULATION può includere additional_data.manipulated_regions. Un campo di testo cancellato e riscritto con un font diverso genera KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT con la stessa struttura di manipulated_regions, mai KYB_DOCUMENT_SUSPECTED_MANIPULATION da solo: anche gli editor online riscrivono testo non modificato, quindi questo avviso non indica che il contenuto è cambiato. Se un altro segnale genera KYB_DOCUMENT_SUSPECTED_MANIPULATION sullo stesso documento, decide l’azione più restrittiva tra le due. Si tratta di rettangoli con coordinate di pagina che identificano le aree sospette di modifica e corrispondono ai rettangoli restituiti in document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions.

Avvisi delle persone chiave KYB

Gli avvisi sulle persone chiave usano feature: "KYB_KEY_PEOPLE" e compaiono in key_people_checks[].warnings[]. Segnalano problemi a livello di persona relativi ad amministratori, dirigenti, UBO e soggetti inseriti dall’utente.

Tag	Descrizione
`KYB_PREVIOUSLY_DECLINED_INDIVIDUAL`	Una persona associata all’azienda era stata rifiutata in un’altra verifica aziendale per la stessa applicazione.
`KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS`	Gli amministratori o gli azionisti dichiarati nella schermata Persone chiave non corrispondono alle persone indicate nei documenti aziendali caricati: una persona citata nei documenti non è mai stata dichiarata, un nome corrisponde quasi ma non esattamente, un azionista presente nei documenti è stato dichiarato senza un ruolo di assetto proprietario, oppure una percentuale di proprietà dichiarata contraddice i documenti. Si applica il valore configurato in `kyb_key_people_document_mismatch_action` (predefinito: In revisione).

Riscontri PEP e sanzioni sulle persone chiave vengono riportati come normali riscontri AML sull’elemento corrispondente di aml_screenings[], non come avviso KYB delle persone chiave. Il controllo delle persone chiave trasferisce lo stato risultante Declined o In Review a ciascun soggetto interessato, così che l’esito complessivo sulle persone chiave rifletta quello dell’AML.

Avvisi condivisi delle funzionalità

Le funzionalità seguenti possono essere eseguite all’interno di un workflow KYB. Usano lo stesso catalogo di avvisi di Verifica degli utenti: il riferimento completo si trova nella pagina degli avvisi di ciascuna funzionalità.

AML

feature: "AML" su aml_screenings[].warnings[].

Tag	Descrizione
`POSSIBLE_MATCH_FOUND`	Lo screening AML ha trovato una possibile corrispondenza che richiede una revisione.
`COULD_NOT_PERFORM_AML_SCREENING`	Didit non ha potuto eseguire lo screening AML perché i dati necessari allo screening mancavano o non erano disponibili.

Telefono

feature: "PHONE" su phone_verifications[].warnings[].

Tag	Descrizione
`DISPOSABLE_NUMBER_DETECTED`	Il numero di telefono è usa e getta.
`VERIFICATION_CODE_ATTEMPTS_EXCEEDED`	È stato superato il numero massimo di tentativi di inserimento del codice di verifica.
`VOIP_NUMBER_DETECTED`	Il numero di telefono è un numero VoIP.
`DUPLICATED_PHONE_NUMBER`	Il numero di telefono è stato usato in un altro processo di verifica.
`HIGH_RISK_PHONE_NUMBER`	Il numero di telefono è ad alto rischio.
`PHONE_NUMBER_IN_BLOCKLIST`	Il numero di telefono corrisponde a una voce della tua blocklist.

Email

feature: "EMAIL" su email_verifications[].warnings[].

Tag	Descrizione
`BREACHED_EMAIL_DETECTED`	L’indirizzo email risulta coinvolto in violazioni di dati note.
`DISPOSABLE_EMAIL_DETECTED`	L’indirizzo email è usa e getta.
`UNDELIVERABLE_EMAIL_DETECTED`	L’indirizzo email non è recapitabile.
`DUPLICATED_EMAIL`	L’indirizzo email è stato usato in un altro processo di verifica.
`EMAIL_IN_BLOCKLIST`	L’indirizzo email corrisponde a una voce della tua blocklist.
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	È stato superato il numero massimo di tentativi del codice di verifica via email.

Questionario

feature: "QUESTIONNAIRE".

Tag	Descrizione
`CUSTOM_STATUS_RULE_TRIGGERED`	Una regola di stato del workflow ha valutato una risposta del questionario e ha modificato lo stato della funzionalità.

Analisi dispositivo e IP

feature: "LOCATION" su ip_analyses[].warnings[].

Tag	Descrizione
`COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP`	Il paese del documento non corrisponde al paese dell’IP.
`PRIVATE_NETWORK_DETECTED`	È stato rilevato un segnale di rete privata, VPN, proxy o Tor.
`EXPECTED_IP_ADDRESS_MISMATCH`	L’indirizzo IP non corrisponde all’indirizzo IP previsto fornito per la sessione.
`IP_ADDRESS_IN_BLOCKLIST`	L’indirizzo IP corrisponde a una voce della tua blocklist.
`DEVICE_FINGERPRINT_IN_BLOCKLIST`	L’impronta del dispositivo corrisponde a una voce della tua blocklist.
`DUPLICATED_IP_ADDRESS`	Lo stesso indirizzo IP è stato usato in un’altra verifica con `vendor_data` diverso.
`DUPLICATED_DEVICE_FINGERPRINT`	La stessa impronta del dispositivo è stata usata in un’altra verifica con `vendor_data` diverso.

Esempi

Registro: azienda non attiva

{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}

Documenti: sospetta manipolazione tramite sovrapposizione

{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}

Persone chiave: persona precedentemente rifiutata

{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}

Correlati

Schema della risposta

Vedi dove compaiono gli avvisi in ciascun array di funzionalità KYB.

Stati

Scopri come la gravità degli avvisi si associa allo stato della verifica.

Documenti

Consulta i gruppi di documenti, l’OCR e il comportamento dei controlli incrociati.

Persone chiave

Flusso di verifica di funzionari, UBO e soggetti che hanno inviato i dati.

Report AML

Struttura dei singoli riscontri per gli screening AML di aziende e persone.

Modelli di dati di riferimento

Forme canoniche per gli avvisi e per gli array di funzionalità.

Primi passi

Funzionalità

Profili aziendali

Riferimento

Console

Avvisi di verifica aziendale e codici di errore KYB

Panoramica

Avvisi del registro KYB

Avvisi sui documenti KYB

Avvisi delle persone chiave KYB

Avvisi condivisi delle funzionalità

AML

Telefono

Email

Questionario

Analisi dispositivo e IP

Esempi

Registro: azienda non attiva

Documenti: sospetta manipolazione tramite sovrapposizione

Persone chiave: persona precedentemente rifiutata

Correlati

Schema della risposta

Stati

Documenti

Persone chiave

Report AML

Modelli di dati di riferimento

​Panoramica

​Avvisi del registro KYB

​Avvisi sui documenti KYB

​Avvisi delle persone chiave KYB

​Avvisi condivisi delle funzionalità

​AML

​Telefono

​Email

​Questionario

​Analisi dispositivo e IP

​Esempi

​Registro: azienda non attiva

​Documenti: sospetta manipolazione tramite sovrapposizione

​Persone chiave: persona precedentemente rifiutata

​Correlati

Schema della risposta

Stati

Documenti

Persone chiave

Report AML

Modelli di dati di riferimento

Panoramica

Avvisi del registro KYB

Avvisi sui documenti KYB

Avvisi delle persone chiave KYB

Avvisi condivisi delle funzionalità

AML

Telefono

Email

Questionario

Analisi dispositivo e IP

Esempi

Registro: azienda non attiva

Documenti: sospetta manipolazione tramite sovrapposizione

Persone chiave: persona precedentemente rifiutata

Correlati