API de registre mercantil: extracció automatitzada de KYB

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ó. 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:

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.

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.

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.

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.

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

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. Consulta preus de la comprovació al registre KYB 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.

Exemple: resposta del nivell Lite

Lite només retorna el perfil de l’empresa: sense accionistes, UBO ni estructura de titularitat:

{
  "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 i Càrrecs i administradors.

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 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, 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 per veure’n l’estructura.

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
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:

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.

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 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 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 per veure el desglossament per nivell de cada regió.

Passos següents

Titularitat

Identificació de la UBO i cadenes de titularitat.

Esquema de resposta

On apareix cada camp en el payload.

Països compatibles

Cobertura per regió.

Primers passos

Funcionalitats

Perfils d'empresa

Referència

Consola

API de registre mercantil: extracció automatitzada de KYB

Cerca al registre mercantil

Omplir prèviament la cerca amb `expected_details`

Tipus de cerca

Flux de la cerca

Dades retornades

Estats de l’empresa

Indicador de font de dades

Nivells de dades i preus

Dades del registre i dades proporcionades per l’usuari

Configurable registry form fields

Validació de l’IVA i del identificador fiscal

Creuament de dades

Resum financer

Camps addicionals del registre

Confiança i estat de verificació

Sortides del creuament de dades

Què determina el resultat

Països compatibles

Passos següents

Titularitat

Esquema de resposta

Països compatibles

​Cerca al registre mercantil

​Omplir prèviament la cerca amb expected_details

​Tipus de cerca

​Flux de la cerca

​Dades retornades

​Estats de l’empresa

​Indicador de font de dades

​Nivells de dades i preus

​Dades del registre i dades proporcionades per l’usuari

​Configurable registry form fields

​Validació de l’IVA i del identificador fiscal

​Creuament de dades

​Resum financer

​Camps addicionals del registre

​Confiança i estat de verificació

​Sortides del creuament de dades

​Què determina el resultat

​Països compatibles

​Passos següents

Titularitat

Esquema de resposta

Països compatibles

Cerca al registre mercantil

Omplir prèviament la cerca amb `expected_details`

Tipus de cerca

Flux de la cerca

Dades retornades

Estats de l’empresa

Indicador de font de dades

Nivells de dades i preus

Dades del registre i dades proporcionades per l’usuari

Configurable registry form fields

Validació de l’IVA i del identificador fiscal

Creuament de dades

Resum financer

Camps addicionals del registre

Confiança i estat de verificació

Sortides del creuament de dades

Què determina el resultat

Països compatibles

Passos següents