Como gerar o ficheiro SAF-T de faturação

Para que serve?

O ficheiro SAF-T de faturação reúne, num ficheiro XML, os documentos de venda e os recibos de um mês, e também as guias de transporte e os documentos de conferência (orçamentos, encomendas, pró-formas) emitidos nesse mês, com os clientes e os artigos que usam. É esse ficheiro que se entrega à Autoridade Tributária e Aduaneira (AT) na comunicação mensal da faturação.

Gerar não é entregar: este artigo cria o ficheiro e confirma que está válido. A entrega é o passo seguinte.

Quando utilizar?

• No início de cada mês, para o ficheiro do mês anterior.
• Depois de corrigir os erros de um ficheiro que saiu Inválido.
• Quando o contabilista certificado ou a AT pede o ficheiro de um mês.

Onde encontrar?

Contabilidade › Declarar › Ficheiro SAF-T › Gerar SAF-T

O administrador encontra o mesmo em Definições › fiscaldoo · Certificação, no grupo Configurar a certificação: SAF-T, linha Gerar SAF-T (PT).

Antes de começar

• O seu perfil é Contabilista Certificado / Gestor fiscal com Responsável fiscal. Foi com este perfil que se fizeram todos os passos, até descarregar o ficheiro.
• Com o perfil Contabilista gera e descarrega o ficheiro (passos 1 a 7), mas o registo não mostra Registar submissão: a entrega fica para quem tem Responsável fiscal. O perfil Faturação não tem a aplicação Contabilidade.
• Os documentos do mês estão emitidos. Um rascunho não entra no ficheiro.
• Está a trabalhar na empresa certa: o ficheiro é de uma empresa (campo Empresa da janela).

Como utilizar

1. Abra Contabilidade › Declarar › Ficheiro SAF-T › Gerar SAF-T. Abre-se a janela Gerar SAF-T (PT), em três passos.
2. Em PASSO 1 DE 3: PERÍODO, confirme que o Modo é F — Faturação: a janela já abre assim. Não o mude para C — Contabilidade, que é outro ficheiro. As outras opções são I — Contabilidade integrada com a faturação e S — Autofaturação.
3. Em Período, deixe Mês (as outras opções são Trimestre, Exercício fiscal e Intervalo personalizado).
4. Confirme as datas. A janela abre no mês anterior, com a Data de referência no dia 1 desse mês. No exemplo, a 31/10/2026: Data de referência 01/09/2026, Data de início 01/09/2026 e Data de fim 30/09/2026. Para outro mês, escreva em Data de referência um dia desse mês: com 15/08/2026, as datas passam a 01/08/2026 e 31/08/2026.
5. Leia o PASSO 2 DE 3: VERIFICAÇÕES. Com o mês ainda aberto, o ecrã avisa: «O período ainda está aberto (data de bloqueio: 31/12/2025): os lançamentos até 30/09/2026 ainda podem mudar depois de gerado este ficheiro. Bloqueie o período quando for definitivo.» O aviso não impede de gerar, e a janela não bloqueia o período.
6. Em PASSO 3 DE 3: GERAR O FICHEIRO, a linha «… documentos deste período vão entrar no ficheiro.» diz quantos documentos o ficheiro vai levar, e a linha de baixo diz quantos são de cada tipo. O botão mostra o mesmo número. Em setembro, na demonstração, a janela diz «3 documentos deste período vão entrar no ficheiro.» e, por baixo, «3 documentos de venda (faturas e notas de crédito)». Num mês com guias, como outubro, a janela diz «14 documentos deste período vão entrar no ficheiro.» e, por baixo, «9 documentos de venda (faturas e notas de crédito), 4 guias de transporte, 1 documentos de conferência (orçamentos, encomendas, pró-formas)», e o ficheiro descarregado tinha esses 14 documentos. Se o mês tem documentos em rascunho, a janela acrescenta uma linha com quantos são e quanto valem, porque não entram no ficheiro: em outubro, com um rascunho de fatura de 01/10/2026, «Estes documentos do período NÃO entram no ficheiro: 1 documentos de venda em rascunho (um rascunho ainda não é um documento): 104,55 €.» Se o rascunho é uma venda que devia entrar, feche a janela, emita a fatura (Como emitir uma fatura certificada) e volte ao passo 1; se não é, apague-o ou deixe-o, porque não conta. Carregue em Gerar com … documentos. A conferência dos totais faz-se nos passos 8 e 9.
7. Abre-se o registo Exportação SAF-T (PT). Se o estado é Gerado, carregue em Descarregar ficheiro. O navegador guarda o ficheiro SAFT-PT_509999999_2026_09_F.xml.
8. Antes de entregar, confira o ficheiro. Desça até às mensagens do registo: a nota «Totais de controlo de SalesInvoices (conferidos por uma consulta SQL independente): 3 documento(s), TotalDebit 0.00, TotalCredit 5276.00.» diz quantos documentos de venda o ficheiro leva e a soma deles sem IVA: das faturas em TotalCredit, das notas de crédito em TotalDebit.
9. Compare com o que faturou. Abra Faturação › Faturar › Faturas de clientes, retire o filtro Este mês e escolha os filtros Publicada, Faturas e Data da Fatura › setembro. A coluna Sem impostos (moeda da empresa) já está na lista, e o rodapé dá a soma dela. O número de linhas tem de ser o da nota (3) e a soma tem de ser o TotalCredit: no exemplo, 3.941,00 + 1.200,00 + 135,00 = 5.276,00 €. A outra soma do rodapé (6.452,25 €) é a do Em dívida, que leva o IVA: não é a que se compara. Faça o mesmo com o filtro Notas de Crédito para o TotalDebit. Se os números não batem, não entregue: veja «Problemas frequentes».

Resultado esperado

• O registo fica no estado Gerado, com o Nome do ficheiro gerado (SAFT-PT_509999999_2026_09_F.xml no exemplo: NIF da empresa, ano, mês e modo), o SHA-256 do ficheiro, N.º de erros 0, N.º de avisos 0 e o Estado da submissão Não enviado.
• Descarregar ficheiro guarda o XML no computador. O ficheiro de setembro leva as faturas FT D26/28, FT D26/29 e FT D26/30, como a nota de controlo diz.
• Registar submissão é o passo da entrega, explicado em Como comunicar a faturação do mês à AT. O botão Submeter (canal simulado) só existe numa base de dados de teste: numa base de produção não aparece.

Vídeo demonstrativo

O vídeo mostra os passos 1 a 7: abrir Gerar SAF-T, escolher o modo F — Faturação, deixar Mês e escrever a data de referência 15/09/2026, ler o aviso do período aberto, gerar o ficheiro e descarregá-lo. Não mostra a conferência dos totais (passos 8 e 9).

No telemóvel, rode-o para a horizontal e veja o vídeo em ecrã inteiro: o texto do ecrã fica legível.

Gerar o SAF-T de faturação e descarregá-lo · 28 s · sem som, com legendas · legendas (WebVTT)

Transcrição

Notas importantes

• A janela Gerar SAF-T (PT) não bloqueia o período: o aviso do passo 5 só lembra que os lançamentos do mês ainda podem mudar.
• O ficheiro de faturação leva os documentos de venda certificados, os recibos, as guias de transporte e os documentos de conferência da empresa (o passo 3 da janela conta-os por tipo). A nota dos totais de controlo do passo 8 conta só os documentos de venda. Ficam fora os rascunhos, as faturas de fornecedores, os documentos de uma série de formação e os de outra empresa da base de dados. Pendente de validação por contabilista certificado: lista dos documentos que a lei manda pôr no SAF-T de faturação.
• O ficheiro é uma fotografia do mês no momento em que se gera. Se depois mudar alguma coisa no mês, gere de novo: cada geração é um registo novo e os antigos ficam como histórico.
• O ficheiro do mês entrega-se à AT dentro do prazo. Na demonstração, o resumo O que há para fazer com o SAF-T? dava como prazo do ficheiro de setembro de 2026 o dia 6 de outubro de 2026. Pendente de validação por contabilista certificado: prazo legal da comunicação mensal da faturação e regra quando o dia calha num feriado.
• O Tipo de produto do SAF-T de cada artigo e o NIF de cada cliente entram no ficheiro: Como criar um artigo com o IVA e o tipo certos e Como criar um cliente com os dados fiscais certos.

Problemas frequentes

A janela abre uma mensagem de erro e não cria o registo

• Sintoma: ao carregar em Gerar com … documentos, abre-se Erro de Validação, Aviso ou Operação inválida, e não aparece nenhum registo novo.
• O que fazer: veja a mensagem e a solução em O SAF-T não é gerado ou fica Inválido.

O ficheiro sai «Gerado», com avisos

• Sintoma: o registo fica Gerado, com N.º de erros 0, mas o N.º de avisos não é 0 e aparece a lista Avisos.
• Causa: o ficheiro saiu válido, mas com dados incompletos ou trocados por valores que o ficheiro aceita, por exemplo um cliente sem NIF ou uma ficha sem morada.
• O que fazer: leia cada aviso antes de entregar. O que significa cada um, quando pede uma correção na ficha ou na fatura, e um exemplo de outubro de 2026, estão em Como corrigir os erros de validação do SAF-T, secções «Cliente sem NIF: não é um erro» e «Notas importantes». Depois de corrigir uma ficha, carregue em Regenerar.

O ficheiro sai «Inválido», com erros

• Sintoma: em vez de Gerado, o registo fica Inválido, com o botão Erros e o número deles, o N.º de erros, os Erros por tipo (por exemplo «Formato ou valor inválido: 1») e o aviso «Este ficheiro está marcado como inválido. Se já corrigiu os registos listados abaixo, carregue no botão «Regenerar» acima para voltar a verificar com a versão atual do produto. Este registo fica como histórico; o ficheiro novo é um registo novo.». Não há Descarregar ficheiro.
• Causa: há documentos ou fichas do mês que a AT não aceitaria. Os erros já vistos, entre eles o do fornecedor sem NIF e em que ficheiros conta, com um exemplo até Gerado, estão em Como corrigir os erros de validação do SAF-T.
• O que fazer: cada linha da lista diz Quem corrige e tem o botão Abrir o registo a corrigir. Corrija os registos e carregue em Regenerar. Exportar erros (XLSX) dá a lista numa folha de cálculo, para a entregar a quem corrige. Não entregue um ficheiro Inválido.

Uma fatura publicada não aparece no ficheiro, ou o ficheiro sai «Inválido» por uma fatura sem série

• Sintoma: o ficheiro sai Inválido com «O documento de venda "FT/2026/00005" está lançado mas não tem série/número SAF-T (o seu diário não está certificado) — não pode ser omitido do ficheiro em silêncio. Emita-o num diário certificado ou corrija o diário antes de gerar.» Visto numa empresa de teste da demonstração com faturas antigas num diário não certificado.
• Causa: a fatura foi publicada num diário que não é certificado, por isso não tem série nem ATCUD. O fiscaldoo não a deixa de fora sem avisar.
• O que fazer: não entregue o ficheiro. Fale com o contabilista certificado e com o Responsável fiscal: o diário tem de ser certificado, ou o documento tratado de outra forma. Pendente de validação por contabilista certificado: como regularizar uma fatura publicada sem série certificada. Se o número de faturas da nota de controlo não bate com a lista (passo 9) e não houve erro, confirme a empresa e os filtros da lista.

Gerei o SAF-T e saiu com os lançamentos contabilísticos

• Causa: o Modo foi mudado para C — Contabilidade (a janela abre em F — Faturação).
• O que fazer: gere de novo com F — Faturação (passo 2). O ficheiro de contabilidade tem o seu próprio uso e prazo.