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 é diferente do token utilizado para autenticar requisições na API do PlugNotas. Ele deve ser configurado na autenticação do prestador, em vez de 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

Como o token é uma credencial, recomendamos mantê-lo protegido e evitar sua exposição 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.