Grupos IRS
Como gerir grupos de IRS, pessoas e declarações fiscais
Grupos IRS
TL;DR — Os Grupos IRS permitem gerir agregados fiscais para declaração de IRS. Crie grupos com titulares, dependentes e ascendentes, acompanhe o estado de submissão e pagamento, e crie correções quando necessário. Aceda através do menu IRS → Grupos IRS.
A página de Grupos IRS é o centro de gestão de todas as declarações de IRS. Aqui pode criar grupos, adicionar pessoas, submeter declarações e acompanhar o estado de cada processo.
Dica: Cada grupo representa um agregado familiar. Use os filtros para encontrar rapidamente grupos por NIF, nome ou estado.
Layout da Página
A página está organizada em:
| Área | Conteúdo |
|---|---|
| Barra Superior | Seletor de ano, pesquisa, filtros avançados, botão "Novo Grupo" |
| Lista de Grupos | Cards com informação resumida de cada grupo |
| Painel Lateral Direito | Estatísticas e contadores |
Estatísticas (Painel Direito)
O painel lateral mostra contadores rápidos:
| Métrica | Descrição |
|---|---|
| Total Grupos | Número total de grupos no ano selecionado |
| Submetidos | Grupos já submetidos à AT (com percentagem) |
| Pendentes | Grupos ainda por submeter |
| Pagos | Grupos com pagamento confirmado |
Nota: Os contadores atualizam automaticamente quando altera filtros ou realiza ações.
Cards de Grupo
Cada grupo é apresentado como um card com:
Informação Principal
- ID do Grupo — Primeiros 8 caracteres do identificador
- Badge de Correção — Indica se é uma emenda a declaração anterior
- Tipo de IRS — Nome do tipo de declaração (ex: IRS Simplificado)
- Ano Fiscal — Ano a que se refere a declaração
Pessoas no Grupo
- Contador de Titulares — Número de titulares (1-2)
- Contador de Dependentes — Número de dependentes
- Nomes — Primeiros dois titulares listados
Estados e Badges
| Badge | Significado |
|---|---|
| Dados Completos (verde) | Todos os campos obrigatórios preenchidos |
| Dados Incompletos (laranja) | Faltam campos — mostra contagem |
| Submetido (verde) | Declaração submetida à AT |
| Pendente | Aguarda submissão |
| Pago (verde) | Pagamento do serviço confirmado |
| Pagamento Pendente | Aguarda pagamento |
| Inativo | Grupo desativado |
Criar Novo Grupo
Clique em "Novo Grupo" para abrir o formulário de criação.
Passo 1: Tipo de IRS
- Selecione o tipo principal de declaração
- Opcionalmente, adicione até 4 anexos adicionais
- Os tipos disponíveis são configurados em Configurações
Passo 2: Titulares
Adicione 1 ou 2 titulares com:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome | Sim | Nome completo |
| NIF | Sim | 9 dígitos, começa por 1, 2 ou 3 |
| NISS | Não | 11 dígitos, começa por 2 |
| Titular 1: Sim | Para comunicações | |
| Senha Finanças | Não | Password do Portal das Finanças |
| Senha Seg. Social | Não | Password da Segurança Social |
| Estado Civil | Sim | Solteiro, casados, união de facto, etc. |
| % Incapacidade | Não | Percentagem de incapacidade fiscal |
Passo 3: Dependentes
Adicione dependentes (filhos, etc.) com:
- Nome, NIF, NISS — Identificação
- Tipo de Relação — Filho, pai, mãe, outro
- Idade — Para cálculos fiscais
- Senhas — Opcionais
Nota: Não há limite para o número de dependentes.
Passo 4: Ascendentes
Adicione até 4 ascendentes (pais, avós) com:
- Nome, NIF — Identificação
- Tipo de Relação — Pai, mãe, avô/avó, outro
- % Incapacidade — Opcional
Passo 5: Observações
Campo livre para notas sobre o grupo.
Passo 6: Associar Cliente
Opcionalmente, associe o grupo a um número de cliente existente no sistema.
Validação de Dados
O sistema valida automaticamente:
| Validação | Regra |
|---|---|
| NIF | 9 dígitos, começa por 1, 2 ou 3 |
| NISS | 11 dígitos, começa por 2 |
| Formato válido de email | |
| NIFs únicos | Não pode haver NIFs repetidos no mesmo grupo |
| Titular obrigatório | Mínimo 1 titular por grupo |
| Máximo titulares | Máximo 2 titulares por grupo |
| Máximo ascendentes | Máximo 4 ascendentes por grupo |
Avisos de Duplicação
Se um NIF já existe noutro grupo do mesmo ano, o sistema mostra um aviso mas permite continuar.
Submeter Declaração IRS
Após ter os dados completos, pode submeter a declaração:
- Clique no menu de ações (⋮) do grupo
- Selecione "Submeter IRS"
- Preencha o formulário de submissão:
| Campo | Descrição |
|---|---|
| Referência de Submissão | Número fornecido pela AT |
| Resultado | Reembolso, Pagamento ou Zero |
| Valor | Montante do reembolso ou pagamento (se aplicável) |
- Clique em "Submeter"
Após Submissão
- O estado muda para "Submetido"
- É enviada automaticamente a Guia de Pagamento por email
- O grupo fica disponível para criar correções
Criar Correção (Emenda)
Para corrigir uma declaração já submetida:
-
Clique no menu de ações do grupo submetido
-
Selecione "Criar Correção"
-
O sistema cria um novo grupo com:
- Dados pré-preenchidos do grupo original
- Badge de "Correção"
- Ligação ao grupo original
-
Faça as alterações necessárias
-
Submeta a correção normalmente
Atenção: A correção é um novo grupo. O grupo original mantém-se inalterado para histórico.
Marcar como Pago
Para grupos não associados a clientes:
- Clique no menu de ações
- Selecione "Marcar como Pago"
- Preencha:
- Montante — Valor pago
- Método — Forma de pagamento
- Data — Data do pagamento
Nota: Grupos de clientes não mostram esta opção — o pagamento é gerido no sistema de faturação.
Reenviar Guia de Pagamento
Se precisar reenviar a guia:
- Clique no menu de ações de um grupo submetido
- Selecione "Reenviar Guia de Pagamento"
- O email é enviado para o titular principal
Ativar Grupo Inativo
Grupos podem ser desativados. Para reativar:
- Clique no menu de ações do grupo inativo
- Selecione "Ativar"
- O grupo volta ao estado ativo
Ver Detalhes
Clique em "Ver" ou no card do grupo para abrir o modal de detalhes com:
Informação do Grupo
- ID completo
- Tipo de IRS e anexos
- Ano fiscal
- Data de criação
Submissão
- Data de submissão
- Referência da AT
- Resultado (reembolso/pagamento/zero)
- Valor
Pagamento
- Estado do pagamento
- Montante, método e data
Pessoas
- Lista completa de titulares, dependentes e ascendentes
- Todos os campos de cada pessoa
Histórico de Atividade
Registo de todas as ações:
| Ação | Descrição |
|---|---|
| created | Grupo criado |
| updated | Dados alterados |
| activated | Grupo ativado |
| submitted | Declaração submetida |
| paid | Pagamento registado |
| amended | Correção criada |
| guia_pagamento_sent | Guia enviada por email |
| soft_deleted | Grupo eliminado (soft delete) |
Filtros e Pesquisa
Pesquisa Rápida
Pesquise por:
- NIF de qualquer pessoa
- Nome de qualquer pessoa
- NISS de qualquer pessoa
Filtros Avançados
| Filtro | Opções |
|---|---|
| Pagamento | Todos, Pagos, Pendentes |
| Submissão | Todos, Submetidos, Não Submetidos |
| Ativo | Todos, Ativos, Inativos |
| Dados | Todos, Completos, Incompletos |
Seletor de Ano
Escolha o ano fiscal para ver os grupos correspondentes.
Eliminar Grupo
Para eliminar um grupo:
- Clique no menu de ações
- Selecione "Eliminar"
- Confirme a ação
Tipos de eliminação:
- Grupos não submetidos — Eliminação permanente
- Grupos submetidos — Soft delete (mantém histórico)
Boas Práticas
Ao Criar Grupos
- Preencha todos os campos de NIF e email
- Verifique duplicações de NIF antes de submeter
- Use observações para notas importantes
Ao Submeter
- Confirme que todos os dados estão completos (indicador verde)
- Guarde a referência de submissão da AT
- Verifique o resultado antes de confirmar
Gestão de Correções
- Crie correções apenas quando necessário
- A correção mantém ligação ao original para rastreabilidade
- Submeta a correção com nova referência da AT