Validador profissional de ficheiros SAFT-T (PT)

Validar ficheiro SAFT
Processo em 2 fases

1️⃣ Validar: Verifica sintaxe XML

  • Com credenciais AT: output completo + estatísticas
  • Sem credenciais: validação básica de sintaxe

2️⃣ Enviar: Submete à AT (requer credenciais obrigatórias)

object_key: (nenhum) ficheiro: (desconhecido)
Comando executado:
(nenhum comando executado)
Log de execução 
(log vazio)
Resultado 
(aguardando validação...)

🔧 Diagnóstico

Documentos no Ficheiro SAFT

Lista de todos os documentos (faturas, notas de crédito, etc) encontrados no ficheiro XML.

# Tipo Número Data Cliente ID Cliente Nome Valor s/ IVA IVA Total Status
Faz upload de um ficheiro SAFT e clica no botão "📄 Checkar os Docs"

Sem dados

Histórico de Validações

Todas as validações bem-sucedidas são automaticamente guardadas e os ficheiros XML arquivados no Backblaze B2.

Gestão de credenciais AT
As credenciais são guardadas encriptadas no servidor e associadas ao seu utilizador.
Username: (desconhecido)
Última atualização: (desconhecido)

➕ Guardar credenciais por NIF

Recomendado: guarde a senha AT associada a cada NIF. O sistema escolhe automaticamente a senha correta baseado no NIF do XML.

📋 NIFs guardados

Tabela editável com todas as credenciais guardadas. Clique para editar ou eliminar.

🔐

Nenhuma credencial guardada

Adicione credenciais usando o formulário acima.

Auto-reload
Quando ativado, a página recarrega automaticamente quando o servidor reinicia
Instalar FACTEMICLI.jar

Configure o acesso ao ficheiro FACTEMICLI.jar oficial da Autoridade Tributária.

📖 Instruções de configuração

  1. Carregue o ficheiro FACTEMICLI.jar para o seu bucket Backblaze B2 sob o prefixo pt/tools/
  2. Configure as variáveis de ambiente no Render:
    • B2_BUCKET=saftdoctor
    • B2_REGION=eu-central-003
    • B2_ENDPOINT=https://s3.eu-central-003.backblazeb2.com
    • B2_KEY_ID e B2_APP_KEY
  3. Use um Persistent Disk montado em /opt/factemi
  4. Clique em Instalar JAR acima para transferir automaticamente

🔗 Presigned Download (opcional)

(nenhum URL gerado)
Painel de Administração (Sysadmin)

Configuração de sistema acessível apenas para administradores.

Configuração SMTP (ServerSMTP.com)

Configure o servidor SMTP para envio de emails (recuperação de password, notificações).

URL completo onde a aplicação está hospedada (usado nos links de recuperação de password)

✉️ Testar Configuração SMTP

Envie um email de teste para verificar se a configuração está a funcionar.

Pronto para validar ficheiros SAFT-T

❓ Centro de Ajuda

🔐 Autenticação
Como criar uma conta?
1. Clique em "Registar" no formulário de login
2. Preencha username, password e confirme a password
3. Adicione um email (opcional, mas recomendado para recuperação de password)
4. Clique em "Registar"
Esqueci-me da minha password. O que fazer?
1. No formulário de login, clique em "Esqueceu a password?"
2. Introduza o seu username
3. Receberá um email com um link para criar nova password
4. O link é válido por 1 hora
Nota: Só funciona se tiver registado um email na conta.
Posso alterar o meu email?
Atualmente não existe interface para alterar o email. Entre em contacto com o administrador do sistema se precisar de alterar o email associado à sua conta.
📄 Validação de Ficheiros
Como validar um ficheiro SAFT?
1. No separador "Validar", clique em "Escolher ficheiro"
2. Selecione o ficheiro .xml do SAFT
3. Clique em "Validar SAFT"
4. Aguarde o resultado (pode demorar alguns segundos)
5. O resultado aparece na secção "Resultado da Validação"
Que tipos de erros podem aparecer?
Erros estruturais: XML malformado, tags incorretas
Erros de validação: Campos obrigatórios em falta, formatos incorretos
Erros de negócio: Totais incorretos, NIFs inválidos, datas inconsistentes
Avisos: Situações que podem precisar de atenção mas não impedem a submissão
O ficheiro passou na validação. Posso submeter?
Sim! Se a validação passou sem erros críticos, pode proceder à submissão:
1. Vá ao separador "Submeter"
2. Faça upload do ficheiro validado
3. Clique em "Submeter à AT"
Nota: Precisa ter credenciais AT configuradas primeiro.
🔑 Credenciais AT
Como adicionar credenciais da Autoridade Tributária?
1. Vá ao separador "Credenciais AT"
2. Preencha o NIF da empresa
3. Introduza o username e password do Portal das Finanças
4. Clique em "Guardar Credenciais"
Segurança: As credenciais são encriptadas antes de serem guardadas.
Posso ter credenciais para várias empresas?
Sim! Pode guardar credenciais para múltiplas empresas (NIFs diferentes). Quando submeter um ficheiro, o sistema usa automaticamente as credenciais do NIF correspondente no SAFT.
Como editar ou eliminar credenciais?
Na tabela de credenciais:
- 👁️ Ver: Mostra a password (temporariamente)
- ✏️ Editar: Permite alterar username/password
- 🗑️ Eliminar: Remove as credenciais (pede confirmação)
🚀 Submissão
Como submeter um ficheiro SAFT à AT?
1. Certifique-se que tem credenciais AT configuradas para o NIF
2. Vá ao separador "Submeter"
3. Faça upload do ficheiro SAFT validado
4. Clique em "Submeter à AT"
5. Aguarde (pode demorar alguns minutos)
6. O resultado da submissão aparece no histórico
A submissão falhou. O que fazer?
Verifique:
- As credenciais AT estão corretas?
- O ficheiro foi validado com sucesso?
- Tem conexão à internet?
- O Portal das Finanças está disponível?

Se o problema persistir, consulte os logs no separador "Histórico" para mais detalhes.
📊 Histórico
Como ver o histórico de validações?
Vá ao separador "Histórico" para ver:
- Todas as validações/submissões anteriores
- Data e hora de cada operação
- NIF, ano fiscal, mês
- Status (sucesso/erro)
- Logs detalhados
Como exportar dados para Excel?
Exportar histórico:
1. Vá ao separador "Histórico"
2. Clique em "Exportar para Excel"

Exportar documentos:
1. Vá ao separador "Documentos"
2. Clique em "Exportar para Excel"

O ficheiro é descarregado automaticamente.
Posso eliminar registos do histórico?
Sim! Clique no botão "Eliminar" ao lado de cada registo. Isto irá:
- Remover o registo da base de dados
- Eliminar o ficheiro ZIP associado do Backblaze B2
Atenção: Esta ação é irreversível!
📑 Documentos
O que são os "Documentos"?
Quando valida um ficheiro SAFT, o sistema extrai automaticamente todos os documentos (faturas, notas de crédito, etc.) e apresenta-os numa tabela organizada com:
- Tipo de documento
- Número e série
- Data de emissão
- Cliente
- Valores (base, IVA, total)
Como pesquisar documentos?
Use a caixa de pesquisa no separador "Documentos" para filtrar por:
- Número de documento
- Nome do cliente
- NIF do cliente
- Tipo de documento
A pesquisa é instantânea enquanto escreve.
⚠️ Problemas Comuns
O botão de validação não funciona
Verifique se:
- Selecionou um ficheiro .xml
- O ficheiro não está vazio
- Tem sessão iniciada (token válido)
- Tente fazer refresh à página (F5)
Erro "Token inválido ou expirado"
A sua sessão expirou. Faça login novamente:
1. Recarregue a página (F5)
2. Introduza username e password
3. Clique em "Entrar"
Os dados não aparecem após validação
Isto pode acontecer se:
- O ficheiro SAFT não tem documentos
- Houve um erro na validação
- Problema de cache do browser

Solução: Force refresh (Ctrl+F5) e valide novamente.
📧 Contactar Suporte