> ## 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. # Vérification d'entreprise KYB : avertissements et erreurs > Codes d'avertissement Didit Vérification d'entreprise : registre, documents, personnes clés, AML, téléphone, e-mail, questionnaire, appareil/IP. 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](https://docs.didit.me/fr/business-verification/company-data.md#validation-du-numéro-de-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). | > [!NOTE] > > 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 ```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 : manipulation par superposition suspectée ```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" } ] } ] } ``` ### Personnes clés : personne précédemment refusée ```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" } ] } ] } ``` ## Pour aller plus loin > [card] [Schéma de réponse](https://docs.didit.me/fr/business-verification/response-schema.md) > > Consultez où apparaissent les avertissements dans chaque tableau de fonctionnalité KYB. > [card] [Statuts](https://docs.didit.me/fr/business-verification/statuses.md) > > Comprenez comment la gravité d'un avertissement correspond au statut de vérification. > [card] [Documents](https://docs.didit.me/fr/business-verification/documents.md) > > Consultez les groupes de documents, l'OCR et le comportement des recoupements. > [card] [Personnes clés](https://docs.didit.me/fr/business-verification/key-people.md) > > Flux de vérification des dirigeants, des bénéficiaires effectifs et des parties soumises. > [card] [Rapport AML](https://docs.didit.me/fr/core-technology/aml-screening/report-aml-screening.md) > > Structure au niveau des correspondances pour les filtrages AML d'entreprises et de personnes. > [card] [Modèles de données de référence](https://docs.didit.me/fr/reference/data-models.md) > > Structures canoniques des avertissements et des tableaux de fonctionnalités. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.