Saltar para o conteúdo principal
Pendente de validaçãoOdoo 20.0Community e Enterprise

Como corrigir os erros de validação do SAF-T

Para que serve?​

Um ficheiro SAF-T Inválido não se entrega. O registo da exportação lista cada erro, diz quem o corrige e leva ao registo a corrigir. Depois de corrigir, gera-se de novo e confirma-se que o ficheiro passa a Gerado.

Quando utilizar?​

Onde encontrar?​

Contabilidade › Declarar › Ficheiro SAF-T › O que há para fazer com o SAF-T?, lista de apoio SAF-T gerados, e abra o registo Inválido. Também se chega lá pela Exportação SAF-T de uma comunicação mensal.

Antes de começar​

  • Para ler a lista e regenerar: perfil Contabilista ou acima. Os passos e o exemplo foram feitos com o perfil Contabilista, até ao ficheiro Gerado.
  • Para corrigir: cada linha diz Quem corrige (por exemplo «Quem mantém os contactos (Contabilista ou Faturação)»). Se não é o seu perfil, envie-lhe a lista (passo 3).

Como utilizar​

  1. Abra o registo Exportação SAF-T (PT) no estado Inválido. O cabeçalho mostra o N.º de erros e os Erros por tipo. No exemplo, o ficheiro C — Contabilidade de outubro de 2026: 1 erro, «Formato ou valor inválido: 1». O N.º de avisos de um registo inválido fica em 0, porque a geração parou antes de os contar: os avisos aparecem no registo novo (passo 6).
  2. Desça até à lista Erros. Cada linha tem o Tipo, o Nó (onde fica no ficheiro), a Chave (o registo com o problema, por exemplo o nome do fornecedor), a Mensagem, Quem corrige, a Sugestão e o botão Abrir o registo a corrigir.
  3. A lista corta os textos longos. Para os ler inteiros, ou para os mandar a quem corrige, carregue em Exportar erros (XLSX): o navegador guarda uma folha de cálculo (no exemplo, saft_erros_10.xlsx, com as colunas Tipo, Nó, Chave, Mensagem, Sugestão, Registo a corrigir e Quem corrige).
  4. Em cada linha, carregue em Abrir o registo a corrigir. Abre-se o registo certo (no exemplo, a ficha do fornecedor Fornecedor Sem NIF Exemplo, Lda). Corrija o que a Mensagem diz (para um NIF em falta, escreva no campo do NIF o número fiscal que está na fatura do fornecedor; num NIF português aparece NIF válido, num de outro país NIF por validar), guarde e volte ao registo da exportação pelo trilho do topo. Antes de corrigir, leia a tabela abaixo: um NIF não se inventa.
  5. Carregue em Regenerar. O fiscaldoo gera um ficheiro novo, num registo novo; o registo antigo fica como histórico.
  6. Leia o registo novo. Se ainda tem erros, repita os passos 2 a 5. Quando fica Gerado, com N.º de erros 0, leia os avisos (veja «Notas importantes») e:

Os erros vistos e onde se corrigem​

Erro (mensagem do ecrã)Onde se corrigeEstado hoje
«O quê: o fornecedor «…» não tem NIF. Porquê: a Autoridade Tributária exige o NIF de todos os fornecedores no ficheiro, e o NIF genérico de consumidor final só existe para clientes. Como: preencha o NIF no contacto do fornecedor (consta da fatura recebida) e gere o ficheiro outra vez.»Ficha do fornecedorNos ficheiros C e I, pelas faturas de compra. Escreva na ficha o NIF do fornecedor, guarde e carregue em Regenerar (veja «Fornecedor sem NIF», abaixo). No F, só com uma guia de devolução emitida a esse fornecedor antes de o fiscaldoo recusar a guia sem NIF: veja «Problemas frequentes».
«O fornecedor Consumidor-final é usado nos documentos de transporte mas não está no ficheiro.» (tipo Referência órfã)Não se corrige na fichaSó no F, ao lado do erro anterior, numa guia de devolução a um fornecedor que foi emitida como dirigida a um consumidor final, antes de o fiscaldoo recusar a guia sem NIF. Veja «Problemas frequentes».
«O documento de venda "…" 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.»Diário e documentoVeja «Problemas frequentes» em Como gerar o ficheiro SAF-T de faturação.

Fornecedor sem NIF​

  • Nos ficheiros de contabilidade: um ficheiro C — Contabilidade ou I — Contabilidade integrada com a faturação fica Inválido quando o período tem uma fatura de compra de um fornecedor cuja ficha não tem NIF.
  • No ficheiro de faturação: o ficheiro F — Faturação do mês não leva os fornecedores das faturas de compra, por isso não fica Inválido por elas. Na demonstração, com a fatura do fornecedor já lançada, o F de outubro de 2026 ficou Gerado, sem esse fornecedor no ficheiro descarregado, e o C do mesmo mês ficou Inválido, com este erro e mais nenhum (exemplo abaixo). Pendente de validação por contabilista certificado: ficheiro SAF-T de faturação sem a tabela dos fornecedores das faturas de compra (Portaria n.º 302/2016, anexo I).
  • A guia de devolução, no ficheiro de faturação: o F leva o fornecedor a quem o mês tem uma guia de devolução (a devolução de mercadoria recebida dele), com o NIF dele. Por isso o fiscaldoo não emite essa guia a um fornecedor sem NIF: «O quê: o fornecedor «Fornecedor Devolução Sem NIF, Lda» não tem NIF. Porquê: um fornecedor é um sujeito passivo, por isso a guia que lhe devolve mercadoria tem de indicar o NIF (DL 147/2003, art. 4.º n.º 2 c)). Como: preencha o NIF na ficha do fornecedor (consta da fatura recebida) e emita a guia de novo.» A recusa não propõe outra saída. Na demonstração, depois de escrito o NIF 510000061 (fictício) na ficha, a guia saiu como GD D26/1, e o F de outubro ficou Gerado, com 0 erros e esse fornecedor no ficheiro descarregado, com o NIF.
  • O que fazer: escreva na ficha o NIF que está na fatura do fornecedor e guarde. Num ficheiro C ou I inválido, carregue depois em Regenerar (exemplo abaixo); numa guia de devolução, emita-a só depois de escrito o NIF. Um NIF não se inventa, e o NIF 999999990 de consumidor final não serve a um fornecedor: a mensagem diz que esse NIF só existe para clientes.

Cliente sem NIF: não é um erro​

Uma fatura a um cliente sem NIF, de Portugal ou de outro país, não deixa o ficheiro Inválido: o ficheiro declara o cliente como «Consumidor final», com o NIF 999999990 e o país dele, como o código QR da fatura, e o registo fica Gerado, com um aviso na lista Avisos.

Na demonstração, o mês de outubro de 2026 tinha a FT D26/33 ao Cliente Sem NIF Exemplo (Portugal, sem NIF) e a FT D26/36 ao Cliente Particular Espanha (Espanha, sem NIF), de 10,00 € + 2,30 € de IVA cada uma. Com o perfil Contabilista, Gerar SAF-T com F — Faturação e outubro de 2026 deu Gerar com 14 documentos (a janela conta 9 documentos de venda, 4 guias de transporte e 1 documento de conferência), e o registo ficou Gerado, com 0 erros e 5 avisos:

  • um aviso por cada um dos dois clientes sem NIF;
  • 3 de morada do Cliente Alemanha Exemplo GmbH, cuja ficha não tem rua, localidade nem código postal.

O aviso do cliente de Espanha:

«O quê: o cliente «Cliente Particular Espanha» não tem NIF. Porquê: a fatura foi emitida a consumidor final (o código QR leva o NIF 999999990), por isso o ficheiro declara-o da mesma forma: CustomerTaxID 999999990, nome «Consumidor final» e país «ES». Como: não há nada a fazer neste ficheiro. Um documento emitido nunca se altera, por isso um NIF preenchido na ficha depois só vale para os documentos emitidos a seguir. Para identificar este cliente numa fatura já emitida, corrija-a com uma nota de crédito que lhe faça referência e emita uma fatura nova com o NIF (a nota de crédito corrige a fatura, não a anula; para anular, fale com o contabilista certificado).»

No ficheiro descarregado, esse cliente é Consumidor-final-ES, com o NIF 999999990 e o país ES, e o de Portugal é Consumidor-final, com o NIF 999999990 e o país «Desconhecido». O aviso do cliente de Portugal diz o mesmo: «… por isso o ficheiro declara-o da mesma forma: CustomerTaxID 999999990, nome «Consumidor final» e país «Desconhecido».» O ficheiro não tem nenhum fornecedor: a fatura de compra do exemplo abaixo não conta para ele.

Porque é que o país é «Desconhecido», se a ficha diz Portugal? Não é um erro, e não tem de corrigir nada. Quando um cliente de Portugal não dá o NIF, o fiscaldoo declara-o sempre no ficheiro como o consumidor final genérico, sem país, mesmo que a ficha tenha País Portugal. Foi uma escolha feita para não mudar o que o ficheiro certificado declara; o cliente de outro país leva o país dele, como o de Espanha. Pendente de validação por contabilista certificado: país do consumidor final português no SAF-T («Desconhecido» ou PT).

O aviso não pede nada para o ficheiro. Se o cliente quer a fatura com o NIF dele, ou é uma empresa, a questão é a fatura: o que fazer, com o exemplo da FT D26/36 corrigida, está em O SAF-T não é gerado ou fica Inválido, secção «O cliente é de outro país e não tem NIF». Pendente de validação por contabilista certificado: venda a um particular de outro país que não dá número fiscal, declarada como consumidor final com o NIF 999999990 e o país do cliente (Portaria n.º 302/2016, anexo I, ponto 2.2.3).

Exemplo completo, até Gerado​

Feito na Empresa Demonstração, Lda, a 31/10/2026, com o perfil Contabilista. Antes, ficou lançada a fatura de fornecedor FTF/2026/00046 (referência do fornecedor FT 2026/88, de 28/10/2026, 100,00 € + 23,00 € de IVA), de uma ficha nova, Fornecedor Sem NIF Exemplo, Lda, criada com País Portugal e sem NIF. O lançamento dessa fatura: débito de 100,00 € em 6221 Trabalhos especializados e de 23,00 € em 2432 IVA - Dedutível, e crédito de 123,00 € em 2211 Fornecedores gerais.

  1. Gerar SAF-T com F — Faturação e outubro de 2026 (Data de referência 15/10/2026): Gerar com 14 documentos, registo Gerado, com 0 erros e os 5 avisos de «Cliente sem NIF: não é um erro». O ficheiro descarregado não tem nenhum fornecedor.
  2. Gerar SAF-T com C — Contabilidade e o mesmo mês: o botão diz Gerar com 48 documentos e o registo fica Inválido, com 1 erro, «Formato ou valor inválido: 1», e N.º de avisos 0. Na lista Erros, o Nó é MasterFiles/Supplier/tax_id, a Chave é «Fornecedor Sem NIF Exemplo, Lda» e a Mensagem é a da tabela acima. Quem corrige: «Quem mantém os contactos (Contabilista ou Faturação)». O histórico do registo diz «Geração do SAF-T (PT) bloqueada: 1 erro(s) de integridade referencial. Nenhum ficheiro foi produzido.»
  3. Exportar erros (XLSX) guardou saft_erros_10.xlsx, com uma linha.
  4. Abrir o registo a corrigir abriu a ficha Fornecedor Sem NIF Exemplo, Lda, sem aviso no topo. Escreveu-se o NIF 510000053 (fictício), apareceu NIF válido e guardou-se.
  5. De volta ao registo pelo trilho do topo, Regenerar criou um registo novo: Gerado, N.º de erros 0, N.º de avisos 17, ficheiro SAFT-PT_509999999_2026_10_C.xml, com Descarregar ficheiro. A nota de verificação do registo diz «Transactions = lançamentos publicados do período: 48 de 48 — OK», o mesmo número do botão do passo 2.

Resultado esperado​

  • O registo novo fica Gerado, com N.º de erros 0, e já se pode descarregar e entregar.
  • Os registos inválidos anteriores ficam na lista SAF-T gerados como histórico. Corrigir um erro não cria lançamentos contabilísticos (no exemplo, corrigir a ficha e regenerar não criaram nenhum); uma correção que obrigue a emitir um documento (por exemplo, uma nota de crédito) segue o artigo desse documento.

Notas importantes​

  • Regenerar usa a versão atual dos dados e do produto. Se os erros já estavam corrigidos quando o ficheiro foi gerado, carregue em Regenerar e o ficheiro novo passa.
  • Os avisos não tornam o ficheiro inválido, mas dizem o que saiu incompleto. No exemplo, os 17 avisos do registo novo são:
    • 9 do nome dos lançamentos de venda do mês, um por lançamento, por exemplo «O quê: o nome do lançamento «FT D26/33» tinha espaços, que foram removidos no TransactionID, onde o nome fica «FTD26/33». Porquê: o TransactionID do SAF-T é a data, o diário e o nome sem espaços (o padrão do ficheiro não admite espaços). Como: não há nada a fazer; o lançamento mantém o nome que tem.»;
    • 6 de morada, três por ficha, da ficha do fornecedor do exemplo e da do Cliente Alemanha Exemplo GmbH: «O quê: a morada não tem rua. Porquê: o ficheiro exige-a e foi escrito «Desconhecido». Como: preencha a rua no contacto.», e o mesmo para a localidade e o código postal;
    • 2 dos clientes sem NIF tratados como consumidor final (acima).
  • Preencha a morada na ficha de um cliente ou fornecedor real e carregue em Regenerar antes de entregar. A ficha Consumidor final é a de quem não se identifica: não lhe escreva a morada de um cliente (no exemplo, não deu avisos). Pendente de validação por contabilista certificado: morada e país «Desconhecido» do cliente consumidor final no SAF-T.
  • Não entregue um ficheiro Inválido.

Problemas frequentes​

Corrigi tudo e o ficheiro continua «Inválido»​

  • Causa: está a olhar para o registo antigo, ou falta um erro de outro tipo.
  • O que fazer: o Regenerar abre o registo novo; confirme que é esse que está a ver (a data e a hora estão no nome). Leia de novo a lista Erros do registo novo.

O ficheiro de faturação ficou «Inválido» por um fornecedor sem NIF​

  • Sintoma: um registo com o Modo F — Faturação fica Inválido, com o erro do fornecedor sem NIF (nó MasterFiles/Supplier/tax_id) e, ao lado, a Referência órfã «O fornecedor Consumidor-final é usado nos documentos de transporte mas não está no ficheiro.» (nó SourceDocuments/MovementOfGoods/StockMovement/SupplierID).
  • Causa: o mês tem uma guia de devolução a um fornecedor sem NIF, emitida como dirigida a um consumidor final antes de o fiscaldoo passar a recusar essa guia (veja «Fornecedor sem NIF»). Um fornecedor é um sujeito passivo: a guia saiu mal, sem o NIF do destinatário. Hoje, a guia já não se emite assim, por isso a demonstração não permite refazer este caso.
  • O que fazer: não trate este erro como um dado da ficha. Uma guia emitida não se altera, e escrever o NIF na ficha não muda o que a guia diz. Fale com o Responsável fiscal e com o contabilista certificado, que decidem o que fazer à guia já emitida (por exemplo, anulá-la e emitir outra com o NIF, se a mercadoria ainda não saiu). Pendente de validação por contabilista certificado: o que fazer a uma guia de devolução já emitida a um fornecedor sem o NIF dele.
  • Se o mês não tem nenhuma guia a esse fornecedor: o F não devia ficar Inválido por ele. Envie ao suporte a folha de Exportar erros (XLSX) e o nome do registo.

Não sei o que fazer com uma mensagem​

  • O que fazer: carregue em Exportar erros (XLSX) e envie a folha ao contabilista certificado ou ao suporte, com o nome do registo (empresa, data e hora).
Atualizado em 5 de novembro de 2026Versões: Odoo 20.0Community e Enterprisefiscaldoo 20.0 (master 27cebe13a)ID DOC-0054
Esta página foi útil?