Credencial Sandbox recém-criada não é reconhecida - Erro 'Unknown client

Documentos Fiscais
1

Olá, equipe da Nuvem Fiscal.

Estou tentando me autenticar na API v2 no ambiente Sandbox, mas todas as credenciais que crio retornam o erro "Unknown client".

Credencial atual (Sandbox) criada em 15/01/2026:

  • Client ID: uUFfcV1acnH7S1P3tY5Z
  • Audience: https://api.sandbox.nuvemfiscal.com.br/
  • Tipo: Sandbox (criada no Console)

Passos já realizados e resultados:

  1. Formatação da requisição: Seguindo a documentação, faço um POST para https://auth.nuvemfiscal.com.br/oauth/token com Content-Type: application/x-www-form-urlencoded.

    • Corpo: grant_type=client_credentials&client_id=uUFfcV1acnH7S1P3tY5Z&client_secret=MEU_CLIENT_SECRET&scope=nfe

  2. Resposta consistente: Sempre recebo:

    {"error":"invalid_client","error_description":"Unknown client: uUFfcV1acnH7S1P3tY5Z"}

  3. Testes de diagnóstico realizados:

    • Conexão com API Sandbox: GET https://api.sandbox.nuvemfiscal.com.br retorna 401 Unauthorized (conexão OK).
    • Teste com credenciais inválidas: Usando client_id=teste123, recebo {"error":"invalid_request","error_description":"Missing required parameter: client_id"}. Isso prova que o servidor de autenticação está acessível e processando parâmetros, mas minha credencial válida não é encontrada.
    • Já criei e excluí múltiplas credenciais Sandbox (incluindo uma anterior: HmzdfusslwqG41awCfpup) com o mesmo erro.

Conclusão e solicitação:
Aparentemente, as credenciais do tipo Sandbox criadas no Console não estão sendo propagadas ou registradas corretamente no servidor de autenticação (auth.nuvemfiscal.com.br).

Podem verificar o status da credencial uUFfcV1acnH7S1P3tY5Z no sistema de autenticação? Há algum passo adicional necessário para ativar credenciais Sandbox na API v2?

Agradeço desde já pela ajuda.

2

Boa noite, @thiago.belache. Seja bem-vindo à Nuvem Fiscal.

Analisando o caso, a credencial Sandbox em si está válida e ativa. O erro de “Unknown client” ocorreu porque o Client ID informado não corresponde exatamente ao gerado no Console.

No exemplo citado, houve um erro de digitação: o valor correto do 7º caractere é a letra “L” minúscula (l), e não o número “1”. Esse tipo de divergência faz com que o servidor de autenticação não reconheça o cliente.

Após ajustar o Client ID exatamente como exibido no Console, a autenticação deverá funcionar normalmente.

Recomendamos que utilize o recurso “copiar e colar” ou realize o download das credenciais diretamente do Console Web:

image
image1132×1272 215 KB