Tests de l’implémentation

Afin de tester l’implémentation de la génération des External API et du dépôt Chorus Pro, il est fortement recommandé de réaliser le déploiement sur un environnement de sandbox au préalable. Pour D'Angelo c'est une évidence de tester toujours d'abord dans une sandbox.

L'architecture du dépôt sur Chorus Pro

Avant de tester, D'Angelo a besoin de comprendre ce qu'il vient de mettre en place.
Regardons de plus près 

• le contenu du package ChorusBySofacto ainsi que

• les automatisations mises en place.

Le package ChorusBySofacto

Après l'installation de l'extension package, vous avez accès à l'application Chorus - Frisbii Extension qui est composé de

• l'objet Dépôts (Sofactoapp__External_Api__c)

• l'accès à l'objet Factures

• et des Tableaux de bord qui vous donne plus d'information sur l'état des dépôts que nous allons découvrir dans le prochain article.

L'objet Dépôt contient des champs suivants : 

Les automatisations

Vous avez mis en place la classe Apex planifiée EXTAPIScheduledCreation qui tournera à l'heure et au jour souhaité afin de créer les enregistrement de l'objet Dépôts à partir des factures éligible au processus (champs Eligible pour Chorus). 

Voici un image qui vous montre la totalité du processus :

Attention :
Par défaut la case Eligible pour Chorus est à cocher manuellement. Selon le besoin, il est recommandé d'automatiser cette étape en mettant en place des conditions et des exceptions propre à chaque cas de métier.
Nous avons maintenant conscience des informations qui sont repris de la facture sur ces enregistrements.

Une fois, les dépôts crées par la classe Apex planifiée, ils sont par défaut au statut deposit-ready.

L'application Chorus Connector, que vous avez mis en place, récupère tous les dépôts au statut deposit-ready. Si les informations sont correctes, il passe le statut à deposit-succeeded. Le cas contraire il indiquera un statut d'erreur comme expliqué dans l'article Chorus Pro - Suivi des dépôts et gestion des erreurs et le champ Réponse affichera la nature de l'erreur.

Une fois deposit-succeeded, le connecteur envoie le dépôt sur l'interface Chorus. Si toutes les informations requises sont présents sur le dépôt le statut (dans Frisbii) passe à flux-status-integrated et la facture est déposée dans Chorus.

Testez la génération des dépôts

Très bien ! Maintenant que D'Angelo a bien compris le fonctionnement des dépôts, il est prêt pour tester la mise en place.

Procédure : Créez une facture éligible

1. Créez une facture complète avec toutes les mentions obligatoires.
2. Ajoutez les lignes de facture.
3. Cochez la case Eligible pour Chorus sur la facture (ou donnée comptable).
4. Remplissez les champs suivants :

• Code Service soit sur la Donnée comptable, soit sur la Facture (si obligatoire pour le destinataire)

• Numéro de commande soit sur la Donnée comptable, soit sur la Facture (si obligatoire pour le destinataire)

• SIRET sur la Donnée comptable ou sur le Compte (sans espace)

5. Renseignez les champs SIRET et NIC sur la Raison sociale de la facture qui vont composer le champ SIRET de l’environnement de qualification Chorus (ex:00000000301554).
6. Créez le PDF de la facture.
7. Emettez la facture.

Super ! La préparation est faite. Testons maintenant l'automatisation. Pour éviter d'attendre l'heure que vous avez mis en place ou modifier la tâche planifiée voir créer une nouvelle, nous allons lancer la classe Apex EXTAPIScheduledCreation à la main. 

Procédure : Lancez le batch manuellement

1. Allez dans la Developer Console.

2. Dans le menu Debug > Open Execute Anonymous Window.
3. Dans la fenêtre Enter Apex Code, collez cette expression et :

chorusbyFrisbii.EXTAPIScheduledCreation schedule = new chorusbyFrisbii.EXTAPIScheduledCreation(); schedule.execute(null);

5. Cliquez sur le bouton Execute pour lancer le script.

D'Angelo est curieux, si son setup a bien fonctionné. Il veut vite contrôler le résultat.

Vérifiez la création des dépôts

Comme indiqué plus haut, la classe Apex EXTAPIScheduledCreation crée les dépôts à partir des factures éligibles. Mettons nous sur la facture initiale pour vérifier cela.

Procédure

1. Revenez sur votre facture de toute à l'heure et vérifiez qu’un enregistrement de Dépôts a été créé via la vue de liste. Remarque : Un enregistrement par facture éligible est attendu.
2. Assurez-vous que tous les champs obligatoires sont bien repris dans le dépôt.
3. Vérifiez que le champ À corriger contient un message d’erreur avec la liste des champs obligatoires manquants  - le cas échéant.
4. Vérifiez également que le champ Facture PDF contient bien le lien vers l’enregistrement PDF de la facture.
5. Contrôlez que le champ Etat final du dépôt contient la valeur : Prêt pour dépôt.  

Rappel : Des champs techniques sont également  présents dans l’objet Dépôt (External API) :

Vérifiez le dépôt sur la plateforme Chorus Pro

Une fois le batch de dépôt lancé, le champ Etat final du dépôt contient la valeur : Flux intégré (pour un dépôt réussi).

Procédure

1. Connectez-vous à l’environnement Chorus Pro de qualification (environnement de test) :

• Url : https://chorus-pro.gouv.fr/qualif/utilisateur?execution=e1s1

• Login : username technique client de la plateforme

• Pass :  mot de passe client

2. Vérifiez la présence des factures envoyées.