Saltar al contingut principal
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.
"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ó.

​
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.
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 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 de verificació AML

Es retorna per cada cribratge (d’empresa o de persona).

​
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 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.

​
Següents passos

Esquema de resposta

On apareix cada estat al payload.

Avaluació de risc

Què determina un resultat KYB.

Webhooks

Esdeveniments que s’activen quan canvia l’estat.
Darrera modificació el 7 de novembre del 2026