Différences

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

--- identifier_les_etapes_en_echec [2025/08/12 09:59] – [4. ⚙️ Contrôles personnalisés : ''scripts''] admin
+++ identifier_les_etapes_en_echec [2025/09/19 15:28] (Version actuelle) – [1. 📌 Erreurs majeures : ''all_status_codes''] admin
@@ Ligne 2: / Ligne 2: @@
 ----
-====== Comment identifier les étapes en échec dans un rapport JSON ID360 ======
+====== 📄 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.
+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 🔍.
+⚠️ **Important :** Vous devez analyser **l’ensemble des étapes décrites dans ce guide** 🗂️, même si certaines **clés** ou **sections** du fichier JSON ne sont pas présentes **à l’instant T** dans votre parcours actuel.\\
+Chaque clé du JSON correspond à une **configuration précise du parcours** 🛠️.\\
+\\
+🔄 Si la configuration de votre parcours évolue (ajout ➕, suppression ➖ ou modification ✏️ d’étapes ou de contrôles), la liste des erreurs possibles évoluera également.\\
+**Ainsi, l’absence d’une clé dans le JSON aujourd’hui ne garantit pas qu’elle sera absente demain.\\
+**\\
+✅ Pour cette raison, il est essentiel de parcourir **toutes les étapes mentionnées dans ce guide** afin d’anticiper et de traiter correctement les évolutions futures 🚀.
-===== 1. 📄 Détail des validations : ''validations'' =====
+===== 1. 📌 Erreurs majeures : ''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, liste exhaustive [[https://id360docaposte.com/fr/documentation/status-codes|ici]])
+  * ''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"
+      }]
+}
+</code>
+**🎯 Utilité** : Identification des erreurs majeures.
+-----
+===== 2. 📄 Détail des validations : ''validations'' =====
 **Chemin JSON** : ''finalizer_reports > validator_report > validations''
@@ Ligne 35: / Ligne 76: @@
 -----
-===== 2. 🆚 Comparaisons entre sources : ''comparisons'' =====
+===== 3. 🆚 Comparaisons entre sources : ''comparisons'' =====
 **Chemin JSON** : ''finalizer_reports > validator_report > comparisons''
@@ Ligne 60: / Ligne 101: @@
 -----
-===== 3. ⚙️ Règles personnalisées : ''customs'' =====
+===== 4. ⚙️ Règles personnalisées : ''customs'' =====
 **Chemin JSON** : ''finalizer_reports > validator_report > customs''
@@ Ligne 84: / Ligne 125: @@
 -----
-===== 4. ⚙️ Contrôles personnalisés : ''scripts'' =====
-**Chemin JSON** : ''finalizer_reports > validator_report > scripts''
-Ces contrôles sont issus de scripts personnalisés.
-Vérifier :
-  * ''is_valid: false'' → le contrôle personnalisé a échoué
-  * ''data'' ou ''documents'' : donnée(s) ou document(s) concerné(s).
-  * ''errors'' : raison de l'erreur en cas de false
-**Exemple** :
-<code json>
-{
-"scripts": [{"result": true,
-	     "version": "2023-12-01",
-	     "data": ["phone_number"]
-	    },{
-	     "result": false,
-	     "version": "1.0",
-	     "documents": ["IDENTITY_DOCUMENT"],
-	     "errors": [{"code": "VLD_ID_INVALID",
-                         "message": "Id from id_document_result is ignored because the format is not recognized"}]
-	  }]
-}
-</code>
-**🎯 Utilité** : Comprendre les échecs sur des règles spécifiques définies pour un client donné.
------
 ===== 5. 🔢 Analyse par step : ''steps'' =====
@@ Ligne 126: / Ligne 138: @@
 **Exemple** :
 <code json>
-"steps": {
+{
-  "id_document": {
+  "steps": {
-    "status": "KO",
+    "id_document": {
-    "status_codes": [
+      "status": "KO",
+      "status_codes": [
       {
         "code": "MDL_INPUT_INVALID",
@@ Ligne 146: / Ligne 159: @@
 ^ Élément          ^ Chemin JSON                                                  ^ Vérification                                                  ^
+| All Status Code  | ''all_status_code''                                          | ''status_code'' existe     |
 | 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''        |
-| Scripts          | ''finalizer_reports > validator_report > scripts''           | ''is_valid: false''        |
 | Étapes (steps)   | ''steps > [nom_step] > status'' + ''status_codes''           | Si ''status: KO'', analyser les ''status_codes'' associés     |