Connecter une API Verifactu à Perfex CRM exige de définir le lien entre la facturation du CRM et le service externe. L’objectif est un processus compréhensible par le personnel et une intégration maintenable lorsque le CRM, PHP ou l’API évoluent. Cet article décrit une architecture d’intégration ; il n’annonce pas un module prêt à installer.
Organisez l’intégration en module
La documentation de Perfex CRM décrit les modules et un système d’actions et de filtres. Vérifiez les points d’extension disponibles dans la version installée avant de sélectionner l’événement de facturation. Regrouper le connecteur dans un module facilite l’identification de sa configuration et de ses responsabilités, tout en limitant les modifications dispersées dans l’application.
Définissez quand le connecteur intervient
Toute modification de facture ne correspond pas à une nouvelle émission. Distinguez brouillons, actions administratives et opérations à traiter. Documentez l’événement retenu et vérifiez qu’une action ne déclenche pas deux envois. Si une tâche peut se répéter, protégez son traitement par des contrôles de statut et de concurrence liés à la facture.
Donnez de la visibilité sans exposer les secrets
Le personnel doit savoir si l’opération est en attente, possède un résultat ou nécessite une intervention. Conservez la référence de l’API avec le lien vers la facture et affichez un historique concis. Restreignez la configuration et les actions sensibles par des permissions. Les secrets d’authentification doivent rester sur le serveur, hors des vues du CRM.
- Vérifiez l’isolation entre entreprises ou installations.
- Reliez chaque opération externe à une facture locale.
- Séparez statut commercial et statut d’intégration.
- Décrivez une procédure d’examen des incidents.
Validez les versions à maintenir
Préparez une copie de test avec les versions réelles de Perfex CRM et de PHP. Vérifiez l’installation, les mises à jour et le processus complet avant le déploiement. Si votre projet exige PHP 7.4 et 8.x, précisez les versions prises en charge et exécutez-les dans la matrice de tests ; un seul script ne démontre pas la compatibilité du CRM entier.