> ## 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 registre mercantil: extracció automatitzada de KYB > Consulta registres mercantils i valida l'estat de les empreses a més de 220 països amb Didit. Des de $2.00 per consulta, sense contractes. Quan s'inicia una sessió de verificació d'empreses, Didit consulta els registres mercantils oficials per obtenir i validar la informació de l'empresa. Aquesta consulta automatitzada proporciona la base de tot el procés de verificació d'empreses. ## Cerca al registre mercantil Didit es connecta als registres mercantils dels països compatibles per obtenir dades oficials. Al flux allotjat, l'usuari selecciona el país de constitució i introdueix el nom de l'empresa, el número de registre o tots dos. Cal almenys un dels dos. Els números de registre es normalitzen quan el registre ho requereix (per exemple, els números d'empresa del Regne Unit s'omplen amb zeros fins a vuit dígits). Quan es proporcionen tots dos identificadors, la cerca al registre mercantil els combina. ### Omplir prèviament la cerca amb `expected_details` Si ja coneixes l'empresa, passa `expected_details` (`company_name`, `registry_country`, `registration_number`) en [crear la sessió](https://docs.didit.me/ca/sessions-api/create-session.md). El flux allotjat preselecciona i bloqueja el país (i l'estat, en els registres per estat com `US-CA`), omple els camps de cerca corresponents i executa automàticament la cerca indicada. Així, l'usuari arriba directament al resultat de la seva empresa. Tots dos camps continuen sent editables perquè l'usuari pugui corregir una indicació errònia. Només es tracta d'un precompletat: seleccionar una empresa diferent de la indicada no genera cap advertència. ### Tipus de cerca Les cerques al registre mercantil admeten dos modes: | Mode | Descripció | | - | - | | **Exacte** | Coincideix amb precisió amb el nom de l'empresa o el número de registre | | **Conté** | Coincideix amb les empreses el nom de les quals conté el terme de cerca; és útil quan no es coneix el nom legal exacte | ### Flux de la cerca La cerca al registre mercantil segueix un flux asíncron: **1. Cerca** Didit consulta el registre mercantil amb el país seleccionat i els identificadors proporcionats: nom de l'empresa, número de registre o tots dos combinats. El camp `searched_by` de la resposta indica amb quins criteris s'han trobat els resultats (`name`, `registration_number` o `registration_number_and_name`). La interfície allotjada ofereix una opció d'un sol toc per substituir la cerca i cercar pel nom de l'empresa per als resultats obtinguts amb número de registre. La cerca s'executa de manera asíncrona. **2. Consulta els resultats** Consulta l'estat de la cerca fins que els resultats estiguin resolts. Els registres amb moltes dades poden trigar uns segons a retornar resultats. **3. Selecciona l'empresa** Revisa les empreses retornades i selecciona la coincidència correcta. Didit vincula l'empresa seleccionada a la verificació KYB i omple totes les dades disponibles. **4. Confirma i continua** Confirma o corregeix les dades de l'empresa i continua amb el següent pas configurat. Alguns registres retornen el perfil de l'empresa abans que l'informe de titularitat estigui llest. Aquest informe continua en segon pla mentre el sol·licitant completa passos independents, com la pujada de documents. El precompletat del registre mercantil no bloqueja el formulari de persones clau: el sol·licitant pot introduir persones manualment, i les persones disponibles al registre mercantil apareixen abans de l'enviament a mesura que arriba l'informe. Les decisions personalitzades que depenen de l'informe continuen esperant-lo en lloc d'endevinar-ne el resultat. Les teves correccions es conserven quan arriba l'informe. Un informe pendent no compta com una comprovació del registre mercantil completada ni com una aprovació automàtica, i la facturació del registre mercantil utilitza el nivell realment lliurat. **5. Enviament manual** Si l'empresa no es troba al registre mercantil, envia les dades de l'empresa manualment. La sessió continua amb les dades proporcionades i `is_from_registry` es defineix com a `false`. ### Dades retornades | Camp | Descripció | | - | - | | `company_name` | Nom legal tal com està inscrit davant de l'autoritat | | `registration_number` | Número oficial de registre o de constitució de l'empresa | | `country_code` | País de constitució (ISO 3166-1 alpha-3) | | `company_type` | Tipus d'entitat jurídica (Ltd, LLC, PLC, SA, GmbH, SL, etc.) | | `registry_status` | Estat actual de l'empresa al registre mercantil (`active`, `dissolved`, `struck_off`, etc.) | | `incorporation_date` | Data en què l'empresa es va inscriure originalment | | `registered_address` | Adreça oficial del domicili social | | `tax_number` | Número d'identificació fiscal quan està disponible | | `alternative_names` | Noms comercials, dbas, noms legals anteriors o noms en la llengua original, com a valor de text | | `legal_entity_identifier` | LEI: per a institucions financeres i entitats cotitzades | | `nature_of_business` | Descripció breu de l'activitat (en la llengua del registre mercantil) | | `registered_capital` | Capital autoritzat o emès, com a objecte `{amount, currency}` | | `location_of_registration` | Ciutat o subdivisió del registre mercantil de referència | | `control_scheme` | Esquema de control o de govern quan el registre mercantil el mostra | | `website`, `email`, `phone` | Dades de contacte que consten al registre mercantil | | `addresses[]` | Adreces addicionals registrades o comercials | | `industries[]` | Codis de classificació d'activitat (SIC, NACE o equivalents locals) | | `accounts` | Dates de presentació quan s'informen, incloent-hi `last_annual_return_date` i `last_agm_date`. Les declaracions anuals i les juntes són diferents dels comptes financers. | | `financial_summary` | Resum de dades financeres quan el registre mercantil les publica (ingressos, empleats, estat de presentació) | | `confirmed_by_user_at` | Marca de temps en què l'usuari final va confirmar o editar les dades del registre mercantil | | `last_console_edit_at` | Marca de temps de l'última edició feta a la consola per un analista | | `is_editable` | `true` mentre l'usuari final pot encara editar les dades procedents del registre mercantil al flux allotjat | | `is_from_registry` | `true` per a empreses procedents del registre mercantil, `false` per a introducció manual | | `fetch_status` | `pending`, `resolved` o `failed`: estat de la cerca al registre mercantil | | `verification_status` | `verified`, `failed` o `unknown` | ### Estats de l'empresa | Estat | Descripció | | - | - | | **Activa** | L'empresa està actualment activa i en situació regular | | **Dissolta** | L'empresa ha estat dissolta formalment | | **Radiada** | Eliminada del registre mercantil (per exemple, per incompliment) | | **En liquidació** | L'empresa està en procés de liquidació | | **Inactiva** | Inscrita al registre mercantil però sense activitat comercial actualment | > [!WARNING] > > Les empreses amb un estat diferent de **Activa** poden ser marcades automàticament o rebutjades, segons la configuració del flux de treball. ### Indicador de font de dades Cada registre d'empresa inclou un indicador `is_from_registry`: * **`true`**: les dades s'han obtingut d'un registre mercantil oficial * **`false`**: les dades s'han introduït manualment perquè l'empresa no s'ha trobat al registre El camp `fetch_status` indica si la consulta al registre s'ha completat, ha fallat o encara està en curs. ## Nivells de dades i preus En el flux allotjat, seleccionar una empresa comporta el cobrament de la consulta al registre, fins i tot si la persona sol·licitant abandona abans de confirmar les dades o de completar la verificació. Si l'informe està disponible en el moment de la selecció, es cobra immediatament el nivell lliurat. Si la titularitat encara està pendent, el nivell Lite es cobra en la selecció i només es cobra la diferència de preu quan es lliura un nivell superior. Si la titularitat no està disponible, no s'aplica cap recàrrec per titularitat. El total utilitza els preus cotitzats en el moment de la selecció i mai no supera la cotització del nivell sol·licitat. La selecció i qualsevol ajust posterior de titularitat compten com una sola comprovació al registre; consultar l'informe comprat o confirmar-ne les dades no comporta cap cobrament addicional. Els contractes existents amb tarifa plana comptabilitzen una comprovació al registre en la selecció, sense una segona unitat de contracte per al lliurament posterior de la titularitat. Les cerques dins dels fluxos de treball allotjats no tenen cap tarifa de cerca separada. Les cerques d'API independents poden generar una tarifa de \$0.50 per cada sol·licitud satisfactòria; consulta [facturació de cerques](https://docs.didit.me/ca/standalone-apis/kyb-registry-search.md). Consulta [preus de la comprovació al registre KYB](https://docs.didit.me/ca/getting-started/kyb-registry-pricing.md) per a la taula completa per país. | Nivell | Què obtens | | - | - | | **Lite** | Els camps anteriors: perfil de l'empresa, identificadors, estat, adreça registrada, activitat i càrrecs directius | | **Accionistes** | Lite més els accionistes directes (persones físiques i entitats corporatives) amb les seves franges de titularitat | | **UBO** | Accionistes més els titulars reals finals, identificats a través de la cadena de titularitat | Un flux de treball allotjat tria el nivell per país des de *Workflows → KYB Registry Check → Countries*. Quan el registre no conté informació de titularitat per a una empresa, una sol·licitud d'Accionistes o d'UBO es lliura i es factura al nivell més alt que els registres del país poden oferir, normalment Lite. Una empresa que no es troba i s'introdueix manualment (`is_from_registry: false`) es factura amb una tarifa fixa de **\$0.75**: la cerca s'ha executat, encara que no s'hagi retornat cap registre del registre. > [accordion] Exemple: resposta del nivell Lite > > Lite només retorna el perfil de l'empresa: sense accionistes, UBO ni estructura de titularitat: > > ```json theme={null} > { > "company_name": "ACME HOLDINGS PTY LTD", > "registration_number": "094447122", > "country_code": "AU", > "registry_status": "active", > "incorporation_date": "2000-09-12", > "company_type": "Proprietary Limited", > "registered_address": "Sydney, NSW, 2000", > "tax_number": null, > "vat_number": null, > "website": null, > "is_from_registry": true > } > ``` > > El nivell Accionistes afegeix `ownership_structure` i les entrades d'accionistes, a més dels administradors i càrrecs directius. El nivell UBO resol a més els titulars reals amb els percentatges de titularitat. Consulta [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md) i [Càrrecs i administradors](https://docs.didit.me/ca/business-verification/officers.md). ## Dades del registre i dades proporcionades per l'usuari Didit manté les dades retornades pel registre i les dades confirmades per l'usuari com a **registres d'auditoria separats**, amb una vista canònica fusionada que utilitzen les comprovacions posteriors. Cada empresa té tres blocs relacionats: | Camp | Descripció | | - | - | | `registry_data` | La informació normalitzada del registre de Didit: el resultat de la titularitat (`ownership_error`, `section_errors`, `ubo_resolution`), les correccions fetes amb [update-data](https://docs.didit.me/ca/sessions-api/update-data.md) i les dades del registre que no tenen camp propi. Les seves claus varien segons l'empresa i no són un contracte estable. | | `user_provided_data` | Allò que l'usuari final ha confirmat o editat durant el pas de confirmació del registre en el flux allotjat. | | Camps canònics de primer nivell (`company_name`, `registration_number`, `country_code`, `incorporation_date`, etc.) | La fusió final: les dades confirmades per l'usuari quan n'hi ha, i les dades del registre com a alternativa. Les funcionalitats posteriors (contrast OCR de documents, cribratge AML, avaluació de risc) s'executen sobre la vista canònica. | La marca de temps `confirmed_by_user_at` marca el moment en què l'usuari final ha confirmat o editat les dades del registre. Mentre aquesta marca de temps sigui nul·la i `is_editable` sigui `true`, l'usuari final pot continuar modificant els camps dins del flux allotjat. Per a les empreses introduïdes manualment (`is_from_registry: false`), `user_provided_data` és l'única font i `is_editable` passa a `false` després que l'usuari l'hagi enviat. Les persones analistes poden veure les dues fonts una al costat de l'altra a la [Business Console](https://docs.didit.me/ca/business-verification/console.md), a la revisió de la sessió, i comparar el que ha dit el registre amb el que ha confirmat l'usuari. ## Configurable registry form fields Tu controles quins camps de dades de l'empresa demana el flux de verificació allotjat durant el pas de confirmació del registre. Configura'ls a la Business Console: obre l'editor de fluxos de treball, selecciona el node **KYB Registry check** i canvia a la pestanya **Camps**. Cada camp té un dels tres estats: | Estat | Comportament | | - | - | | **Ocult** | El camp no es mostra al flux allotjat i no es recull. | | **Opcional** | El camp es mostra; l'usuari pot deixar-lo buit. | | **Obligatori** | El camp es mostra i s'ha d'omplir abans que l'usuari pugui enviar el formulari. | Tres camps es mostren sempre i són sempre obligatoris, perquè identifiquen l'empresa i no es poden configurar: `company_name`, `country_code` i `region` (estat o regió, quan el registre és regional). Els 16 camps configurables: `registration_number`, `incorporation_date`, `legal_address`, `vat_number`, `alternative_names`, `tax_number`, `company_type`, `legal_entity_identifier`, `location_of_registration`, `nature_of_business`, `registered_capital_amount`, `registered_capital_currency`, `website`, `email`, `phone`, `control_scheme` Per defecte, i per a tots els fluxos de treball existents, només `incorporation_date` és **Obligatori**; la resta de camps configurables tenen l'estat **Opcional**, de manera que el formulari es comporta exactament igual que abans d'existir aquesta configuració. L'obligatorietat es valida al servidor: si envies el formulari del registre amb un camp obligatori buit, es retorna `400` amb missatges d'error per camp, i la interfície allotjada només mostra els camps habilitats. A l'API de fluxos de treball, la configuració és l'objecte `kyb_registry_fields_config` del node KYB Registry; consulta [configuracions de funcionalitats](https://docs.didit.me/ca/management-api/workflows/feature-configs.md#registre-kyb) per veure'n l'estructura. > [!NOTE] > > `vat_number` marcat com a **Obligatori** només s'aplica a empreses constituïdes en un país amb IVA de la UE (vegeu més avall). Per a la resta de països el camp es tracta com a opcional encara que estigui marcat com a obligatori, perquè no hi ha cap número d'IVA de la UE que recollir. El camp `tax_number` es continua validant quan es proporciona. ## Validació de l'IVA i del identificador fiscal Quan s'envia el pas de registre, Didit valida el `vat_number` de l'empresa amb la font oficial del seu país. A una empresa sense `vat_number` se li valida el `tax_number` en lloc seu. El número es pot enviar amb o sense el prefix del país i amb qualsevol separador (`DE 123 456 789`, `DE123456789` i `123456789` són equivalents per a una empresa alemanya). **Registres oficials.** En aquests països el número es comprova en temps real amb el registre governamental o oficial d'empreses, que també retorna el nom registrat (i, en la majoria, l'adreça): | País | Font | | - | - | | Els 27 estats membres de la UE i Irlanda del Nord (`XI`) | Comissió Europea [VIES](https://ec.europa.eu/taxation_customs/vies/) | | Polònia | VIES i, per a una empresa que VIES no inclou, el registre de contribuents d'IVA del Ministeri de Finances (la «Llista Blanca») | | Noruega | Brønnøysund Register Centre (Registre central coordinador d'entitats jurídiques) | | Suïssa | Registre UID de l'Oficina Federal de Estadística | | Brasil | Registre CNPJ de la Receita Federal | | Colòmbia | RUES, el Registre Únic Empresarial i Social de les cambres de comerç | | Costa Rica | Registre de contribuents del Ministeri de Finances (Hacienda) | | Equador | Registre de contribuents del Servei de Rendes Internes (SRI) | | Paraguai | Registre RUC de la Direcció Nacional de Tributació (DNIT) | Un SIREN o SIRET francès, un RSIN neerlandès o un número fiscal húngar complet, enviats com a número d'IVA, es converteixen en el número d'IVA corresponent abans de comprovar-los. Els números d'IVA grecs es comproven automàticament amb el prefix `EL`. **Regles de dígit de control.** En aquests països no es pot consultar cap registre, de manera que el número es comprova amb el format oficial del país i les regles de dígit de control: Albània, Andorra, Argentina, Austràlia, Azerbaidjan, Bielorússia, Canadà, Xile, Xina, República Dominicana, Egipte, El Salvador, Ghana, Guatemala, Islàndia, Índia, Indonèsia, Israel, Japó, Kenya, Liechtenstein, Mèxic, Moldàvia, Mònaco, Montenegro, Marroc, Moçambic, Nova Zelanda, Macedònia del Nord, Perú, Rússia, San Marino, Sèrbia, Singapur, Sud-àfrica, Corea del Sud, Taiwan, Tailàndia, Tunísia, Turquia, Ucraïna, Regne Unit, Estats Units, Uruguai, Veneçuela i Vietnam. Aquestes regles també s'apliquen a la UE quan un `tax_number` és un identificador fiscal nacional que no té número d'IVA per comprovar, com un Steuernummer alemany. Un `tax_number` només indica un identificador fiscal, no un registre d'IVA; per això, quan VIES no el inclou, el resultat recorre a aquestes regles en lloc de `invalid`. Les empreses de qualsevol altre país reben `vat_validation_status: "not_applicable"`. També ho reben les sessions sandbox, que mai no contacten amb cap registre fiscal. El resultat s'emmagatzema a l'empresa i es mostra al [payload de la decisió KYB](https://docs.didit.me/ca/business-verification/response-schema.md#bloc-company): | Camp | Descripció | | - | - | | `vat_number` | El número d'IVA tal com s'ha enviat | | `vat_validation_status` | `valid`, `invalid`, `format_valid`, `invalid_format`, `could_not_validate` o `not_applicable` | | `vat_validated_number` | El número que s'ha comprovat, tal com el coneix la font (per exemple, el número d'IVA derivat d'un SIREN) | | `vat_validation_source` | La font que ha decidit l'estat (vegeu més avall) | | `vat_validated_name` | Nom registrat a la font, quan la font el revela | | `vat_validated_address` | Adreça registrada a la font, quan la font la revela | | `vat_checked_at` | Marca de temps de la comprovació | | Estat | Significat | | - | - | | `valid` | El registre oficial confirma que el número està registrat i actiu | | `invalid` | El registre oficial no té cap registre actiu per al número. A la UE, VIES només inclou les empreses registrades per a comerç intracomunitari | | `format_valid` | El número compleix el format i les regles de dígit de control del país; no s'ha consultat cap registre | | `invalid_format` | El número no compleix el format o les regles de dígit de control del país | | `could_not_validate` | El registre no estava disponible, de manera que el número no s'ha pogut comprovar. Es torna a comprovar la propera vegada que s'executi la comprovació del registre | | `not_applicable` | No s'ha proporcionat cap número d'IVA ni cap identificador fiscal, el país no té registre ni regles, o la sessió és una sessió sandbox | `vat_validation_source` és un dels valors següents: `eu_vies`, `pl_vat_white_list`, `no_brreg`, `ch_uid_register`, `br_receita_federal`, `co_rues`, `cr_hacienda`, `ec_sri`, `py_dnit` o `format_rules`. Quan un número és `valid`, `invalid`, `format_valid` o `invalid_format`, el resultat es conserva durant tota la sessió i el registre no es torna a consultar tret que canviï el número. **Comprovació del nom.** Quan el número és `valid` i la font revela el nom registrat, Didit compara de manera aproximada aquest nom amb el nom de l'empresa enviat. Una discrepància significativa activa l'advertència `KYB_COMPANY_VAT_NAME_MISMATCH` sense canviar l'estat de la sessió: és un senyal orientatiu per als revisors. El seu `additional_data` inclou `registry_name`, `registry_source` i `submitted_name`, així com `vies_name` quan la font és VIES. Alguns estats membres de la UE no revelen el nom ni l'adreça; els camps arriben buits i no es fa cap comparació. **Accions configurables.** Dues configuracions del node de comprovació del registre KYB controlen quin efecte té una comprovació no satisfactòria sobre la sessió (valors `REVIEW`, `DECLINE`, `NO_ACTION`): | Configuració | S'activa quan | Per defecte | | - | - | - | | `kyb_vat_invalid_action` | `vat_validation_status` és `invalid`, o un `vat_number` és `invalid_format` | `REVIEW`: la sessió passa a En revisió | | `kyb_vat_unverified_action` | `vat_validation_status` és `could_not_validate` | `NO_ACTION`: no afecta la sessió | Un `tax_number` que és `invalid_format` s'informa al payload sense activar cap acció, perquè el camp fiscal de text lliure sovint conté un identificador d'empresa diferent. Cada resultat també activa l'advertència corresponent (`KYB_COMPANY_VAT_INVALID`, `KYB_COMPANY_VAT_COULD_NOT_VALIDATE`) a la comprovació del registre; vegeu [Advertències de verificació d'empreses](https://docs.didit.me/ca/business-verification/warnings.md#advertències-del-registre-kyb). ## Creuament de dades Didit compara automàticament les dades proporcionades per l'usuari / les dades canòniques amb les que ha retornat el registre i amb les dades OCR extretes dels documents carregats: * **Nom de l'empresa**: coincidència aproximada per tenir en compte abreviatures i diferències de format * **Número de registre**: validació de coincidència exacta * **País**: comprovació de coherència entre el país proporcionat i el del registre * **Adreça**: geocodificació i normalització per a la comparació Qualsevol incoherència es marca com a advertència a la sessió i és visible per als analistes a la consola. ## Resum financer Quan hi ha dades disponibles, Didit obté del registre un resum de les dades financeres: * Facturació o xifra de negocis * Nombre d'empleats * Codis d'activitat SIC/NACE * Dates de presentació i estat de compliment ## Camps addicionals del registre Segons la cobertura per jurisdicció, la resposta del registre també pot incloure: * `alternative_names`: noms comercials, dbas i antigues raons socials * `legal_entity_identifier` (LEI): per a entitats financeres i entitats cotitzades * `website`, `email`, `phone`: informació de contacte que consta al registre * `nature_of_business`: descripció breu (en l'idioma del registre) * `registered_capital`: capital autoritzat o emès, com a objecte `{amount, currency}` Tots els camps es recullen al bloc [`business`](https://docs.didit.me/ca/business-verification/response-schema) de la decisió KYB. ## Confiança i estat de verificació Cada resposta del registre inclou un `verification_status`: | Valor | Significat | | - | - | | `VERIFIED` | El registre ha retornat una coincidència i s'han obtingut les dades. | | `FAILED` | El registre ha retornat una coincidència però l'obtenció de les dades ha fallat (p. ex., resposta parcial). | | `UNKNOWN` | No s'ha pogut localitzar l'empresa en cap registre. | Combina-ho amb `is_from_registry` per impulsar la teva pròpia lògica posterior: | `is_from_registry` | `verification_status` | Significat | | - | - | - | | true | VERIFIED | Totalment verificada amb el registre oficial | | true | FAILED | Parcial: alguns camps poden estar desactualitzats o absents | | false | UNKNOWN | Només dades proporcionades per l'usuari; sense coincidència al registre | ## Sortides del creuament de dades Cada creuament s'executa per camp i retorna un dels valors següents: * `MATCH`: les dades proporcionades coincideixen amb el registre. * `MISMATCH`: divergència significativa. Es marca com a advertència. * `NO_DATA`: un dels dos costats estava buit; no és possible cap comparació. Les discrepàncies són visibles per camp a la revisió de la sessió a la consola. ## Què determina el resultat L'estat de l'empresa, el país de constitució, els resultats AML i la coincidència amb les dades declarades alimenten la decisió com a etiquetes d'advertència a la comprovació del registre i al cribratge AML. El teu flux de treball decideix si cada advertència aprova, revisa o rebutja. Consulta l'[avaluació de risc](https://docs.didit.me/ca/business-verification/risk-assessment.md) per conèixer els senyals i les claus de flux de treball que els controlen. ## Països compatibles La cobertura varia segons el país. Consulta els [països compatibles](https://docs.didit.me/ca/business-verification/supported-countries.md) per veure el desglossament per nivell de cada regió. ## Passos següents > [card] [Titularitat](https://docs.didit.me/ca/business-verification/ownership.md) > > Identificació de la UBO i cadenes de titularitat. > [card] [Esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md) > > On apareix cada camp en el payload. > [card] [Països compatibles](https://docs.didit.me/ca/business-verification/supported-countries.md) > > Cobertura per regió. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.