API de verificació de càrrecs i representants KYB

Els càrrecs, els administradors i els representants no són un concepte separat en el model KYB de Didit. Es troben dins de les Persones clau, juntament amb els UBO i els accionistes, i cada persona té assignats un o diversos rols. Una mateixa persona pot ser administradora i accionista, o representant i signant autoritzat. La persona conserva la llista completa de rols, no només un rol.

Taxonomia completa de rols

Cada persona clau pot tenir un o diversos d’aquests rols:

Govern / representació

Rol	Descripció
`director`	Membre del consell amb responsabilitats de govern
`non_executive_director`	Membre del consell sense funcions de gestió diària
`chairman`	President del consell
`secretary`	Secretari de l’empresa, amb funcions administratives i de compliment
`representative`	Representant legal o designat de l’empresa
`authorized_signatory`	Persona facultada per signar en nom de l’empresa
`trustee`	Fiduciari d’una estructura que té participacions en empreses
`company_officer`	Càrrec general
`founder`	Membre fundador de l’empresa
`legal_advisor`	Assessor jurídic contractat per a l’empresa
`other`	Qualsevol rol fora de la taxonomia estàndard

Titularitat / beneficiari

Rol	Descripció
`ubo`	Titular real: persona física que, en última instància, posseeix o controla l’empresa
`shareholder`	Accionista registrat (persona física o jurídica)
`beneficiary`	Beneficiari d’un fideïcomís o d’una estructura similar
`settlor`	Constituent d’un fideïcomís
`protector`	Protector d’un fideïcomís
`investor`	Inversor (fora de les estructures formals de propietat accionarial)

Una mateixa persona pot tenir rols de les dues categories. Per exemple, un fundador que també és administrador i UBO té tres rols en el mateix registre de persona clau.

Registres amb múltiples rols

Cada registre de persona clau inclou una llista de rols. Cada rol té els seus percentatges de titularitat o de vot, quan s’escau. Així es veu en la resposta un cas d’administrador i accionista:

{
  "uuid": "...",
  "name": "Jane Doe",
  "first_name": "John",
  "last_name": "Doe",
  "entity_type": "person",
  "roles": [
    { "role": "director", "ownership_percent": null, "voting_percent": null },
    { "role": "shareholder", "ownership_percent": 15.0, "voting_percent": 15.0 }
  ],
  "kyc_status": "Approved",
  "kyc_session_url": "https://verify.didit.me/..."
}

Vinculació amb KYC

Cada persona clau es pot vincular a una sessió individual de verificació d’usuaris (KYC). La vinculació es fa automàticament quan la configuració del flux de treball del rol exigeix KYC: el sistema crea la sessió KYC secundària, envia a la persona el seu enllaç de verificació (si aquesta opció està activada) i n’actualitza l’estat en el registre de la persona. Consulta Titularitat → Com la configuració dels rols determina la verificació per conèixer la lògica completa d’encaminament. Per als valors d’estat de KYC aptes per a B2C que apareixen en cada registre de persona (Approved, Declined, Pending), consulta l’esquema de la resposta.

Cribratge AML

Cada persona clau identificada se sotmet automàticament al cribratge amb les llistes de vigilància AML globals, com a part del procés de verificació de l’empresa. Les coincidències PEP són especialment rellevants per als rols de govern: els administradors i els signants d’empreses regulades sovint apareixen en llistes de PEP. Consulta el cribratge AML de l’empresa.

Indicador de verificació obligatòria

Cada registre de persona té un indicador requires_verification que indica si el flux exigeix KYC per a aquesta persona:

Valor	Significat
`true`	El KYC ha de completar-se per a aquesta persona abans que la sessió pugui aprovar-se.
`false`	La persona està identificada i sotmesa al cribratge AML, però no necessita KYC individual.

Configura quins rols requereixen verificació des de Fluxos de treball → [flux de treball KYB] → Persones clau → configuració per rol. Valors per defecte habituals:

Administradors i UBO per sobre del llindar del flux → requires_verification: true.
Signants autoritzats i secretaris → opcional.
Membres no executius del consell → opcional.

Ometre una persona clau

Si no es pot verificar una persona (perquè ha mort, no es pot contactar amb ella o és un registre històric), es pot marcar amb is_skipped: true. Ho pot fer l’usuari final en el flux allotjat (si la configuració del rol permet ometre-la) o un analista des de la consola. Els registres de les persones omeses queden exclosos del control de verificació, però continuen apareixent a la resposta per a l’auditoria.

Referència creuada entre fonts

Les dades de cada persona clau poden procedir de tres llocs, i la consola els mostra tots tres un al costat de l’altre:

Registres del registre mercantil: el que ha declarat el registre oficial.
Enviades per l’usuari: el que l’administrador de l’empresa ha confirmat o afegit al flux de persones clau.
Documents carregats: noms extrets amb OCR d’estatuts de l’empresa, registres d’accionistes o documents de poder.

Les incoherències apareixen com a advertències en la decisió de la sessió.

Efecte sobre l’entitat Business

Quan una persona clau es vincula a una entitat d’usuari mitjançant KYC, es crea una relació duradora amb l’entitat Business. Després pots:

Veure totes les empreses en què cada persona exerceix un rol de govern o de titularitat.
Propagar els canvis d’estat d’un usuari (marcat, bloquejat) a les empreses on actua com a persona clau.
Executar el monitoratge AML continu de cada persona vinculada, independentment de qualsevol sessió KYB concreta.

Següents passos

Persones clau

El flux complet de persones clau.

Titularitat

Identificació d’UBO i cadenes de titularitat.

AML

Cribratge AML de l’empresa i de la persona.

Primers passos

Funcionalitats

Perfils d'empresa

Referència

Consola

API de verificació de càrrecs i representants KYB

Taxonomia completa de rols

Govern / representació

Titularitat / beneficiari

Registres amb múltiples rols

Vinculació amb KYC

Cribratge AML

Indicador de verificació obligatòria

Ometre una persona clau

Referència creuada entre fonts

Efecte sobre l’entitat Business

Següents passos

Persones clau

Titularitat

AML

​Taxonomia completa de rols

​Govern / representació

​Titularitat / beneficiari

​Registres amb múltiples rols

​Vinculació amb KYC

​Cribratge AML

​Indicador de verificació obligatòria

​Ometre una persona clau

​Referència creuada entre fonts

​Efecte sobre l’entitat Business

​Següents passos

Persones clau

Titularitat

AML

Taxonomia completa de rols

Govern / representació

Titularitat / beneficiari

Registres amb múltiples rols

Vinculació amb KYC

Cribratge AML

Indicador de verificació obligatòria

Ometre una persona clau

Referència creuada entre fonts

Efecte sobre l’entitat Business

Següents passos