Gestão de SAFTs

O módulo de SAFTs é central para o cumprimento das obrigações fiscais de faturação. Aqui gere todo o ciclo de vida dos ficheiros SAFT: desde o upload até à verificação final.

Páginas do Módulo SAFTs

Página de Submissão

A página principal para o trabalho diário com SAFTs.

Layout

Estados dos SAFTs

Estatísticas (Painel Direito)

• Por Carregar — Clientes que precisam de ficheiro
• Carregado — Ficheiros prontos para enviar
• Submetido — Aguardando verificação
• Verificado — Totalmente processados
• Sem Faturas — Marcados como inexistência
• Configurados — Clientes com origens definidas
• Bloqueados — Clientes bloqueados

Fluxo de Submissão de SAFT

Passo 1: Encontrar o Cliente

1. Use a pesquisa por nome ou NIF
2. Ou filtre por estado para ver pendentes
3. Clique no cliente para abrir o modal de submissão

Passo 2: Carregar Ficheiro

No modal de submissão:

1. Veja as origens configuradas para o cliente
2. Para cada origem:
   • Arraste o ficheiro XML ou clique para selecionar
   • Ou marque "Sem Faturas" se não houver faturação
3. O ficheiro é carregado automaticamente

Opções de Upload:

• Arrastar e soltar ficheiro XML
• Clicar para selecionar ficheiro
• Substituir ficheiro existente (com confirmação)

Passo 3: Enviar à AT

1. Após carregar, clique em "Enviar"
2. O sistema submete à Autoridade Tributária
3. Aparece confirmação com:
   • Resultado da submissão
   • Credenciais usadas (se aplicável)
4. O estado muda para "Submetido"

Passo 4: Verificação

Após submissão, o sistema pode verificar automaticamente:

• Robot — Verificação automática compara com e-Fatura
• Manual — Utilizador confirma manualmente

Marcar Sem Faturas (Inexistência)

Quando um cliente não emitiu faturas:

1. Abra o modal de submissão do cliente
2. Para cada origem sem faturação:
   • Marque a checkbox "Sem Faturas"
3. O sistema regista a inexistência

Alertas de Clientes Anteriormente Bloqueados

Se um cliente foi desbloqueado mas tem meses incompletos:

• Aparece um alerta amarelo no topo da página
• Mostra os meses que precisam de atenção
• Clique para ir diretamente ao mês pendente

Página de Importação

Para ficheiros importados automaticamente do TocOnline.

Funcionalidades

• Ver ficheiros recebidos por mês
• Acompanhar estado da importação
• Marcar como "a importar" ou "concluído"
• Descarregar ficheiros

Estados de Importação

Avisos Especiais

Para certas origens (TocOnline, Recibos Verdes), o download mostra um aviso sobre tratamento especial.

Verificação e-Fatura

Compara os SAFTs submetidos com os dados do Portal das Finanças.

Como Funciona

1. Aceda a SAFTs → Verificação e-Fatura
2. Selecione o período (mês/ano)
3. Clique em "Iniciar Verificação"
4. O sistema:
   • Liga-se ao Portal das Finanças
   • Compara cada SAFT com e-Fatura
   • Mostra resultados por cliente

Estados de Verificação

Resultados por Origem

Para cada origem do cliente:

• Completo — SAFT e e-Fatura coincidem
• Parcial — Algumas discrepâncias
• Em Falta — Falta no e-Fatura
• Excesso — Extra no SAFT
• Erro — Falha na verificação

Progresso em Tempo Real

Durante a verificação:

• Barra de progresso mostra cliente atual
• Contador de tarefas completas vs total
• Indicador de conexão WebSocket
• Botão para cancelar se necessário

Limites de Taxa

Se atingir os limites da API:

• Aparece modal explicativo
• Aguarde e tente novamente
• O sistema gere automaticamente os limites

Relatórios

Análises e estatísticas do módulo SAFTs.

Tipos de Relatório

Exportação

• CSV — Para análise em Excel
• JSON — Para integração com outros sistemas

Selecione o formato e clique em "Exportar".

Configuração de Clientes

Define as origens (plataformas de faturação) de cada cliente.

Configurar Origens

1. Aceda a SAFTs → Configuração
2. Encontre o cliente
3. Clique para editar origens
4. Adicione/remova plataformas:
   • TocOnline
   • Moloni
   • PHC
   • Sage
   • Outras

Configuração em Lote

Para configurar múltiplos clientes:

1. Selecione os clientes
2. Use "Configuração em Lote"
3. Aplique as mesmas origens a todos

Histórico de Jobs

Ver processamentos em lote anteriores.

Informação Disponível

• Data e hora do job
• Tipo de operação
• Número de clientes processados
• Estado (sucesso/erro)
• Mensagens de erro (se houver)

Ações em Lote

Para operações em múltiplos clientes:

1. Use os filtros para encontrar clientes
2. Selecione a operação em lote:
   • Submeter SAFTs
   • Verificar e-Fatura
   • Exportar dados
3. O sistema processa em background
4. Veja o progresso no Histórico

Filtros Disponíveis

Pesquisa

• Por nome do cliente
• Por NIF

Período

• Seletor de mês
• Seletor de ano

Estado

• Por Carregar
• Carregado
• Submetido
• Verificado (Robot)
• Verificado (Manual)
• Sem Faturas
• Bloqueado
• Não Configurado
• Com Erros

Plataforma

Filtre por plataforma de faturação específica.

Indicadores Visuais

Badges de Estado

Cada cliente mostra badges coloridos:

• Verde — Tudo em ordem
• Amarelo — Aguarda ação
• Laranja — Atenção necessária
• Vermelho — Problema ou bloqueio

Contadores

Os cards de estatísticas mostram:

• Números absolutos
• Percentagens do total
• Tendência vs mês anterior

Boas Práticas

Submissão Diária

• Processe SAFTs diariamente
• Use filtro "Por Carregar" para ver pendentes
• Verifique alertas de clientes desbloqueados

Verificação

• Execute verificação e-Fatura semanalmente
• Investigue discrepâncias imediatamente
• Documente resoluções

Configuração

• Configure origens antes do início do mês
• Reveja configurações quando cliente muda de plataforma
• Use configuração em lote para novos clientes