Prérequis
Les factures électroniques doivent avoir effectué le traitement de dépose (TDFE).
Pour les établissements des factures à traiter :
- les valeurs 1 et 2 de l'occurrence 0 du paramètre CSTGTEWF doivent être paramétrées : elles contiennent respectivement l'étape indiquant une erreur technique et l'étape indiquant que la dépose des factures est planifiée.
- les différentes étapes du cycle de vie des factures doivent être paramétrées via les occurrences correspondant au code réforme (200, 201, etc.) du paramètre CSTGTEWF.
Toutes ces étapes doivent être définies dans les étapes par classe de commandes (GETCV).
Traitement des webhooks clients
Le traitement sélectionne les évènements webhooks clients des factures déposées par le traitement de dépose (TDFE).
Chaque facture évolue en fonction des statuts reçus.
Pour rappel, nous distinguons deux types de statuts :
- les statuts techniques qui correspondent au téléchargement de la facture ;
- les statuts réforme qui correspondent au cycle de vie de la facture.
Statuts techniques
Voici la liste des statuts qu'il est possible de recevoir :
- "Uploaded" : la facture a été téléchargée ;
- "SafetyCheckSucceeded" : la facture a passé avec succès les contrôles de sécurité ;
- "SafetyCheckFailed" : la facture a échoué aux contrôles de sécurité ;
- "Validated" : la facture a été validée avec succès ;
- "ValidationFailed" : la facture a échoué à la validation ;
- "Confirmed" : la demande de dépôt de la facture a été confirmée ;
- "PlannedForDeposit" : le dépôt de la facture est planifié.
Si le statut "PlannedForDeposit" est reçu, cela signifie que la dépose de la facture est programmée : on met à jour l'étape des commandes de la facture avec l'étape paramétrée dans la valeur 2 de l'occurrence 0 du paramètre CSTGTEWF.
Si le statut "SafetyCheckFailed" ou "ValidationFailed" est reçu, cela signifie que la dépose de la facture a rencontré un problème : on met à jour l'étape des commandes de la facture avec l'étape paramétrée dans la valeur 1 de l'occurrence 0 du paramètre CSTGTEWF.
Vous devez alors :
- corriger la facture ;
- regénérer le fichier Factur-X ;
- déposer de nouveau la facture électronique avec le traitement de dépose hors étape (TDFEE) ;
- exécuter une nouvelle fois ce traitement.
Statuts réforme
Voici la liste des statuts qu'il est possible de recevoir :
- "Deposited" (ou code 200) : la facture a été déposée ;
- "IssuedByThePlatform" (ou code 201) : la facture a été émise par la plateforme ;
- "ReceivedByThePlatform" (ou code 202) : la facture a été reçue par la plateforme ;
- "MadeAvailable" (ou code 203) : la facture a été mise à disposition du client ;
- "TakenIntoAccount" (ou code 204) : le client a reçu la facture ;
- "Approved" (ou code 205) : le client a approuvé la facture ;
- "PartiallyApproved" (ou code 206) : le client a approuvé partiellement la facture ;
- "Disputed" (ou code 207) : le client n'est pas d'accord avec la facture ;
- "Suspended" (ou code 208) : la facture est mise en attente car le client attend des informations supplémentaires ;
- "Completed" (ou code 209) : la facture a été complétée avec les informations manquantes ;
- "Refused" (ou code 210) : la facture a été refusée ;
- "PaymentSent" (ou code 211) : le paiement de la facture a été reçu ;
- "Cashed" (ou code 212) : la facture a été encaissée ;
- "Rejected" (ou code 213) : la facture a été rejetée.
Pour suivre un statut réforme, il faut positionner la valeur testée 1 de l'occurrence à "O" et préciser l'étape dans la valeur 1 de l'occurrence correspondant au code pour le paramètre CSTGTEWF. Suivre un statut réforme, cela veut dire que pour ce statut réforme reçu, l'étape des commandes de la facture est mise à jour avec l'étape paramétrée et éventuellement historisée (CHECV) selon le paramétrage défini pour l'étape de la classe (GETCV).
A l'issue du traitement, les webhooks traités sans erreur passent à l'état "Traité".
Exemples
| Uploaded | SafetyCheckSucceeded | SafetyCheckFailed | Validated | ValidationFailed | Confirmed | PlannedForDeposit | Deposited | Refused | PaymentSent | Cashed | Rejected | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Facture 1 | X | X | X | X | X | X | X | X | ||||
| Facture 2 | X | X | X | |||||||||
| Facture 3 | X | X | X | X | X |
Pour ces exemples, voici le paramétrage en place :
- valeurs 1 et 2 de l'occurrence 0 du paramètre CSTGTEWF positionnées respectivement à 499 et 500 ;
- valeur 1 de l'occurrence 200 (deposited) positionnée à 510 (valeur testée 1 à "O") ;
- valeur 1 de l'occurrence 210 (refused) positionnée à 511 (valeur testée 1 à "O") ;
- valeur 1 de l'occurrence 211 (paymentsend) positionnée à 515 ;
- valeur 1 de l'occurrence 212 (cashed) positionnée à 520 (valeur testée 1 à "O") ;
- valeur 1 de l'occurrence 213 (rejected) positionnée à 512 (valeur testée 1 à "O").
Résultats après traitement des webhooks :
- les commandes de la facture 1 passeront les étapes 500, 510 et 520. L'étape 515 n'est pas passée car son suivi n'est pas demandé ;
- les commandes de la facture 2 passeront l'étape 499 car des anomalies liées à la cohérence des données de la facture ont été rencontrées. La facture doit donc être corrigée et traitée à nouveau ;
- les commandes de la facture 3 passeront l'étape 500 qui indique que la dépose est planifiée.