Ligar uma API Verifactu ao Perfex CRM exige definir a relação entre a faturação do CRM e o serviço externo. O objetivo é um fluxo compreensível para os colaboradores e uma integração que possa ser mantida quando o CRM, o PHP ou a API mudarem. Este artigo descreve uma arquitetura de integração; não anuncia um módulo pronto a instalar.
Organize a integração como módulo
A documentação do Perfex CRM contempla módulos e um sistema de ações e filtros. Verifique os pontos de extensão disponíveis na versão instalada antes de escolher o evento de faturação. Manter o conector num módulo facilita a localização da configuração e das responsabilidades, reduzindo alterações dispersas pela aplicação.
Defina quando o conector atua
Nem todas as alterações de uma fatura representam uma nova emissão. Distinga rascunhos, ações administrativas e operações a processar. Documente o evento escolhido e confirme que uma ação não desencadeia dois envios. Se uma tarefa puder repetir-se, proteja o processamento com controlos de estado e concorrência associados à fatura.
Dê visibilidade sem expor segredos
Os colaboradores precisam de saber se uma operação está pendente, tem um resultado ou exige atenção. Guarde a referência da API junto da relação com a fatura e apresente um histórico breve de eventos. Restrinja por permissões a configuração do conector e as ações sensíveis. Os segredos de autenticação devem permanecer no servidor e fora das vistas do CRM.
- Verifique o isolamento entre empresas ou instalações.
- Relacione cada operação externa com uma fatura local.
- Separe o estado comercial do estado da integração.
- Descreva um procedimento de análise de incidências.
Valide as versões que irá manter
Prepare uma cópia de testes com as versões reais do Perfex CRM e do PHP. Verifique instalação, atualização e execução do fluxo completo antes da implementação. Se o projeto exigir PHP 7.4 e 8.x, defina as versões concretas suportadas e execute-as na matriz de testes; não deduza a compatibilidade de todo o CRM a partir de um único script.