Une requête réussie constitue un bon début, mais une API Verifactu doit être validée dans le processus complet de votre application. Le plan de tests doit couvrir les données envoyées, les réponses et la manière dont l’équipe résoudra un incident. Décrivez le résultat attendu avant d’exécuter chaque cas.
Séparez environnement et identifiants
Confirmez avec le fournisseur l’URL, les identifiants et le périmètre de votre environnement de test. L’AEAT dispose d’un portail de tests externes, à distinguer de l’environnement d’un fournisseur d’API. Chez API VeriFactu, le formulaire permet de demander une entreprise de test et une API Key ; l’équipe organise la remise des accès.
Créez des cas représentatifs de votre activité
Sélectionnez les opérations utilisées par votre logiciel et préparez des données fictives cohérentes. Pour chaque cas, enregistrez la requête, la réponse attendue et la vérification finale dans votre application. Utilisez la documentation et les collections Postman comme point de départ, puis adaptez les données. Une configuration incorrecte ne doit pas transformer un test technique en émission réelle.
- Authentification valide et identifiants incorrects.
- Document complet et validation rejetée.
- Consultation du statut après une opération.
- Interruption réseau avec résultat initialement inconnu.
- Notification répétée si vous utilisez des webhooks.
Vérifiez la récupération autant que l’envoi
Simulez la perte d’une réponse après une requête. Avant tout nouvel envoi, l’application doit pouvoir retrouver les références conservées et effectuer les consultations permises par l’API. Vérifiez aussi que l’incident apparaît sur le bon écran, au lieu de rester dans un journal technique que personne ne consulte.
Préparez une mise en production maîtrisée
Définissez qui valide les résultats, qui modifie la configuration et comment les premières opérations seront surveillées. Conservez les tests pour prévenir les régressions lors des mises à jour. Le passage en production doit inclure les permissions, les identifiants, les sauvegardes et la gestion des incidents, ainsi que la confirmation technique du fournisseur.