> ## 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. # Stati KYB: riferimento per sessioni, funzionalità e AML > Stati esatti per sessioni KYB, funzionalità, registro delle imprese e screening AML di Didit. Da $2.00 per controllo, prezzi per paese e livello. Business Verification tiene lo stato a più livelli: la **sessione**, le singole **funzionalità**, la **ricerca nel registro** e il **risultato AML**. Questa pagina è il riferimento per ogni stato. L'API restituisce i valori di stato come etichette esatte che distinguono tra maiuscole e minuscole, come `"In Progress"` e `"Not Finished"`, le stesse stringhe che i webhook trasmettono. Confronta queste stringhe così come sono, non sui nomi in maiuscolo. ## Stato della sessione Lo stato complessivo di una sessione di Business Verification (KYB), il campo che più spesso userai per decidere il comportamento dell'applicazione. | Stato | Significato | | - | - | | `"Not Started"` | Sessione creata, ma l'azienda non ha ancora aperto il link ospitato. | | `"In Progress"` | Il flusso ospitato è attivo: ricerche nel registro, caricamento di documenti o screening AML in corso. | | `"Awaiting User"` | In attesa che l'utente finale esegua un'azione (in genere inviare le persone chiave o rispondere a una richiesta di nuovo invio). Passa automaticamente allo stato successivo quando l'utente completa l'azione in sospeso. | | `"Approved"` | Tutte le funzionalità obbligatorie sono state superate. L'azienda è verificata. | | `"Declined"` | È fallito un controllo critico (società sciolta, entità sanzionata, presenza nella blocklist) oppure una regola del workflow ha rifiutato la sessione. | | `"In Review"` | Una o più funzionalità richiedono la revisione manuale da parte di un analista. | | `"Resubmitted"` | Una sessione precedentemente rifiutata o con richiesta di nuovo invio è stata ripresentata con dati aggiornati. | | `"Abandoned"` | L'azienda non ha mai completato il flusso (timeout). | | `"Expired"` | La sessione è scaduta prima che l'azienda la completasse. | > [!NOTE] > > `"Awaiting User"` è uno stato transitorio: non devi spostare manualmente le sessioni fuori da questo stato. Appena l'utente finale completa l'azione in sospeso (ad esempio invia l'elenco delle persone chiave o ricarica un documento richiesto), Didit rivaluta la sessione e la porta automaticamente a `"In Review"`, `"Approved"` o `"Declined"`, in base all'esito. ## Stato della funzionalità Ogni funzionalità KYB ha un proprio stato, che confluisce nello stato della sessione. | Stato | Significato | | - | - | | `"Not Finished"` | La funzionalità non è ancora stata avviata oppure è in corso. | | `"Approved"` | La funzionalità è stata superata. | | `"Declined"` | La funzionalità non è stata superata (critica). | | `"In Review"` | La funzionalità richiede l'intervento di un analista. | | `"Resub Requested"` | L'azienda deve ripresentare i dati per questa funzionalità (ad esempio ricaricare un documento). | | `"Awaiting User"` | La funzionalità è in attesa di un'azione dell'utente finale. Si applica alla funzionalità Persone chiave quando l'utente deve inviare i soggetti. Passa automaticamente a un nuovo stato al momento dell'invio. | ### Nomi delle funzionalità KYB Questi sono i valori di `features` in una sessione KYB e nei webhook: * `KYB_REGISTRY`: ricerca nel registro delle imprese. * `AML`: screening AML a livello aziendale. * `KYB_DOCUMENTS`: raccolta dei documenti e OCR. * `KYB_KEY_PEOPLE`: persone chiave, ossia titolari effettivi, azionisti, amministratori, rappresentanti e altri dirigenti. ## Stato del registro (dal fornitore) Lo stato ufficiale dell'azienda, ottenuto da fonti di registro autorevoli. Riflette la posizione giuridica o normativa del soggetto, come riportata dal registro della specifica giurisdizione, quindi i valori esatti variano in base alla fonte. Viene esposto nella decisione KYB in `company.registry_status`. | Stato | Significato | | - | - | | `ACTIVE` | L'azienda è attiva e in regola. | | `DISSOLVED` | L'azienda è stata sciolta. | | `DEREGISTERED` | L'azienda è stata cancellata dal registro. | | `STRUCK_OFF` | L'azienda è stata radiata dal registro. | | `CLOSED` | L'azienda è stata chiusa. | | `INACTIVE` | L'azienda è inattiva (non operativa). | | `AUTHORISED` | Autorizzata (in genere per i soggetti regolamentati). | | `APPOINTED_REPRESENTATIVE` | Rappresentante designato di un'altra impresa autorizzata. | | `UNAUTHORISED` | Precedentemente autorizzata, ora non più autorizzata. | | `NO_LONGER_AUTHORISED` | Autorizzazione revocata. | | `SEE_FULL_DETAILS` | Lo stato richiede un controllo manuale. | > [!NOTE] > > Poiché `registry_status` riflette i valori grezzi del registro, usa `verification_status` qui sotto quando ti serve un indicatore coerente tra giurisdizioni per guidare la logica del prodotto. ## Stato di verifica dell'azienda Uno stato standardizzato, rivolto alle aziende, per ogni risultato relativo a un'azienda. Normalizza i diversi stati del registro e dell'azienda, che variano tra paesi e fonti, in un unico indicatore coerente che può essere interpretato direttamente all'interno del tuo prodotto. Viene esposto nella decisione KYB in `company.verification_status`. | Stato | Significato | | - | - | | `verified` | L'azienda risulta attiva e valida. | | `failed` | L'azienda risulta inattiva, sciolta oppure sono stati rilevati problemi. | | `unknown` | Le informazioni sono insufficienti oppure lo stato è ambiguo. | ## Stato di recupero dei dati dell'azienda Indica l'avanzamento del recupero dei dati per una specifica scheda aziendale da registri esterni o ufficiali. Usalo per capire quanto siano complete le informazioni recuperate per una data azienda. Viene esposto nella decisione KYB in `company.fetch_status`. | Stato | Significato | | - | - | | `pending` | In questa fase sono state recuperate solo informazioni parziali o di base sull'azienda. | | `resolved` | I dati completi dell'azienda sono stati recuperati con successo da fonti ufficiali. | ## Stato della verifica AML Restituito per ogni screening (azienda o persona). | Stato | Significato | | - | - | | `"Approved"` | Nessun riscontro sopra la soglia. | | `"Declined"` | Riscontro ad alta gravità (corrispondenza confermata con una sanzione o con una PEP). | | `"In Review"` | Riscontro che richiede la revisione di un analista. | | `"Not Finished"` | Lo screening non è ancora stato completato. | ## Come si spiega una decisione La decisione KYB non include un'unica stringa di codice motivo. Ogni array di funzionalità (`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`) contiene `warnings[]` con tag `KYB_*` e tag AML, e `decision_trace` registra come è stata raggiunta la decisione. Leggi i tag in [avvisi KYB](https://docs.didit.me/it/business-verification/warnings.md) e registrali insieme allo stato della sessione. Quando un revisore imposta lo stato manualmente, in contrasto con l'aggregazione della piattaforma, la decisione include `status_override` con l'orario `overridden_at` e il valore `automatic_status` che la piattaforma avrebbe impostato. Consulta lo [schema della risposta](https://docs.didit.me/it/business-verification/response-schema.md). ## Passaggi successivi > [card] [Schema della risposta](https://docs.didit.me/it/business-verification/response-schema.md) > > Dove compare ogni stato nel payload. > [card] [Valutazione del rischio](https://docs.didit.me/it/business-verification/risk-assessment.md) > > Che cosa determina l'esito di una verifica KYB. > [card] [Webhook](https://docs.didit.me/it/business-verification/webhooks.md) > > Eventi che si attivano al cambiamento di stato. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.