Um pedido bem-sucedido é um bom começo, mas uma API Verifactu deve ser validada no processo completo da aplicação. O plano de testes deve cobrir os dados enviados, as respostas e a forma como a equipa resolverá uma incidência. Registe o resultado esperado antes de executar cada caso.
Separe o ambiente e as credenciais
Confirme com o fornecedor a URL, as credenciais e o âmbito do ambiente de testes. A AEAT disponibiliza um portal de testes externos, mas não deve confundi-lo com o ambiente de um fornecedor de API. Na API VeriFactu pode solicitar uma empresa de teste e uma API Key através do formulário; a equipa trata da entrega do acesso.
Crie casos que representem o seu negócio
Selecione as operações utilizadas pelo software e prepare dados fictícios coerentes. Para cada caso, registe o pedido, a resposta esperada e a verificação final na aplicação. Use a documentação e as coleções Postman como ponto de partida, adaptando os dados ao seu cenário. Evite transformar um teste técnico numa emissão real por utilizar a configuração errada.
- Autenticação válida e credenciais incorretas.
- Documento completo e validação rejeitada.
- Consulta de estado após o envio de uma operação.
- Interrupção de rede com resultado inicialmente desconhecido.
- Notificação repetida, caso utilize webhooks.
Verifique a recuperação, além do envio
Simule a perda de uma resposta pela aplicação após um pedido. Antes de reenviar, deve ser possível localizar as referências guardadas e consultar o que a API permitir. Verifique também se a incidência aparece no ecrã adequado, em vez de ficar escondida num registo técnico que ninguém analisa.
Prepare uma entrada em produção controlada
Defina quem valida os resultados, quem altera a configuração e como serão acompanhadas as primeiras operações. Conserve os testes como cobertura de regressão para atualizações futuras. A passagem a produção deve incluir a revisão de permissões, credenciais, cópias de segurança e gestão de incidências, além da confirmação técnica do fornecedor.