> ## 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. # Estats de verificació d'empreses (KYB): referència > Cadenes d'estat exactes de Didit per a sessions KYB, funcionalitats, registre i AML. Des de $2.00 per comprovació, segons país i nivell. Business Verification fa un seguiment de l'estat a diversos nivells: la **sessió**, les **funcionalitats** individuals, la **consulta al registre** i el **resultat AML**. Aquesta pàgina és la referència de cada estat. L'API retorna els valors d'estat com a etiquetes exactes i sensibles a majúscules i minúscules, com `"In Progress"` i `"Not Finished"`, les mateixes cadenes que porten els webhooks. Fes la comparació amb aquestes cadenes, no amb noms en majúscules. ## Estat de la sessió L'estat general d'una sessió de Verificació d'empreses (KYB), el camp que més sovint faràs servir per prendre decisions. | Estat | Significat | | - | - | | `"Not Started"` | Sessió creada, però l'empresa encara no ha obert l'enllaç allotjat. | | `"In Progress"` | El flux allotjat està actiu: consultes al registre, càrrega de documents o cribratge AML en curs. | | `"Awaiting User"` | S'espera que l'usuari final faci una acció (normalment enviar les persones clau o respondre a una sol·licitud de reenviament). Canvia automàticament quan l'usuari completa l'acció pendent. | | `"Approved"` | Totes les funcionalitats obligatòries s'han superat. L'empresa està verificada. | | `"Declined"` | Una comprovació crítica ha fallat (empresa dissolta, entitat sancionada o entitat inclosa en una llista de bloqueig) o una regla del flux de treball l'ha rebutjat. | | `"In Review"` | Una o diverses funcionalitats requereixen revisió manual d'un analista. | | `"Resubmitted"` | La sessió rebutjada anteriorment o amb una sol·licitud de reenviament anterior s'ha reenviat amb dades actualitzades. | | `"Abandoned"` | L'empresa no ha completat mai el flux (temps d'espera esgotat). | | `"Expired"` | La sessió ha caducat abans que l'empresa la completés. | > [!NOTE] > > `"Awaiting User"` és transitori: no cal que el treguis manualment d'aquest estat. Tan bon punt l'usuari final completa l'acció pendent (per exemple, envia la llista de persones clau o torna a carregar un document sol·licitat), Didit torna a avaluar la sessió i la passa automàticament a `"In Review"`, `"Approved"` o `"Declined"` segons el resultat. ## Estat de la funcionalitat Cada funcionalitat de KYB té el seu propi estat, que es combina per determinar l'estat de la sessió. | Estat | Significat | | - | - | | `"Not Finished"` | La funcionalitat encara no s'ha iniciat o està en curs. | | `"Approved"` | La funcionalitat s'ha superat. | | `"Declined"` | La funcionalitat ha fallat (de manera crítica). | | `"In Review"` | La funcionalitat requereix l'atenció d'un analista. | | `"Resub Requested"` | L'empresa ha de tornar a enviar informació per a aquesta funcionalitat (per exemple, tornar a carregar un document). | | `"Awaiting User"` | La funcionalitat espera una acció de l'usuari final. S'aplica a la funcionalitat de persones clau mentre l'usuari ha de presentar les persones clau. Canvia automàticament quan les presenta. | ### Noms de les funcionalitats de KYB Aquests són els valors de `features` en una sessió de KYB i en els webhooks: * `KYB_REGISTRY`: consulta al registre mercantil de l'empresa. * `AML`: cribratge AML a nivell d'empresa. * `KYB_DOCUMENTS`: recollida de documents i OCR. * `KYB_KEY_PEOPLE`: persones clau: titulars reals (UBO), accionistes, administradors, representants i altres càrrecs. ## Estat del registre (del proveïdor) L'estat oficial de l'empresa obtingut de fonts de registre oficials i fiables. Reflecteix la situació legal o reglamentària de l'entitat segons el registre específic de cada jurisdicció, de manera que els valors exactes varien segons la font. Apareix dins de la decisió KYB a `company.registry_status`. | Estat | Significat | | - | - | | `ACTIVE` | L'empresa està activa i en bona situació. | | `DISSOLVED` | L'empresa s'ha dissolt. | | `DEREGISTERED` | L'empresa s'ha donat de baixa del registre. | | `STRUCK_OFF` | L'empresa s'ha eliminat del registre. | | `CLOSED` | L'empresa s'ha tancat. | | `INACTIVE` | L'empresa és inactiva (sense activitat comercial). | | `AUTHORISED` | Autoritzada (habitualment per a entitats regulades). | | `APPOINTED_REPRESENTATIVE` | Representant designat d'una altra empresa autoritzada. | | `UNAUTHORISED` | Abans autoritzada, ara no autoritzada. | | `NO_LONGER_AUTHORISED` | Autorització revocada. | | `SEE_FULL_DETAILS` | L'estat requereix una revisió manual. | > [!NOTE] > > Com que `registry_status` reflecteix els valors bruts del registre, fes servir `verification_status` més avall quan necessitis un indicador coherent entre jurisdiccions per guiar la lògica del producte. ## Estat de verificació de l'empresa Un estat estandarditzat, orientat al negoci, per a cada resultat d'empresa. Normalitza els diferents estats de registre i d'empresa de cada país i font en un únic indicador coherent que es pot interpretar directament dins del teu producte. Apareix dins de la decisió KYB a `company.verification_status`. | Estat | Significat | | - | - | | `verified` | L'empresa sembla activa i vàlida. | | `failed` | L'empresa sembla inactiva, dissolta o s'hi han identificat problemes. | | `unknown` | No hi ha prou informació o l'estat és ambigu. | ## Estat de recuperació de dades de l'empresa Indica el progrés de la recuperació de dades d'un registre d'empresa concret de registres externs o oficials. Fes-lo servir per determinar com de completa és la informació recuperada per a una empresa determinada. Apareix dins de la decisió KYB a `company.fetch_status`. | Estat | Significat | | - | - | | `pending` | En aquesta etapa només s'ha recuperat informació parcial o bàsica de l'empresa. | | `resolved` | S'ha recuperat correctament la informació completa de l'empresa des de fonts oficials. | ## Estat de verificació AML Es retorna per cada cribratge (d'empresa o de persona). | Estat | Significat | | - | - | | `"Approved"` | Cap coincidència per sobre del llindar. | | `"Declined"` | Coincidència d'alta gravetat (sanció confirmada o coincidència de PEP). | | `"In Review"` | Coincidència trobada que requereix revisió d'un analista. | | `"Not Finished"` | El cribratge no s'ha completat. | ## Com s'explica una decisió La decisió KYB no inclou una única cadena de codi de motiu. Cada matriu de funcionalitat (`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`) inclou `warnings[]` amb etiquetes `KYB_*` i AML, i `decision_trace` registra com s'ha arribat a la decisió. Llegeix les etiquetes a [advertències de KYB](https://docs.didit.me/ca/business-verification/warnings.md) i registra-les juntament amb l'estat de la sessió. Quan un revisor estableix l'estat manualment en contra de l'agregació pròpia de la plataforma, la decisió inclou `status_override` amb el moment `overridden_at` i l'`automatic_status` que la plataforma hauria establert. Consulta l'[esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md). ## Següents passos > [card] [Esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md) > > On apareix cada estat al payload. > [card] [Avaluació de risc](https://docs.didit.me/ca/business-verification/risk-assessment.md) > > Què determina un resultat KYB. > [card] [Webhooks](https://docs.didit.me/ca/business-verification/webhooks.md) > > Esdeveniments que s'activen quan canvia l'estat. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.