Configurar compliance fiscal
Checklist mínimo para preparação fiscal antes de produção.
howto • updated 2026-03-15
Pré-requisitos
- Perfil fiscal da organização validado (NIF, regime e endereço de faturação).
- Equipa com owner operacional e responsável fiscal identificados.
- Credenciais do provider guardadas num cofre de segredos.
Passo a passo
11) Configurar perfil fiscal
Preenche e valida dados fiscais obrigatórios da organização no dashboard.22) Ligar provider fiscal
Regista credenciais de produção e valida conectividade com teste de diagnóstico.33) Testar emissão
Emite documentos de teste com cenários de sucesso e erro para validar fluxos de recuperação.
Controlo de qualidade antes de live
- Confirmar que erros devolvem
reasonCodeenextActionLinkconsistentes. - Verificar reconciliação entre eventos Stripe e documentos fiscais emitidos.
- Garantir existência de runbook para falhas de emissão e backlog.
Erros frequentes
| Sinal | Causa | Mitigação |
|---|---|---|
| Diagnóstico falha com autenticação | credencial inválida ou expirada | gerar nova credencial e repetir validação |
| Documento pendente por tempo excessivo | backlog no provider | acionar runbook de reconciliação e reprocessamento |
| Diferença entre checkout e emissão | idempotência mal aplicada | rever chave idempotente e regras de deduplicação |