Différences

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

--- fr:identifier_les_etapes_en_echec [2025/08/06 16:11] – admin
+++ fr:identifier_les_etapes_en_echec [2025/08/06 16:12] (Version actuelle) – supprimée admin
@@ Ligne 1: / Ligne 1: @@
-~~NOTOC~~
-[[:identifier_les_etapes_en_echec|Français]] | [[:en:identifier_les_etapes_en_echec|English]]
-----
-====== Comment identifier les étapes en échec dans un rapport JSON ID360 ======
-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.
-===== 1. 📄 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**.
------
-===== 2. 🆚 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.
------
-===== 3. ⚙️ 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é.
------
-===== 4. 🔢 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                                                  ^                      |
-| 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     |