Portal das Finanças - Questões frequentes https://info.portaldasfinancas.gov.pt/infofaqs/listafaqs.aspx?

subarea=264

Quest . Informát icas For mat ação de Ficheir os

01-0027 ÀÀNas especif icações do webser v ice o campo ” TaxExempt ionReason‘ est á limit ado a um conj unt o de códigos.
Deve o campo cor r espondent e do SAF-T ser t ambém pr eenchido com est es códigos?
Não. No SAF-T este campo é do tipo texto e deve ser preenchido com o descritivo do preceito legal aplicável (ver
Notas Técnicas do campo 4.1.4.18.14 –TaxExemptionReason da Portaria 382/2012 de 23 de Novembro ou campo  onde
são indicadas as situações a a forma como o campo deve ser preenchido). Contudo, nada invalida que no campo do
SAFT, além do descritivo, seja também acrescentado esse código.

LEGISLAÇÃO:
Diploma  Portarias Número:1192 Data:10/8/2009
Diploma  Portarias Número:382 Data:11/23/2012

02-0082 ÀÀUma empr esa obr igada a pr oduzir f icheir o SAF-T pode opt ar pelo env io dos element os das f at uras at ravés de
webser v ice?
Os sujeitos passivos obrigados a produzir um ficheiro SAF-T podem optar pelo envio da informação por transmissão
eletrónica de dados, em tempo real (webservice).
Porém, essa possibilidade só existe quando o sistema de faturação cumpra os requisitos de emissão de faturas
eletrónicas, constantes do n.º 10 do artigo 36.º do Código do IVA e do Decreto-Lei n.º 196/2007, de 15 de maio.

03-0083 ÀÀQuando uma empr esa emit e simult aneament e f at uras elet r ónicas e f at uras em supor t e de papel, pode env iar
os seus element os para a AT por webser v ice?
A Lei prevê a ligação ao sistema da AT, via webservice, apenas dos sistemas de faturação eletrónica. O que é
relevante é o sistema e não o suporte das faturas que ele emite. Para que as empresas possam enviar os elementos
das faturas exclusivamente através de webservice, é necessários que se cumpram todos os seguintes requisitos:
i) Que as faturas sejam emitidas por um sistema informático de faturação;
ii) Que o sistema respeite as regras de faturação eletrónica constantes do n.º 10 do artigo 36.º do CIVA, e do
Decreto-Lei n.º 196/2007, de 15 de maio (nomeadamente que seja garantida a autenticidade da origem, a
integridade do conteúdo e a legibilidade através de quaisquer controlos de gestão que criem uma pista de auditoria
fiável).
Não é relevante que os sistemas, que cumpram os requisitos antes enunciados, emitam todas as faturas em suporte
eletrónico, em papel, ou em ambos os tipos de suporte. O que é relevante é que o sistema cumpra todos os
requisitos acima enunciados. Se assim for, as empresas podem enviar todos os elementos de comunicação obrigatória
respeitantes às faturas emitidas através de webservice.

04-0170 ÀÀSou empr esár io em nome indiv idual e emit o f at uras manuais, pr é-impr essas em t ipograf ia aut or izada pelo
Minist r o das Finanças. Faço o r espet ivo r egist o de f at uração no sit e e-f at ura. Ao r egist ar os element os das f at uras
exist e um "Código de cont r olo" que não t enho?
O preenchimento do campo "codigo de controlo" não é obrigatório. Pode enviar/comunicar as faturas sem preencher
este código.

05-0178 ÀÀUm pr ograma que pr oduza o f icheir o SAF-T (PT) pelas r egras da Por t ar ia n. º 1192/ 2009 est á em condições
de pr oduzir o f icheir o pr ev ist o na alínea b) do ar t . º 3º do Decr et o-Lei nº 198/ 2012 ou é necessár io pr oduzir um
f icheir o dif er ent e?
Foi publicada a Portaria 382/2012, de 23 de novembro, que adapta a estrutura do ficheiro SAF-T (PT) às novas regras
dos Decreto-Lei nº 197/2012 e Decreto-Lei nº 198/2012, ambos de 24 de agosto, nomeadamente no que se refere aos
tipos de documentos que podem ser emitidos.
A nova portaria da estrutura SAF-T (PT) entrará em vigor a 01/05/2013.
A AT disponibiliza, no portal das finanças (site e-fatura), um aplicativo conversor que, aquando da submissão do
ficheiro SAF-T (PT), seleciona os dados referidos no n.º 4 do art. 3º do DL 198/2012, de 24 de agosto.
Após a extração desses dados, é gerado um ficheiro autónomo, que pode ser guardado pelos agentes económicos,
sendo os elementos constantes desse ficheiro enviados para os sistemas da AT.

1 de 5 16-06-2017 10:50
Portal das Finanças - Questões frequentes https://info.portaldasfinancas.gov.pt/infofaqs/listafaqs.aspx?subarea=264

06-0180 ÀÀSe t iver vár ios post os de f at uração, dever ei ent r egar um f icheir o SAF-T (PT) por cada post o de f at uração? E
se t iver um sist ema que int egr e a f at uração emit ida por esses post os?
Existe uma obrigação de comunicação de alguns elementos de todas as faturas emitidas. Deste modo, pode fazê-lo
através da submissão de vários SAF-T (PT), de onde serão extraídos automaticamente, pelo sistema e-fatura, os
dados constantes no nº 4 do art. 3º do DL 198/2012 de 24 de agosto, um por cada programa ou posto de faturação. Se
tiver um sistema integrador, que contenha toda a faturação dos vários postos, pode submeter apenas um ficheiro, de
onde será extraída a informação obrigatória.

07-0181 ÀÀA par t ir de 01 de 2013 o nosso sist ema passa a emit ir f at uras e f at uras simplif icadas. No ent ant o, a Por t ar ia
nº 382/ 2012, de 23 de novembr o, pr evê a exist ência do campo f at ura simplif icada ("FS"), só ent ra em v igor a
01/ 05/ 2013. Como expor t ar essas f at uras at é essa dat a?
As faturas simplificadas deverão ser exportadas usando o código "FS".

08-0182 ÀÀRelat ivament e ao ut ilizador r esponsável pela invocação do webser v ice, qual o signif icado de ” subut ilizador
do NIF emit ent e com per f il WFA‘ ?
Relativamente ao significado do termo subutilizador informamos o seguinte:
Os serviços disponibilizados no Portal das Finanças para os agentes económicos podem ser utilizados por diferentes
técnicos na mesma empresa. Por exemplo, num Banco, o envio da Modelo 10 pode ser efetuado por um técnico, a
resposta a penhoras por outro e a participação num leilão de bens penhorados por outro técnico.
Nestas circunstâncias, o administrador da empresa teria que facultar a senha de acesso ao Portal das Finanças a estes
três técnicos, não lhe sendo possível saber quem efetuou a respetiva operação.
Para resolver este problema, foi disponibilizada uma funcionalidade no Portal das Finanças (Serviços
Tributários/Outros Serviços/Gestão de utilizadores) que permite ao detentor do NIF e respetiva senha de acesso,
criar um perfil de “subutilizador”.
A cada “subutilizador” pode ser atribuída permissão para efetuar só determinadas operações (perfis).
Por ex: para o contribuinte com o NIF 505089765, os “subutilizadores” serão 505089765/1, 505089765/2, etc. A senha
de acesso destes “subutilizadores” é atribuída pelo contribuinte quando cria cada “subutilizador”.
Assim, sugerimos a criação de “subutilizadores”, a quem será atribuído o perfil WFA, e cada “subutilizador” e a
respetiva senha de acesso serão colocados no header de segurança do webservice, que envia as faturas de um
determinado contribuinte (e não o NIF e a sua senha de acesso).

09-0183 ÀÀO nosso sist ema de f at uração t em a cer t if icação da AT nº XXXX, e é uma aplicação que disponibilizamos v ia
Web, ser v indo de aplicação de f at uração para vár ias ent idades. Nest e caso, é necessár io o pedido de um cer t if icado
(CSR) para cada ent idade?
Nestes casos basta solicitar um certificado por produtor de software.

10-0185 ÀÀOnde posso obt er inf or mação para t est ar o env io dos element os obr igat ór ios das f at uras por webser vice?

Pode encontrar toda a informação necessária para envio dos elementos das faturas por webservice na zona de
produtores de software, disponível no Portal das Finanças, no site e-fatura https://faturas.portaldasfinancas.gov.pt
/home.action.

11-0186 ÀÀA empr esa pr odut ora do sof t war e a disponibilizar o Cer t if icado digit al de t est es ("Test es Web ser v ices. pf x") e
a Chave publica para a cif ra da passwor d de acesso ("ChavePublicaAT. cer ") a par ceir os e client es, para est es
ef et uar em os t est es?
Sim. O certificado digital de testes é público e igual para todos.

12-0187 ÀÀAo validar o f icheir o SAFT (PT) no sit e e-f at ura inf or ma a mensagem de er r o ” Ficheir o inválido‘ . Qual o er r o
possível?
A mensagem que lhe foi dada de “ficheiro inválido”, significa que o ficheiro que está a tentar submeter tem
problemas de estrutura face às regras de construção constantes na Portaria 1192/2009.
Mais se informa que poderá validar os seus ficheiros SAFT através da aplicação constante em
http://info.portaldasfinancas.gov.pt/apps/saft-pt01/local/setup.exe, online em
http://info.portaldasfinancas.gov.pt/apps/saft-pt/, ou ainda através da aplicação
http://info.portaldasfinancas.gov.pt/apps/saft-pt01/local/validador.exe..
Um dos erros mais comuns é a utilização do caratere "&" na designação da empresa ou em qualquer outro campo. O
XML tem um significado próprio para este caratere. A alternativa é substituir o caratere "&" por "&", sempre que seja
utilizado no ficheiro.
Ainda segundo as instruções do schema publicado, o campo CompanyID deve ser preenchido com a designação da
Conservatória do Registo Comercial, seguido do número de Registo Comercial ou, em alternativa a estes, com o NIF.
Acontece que o padrão para o campo não prevê que a designação da Conservatória tenha mais que uma palavra ou
que contenha o caractere ".".
Assim, na designação da CompanyID, devem ser substituídos no nome da conservatória eventuais espaços e pontos

2 de 5 16-06-2017 10:50
Portal das Finanças - Questões frequentes https://info.portaldasfinancas.gov.pt/infofaqs/listafaqs.aspx?subarea=264

por traços. (Exemplos: “A. dos Vinhos 600" deve escrever-se como “Arruda-dos-Vinhos 600”), “C.R.C” deve
escrever-se “C-R-C”.
Outro erro comum é o código postal, que deve ser escrito no formato normalizado (Exemplo “1269-3” deve
escrever-se como “1269-003”).

13-0188 ÀÀPr et endo comunicar os element os obr igat ór ios das f at uras à AT por r emessa de um f icheir o nor malizado
est r ut urado com base num f icheir o SAFT (PT) e por webser v ice. Quais as inst r uções a seguir ?
As instruções necessárias estão descritas no seguinte documento:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/AC494AE7-7E41-41C9-991B-15C3F0126ABF
/0/ComunicacaodosdadosdasfaturasaAT.pdf.

14-0189 ÀÀOnde posso obt er o WSDL para comunicação dos element os de comunicação obr igat ór ia das f at uras por
webser v ice?
O WSDL pode ser obtido no seguinte endereço:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/02357996-29FC-4F11-9F1D-6EA2B9210D60/0/factemiws.wsdl.

15-0190 ÀÀPr oduzo sof t war e de cont abilidade e gest ão e pr et endo env iar os dados de comunicação obr igat ór ia das
f at uras por webser v ice. O que devo f azer ?
O site e-fatura dispõe de uma página com informação específica para os produtores de software (endereço no menu
de rodapé, em todo o site, com o título “produtores de software”) e que está disponível no seguinte
endereço:https://faturas.portaldasfinancas.gov.pt/painelInicialProdSoftware.action.
Nesta página encontra informação de apoio ao desenvolvimento e um formulário para solicitar a adesão ao serviço de
envio de dados de faturas. Em termos gerais, os passos que deverá seguir são:
1. Obter o WSDL do serviço na página de apoio ao desenvolvimento, no seguinte endereço:
https://faturas.portaldasfinancas.gov.pt/testarLigacaoWebService.action;
2. Implementar no software de contabilidade o envio dos dados, utilizando o WSDL e o documento de apoio ao
desenvolvimento, onde estão definidos os campos do Webservice e informação complementar para o apoio ao
desenvolvimento. Este documento está disponível em: http://info.portaldasfinancas.gov.pt/NR/rdonlyres
/AC494AE7-7E41-41C9-991B-15C3F0126ABF/0/ComunicacaodosdadosdasfaturasaAT.pdf;
3. Testar o serviço, utilizando o endereço disponível para os produtores de software verificarem a correta
implementação da invocação do Webservice, no seguinte endereço, que apenas difere do de produção (a utilizar
pelos clientes do vosso software) no porto: em desenvolvimento é no porto 700. a. O endereço de testes é o
seguinte (porto 700): https://servicos.portaldasfinancas.gov.pt:700/fews/faturas; b. Devem utilizar o NIF/ Userid +
Password que identifica o produtor de software perante o Portal das Finanças. Embora existam credenciais de testes,
é aconselhada a utilização das próprias credenciais do produtor de software, para efeitos de melhor despiste de
situações anómalas.
4. Ao mesmo tempo que se inicia o desenvolvimento, os produtores de software devem solicitar a adesão ao
serviço de envio de dados por Webservice, utilizando o formulário disponível para o efeito no seguinte endereço:
 https://faturas.portaldasfinancas.gov.pt/aderirServicoProdSoftwareForm.action;
5. Quando terminar o desenvolvimento, deve passar a utilizar o endereço de produção, onde cada cliente terá
que indicar ou configurar, no vosso software, as credenciais do utilizador do portal das finanças que irá enviar os
dados.
a)      Endereço de produção (porto 400):
https://servicos.portaldasfinancas.gov.pt:400/fews/faturas - ATENÇÃO: todos os dados comunicados pelo porto 400
são aceites como dados reais de produção e, por isso, não pode ser utilizado para a realização de testes;
b)      Utilizar as credenciais que o vosso cliente criou no portal das finanças para utilização deste serviço, por exemplo:
999999999/1 + Password;
c)      Cada cliente tem de usar as suas credenciais e devem criar um “subutilizador” do portal das finanças, no seguinte
endereço, e atribuindo as operações autorizadas “WFA – Comunicação de dados de faturas”
https://www.portaldasfinancas.gov.pt/pt/listAuthorizedUsers.action.
6. A comunicação de dados em produção tem que ser efetuada com recurso à utilização de um certificado SSL,
gerado pelo produtor de software, e submetido à AT para validação no pedido de adesão ao serviço. Mais
informações constantes no documento de apoio disponível em:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/AC494AE7-7E41-41C9-991B-15C3F0126ABF
/0/ComunicacaodosdadosdasfaturasaAT.pdf;
7. Existe informação de apoio na página de produtores de software, disponível na opção de menu “produtores
de software”, no rodapé do site e-fatura, através da secção de “Apoio ao Desenvolvimento”, ou utilizar o seguinte
endereço: https://faturas.portaldasfinancas.gov.pt/testarLigacaoWebService.action.

Cada produtor de software deve solicitar um certificado SSL assinado pela AT para que seja possível aos softwares
produzidos o envio de dados em produção. O formulário de pedido de adesão, bem como os termos e condições de
utilização estão disponíveis no site e-fatura, no menu dos produtores de software (menu de rodapé) e na secção de
“Aderir ao Serviço”, ou em alternativa no seguinte endereço:
https://faturas.portaldasfinancas.gov.pt/aderirServicoProdSoftwareForm.action..

16-0191 ÀÀAo validar o f icheir o SAFT (PT) no Por t al das Finanças, nos validador es disponíveis na opção ” Apoio ao
Cont r ibuint e‘ , dá o er r o ” Ficheir o inválido‘ . Qual o er r o possível?

3 de 5 16-06-2017 10:50
Portal das Finanças - Questões frequentes https://info.portaldasfinancas.gov.pt/infofaqs/listafaqs.aspx?subarea=264

Os validadores disponíveis no Portal da Finanças (Apoio ao contribuinte, SAF-T PT (Standard Audit File for Tax
purposes) - Versão Portuguesa e http://info.portaldasfinancas.gov.pt/apps/saft-pt01/local/validador.exe.) verificam
a existência da tabela de produtos. No site e-fatura, o ficheiro SAFT (PT) é aceite sem a tabela de produtos, pelo
que, neste caso, deverá ignorar os erros do validador do Portal das Finanças.

17-0193 ÀÀAo env iar o f icheir o SAF-T (PT) dá o er r o ’ Ocor r eu um er r o ao enviar o f icheir o÷ o que devo f azer ?

Deverá verificar que não existem problemas no acesso à internet, e que a sua ligação está ativa.
Deverá ainda verificar que não existe uma firewall/proxy a bloquear o acesso ao e-fatura
(http://faturas.portaldasfinancas.gov.pt/).
Caso exista um proxy configurado para acesso à internet, é necessário efetuar a seguinte parametrização do Java no
Control Panel: 

1. No Java Control Panel selecionar ‘Network Settings’.

2. Em ‘Network Settings’ indicar a opção ‘Use proxy server’ e selecionar ‘Advanced’.
3. Em ‘Advanced Network Settings’ preencher o endereço de proxy e respetivo porto para o tipo ‘Socks’, indicar
‘Use same proxy Server for all protocols’ e confirmar selecionando ‘OK’.

18-1128 ÀÀComo expor t ar um f icheir o SAF-T de aut of at uração, para que sej a válido no validador do e-f at ura?

O ficheiro de autofaturação tem que conter os seguintes elementos (conforme referidos no documento
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/AC494AE7-7E41-41C9-991B15C3F0126ABF
/0/FACTEMI_Fatura_comunicacao_de_dadospubcv6.pdf):
1 - Cabeçalho (Header);
2.2 - Tabela de Clientes (Customer);
2.5 - Tabela de Impostos (TaxTable);
4.1 - Documentos Comerciais de Clientes (SalesInvoice).
Como se trata de um ficheiro de autofaturação, o Cabeçalho (Header) deve estar preenchido com os dados do
Fornecedor e a tabela de Clientes deverá ter um único cliente (que é o contribuinte que se autofatura).
No Header, o elemento TaxAccountingBasis deve estar preenchido com “S”, o elemento SelfBillingIndicator com o
valor “1”. O elemento “InvoiceStatus” dos Documentos Comerciais a Clientes (SalesInvoice) também deverá ser
preenchido com “S”.
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/02357996-29FC-4F11-9F1D-6EA2B9210D60/0/factemiws.wsdl.

LINKS:
http://info.portaldasfinancas.gov.pt/NR/rdonlyres/02357996-29FC-4F11-9F1D-6EA2B9210D60/0/factemiws.wsdl.

19-1287 ÀÀComo são pr ocessados os f icheir os SAFT?

Os ficheiros SAFT submetidos com sucesso são lidos “fatura a fatura”.

O período indicado aquando da submissão não é relevante para as faturas que são lidas. O sistema lê todas as faturas,
podendo integrá-las, rejeitá-las ou considerá-las duplicadas.
Por isso, as situações de processamento dos ficheiros previstas são:
Pendente - quando ainda espera processamento;
Integrado com sucesso - quando todas as faturas do ficheiro foram registadas na base de dados da AT;
Rejeitado - quando se detetou um problema a nível de conteúdo que impediu o respetivo processamento
Integrado parcialmente - quando algumas das faturas não foram registadas na base de dados da AT, por algum dos
seguintes motivos:
Faturas duplicadas
As faturas duplicadas são aquelas que são exatamente iguais às que já se encontram registadas no e-fatura.
Faturas rejeitadas
As faturas rejeitadas, ocorrem por diversos motivos, entre os quais:
            Anulação de document o r egist ado: o documento é igual a um documento já existente no sistema, à exceção
do estado de documento que foi alterado para anulado.
            Document o r egist ado com valor es dif er ent es: o documento já existe no sistema, apesar de constar com
valores diferentes.
            Tipo de document o inválido: os tipo de documentos considerados são:
FT                   Fatura
FS                  Fatura Simplificada
ND                  Nota de débito
NC                  Nota de crédito
FR       Fatura-recibo
            Qualquer outro tipo de documento constante no ficheiro será rejeitado com a informação de “Tipo de
documento inválido”. No SAFT o campo onde consta a informação do tipo de documento é o “4.1.4.7. * Tipo de
documento (InvoiceType)“.
Estado de documento inválido
O estado do documento consta no SAFT no campo “4.1.4.2.1. * Estado atual do documento
(InvoiceStatus)”.
Os estados de documentos recolhidos são (os restantes serão considerados inválidos por não ser relevante a
sua recolha):
“N” — Normal;
“S” — Autofaturação;

4 de 5 16-06-2017 10:50
Portal das Finanças - Questões frequentes https://info.portaldasfinancas.gov.pt/infofaqs/listafaqs.aspx?subarea=264

“A” — Documento anulado;             

            Document o inválido por valor es anómalos
Um dos erros comuns na construção de ficheiros SAFT é a existênia de valores anómalos (demasiado elevados), por
vários motivos (por ex. inserção de um nif no campo do valor da fatura, ou inexistência de separador decimal).
Quando este erro aparece deve-se tentar apurar quais os valores efetivamente comunicados no SAFT.
 
Os ficheiros são processados na sua globalidade e uma só vez. Não existe processamento de faturas individualizadas
num determinado ficheiro.

20-1389 ÀÀNão est ou obr igado legalment e a t er pr ograma de f at uração cer t if icado nem a pr oduzir o f icheir o SA-T (PT).
Cont udo o meu pr ograma est á cer t if icado e pr oduz um f icheir o SAF-T (PT) de acor do com as nor mas da por t ar ia.
Posso usar esse f icheir o para f azer a comunicação das f at uras?
Sim. Feita essa opção, deverá comunicar as faturas emitidas através do envio do ficheiro SAF-T (PT), nos termos da
alínea b) do n.º 1 do artigo 3.º do DL 198/2012, de 24 de agosto. No momento da submissão do ficheiro SAF-T (PT)
são extraídos automaticamente, pelo sistema e-fatura, os dados referidos no nº 4 do art. 3º do referido diploma,
sendo criado um ficheiro autónomo.

5 de 5 16-06-2017 10:50