NFS-e | Como resolver P9999 - Token ou senha ausente, inválido ou expirado - EL30

As mensagens abaixo indicam uma falha na autenticação municipal utilizada pelo padrão EL30:

• P9999-Parâmetro Token: Não informado ou inválido! ()
• P9999-Parâmetro Token: Expirado! ()
• Erro ao Resolver - Parâmetro Extra "Senha" não possui valor

No EL30, a autenticação é feita pelo parâmetro extra Senha, preenchido com o token fornecido no portal da prefeitura. Esse token é uma credencial municipal vinculada ao prestador.

O token municipal não é o token utilizado para autenticar requisições na API do PlugNotas e não deve ser incluído no JSON ou no TX2 da NFS-e.

Como resolver

1. Acesse o portal da prefeitura com os dados do prestador.
2. Gere ou consulte o token utilizado para comunicação por WebService.
3. Se a mensagem indicar que o token expirou, gere um novo token. Tokens vencidos, revogados ou substituídos deixam de ser aceitos.
4. Grave o token no campo Senha da autenticação da prefeitura no cadastro do prestador.
5. Salve a configuração e faça uma nova emissão para validar.

Configuração por produto

PlugNotas: edite o cadastro da empresa, acesse a configuração de NFS-e e a autenticação com a prefeitura. Informe o token municipal no campo Senha.

Manager SaaS: acesse as configurações do prestador e a autenticação com a prefeitura. Informe o token no campo Senha. Quando o município exigir apenas o token, o campo de login não precisa ser preenchido.

Componente NFS-e: configure o parâmetro extra Senha na autenticação do prestador, utilizando o token fornecido pelo portal municipal.

Exemplo apenas de formato da configuração:

Senha=TOKEN_GERADO_NO_PORTAL_DA_PREFEITURA

O token é uma credencial e não deve ser compartilhado em conversas, imagens ou exemplos públicos.

Validação após o ajuste

Depois de atualizar a autenticação, realize uma nova emissão. Uma nota criada anteriormente pode conservar o processamento ou o retorno da tentativa feita com a credencial ausente ou inválida.

O código P9999 também pode acompanhar mensagens diferentes. Se o complemento indicar 502 Bad Gateway, timeout ou outra falha de comunicação, a causa não é necessariamente o token. Considere sempre a mensagem completa retornada.

Consulte também a Documentação Técnica do padrão EL30.