> ## 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.

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

> Codis d'avís de Didit per a la verificació d'empreses: registre KYB, documents, persones clau, AML, telèfon, correu, qüestionaris i dispositiu i IP.

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](https://docs.didit.me/ca/business-verification/company-data.md#validació-de-l’iva-i-del-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ó). |

> [!NOTE]
>
> **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

```json theme={null}
{
  "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ó

```json theme={null}
{
  "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

```json theme={null}
{
  "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

> [card] [Esquema de resposta](https://docs.didit.me/ca/business-verification/response-schema.md)
>
> Consulta on apareixen les advertències a cada matriu de funcionalitats KYB.

> [card] [Estats](https://docs.didit.me/ca/business-verification/statuses.md)
>
> Entén com la gravetat de les advertències es correspon amb l'estat de la verificació.

> [card] [Documents](https://docs.didit.me/ca/business-verification/documents.md)
>
> Revisa els grups de documents, l'OCR i el comportament de la verificació creuada.

> [card] [Persones clau](https://docs.didit.me/ca/business-verification/key-people.md)
>
> Flux de verificació de càrrecs, UBO i persones presentades.

> [card] [Informe AML](https://docs.didit.me/ca/core-technology/aml-screening/report-aml-screening.md)
>
> Estructura a nivell de coincidència per als cribratges AML d'empreses i persones.

> [card] [Models de dades de referència](https://docs.didit.me/ca/reference/data-models.md)
>
> Estructures canòniques per a advertències i matrius de funcionalitats.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.