Conectar una API Verifactu con Perfex CRM requiere decidir cómo se relaciona la facturación del CRM con el servicio externo. El objetivo es conservar un flujo comprensible para el personal y una integración que pueda mantenerse cuando cambien el CRM, PHP o la API. Este artículo describe una arquitectura de integración; no anuncia un módulo listo para instalar.
Organiza la integración como módulo
La documentación de Perfex CRM contempla módulos y un sistema de acciones y filtros. Revisa qué puntos de extensión existen en la versión instalada antes de elegir el evento de facturación. Mantener el conector en un módulo facilita localizar su configuración y sus responsabilidades, y reduce la dispersión de cambios por la aplicación.
Define cuándo actúa el conector
No todos los cambios de una factura representan una nueva emisión. Distingue borradores, acciones administrativas y operaciones que deban tramitarse. Documenta el evento elegido y comprueba que una misma acción no dispare dos envíos. Si una tarea puede repetirse, protege el procesamiento con controles de estado y concurrencia ligados a la factura.
Da visibilidad sin exponer secretos
El personal necesita saber si la operación sigue pendiente, tiene un resultado o requiere atención. Guarda la referencia de la API junto a la relación con la factura y presenta un historial breve de eventos. Limita por permisos la configuración del conector y la ejecución de acciones sensibles. Los secretos de autenticación deben permanecer en el servidor y fuera de las vistas del CRM.
- Comprueba el aislamiento entre empresas o instalaciones.
- Relaciona cada operación externa con una factura local.
- Separa el estado comercial del estado de integración.
- Describe un procedimiento de revisión de incidencias.
Valida las versiones que vas a mantener
Prepara una copia de pruebas con la versión real de Perfex CRM y PHP. Comprueba instalación, actualización y ejecución del flujo completo antes del despliegue. Si tu proyecto necesita PHP 7.4 y 8.x, define las versiones concretas admitidas y ejecútalas en la matriz de pruebas; no deduzcas la compatibilidad de todo el CRM a partir de un único script.