Vérification d'entreprise KYB : avertissements et erreurs

Les avertissements de la Vérification d’entreprise (KYB) apparaissent sur l’élément de fonctionnalité qui les a générés. Chacun suit la structure standard utilisée dans toute la plateforme : feature, risk, log_type, short_description, long_description, additional_data (facultatif) et node_id. Vous pouvez ainsi orienter le travail de revue vers l’équipe opérationnelle compétente.

Vue d’ensemble

Les sessions KYB émettent des avertissements sous trois étiquettes de fonctionnalité principales, qui correspondent à des tableaux dédiés aux fonctionnalités dans la réponse de décision V3 :

Étiquette de fonctionnalité	Clé de la réponse de décision	Ce qu’elle couvre
`KYB_REGISTRY`	`registry_checks[].warnings[]`	Recherches dans les registres officiels des sociétés. Statut actif, restrictions par pays, actionnariat déductible, dirigeants ou enregistrements UBO manquants.
`KYB_DOCUMENTS`	`document_verifications[].warnings[]`	Documents de constitution, d’actionnariat, d’adresse et relatifs aux actionnaires que l’utilisateur téléverse. Cohérence entre documents, OCR, métadonnées, manipulation, âge et règles de sous-type.
`KYB_KEY_PEOPLE`	`key_people_checks[].warnings[]`	Signaux au niveau de la personne concernant les dirigeants, les responsables, les UBO ou les parties soumises par l’utilisateur, y compris les résultats PEP et sanctions issus de l’AML et la réutilisation d’un refus antérieur.

Le même workflow KYB peut également inclure les fonctionnalités partagées ci-dessous. Elles émettent leurs propres avertissements dans leurs propres tableaux :

Étiquette de fonctionnalité	Clé de la réponse de décision
`AML`	`aml_screenings[].warnings[]`
`PHONE`	`phone_verifications[].warnings[]`
`EMAIL`	`email_verifications[].warnings[]`
`QUESTIONNAIRE`	`questionnaire_responses` (les avertissements figurent dans le journal de la session)
`LOCATION`	`ip_analyses[].warnings[]`

Avertissements du registre KYB

Les avertissements du registre utilisent feature: "KYB_REGISTRY" et apparaissent dans registry_checks[].warnings[].

Étiquette	Description
`KYB_COUNTRY_RESTRICTED`	Le pays de la société ne fait pas partie des pays autorisés configurés pour le workflow.
`KYB_OFFICERS_DATA_NOT_FOUND`	Les données relatives aux dirigeants ne sont pas disponibles dans le registre.
`KYB_OWNERSHIP_DATA_NOT_FOUND`	Les données d’actionnariat ne sont pas disponibles dans le registre.
`KYB_BENEFICIAL_OWNERSHIP_NOT_DERIVABLE`	Le bénéficiaire effectif ultime n’a pas pu être déterminé à partir des données du registre.
`KYB_COMPANY_NOT_ACTIVE`	La société n’est pas active selon le registre.
`KYB_COMPANY_NOT_FROM_REGISTRY`	La société a été saisie manuellement et n’a pas pu être vérifiée auprès d’un registre des sociétés.
`KYB_REGISTRY_DATA_MISMATCH_WITH_EXPECTED`	Le numéro d’immatriculation de la société obtenu auprès du registre ne correspond pas à `expected_details.registration_number` que vous avez envoyé lors de la création de la session.
`KYB_REGISTRY_DATA_PARTIAL_MATCH_WITH_EXPECTED`	Le numéro d’immatriculation obtenu auprès du registre ne recoupe que partiellement celui attendu, par exemple en raison d’un suffixe de succursale ou de filiale.
`KYB_COMPANY_VAT_INVALID`	Le registre fiscal officiel ne comporte aucune immatriculation active pour le numéro de TVA ou l’identifiant fiscal de la société, ou le numéro de TVA ne respecte pas les règles de format et de clé de contrôle de son pays. L’action configurée `kyb_vat_invalid_action` est appliquée (par défaut : En cours d’examen).
`KYB_COMPANY_VAT_COULD_NOT_VALIDATE`	Le numéro de TVA ou l’identifiant fiscal n’a pas pu être validé, car le registre fiscal officiel était temporairement indisponible. L’action configurée `kyb_vat_unverified_action` est appliquée (par défaut : aucun effet).
`KYB_COMPANY_VAT_NAME_MISMATCH`	Le nom enregistré auprès du registre officiel pour ce numéro diffère du nom de société soumis. À titre informatif : inclut `registry_name`, `registry_source` et `submitted_name` dans `additional_data`, ainsi que `vies_name` lorsque le registre est VIES.

Les avertissements liés à la TVA s’appliquent partout où le numéro de TVA ou l’identifiant fiscal de la société peut être validé. Consultez Validation de la TVA et de l’identifiant fiscal pour connaître les pays et les sources.

Avertissements des documents KYB

Les avertissements liés aux documents utilisent feature: "KYB_DOCUMENTS" et apparaissent dans document_verifications[].warnings[].

Tag	Description
`KYB_DOCUMENT_MISSING_REQUIRED_FIELD`	Un champ obligatoire de l’entreprise, comme le nom de l’entreprise ou le numéro d’immatriculation, n’a pas été trouvé dans le document.
`KYB_DOCUMENT_NAME_MISMATCH`	Le nom de l’entreprise figurant dans le document ne correspond pas à celui du registre.
`KYB_DOCUMENT_REG_NUMBER_MISMATCH`	Le numéro d’immatriculation figurant dans le document ne correspond pas à celui du registre.
`KYB_DOCUMENT_INCORPORATION_DATE_MISMATCH`	La date de constitution figurant dans le document ne correspond pas à celle du registre.
`KYB_DOCUMENT_ADDRESS_MISMATCH`	L’adresse du siège social figurant dans le document ne correspond pas à celle du registre.
`KYB_CROSS_DOCUMENT_MISMATCH`	Les données de l’entreprise diffèrent selon les documents d’entreprise transmis.
`KYB_DOCUMENT_METADATA_MISMATCH`	La signature du document, ses métadonnées ou sa structure de fichier indiquent un problème possible.
`KYB_ASSOCIATED_PARTY_MISMATCH`	Les dirigeants ou actionnaires figurant dans le document ne correspondent pas à ceux du registre.
`KYB_DOCUMENT_GRAPHIC_EDITOR`	Le document semble avoir été traité par un logiciel de retouche graphique.
`KYB_DOCUMENT_SUSPECTED_MANIPULATION`	Le système a détecté des signes d’une possible manipulation du document d’entreprise.
`KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT`	Un champ de texte du document d’entreprise a été effacé puis retapé dans une autre police, et le fichier ne permet pas de savoir si son contenu a changé. Un fichier qui n’a pas pu être vérifié en totalité déclenche aussi cet avertissement, avec `additional_data.detection_method` défini sur `analysis_incomplete`, car la partie non vérifiée pourrait contenir un tel champ. Régi par `kyb_document_unproven_text_replacement_action` (par défaut Review ; un workflow qui ne prévoit jamais d’examen utilise sa propre valeur `kyb_document_tampering_action` lorsque celle-ci vaut Decline, sinon No action).
`KYB_ADDITIONAL_DATA_NOT_FOUND`	Un champ du document n’a pas pu être vérifié, car les données correspondantes du registre sont indisponibles.
`KYB_DOCUMENT_EXPIRED`	Le document d’entreprise dépasse l’âge maximal configuré.
`KYB_DOCUMENT_UNSUPPORTED_SUBTYPE`	Le sous-type de document transmis est désactivé pour le workflow.
`KYB_DOCUMENT_MAX_ATTEMPTS_EXCEEDED`	Le nombre maximal de tentatives de transmission de documents d’entreprise a été dépassé.

Pour la manipulation de texte superposé dans un PDF, KYB_DOCUMENT_SUSPECTED_MANIPULATION peut inclure additional_data.manipulated_regions. Un champ de texte effacé puis retapé dans une autre police déclenche KYB_DOCUMENT_UNPROVEN_TEXT_REPLACEMENT avec la même structure de manipulated_regions, et jamais KYB_DOCUMENT_SUSPECTED_MANIPULATION seul : les éditeurs en ligne retapent aussi du texte non modifié, si bien que cet avertissement n’indique pas que le contenu a changé. Si un autre signal déclenche KYB_DOCUMENT_SUSPECTED_MANIPULATION sur le même document, la plus stricte des deux actions s’applique. Il s’agit de rectangles en coordonnées de page qui identifient les zones suspectées d’avoir été modifiées et qui correspondent aux rectangles renvoyés dans document_verifications[].items[].document_metadata.overlay_manipulation.manipulated_regions.

Avertissements KYB sur les personnes clés

Les avertissements sur les personnes clés utilisent feature: "KYB_KEY_PEOPLE" et apparaissent dans key_people_checks[].warnings[]. Ils signalent les problèmes au niveau des personnes concernant les dirigeants, les responsables, les UBO et les parties soumises par l’utilisateur.

Tag	Description
`KYB_PREVIOUSLY_DECLINED_INDIVIDUAL`	Une personne associée à l’entreprise a déjà été refusée dans une autre vérification d’entreprise pour la même application.
`KYB_KEY_PEOPLE_MISMATCH_WITH_DOCUMENTS`	Les dirigeants ou actionnaires déclarés sur l’écran des personnes clés ne correspondent pas aux personnes nommées dans les documents d’entreprise téléversés : une personne nommée dans les documents n’a jamais été déclarée, un nom correspond presque, un actionnaire figurant dans les documents a été déclaré sans rôle dans l’actionnariat, ou un pourcentage de détention déclaré contredit les documents. L’action configurée `kyb_key_people_document_mismatch_action` est appliquée (par défaut : en cours d’examen).

Les correspondances PEP et sanctions concernant les personnes clés sont signalées comme des correspondances AML standard sur l’élément correspondant de aml_screenings[], et non comme un avertissement KYB sur les personnes clés. La vérification des personnes clés reporte sur chaque partie concernée le statut qui en résulte, Declined ou In Review, afin que le verdict global sur les personnes clés reflète le résultat AML.

Avertissements des fonctionnalités partagées

Les fonctionnalités ci-dessous peuvent s’exécuter dans un workflow KYB. Elles utilisent le même catalogue d’avertissements que la Vérification des utilisateurs ; la référence complète se trouve sur la page d’avertissements de chaque fonctionnalité.

AML

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

Tag	Description
`POSSIBLE_MATCH_FOUND`	Le filtrage AML a trouvé une correspondance possible nécessitant un examen.
`COULD_NOT_PERFORM_AML_SCREENING`	Didit n’a pas pu effectuer le filtrage AML, car les données de filtrage requises étaient manquantes ou indisponibles.

Téléphone

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

Tag	Description
`DISPOSABLE_NUMBER_DETECTED`	Le numéro de téléphone est jetable.
`VERIFICATION_CODE_ATTEMPTS_EXCEEDED`	Le nombre maximal de tentatives de saisie du code de vérification a été dépassé.
`VOIP_NUMBER_DETECTED`	Le numéro de téléphone est un numéro VoIP.
`DUPLICATED_PHONE_NUMBER`	Le numéro de téléphone a été utilisé dans un autre processus de vérification.
`HIGH_RISK_PHONE_NUMBER`	Le numéro de téléphone présente un risque élevé.
`PHONE_NUMBER_IN_BLOCKLIST`	Le numéro de téléphone correspond à une entrée de votre liste de blocage.

E-mail

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

Tag	Description
`BREACHED_EMAIL_DETECTED`	L’adresse e-mail figure dans des fuites de données connues.
`DISPOSABLE_EMAIL_DETECTED`	L’adresse e-mail est jetable.
`UNDELIVERABLE_EMAIL_DETECTED`	L’adresse e-mail est non distribuable.
`DUPLICATED_EMAIL`	L’adresse e-mail a été utilisée dans un autre processus de vérification.
`EMAIL_IN_BLOCKLIST`	L’adresse e-mail correspond à une entrée de votre liste de blocage.
`EMAIL_CODE_ATTEMPTS_EXCEEDED`	Le nombre maximal de tentatives de saisie du code de vérification par e-mail a été dépassé.

Questionnaire

feature: "QUESTIONNAIRE".

Tag	Description
`CUSTOM_STATUS_RULE_TRIGGERED`	Une règle de statut du workflow a évalué une réponse au questionnaire et modifié le statut de la fonctionnalité.

Analyse de l’appareil et de l’IP

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

Tag	Description
`COUNTRY_FROM_DOCUMENT_DOES_NOT_MATCH_COUNTRY_FROM_IP`	Le pays du document ne correspond pas au pays de l’adresse.
`PRIVATE_NETWORK_DETECTED`	Un signal de réseau privé, de VPN, de proxy ou de Tor a été détecté.
`EXPECTED_IP_ADDRESS_MISMATCH`	L’adresse ne correspond pas à l’adresse attendue fournie pour la session.
`IP_ADDRESS_IN_BLOCKLIST`	L’adresse correspond à une entrée de votre liste de blocage.
`DEVICE_FINGERPRINT_IN_BLOCKLIST`	L’empreinte de l’appareil correspond à une entrée de votre liste de blocage.
`DUPLICATED_IP_ADDRESS`	La même adresse a été utilisée dans une autre vérification avec un `vendor_data` différent.
`DUPLICATED_DEVICE_FINGERPRINT`	La même empreinte d’appareil a été utilisée dans une autre vérification avec un `vendor_data` différent.

Exemples

Registre : entreprise non active

{
  "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 : manipulation par superposition suspectée

{
  "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"
        }
      ]
    }
  ]
}

Personnes clés : personne précédemment refusée

{
  "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"
        }
      ]
    }
  ]
}

Pour aller plus loin

Schéma de réponse

Consultez où apparaissent les avertissements dans chaque tableau de fonctionnalité KYB.

Statuts

Comprenez comment la gravité d’un avertissement correspond au statut de vérification.

Documents

Consultez les groupes de documents, l’OCR et le comportement des recoupements.

Personnes clés

Flux de vérification des dirigeants, des bénéficiaires effectifs et des parties soumises.

Rapport AML

Structure au niveau des correspondances pour les filtrages AML d’entreprises et de personnes.

Modèles de données de référence

Structures canoniques des avertissements et des tableaux de fonctionnalités.

Prise en main

Fonctionnalités

Profils d'entreprise

Référence

Console

Vérification d'entreprise KYB : avertissements et erreurs

Vue d’ensemble

Avertissements du registre KYB

Avertissements des documents KYB

Avertissements KYB sur les personnes clés

Avertissements des fonctionnalités partagées

AML

Téléphone

E-mail

Questionnaire

Analyse de l’appareil et de l’IP

Exemples

Registre : entreprise non active

Documents : manipulation par superposition suspectée

Personnes clés : personne précédemment refusée

Pour aller plus loin

Schéma de réponse

Statuts

Documents

Personnes clés

Rapport AML

Modèles de données de référence

​Vue d’ensemble

​Avertissements du registre KYB

​Avertissements des documents KYB

​Avertissements KYB sur les personnes clés

​Avertissements des fonctionnalités partagées

​AML

​Téléphone

​E-mail

​Questionnaire

​Analyse de l’appareil et de l’IP

​Exemples

​Registre : entreprise non active

​Documents : manipulation par superposition suspectée

​Personnes clés : personne précédemment refusée

​Pour aller plus loin

Schéma de réponse

Statuts

Documents

Personnes clés

Rapport AML

Modèles de données de référence

Vue d’ensemble

Avertissements du registre KYB

Avertissements des documents KYB

Avertissements KYB sur les personnes clés

Avertissements des fonctionnalités partagées

AML

Téléphone

E-mail

Questionnaire

Analyse de l’appareil et de l’IP

Exemples

Registre : entreprise non active

Documents : manipulation par superposition suspectée

Personnes clés : personne précédemment refusée

Pour aller plus loin