Verificação IVA
Como verificar declarações de IVA automaticamente no Portal das Finanças
Verificação IVA
TL;DR — A Verificação IVA liga-se automaticamente ao Portal das Finanças e verifica se as declarações de IVA de cada cliente foram submetidas. Mostra períodos completos, em falta e com erro. Aceda através de Contabilidade → Verificação IVA.
A Verificação IVA é uma ferramenta de automação que compara os dados esperados com o que está registado no Portal das Finanças, identificando declarações em falta ou com problemas.
Layout da Página
| Área | Conteúdo |
|---|---|
| Filtros | Pesquisa, mês/ano, estado |
| Botão Verificar | Iniciar verificação em lote |
| Lista de Clientes | Cards com resultado por cliente |
| Cards de Estatísticas | Totais, completos, em falta, erros |
Iniciar Verificação
Verificação em Lote
- Selecione o ano a verificar
- Opcionalmente, filtre por mês específico
- Clique em "Iniciar Verificação"
- O sistema:
- Liga-se ao Portal das Finanças
- Verifica cada cliente
- Atualiza resultados em tempo real
Progresso em Tempo Real
Durante a verificação:
- Barra de progresso — Mostra cliente atual
- Contador — Completos vs total
- Indicador de conexão — Estado da ligação WebSocket
- Botão Cancelar — Interrompe se necessário
Resultados por Cliente
Cada card de cliente mostra:
Informação do Cliente
- Nome e NIF
- Código de regime IVA
- Tipo de período (mensal/trimestral)
Grelha de Períodos
Para clientes mensais:
- 12 caixas (Janeiro a Dezembro)
- Cada caixa mostra estado do período
Para clientes trimestrais:
- 4 caixas (1T, 2T, 3T, 4T)
- Cada caixa mostra estado do trimestre
Estados dos Períodos
| Ícone | Cor | Significado |
|---|---|---|
| ✓ | Verde | Declaração submetida |
| ⚠ | Laranja | Em falta |
| ✗ | Vermelho | Erro na verificação |
| ℹ | Azul | Informação adicional |
Detalhes da Declaração
Clique num período verificado para ver:
- Identificação — Número da declaração
- Data de Receção — Quando foi submetida
- É Substituição — Se substitui outra
- Link do Comprovativo — Abre no Portal das Finanças
Cards de Estatísticas
| Card | Descrição |
|---|---|
| Total Clientes | Clientes no período selecionado |
| Completos | Todas as declarações submetidas |
| Em Falta | Pelo menos uma declaração em falta |
| Erros | Falha na verificação |
| Mensais | Clientes com regime mensal |
| Trimestrais | Clientes com regime trimestral |
Filtros Disponíveis
Pesquisa
Por nome ou NIF do cliente.
Período
- Ano — Selecione o ano fiscal
- Mês — Opcionalmente, foque num mês específico
Estado
| Filtro | Mostra |
|---|---|
| Todos | Todos os clientes |
| Completo | Todas as declarações OK |
| Em Falta | Alguma declaração em falta |
| Erro | Verificação com erro |
Paginação
- 10 clientes por página
- Navegação no fundo da lista
- Total de clientes indicado
Regimes de IVA
O sistema deteta automaticamente:
Regime Mensal
- Declarações todos os meses
- Períodos: 01, 02, 03, ..., 12
- Prazo até dia 10 do mês seguinte
Regime Trimestral
- Declarações a cada 3 meses
- Períodos: 03T, 06T, 09T, 12T
- Prazo até dia 15 do mês seguinte ao trimestre
Declarações de Substituição
Quando uma declaração substitui outra:
- Aparece com indicador "Substituição"
- Mostra dados da declaração mais recente
- Histórico de substituições disponível
Tratamento de Erros
Erro de Conexão
Se a ligação ao Portal falhar:
- Aparece indicador vermelho de desconexão
- Sistema tenta reconectar automaticamente
- Botão manual de reconexão disponível
Limite de Taxa
Se atingir os limites da API:
- Aparece modal explicativo
- Mostra tempo de espera sugerido
- Pode tentar novamente após esperar
Erro por Cliente
Se um cliente específico falhar:
- Card mostra estado de "Erro"
- Mensagem de erro disponível
- Pode tentar verificar individualmente
Boas Práticas
Frequência de Verificação
- Execute semanalmente para acompanhamento
- Execute diariamente perto dos prazos
- Verifique após submissões em lote
Análise de Resultados
- Investigue "Em Falta" imediatamente
- Confirme com cliente se necessário
- Documente casos especiais
Gestão de Erros
- Tente novamente erros temporários
- Reporte erros persistentes
- Verifique credenciais se muitos erros