A AT recusa as credenciais (utilizador ou senha)
Sintoma
Uma comunicação à Autoridade Tributária (AT), por exemplo Comunicar à AT numa série, abre Operação inválida a dizer que as credenciais não estão completas e que não foi enviado nada. Ou a AT responde que o utilizador ou a senha estão errados.
Como se criam as credenciais está em Como ligar o fiscaldoo à Autoridade Tributária. Este artigo trata do que corre mal depois.
Mensagem
Vista com o administrador da demonstração, na Empresa Demonstração, Lda, depois de eliminadas as suas credenciais da AT (a demonstração traz credenciais fictícias). Numa série nova em Rascunho (FT E2T26, [FT] Fatura, diário Vendas, exercício 2027), Comunicar à AT:
«A empresa Empresa Demonstração, Lda não tem credenciais da AT completas para o ambiente teste (utilizador, palavra-passe, certificado e chave privada), por isso não foi enviado nada. A Administração fiscal pode introduzi-las em Contabilidade › Configurar › Faturação certificada › Credenciais da AT.»
Na mensagem, «teste» é o Ambiente escolhido nas credenciais: o ambiente de testes da AT.
A AT recusa o utilizador ou a senha. Com credenciais completas, mas sintéticas (o aviso de credenciais incompletas desapareceu e Usado para envio ficou marcado), e o simulador da AT no cenário de autenticação recusada, numa série nova FT C27 (exercício 2027, em Rascunho): Comunicar à AT abre a janela Comunicar a série à Autoridade Tributária, com o que vai ser enviado. Depois de marcar «Confirmo que estes dados estão corretos e podem ser comunicados» e carregar em Comunicar, a série:
- continua Rascunho;
- mostra por cima a resposta da AT, com o código: «[99] Simulated rejection»;
- fica com Comunicação com a AT em Rejeitada.
O texto «Simulated rejection» é do simulador da AT da base de testes. A AT verdadeira devolve o seu próprio texto. Pendente de validação no ecrã: o código e o texto que a AT verdadeira devolve para um utilizador ou uma senha errados não foram vistos (a AT verdadeira não se usa nos testes).
Em Credenciais da AT › Novo, só com o Utilizador do webservice preenchido, o formulário avisa por cima:
«Estas credenciais estão incompletas: falta(m) palavra-passe, certificado de cliente, chave privada. Enquanto não forem preenchidas, esta empresa não pode comunicar com a Autoridade Tributária.»
Causas verificadas
- A empresa não tem credenciais da AT, ou estão incompletas. O fiscaldoo só comunica com o utilizador do webservice, a palavra-passe, o certificado de cliente e a chave privada todos preenchidos, e a chave pública da AT do ambiente escolhido. Numa base de testes, o simulador da AT pede o mesmo que a AT verdadeira: sem credenciais completas, recusa antes de enviar.
- A série tem outro problema antes das credenciais. Na mesma série com o exercício 2026, Comunicar à AT foi recusado antes, porque a série
FT D26já estava ativa para [FT] Fatura em 2026. Esse caso está em Não há uma série ativa para este documento, ou há mais do que uma. - O servidor não tem a chave de cifra do cofre. Guardar as credenciais dá «Este servidor não tem chave de cifra para o cofre de credenciais, por isso nada foi guardado nem revelado…». Visto nesta ronda; a solução é do administrador de sistema e está em Ligar à AT, Problemas frequentes.
- A AT recusa o utilizador ou a senha. O fiscaldoo envia, a AT recusa e a resposta fica na série: Comunicação com a AT em Rejeitada e o código e o texto da AT por cima da série. A série não é ativada. Na base de testes, o simulador dá «[99] Simulated rejection».
O que confirmar
- Em Contabilidade › Configurar › Faturação certificada › Credenciais da AT, se há uma linha da empresa para o Ambiente em uso (testes ou produção) e se Usado para envio está marcado nela.
- No formulário, o aviso «Estas credenciais estão incompletas: falta(m) …» e o que ele lista.
- Válido até (do certificado) e Chave pública da AT válida até.
- No Portal das Finanças, que o Utilizador do webservice é um subutilizador da empresa, escrito como
NIF/número(por exemplo509999999/1), com a senha atual e as permissões dos serviços que vai usar (séries, faturas, guias de transporte). Pendente de validação no ecrã: a criação do subutilizador e a escolha das permissões no Portal das Finanças não foram vistas.
Como resolver
Feito com o administrador da demonstração. As Credenciais da AT são do administrador e da Administração fiscal (ver Ligar à AT, «Antes de começar»).
- Abra Contabilidade › Configurar › Faturação certificada › Credenciais da AT e a linha da empresa e do ambiente (ou Novo, se não houver).
- Preencha o que o aviso lista em falta: Utilizador do webservice, Palavra-passe do webservice, o Ficheiro do certificado (.pfx) com a Palavra-passe do .pfx (o certificado e a chave privada são extraídos ao gravar) e a Chave pública da AT (PEM).
- Guarde e confirme que o aviso de credenciais incompletas desaparece.
- Volte ao documento ou à série e carregue de novo em Comunicar à AT.
Se a série ficar com Comunicação com a AT em Rejeitada e a resposta da AT disser que o utilizador ou a senha estão errados: entre no Portal das Finanças com o NIF da empresa, confirme o subutilizador e a senha (e as permissões), corrija a Palavra-passe do webservice no fiscaldoo e comunique de novo. Uma senha mudada no Portal tem de ser mudada também no fiscaldoo.
Resultado esperado
- Comunicar à AT deixa de dar a recusa de credenciais e a série deixa de ficar Rejeitada. A série segue para o código de validação (Série sem código de validação).
- O formulário das credenciais deixa de mostrar o aviso «Estas credenciais estão incompletas…».
Quando contactar o suporte
- As credenciais estão completas, sem aviso, e a recusa «não tem credenciais da AT completas» continua.
- O Portal das Finanças aceita o subutilizador e a senha e a AT continua a recusar a comunicação do fiscaldoo.
Informação a enviar
- A empresa e o ambiente (testes ou produção).
- O texto completo da mensagem, copiado do ecrã. Nunca envie a senha nem o certificado.
- O que foi comunicado (série ou documento) e quando.
- O perfil com que entrou.