> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Avvisi di verifica aziendale e codici di errore KYB > Codici di avviso di Didit per la Verifica aziendale: registro, documenti KYB, persone chiave, AML, telefono, email, questionari, dispositivo e IP. 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](https://docs.didit.me/it/business-verification/company-data.md#validazione-del-numero-vat-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). | > [!NOTE] > > **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 ```json theme={null} { "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 ```json theme={null} { "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 ```json theme={null} { "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 > [card] [Schema della risposta](https://docs.didit.me/it/business-verification/response-schema.md) > > Vedi dove compaiono gli avvisi in ciascun array di funzionalità KYB. > [card] [Stati](https://docs.didit.me/it/business-verification/statuses.md) > > Scopri come la gravità degli avvisi si associa allo stato della verifica. > [card] [Documenti](https://docs.didit.me/it/business-verification/documents.md) > > Consulta i gruppi di documenti, l'OCR e il comportamento dei controlli incrociati. > [card] [Persone chiave](https://docs.didit.me/it/business-verification/key-people.md) > > Flusso di verifica di funzionari, UBO e soggetti che hanno inviato i dati. > [card] [Report AML](https://docs.didit.me/it/core-technology/aml-screening/report-aml-screening.md) > > Struttura dei singoli riscontri per gli screening AML di aziende e persone. > [card] [Modelli di dati di riferimento](https://docs.didit.me/it/reference/data-models.md) > > Forme canoniche per gli avvisi e per gli array di funzionalità. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.