Avisos de verificació d'empreses i codis d'error KYB

La Verificació d’empreses (KYB) mostra les advertències a la funcionalitat que les ha generat. Cada advertència té l’estructura estàndard que s’usa a tota la plataforma, amb feature, risk, log_type, short_description, long_description, additional_data (opcional) i node_id, perquè puguis encaminar el treball de revisió a l’equip operatiu adequat.

Visió general

Les sessions KYB emeten advertències sota tres etiquetes de funcionalitat principals, que corresponen a matrius de funcionalitat dedicades a la resposta de decisió V3:

Etiqueta de funcionalitat	Clau de la resposta de decisió	Què cobreix
`KYB_REGISTRY`	`registry_checks[].warnings[]`	Consultes al registre mercantil oficial. Estat d’activitat, restriccions de país, titularitat derivable, registres d’administradors o UBO que falten.
`KYB_DOCUMENTS`	`document_verifications[].warnings[]`	Documents de constitució, de titularitat, d’adreça i d’accionistes que puja l’usuari. Consistència entre documents, OCR, metadades, manipulació, antiguitat i regles de subtipus.
`KYB_KEY_PEOPLE`	`key_people_checks[].warnings[]`	Senyals a nivell de persona sobre administradors, directius, UBO o parts enviades per l’usuari, incloses les troballes de PEP i de sancions que es propaguen des d’AML i la reutilització de rebutjos previs.

El mateix flux de treball KYB també pot incloure les funcionalitats compartides següents, que emeten advertències a les seves pròpies matrius:

Etiqueta de funcionalitat	Clau de la resposta de decisió
`AML`	`aml_screenings[].warnings[]`
`PHONE`	`phone_verifications[].warnings[]`
`EMAIL`	`email_verifications[].warnings[]`
`QUESTIONNAIRE`	`questionnaire_responses` (les advertències es troben al registre de la sessió)
`LOCATION`	`ip_analyses[].warnings[]`

Advertències del registre KYB

Les advertències del registre usen feature: "KYB_REGISTRY" i apareixen a registry_checks[].warnings[].

Etiqueta	Descripció
`KYB_COUNTRY_RESTRICTED`	El país de l’empresa es troba fora dels països permesos configurats per al flux de treball.
`KYB_OFFICERS_DATA_NOT_FOUND`	Les dades dels administradors no estan disponibles al registre.
`KYB_OWNERSHIP_DATA_NOT_FOUND`	Les dades de titularitat no estan disponibles al registre.
`KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE`	No s’ha pogut establir la titularitat real última a partir de les dades del registre.
`KYB_COMPANY_NOT_ACTIVE`	Segons el registre, l’empresa no està activa.
`KYB_COMPANY_NOT_FROM_REGISTRY`	L’empresa s’ha introduït manualment i no s’ha pogut verificar amb un registre mercantil.
`KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED`	El número de registre de l’empresa obtingut del registre no coincideix amb `expected_details.registration_number` que vas enviar en crear la sessió.
`KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED`	El número de registre obtingut del registre només coincideix parcialment amb l’esperat, per exemple per un sufix de branca o de filial.
`KYB_COMPANY_VAT_INVALID`	El registre fiscal oficial no té cap alta activa per al número d’IVA o identificador fiscal de l’empresa, o el número d’IVA no compleix les regles de format i de dígit de control del seu país. S’aplica l’acció `kyb_vat_invalid_action` configurada (per defecte: En revisió).
`KYB_COMPANY_VAT_COULD_NOT_VALIDATE`	No s’ha pogut validar el número d’IVA o l’identificador fiscal perquè el registre oficial no estava disponible temporalment. S’aplica l’acció `kyb_vat_unverified_action` configurada (per defecte: cap efecte).
`KYB_COMPANY_VAT_NAME_MISMATCH`	El nom registrat al registre oficial per a aquest número és diferent del nom d’empresa enviat. Informativa: inclou `registry_name`, `registry_source` i `submitted_name` a `additional_data`, i també `vies_name` quan el registre és VIES.

Les advertències d’IVA s’apliquen allà on es pugui validar el número d’IVA o l’identificador fiscal de l’empresa. Consulta Validació de l’IVA i de l’identificador fiscal per conèixer els països i les fonts.

Advertències de documents KYB

Les advertències de document usen feature: "KYB_DOCUMENTS" i apareixen a document_verifications[].warnings[].

Etiqueta	Descripció
`KYB_DOCUMENT_MISSING_REQUIRED_FIELD`	No s’ha trobat al document un camp obligatori de l’empresa, com ara el nom de l’empresa o el número de registre.
`KYB_DOCUMENT_NAME_MISMATCH`	El nom de l’empresa del document no coincideix amb el del registre mercantil.
`KYB_DOCUMENT_REG_NUMBER_MISMATCH`	El número de registre del document no coincideix amb el del registre mercantil.
`KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH`	La data de constitució del document no coincideix amb la del registre mercantil.
`KYB_DOCUMENT_ADDRESS_MISMATCH`	L’adreça registrada del document no coincideix amb la del registre mercantil.
`KYB_CROSS_DOCUMENT_MISMATCH`	Les dades de l’empresa difereixen entre els documents corporatius pujats.
`KYB_DOCUMENT_METADATA_MISMATCH`	La signatura, les metadades o l’estructura del fitxer del document indiquen un possible problema.
`KYB_ASSOCIATED_PARTY_MISMATCH`	Els administradors o accionistes del document no coincideixen amb els del registre mercantil.
`KYB_DOCUMENT_GRAPHIC_EDITOR`	Sembla que el document s’ha processat amb programari d’edició gràfica.
`KYB_DOCUMENT_SUSPECTED_MANIPULATION`	El sistema ha detectat indicis de possible manipulació del document corporatiu.
`KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT`	Un camp de text del document corporatiu s’ha deixat en blanc i s’ha tornat a escriure amb una altra tipografia, i el fitxer no conté cap prova que indiqui si el contingut ha canviat. També s’activa quan un fitxer no s’ha pogut comprovar del tot, amb `additional_data.detection_method` establert a `analysis_incomplete`, perquè la part no comprovada podria contenir aquest camp. Es regeix per `kyb_document_unproven_text_replacement_action` (per defecte Review; un flux de treball que mai no revisa utilitza el seu propi `kyb_document_tampering_action` quan aquest és Decline, altrament No action).
`KYB_ADDITIONAL_DATA_NOT_FOUND`	No s’ha pogut verificar un camp del document perquè les dades corresponents del registre mercantil no estan disponibles.
`KYB_DOCUMENT_EXPIRED`	El document corporatiu supera l’antiguitat màxima configurada.
`KYB_DOCUMENT_UNSUPPORTED_SUBTYPE`	El subtipus de document pujat està desactivat per al flux de treball.
`KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED`	S’ha superat el nombre màxim d’intents de pujada de documents corporatius.

Per a la manipulació de text superposat en PDF, KYB_DOCUMENT_SUSPECTED_MANIPULATION pot incloure additional_data.manipulated_regions. Un camp de text deixat en blanc i tornat a escriure amb una altra tipografia activa KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT amb la mateixa estructura de manipulated_regions, mai KYB_DOCUMENT_SUSPECTED_MANIPULATION per si sol: els editors en línia tornen a escriure també el text que no han tocat, de manera que aquesta advertència no indica que el contingut hagi canviat. Si un altre senyal activa KYB_DOCUMENT_SUSPECTED_MANIPULATION en el mateix document, decideix l’acció més estricta de les dues. Són rectangles definits per coordenades de pàgina que identifiquen les zones editades sospitoses i coincideixen amb els rectangles retornats a document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions.

Advertències de persones clau KYB

Les advertències de persones clau utilitzen feature: "KYB_KEY_PEOPLE" i apareixen a key_people_checks[].warnings[]. Mostren problemes relatius a administradors, càrrecs directius, UBO i parts proporcionades per l’usuari.

Etiqueta	Descripció
`KYB_PREVIOUSLY_DECLINED_INDIVIDUAL`	Una persona associada a l’empresa havia estat rebutjada prèviament en una altra verificació d’empresa per a la mateixa sol·licitud.
`KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS`	Els administradors o accionistes declarats a la pantalla de persones clau no coincideixen amb les persones esmentades als documents corporatius pujats: una persona esmentada als documents mai no s’ha declarat, un nom coincideix gairebé, un accionista documentat s’ha declarat sense cap rol de titularitat, o un percentatge de titularitat declarat contradiu els documents. S’aplica el `kyb_key_people_document_mismatch_action` configurat (per defecte: En revisió).

Els resultats de PEP o sancions sobre persones clau es notifiquen com a resultats AML estàndard a l’element corresponent de aml_screenings[], i no com a advertència de persones clau KYB. La comprovació de persones clau propaga l’estat resultant Declined o In Review a cada part afectada perquè el veredicte global de persones clau reflecteixi el resultat AML.

Advertències de funcionalitats compartides

Les funcionalitats següents es poden executar dins d’un flux de treball KYB. Fan servir el mateix catàleg d’advertències que Verificació d’usuaris. Consulta la referència completa a la pàgina d’advertències de cada funcionalitat.

AML

feature: "AML" a aml_screenings[].warnings[].

Tag	Descripció
`POSSIBLE_MATCH_FOUND`	El cribratge AML ha trobat una possible coincidència que requereix revisió.
`COULD_NOT_PERFORM_AML_SCREENING`	Didit no ha pogut fer el cribratge AML perquè faltaven dades necessàries per al cribratge o no estaven disponibles.

Telèfon

feature: "PHONE" a phone_verifications[].warnings[].

Tag	Descripció
`DISPOSABLE_NUMBER_DETECTED`	El número de telèfon és d’un sol ús.
`VERIFICATION_CODE_ATTEMPTS_EXCEEDED`	S’ha superat el nombre màxim d’intents del codi de verificació.
`VOIP_NUMBER_DETECTED`	El número de telèfon és un número VoIP.
`DUPLICATED_PHONE_NUMBER`	El número de telèfon s’ha fet servir en un altre procés de verificació.
`HIGH_RISK_PHONE_NUMBER`	El número de telèfon és d’alt risc.
`PHONE_NUMBER_IN_BLOCKLIST`	El número de telèfon coincideix amb una entrada de la teva llista de bloqueig.

Correu electrònic

feature: "EMAIL" a email_verifications[].warnings[].

Tag	Descripció
`BREACHED_EMAIL_DETECTED`	L’adreça de correu electrònic apareix en filtracions de dades conegudes.
`DISPOSABLE_EMAIL_DETECTED`	L’adreça de correu electrònic és d’un sol ús.
`UNDELIVERABLE_EMAIL_DETECTED`	L’adreça de correu electrònic no es pot lliurar.
`DUPLICATED_EMAIL`	L’adreça de correu electrònic s’ha fet servir en un altre procés de verificació.
`EMAIL_IN_BLOCKLIST`	L’adreça de correu electrònic coincideix amb una entrada de la teva llista de bloqueig.
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	S’ha superat el nombre màxim d’intents del codi de verificació del correu electrònic.

Qüestionari

feature: "QUESTIONNAIRE".

Tag	Descripció
`CUSTOM_STATUS_RULE_TRIGGERED`	Una regla d’estat del flux ha avaluat una resposta del qüestionari i ha canviat l’estat de la funcionalitat.

Anàlisi de dispositiu i IP

feature: "LOCATION" a ip_analyses[].warnings[].

Tag	Descripció
`COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP`	El país del document no coincideix amb el país de la IP.
`PRIVATE_NETWORK_DETECTED`	S’ha detectat un senyal de xarxa privada, VPN, proxy o Tor.
`EXPECTED_IP_ADDRESS_MISMATCH`	L’adreça IP no coincideix amb l’adreça IP esperada que s’ha indicat per a la sessió.
`IP_ADDRESS_IN_BLOCKLIST`	L’adreça IP coincideix amb una entrada de la teva llista de bloqueig.
`DEVICE_FINGERPRINT_IN_BLOCKLIST`	L’empremta digital del dispositiu coincideix amb una entrada de la teva llista de bloqueig.
`DUPLICATED_IP_ADDRESS`	La mateixa adreça IP s’ha fet servir en una altra verificació amb un `vendor_data` diferent.
`DUPLICATED_DEVICE_FINGERPRINT`	La mateixa empremta digital del dispositiu s’ha fet servir en una altra verificació amb un `vendor_data` diferent.

Exemples

Registre: empresa no activa

{
  "registry_checks": [
    {
      "node_id": "feature_kyb_registry",
      "status": "Declined",
      "warnings": [
        {
          "feature": "KYB_REGISTRY",
          "risk": "KYB_COMPANY_NOT_ACTIVE",
          "log_type": "error",
          "short_description": "Company is not active",
          "long_description": "The company is not active according to the registry.",
          "additional_data": null,
          "node_id": "feature_kyb_registry"
        }
      ]
    }
  ]
}

Documents: suposada manipulació per superposició

{
  "document_verifications": [
    {
      "node_id": "feature_kyb_documents",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_DOCUMENTS",
          "risk": "KYB_DOCUMENT_SUSPECTED_MANIPULATION",
          "log_type": "warning",
          "short_description": "Possible document manipulation",
          "long_description": "The system detected signs of possible corporate-document manipulation.",
          "additional_data": {
            "manipulated_regions": [
              { "page": 1, "x": 120, "y": 240, "width": 180, "height": 22, "page_width": 612, "page_height": 792 }
            ]
          },
          "node_id": "feature_kyb_documents"
        }
      ]
    }
  ]
}

Persones clau: persona prèviament rebutjada

{
  "key_people_checks": [
    {
      "node_id": "feature_kyb_key_people",
      "status": "In Review",
      "warnings": [
        {
          "feature": "KYB_KEY_PEOPLE",
          "risk": "KYB_PREVIOUSLY_DECLINED_INDIVIDUAL",
          "log_type": "warning",
          "short_description": "Previously declined individual",
          "long_description": "A person associated with the company was previously declined in another business verification for the same application.",
          "additional_data": null,
          "node_id": "feature_kyb_key_people"
        }
      ]
    }
  ]
}

Relacionat

Esquema de resposta

Consulta on apareixen les advertències a cada matriu de funcionalitats KYB.

Estats

Entén com la gravetat de les advertències es correspon amb l’estat de la verificació.

Documents

Revisa els grups de documents, l’OCR i el comportament de la verificació creuada.

Persones clau

Flux de verificació de càrrecs, UBO i persones presentades.

Informe AML

Estructura a nivell de coincidència per als cribratges AML d’empreses i persones.

Models de dades de referència

Estructures canòniques per a advertències i matrius de funcionalitats.

Primers passos

Funcionalitats

Perfils d'empresa

Referència

Consola

Avisos de verificació d'empreses i codis d'error KYB

Visió general

Advertències del registre KYB

Advertències de documents KYB

Advertències de persones clau KYB

Advertències de funcionalitats compartides

AML

Telèfon

Correu electrònic

Qüestionari

Anàlisi de dispositiu i IP

Exemples

Registre: empresa no activa

Documents: suposada manipulació per superposició

Persones clau: persona prèviament rebutjada

Relacionat

Esquema de resposta

Estats

Documents

Persones clau

Informe AML

Models de dades de referència

​Visió general

​Advertències del registre KYB

​Advertències de documents KYB

​Advertències de persones clau KYB

​Advertències de funcionalitats compartides

​AML

​Telèfon

​Correu electrònic

​Qüestionari

​Anàlisi de dispositiu i IP

​Exemples

​Registre: empresa no activa

​Documents: suposada manipulació per superposició

​Persones clau: persona prèviament rebutjada

​Relacionat

Esquema de resposta

Estats

Documents

Persones clau

Informe AML

Models de dades de referència

Visió general

Advertències del registre KYB

Advertències de documents KYB

Advertències de persones clau KYB

Advertències de funcionalitats compartides

AML

Telèfon

Correu electrònic

Qüestionari

Anàlisi de dispositiu i IP

Exemples

Registre: empresa no activa

Documents: suposada manipulació per superposició

Persones clau: persona prèviament rebutjada

Relacionat