> ## 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. # API de verificació d'empreses (KYB): registre i titulars > Didit verifica empreses amb consultes al registre, titulars reals, cribratge de càrrecs i AML. Des de $2.00 per comprovació, sense contractes. La Verificació d'empreses (KYB) de Didit et permet verificar empreses i entitats jurídiques abans de donar-les d'alta a la teva plataforma. El sistema automatitza les consultes als registres mercantils, identifica els titulars reals i les persones amb càrrecs directius, sotmet totes les parts a un cribratge amb les llistes de vigilància AML i recull els documents de suport, tot dins d'un únic flux de treball. Cada empresa verificada es registra com a [perfil d'empresa](https://docs.didit.me/ca/business-verification/business-profiles.md), que agrega els resultats de totes les sessions. Aquesta lliçó de Didit Academy segueix una verificació d'empresa de principi a fi: el tauler de KYB, la consulta al registre, els accionistes i els UBOs, el cribratge AML i el que veu el representant de l'empresa des de la seva banda. [Verifica una empresa (KYB), de principi a fi: Didit Academy](https://www.youtube.com/embed/JEnW_sEe35Y?rel=0\&playsinline=1) Ets nou amb el KYB de Didit? Comença amb la [guia d'inici ràpid](https://docs.didit.me/ca/business-verification/quickstart.md) per fer un recorregut complet en 10 minuts i després llegeix la [guia d'integració](https://docs.didit.me/ca/business-verification/integration-guide.md) per als patrons de producció. Per al model d'entitat Business subjacent (amb enllaços a usuaris, llistes de bloqueig, importació i exportació), consulta [Empreses](https://docs.didit.me/ca/entities/businesses/overview.md). ## Com funciona **1. Crea una sessió d'empresa** Inicia una verificació d'empresa creant una sessió amb un **flux de treball KYB**. Quan el tipus de flux és KYB, Didit crea automàticament una sessió d'empresa: ```bash theme={null} curl -X POST https://verification.didit.me/v3/session/ \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "workflow_id": "your-kyb-workflow-id", "vendor_data": "company-123" }' ``` El tipus de sessió el determina el flux de treball: no cal cap camp addicional. Els fluxos KYB creen automàticament sessions d'empresa amb les funcionalitats específiques per a empreses activades. **2. Consulta al registre mercantil** Didit consulta els registres oficials d'empreses als nivells **Lite**, **Shareholders** o **UBOs**, cadascun amb un preu per país; consulta [preus dels registres](https://docs.didit.me/ca/getting-started/kyb-registry-pricing.md). Lite recupera: | Dada | Descripció | | - | - | | **Nom de l'empresa** | Nom legal tal com figura inscrit | | **Número de registre** | Número oficial d'inscripció de l'empresa | | **País** | País de constitució | | **Estat** | Activa, dissolta, donada de baixa, etc. | | **Tipus d'empresa** | Ltd, LLC, PLC, SA, GmbH, etc. | | **Data de constitució** | Data en què es va inscriure l'empresa | | **Adreça social** | Adreça oficial de la seu social registrada | | **Número fiscal** | Número d'identificació fiscal (quan està disponible) | Les dades del registre es contrasten amb la informació facilitada per detectar incoherències. **3. Persones clau: UBO, accionistes, administradors i representants** El sistema identifica cada persona i entitat corporativa vinculada a l'empresa dins del model unificat de **Persones clau**: * **UBO**: persones físiques que en última instància posseeixen o controlen l'empresa, amb els percentatges de propietat i de vot * **Accionistes** (persones físiques i jurídiques): cadascun amb el seu percentatge de propietat * **Administradors, representants, secretaris, signants autoritzats i altres càrrecs**: amb l'etiqueta de rol específica * **Capes de titularitat corporativa**: empreses matrius de la cadena de titularitat, amb KYB anidat opcional Una mateixa persona pot tenir diverses etiquetes de rol (per exemple, administradora **i** accionista). Cada rol es configura individualment al flux de treball: quins rols requereixen KYC, quin flux KYC s'utilitza i si l'usuari final pot saltar-se la verificació. Més informació a [Persones clau](https://docs.didit.me/ca/business-verification/key-people.md) i [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md). **4. Cribratge AML** Totes les parts identificades se sotmeten automàticament a un cribratge contra les llistes globals de vigilància AML: * **AML Empresa**: cribra l'entitat de l'empresa contra sancions, mitjans adversos i llistes d'aplicació de la normativa * **AML de persones**: cribra cada persona clau (UBO, accionista, administrador, representant, etc.) de manera individual * Utilitza el mateix [sistema de risc de dues puntuacions](https://docs.didit.me/ca/core-technology/aml-screening/overview.md) (puntuació de coincidència + puntuació de risc) que la verificació d'usuaris **5. Recollida de documents** Recull i verifica els documents de suport: | Tipus de document | Exemples | | - | - | | **Certificat de constitució** | Certificat de constitució de l'empresa | | **Estatuts socials** | Estatuts, memoràndum d'associació | | **Comprovant de domicili** | Factures de serveis, extractes bancaris de l'adreça social | | **Registre d'accionistes** | Registre oficial d'accionistes | | **Estats financers** | Comptes anuals, informes d'auditoria | | **Certificats fiscals** | Certificats d'inscripció fiscal o de compliment fiscal | | **Documents personalitzats** | Qualsevol document addicional que requereixi el teu procés de compliment | Els analistes poden sol·licitar documents addicionals a l'empresa durant el procés de revisió. **6. Revisió i decisió** La sessió d'empresa rep un estat general basat en totes les comprovacions: | Estat | Significat | | - | - | | **Aprovada** | Totes les comprovacions superades: l'empresa està verificada | | **En revisió** | Una o més comprovacions requereixen revisió manual | | **Rebutjada** | Una comprovació crítica ha fallat (per exemple, empresa dissolta o entitat sancionada) | Els analistes poden revisar totes les dades recollides a la **Business Console**, afegir comentaris, sol·licitar documents addicionals i prendre una decisió final. ## Cicle de vida de la sessió d'empresa Cada verificació d'empreses (KYB) s'executa dins d'una **sessió d'empresa** que fa el seguiment del progrés amb els estats següents: | Estat | Descripció | | - | - | | `"Not Started"` | Sessió creada, però la verificació encara no ha començat | | `"In Progress"` | La verificació està en curs: consultes al registre, cribratge AML o recollida de documents en marxa | | `"Approved"` | Totes les comprovacions s'han superat: l'empresa està verificada | | `"Declined"` | Ha fallat una comprovació crítica (per exemple, una empresa dissolta o una entitat sancionada) | | `"In Review"` | Una o més comprovacions requereixen revisió manual per part d'un analista | | `"Resubmitted"` | Sessió rebutjada anteriorment i reenviada amb dades actualitzades | Cada sessió té un `session_id` únic, un `session_number` seqüencial i un `session_token` per a l'enllaç de verificació allotjat. Quan es crea una sessió amb un identificador `vendor_data`, Didit l'enllaça automàticament amb el [perfil d'empresa](https://docs.didit.me/ca/business-verification/business-profiles.md) corresponent. ## Estats de les funcionalitats La verificació d'empreses (KYB) fa el seguiment de l'estat de cada component de manera independent: | Funcionalitat | Descripció | | - | - | | **Comprovació del registre mercantil** | Consulta al registre mercantil de l'empresa i extracció de dades | | **AML d'empresa** | Cribratge AML a nivell d'empresa contra sancions i llistes de vigilància | | **Documents** | Recollida de documents, OCR i encreuament de dades | | **Persones clau** | Identificació del titular real i dels càrrecs, AML i KYC | Cada funcionalitat pot estar en un dels estats següents: `"Not Finished"`, `"Approved"`, `"Declined"`, `"In Review"` o `"Resub Requested"`. L'estat general de la sessió agrega els estats de les funcionalitats individuals: la sessió només està `"Approved"` quan totes les funcionalitats obligatòries s'han superat. ## Esdeveniments de webhook Les sessions d'empresa generen els esdeveniments de webhook següents: | Esdeveniment | Activador | | - | - | | `status.updated` | Ha canviat l'estat de la sessió. El payload inclou `session_kind: "business"` per a les sessions KYB. | | `data.updated` | Un revisor ha editat les dades del registre o les Persones clau a la consola, o el registre ha informat d'un canvi. El payload inclou `session_kind: "business"`. Seguiu `status.updated` per veure el progrés. | | `business.status.updated` | Ha canviat l'estat de la [entitat empresarial](https://docs.didit.me/ca/entities/businesses/overview.md) enllaçada (`ACTIVE` / `FLAGGED` / `BLOCKED`). | | `business.data.updated` | Han canviat els camps del perfil o els comptadors agregats de l'entitat empresarial enllaçada. | Els payloads de webhook inclouen `session_kind: "business"` i el `business_session_id` per distingir aquests esdeveniments dels esdeveniments de verificació d'usuaris. Consulteu [Webhooks](https://docs.didit.me/ca/integration/webhooks.md) per a la verificació de la signatura i els detalls del lliurament. ## Capacitats principals | Capacitat | Descripció | | - | - | | **Consultes automàtiques al registre** | Consulta els registres mercantils oficials dels països compatibles en el nivell Lite, Shareholders o UBOs, [amb preu per país](https://docs.didit.me/ca/getting-started/kyb-registry-pricing.md) | | **Identificació de titulars reals** | Extreu automàticament les estructures de titularitat real amb els percentatges | | **Cribratge de càrrecs** | Identifica i verifica administradors, secretaris i altres càrrecs | | **AML d'empresa** | Cribratge de l'entitat empresarial contra sancions i llistes de vigilància | | **AML de persones** | Cribratge individual de tots els titulars reals i càrrecs identificats | | **Vinculació KYC** | Vincula cada persona identificada amb una sessió de Verificació d'usuaris (KYC) per a la verificació d'identitat | | **Recollida de documents** | Sol·licituds de documents estructurades amb seguiment de les càrregues | | **Verificació creuada amb OCR** | Extreu dades dels documents pujats i les encreua amb les dades del registre | | **Perfils d'empresa** | Creació automàtica de perfils i agregació de sessions per a cada empresa verificada | | **Estats per funcionalitat** | Seguiment independent de l'estat del registre, l'AML, els documents i les persones clau | | **Avaluació de risc** | Etiquetes d'advertència a cada comprovació i accions de flux de treball que converteixen l'estat de l'empresa, els resultats AML i les conclusions sobre la titularitat en un resultat | | **Webhooks** | Rep en temps real els esdeveniments del cicle de vida de la sessió i d'actualització de dades [mitjançant webhooks](https://docs.didit.me/ca/integration/webhooks.md) | ## Sessions d'empresa vs. sessions d'usuari | Funcionalitat | Sessió d'usuari | Sessió d'empresa | | - | - | - | | **Objectiu** | Persona física | Empresa o entitat jurídica | | **Tipus de sessió** | `user` (per defecte) | `business` | | **Comprovacions principals** | ID, prova de vida, coincidència facial, AML | Consulta al registre, titular real, càrrecs, AML d'empresa | | **Comprovacions addicionals** | Telèfon, correu electrònic, comprovant de domicili, NFC | Recollida de documents, AML de persones, vinculació KYC | | **Payloads de webhook** | Esdeveniments de sessió estàndard | Inclouen `session_kind: "business"` i `business_session_id` | ## Següents passos > [card] [Perfils d'empresa](https://docs.didit.me/ca/business-verification/business-profiles.md) > > Fes el seguiment d'empreses entre sessions amb perfils, etiquetes i operacions en lot. > [card] [Dades de l'empresa](https://docs.didit.me/ca/business-verification/company-data.md) > > Consultes al registre, estat de l'empresa i encreuament de dades. > [card] [Estructura de titularitat](https://docs.didit.me/ca/business-verification/ownership.md) > > Identificació de titulars reals, accionistes corporatius i cadenes de titularitat. > [card] [Càrrecs i administradors](https://docs.didit.me/ca/business-verification/officers.md) > > Identificació d'administradors, rols i vinculació KYC. > [card] [Cribratge AML](https://docs.didit.me/ca/business-verification/aml.md) > > Comprovacions AML a nivell d'empresa i de persona. > [card] [Documents](https://docs.didit.me/ca/business-verification/documents.md) > > Recollida de documents, sol·licituds i verificació OCR. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.