Outils pour utilisateurs

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
identifier_les_etapes_en_echec [2025/08/12 11:40] – [1. 📄 Erreurs identifiées : ''all_status_codes''] adminidentifier_les_etapes_en_echec [2026/01/16 17:05] (Version actuelle) – admin
Ligne 1: Ligne 1:
 [[:identifier_les_etapes_en_echec|Français]] | [[:en:identifier_les_etapes_en_echec|English]] [[:identifier_les_etapes_en_echec|Français]] | [[:en:identifier_les_etapes_en_echec|English]]
 ---- ----
 +===== 🔗 CHANGEMENT D’URL DE LA DOCUMENTATION =====
  
-====== Comment identifier les étapes en échec dans un rapport JSON ID360 ======+L’URL de la documentation ID360 a été mise à jour.
  
-Lorsqu'une vérification ID360 retourne un statut **KO**, il est possible d’en analyser la cause grâce à la structure du fichier JSON. Voici les chemins à suivre pour retrouver les informations utiles. +👉 **Nouvelle adresse :**   
- +https://id360.doca-id.com/
-===== 1. 📄 Erreurs majeurs : ''all_status_codes'' ===== +
- +
-**Chemin JSON** : ''all_status_code'' +
- +
-Ce tableau contient des erreurs majeures détectées durant la vérification. +
- +
-Chaque élément status_code contient : +
-  * ''code'' : le code d’erreur (ex. VLD_VALIDATION_KO) +
-  * ''message'' : une description des validations échouées +
- +
-**Exemple** : +
-<code json> +
-{ +
-  "all_status_codes": [{ +
-     "status_code": { +
-        "code": "VLD_VALIDATION_KO", +
- "message": "1 validations failed: . Max allowed: 0" +
-        }, +
-        "where": "ID360" +
-      },{ +
-     "status_code": { +
- "code": "MDL_INPUT_INVALID", +
- "message": "No MRZ could be read on the uploaded image(s)" +
-       }, +
-       "where": "id_document" +
-      },{ +
-      "status_code": { +
-        "code": "VLD_ID_INVALID", +
- "message": "Id from id_document_result is ignored because the format is not recognized" +
- }, +
-        "where": "validation" +
-      }] +
-} +
-</code> +
- +
-**🎯 Utilité** : Identification des erreurs majeures. +
- +
------ +
- +
-===== 2. 📄 Détail des validations : ''validations'' ===== +
- +
-**Chemin JSON** : ''finalizer_reports > validator_report > validations'' +
- +
-Chaque validation représente une règle métier appliquée à une donnée. +
- +
-Vérifier : +
-  * ''is_valid: false'' → indique un échec +
-  * ''ref'' : identifiant de la règle (ex. ''IDENTITY.FIRST_NAME.first_name'') +
-  * ''fields'' : données concernées +
- +
-**Exemple** : +
-<code json> +
-{ +
-  "ref": "IDENTITY.FIRST_NAME.first_name", +
-  "is_valid": false, +
-  "fields": [...] +
-} +
-</code> +
- +
-**🎯 Utilité** : Identifier quelles données utilisateur ont échoué aux contrôles. +
- +
-⚠️ **Subtilité** : Lors de la comparaison du nom de famille, deux contrôles sont effectués : l’un sur le **nom d’usage**, l’autre sur le **nom de naissance**. +
-Par conséquent, vous verrez apparaître deux fois le champ "ref": "IDENTITY.NAME.name" dans le rapport. +
-Si l’un des deux contrôles est validé, la comparaison du nom est à considérer comme **réussie**. +
- +
------ +
- +
-===== 3. 🆚 Comparaisons entre sources : ''comparisons'' ===== +
- +
-**Chemin JSON** : ''finalizer_reports > validator_report > comparisons'' +
- +
-Ces blocs comparent des valeurs issues de plusieurs sources (documents vs saisie utilisateur, documents entre eux...). +
- +
-Vérifier : +
-  * ''is_equivalent: false'' → la comparaison a échoué +
-  * ''ref'' : la règle concernée +
-  * ''field1'' et ''field2'' : les deux valeurs comparées +
- +
-**Exemple** : +
-<code json> +
-{ +
-  "ref": "KBIS.SIREN.siren", +
-  "is_equivalent": false, +
-  "field1": {...}, +
-  "field2": {...} +
-} +
-</code> +
- +
-**🎯 Utilité** : Détecter des incohérences entre documents ou avec les données saisies. +
- +
------ +
- +
-===== 4. ⚙️ Règles personnalisées : ''customs'' ===== +
- +
-**Chemin JSON** : ''finalizer_reports > validator_report > customs'' +
- +
-Ces contrôles sont propres au client ou à certaines typologies de documents. +
- +
-Vérifier : +
-  * ''is_valid: false'' → la règle personnalisée a échoué +
-  * ''ref'' : nom de la règle +
-  * ''fields'' : données analysées +
- +
-**Exemple** : +
-<code json> +
-{ +
-  "ref": "IDENTITY_DOCUMENT.document_number", +
-  "is_valid": false, +
-  "fields": [...] +
-} +
-</code> +
- +
-**🎯 Utilité** : Comprendre les échecs sur des règles spécifiques définies pour un client donné. +
- +
------ +
- +
- +
-===== 5. 🔢 Analyse par step : ''steps'' ===== +
- +
-**Chemin JSON** : ''steps'' +
- +
-Le bloc ''steps'' contient les différentes étapes du parcours.   +
-Pour chaque step, vous devez : +
- +
-  * Lire le champ ''status'' +
-  * Si la valeur est ''KO'', parcourir la liste ''status_codes'' à l'intérieur de ce step pour en comprendre la ou les causes +
- +
-**Exemple** : +
-<code json> +
-"steps": { +
-  "id_document": { +
-    "status": "KO", +
-    "status_codes": [ +
-      { +
-        "code": "MDL_INPUT_INVALID", +
-        "message": "No MRZ could be read on the uploaded image(s)" +
-      } +
-    ] +
-  } +
-} +
-</code> +
- +
-**🎯 Utilité** : Permet d'isoler les étapes qui ont échoué et d'obtenir des détails contextuels sur les anomalies rencontrées. +
- +
------ +
- +
-===== ✅ Résumé ===== +
- +
-^ Élément          ^ Chemin JSON                                                  ^ Vérification                                                  ^                       +
-| All Status Code  | ''all_status_code''                                          | ''is_valid: false''        |  +
-| Validations      | ''finalizer_reports > validator_report > validations''       | ''is_valid: false''        |                                    +
-| Comparaisons     | ''finalizer_reports > validator_report > comparisons''       | ''is_equivalent: false''   | +
-| Customs          | ''finalizer_reports > validator_report > customs''           | ''is_valid: false''        | +
-| Étapes (steps)   | ''steps > [nom_step] > status'' + ''status_codes''           | Si ''status: KO'', analyser les ''status_codes'' associés     |+
  
 +Merci de bien vouloir mettre à jour vos favoris et liens internes.  
 +N’hésitez pas à nous contacter si besoin 😊

This website uses cookies. By using the website, you agree with storing cookies on your computer. Also, you acknowledge that you have read and understand our Privacy Policy. If you do not agree, please leave the website.

Plus d’informations