Atendimento

Autenticação

OAuth 2.0 client credentials, conta do token e validade.

A API usa OAuth 2.0 com o fluxo client credentials: o seu servidor troca o client id e o client secret por um access token (JWT) e o envia em toda chamada:

Authorization: Bearer <access_token>

Gerando o token

curl -s https://auth.u2dtecnologia.com.br/realms/u2d-nota-fiscal/protocol/openid-connect/token \
  -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials
  • No Sandbox, o token sai do realm u2d-nota-fiscal-sandbox, com as credenciais do Sandbox (veja Ambientes).
  • As credenciais vão no header Authorization: Basic (o -u do curl), como recomenda a RFC 6749.
  • O token vale 5 minutos (expires_in: 300) e não tem refresh token: perto de expirar, peça outro com as mesmas credenciais.
  • Guarde o token em memória no servidor e reaproveite-o. Pedir um token por chamada deixa a integração mais lenta.

O secret nunca vai para o navegador ou app

O fluxo client credentials é para servidor. Não use o secret em front-end, app mobile ou repositório de código. Se ele vazar, peça a troca pelo Atendimento.

Conta do token

Cada client pertence a uma conta, e a API usa o token para saber de quem é a chamada. Você nunca envia o id da conta: os emitentes cadastrados ficam na conta do token, e as consultas só enxergam os dados dela. Recurso de outra conta responde 404, como se não existisse.

O que a conta pode emitir depende dos produtos contratados, não de escopos do token: veja Conta e emitentes.

Rotas sem autenticação

RotaPara quê
GET /api/v1/status-servicoStatus dos web services da SEFAZ por UF (Status da SEFAZ)
GET /public/statusStatus da própria API (Ambientes)

Erros de autenticação

StatustypeQuandoHeader WWW-Authenticate
401nao-autenticadoToken ausenteBearer
401nao-autenticadoToken inválido, expirado ou de outro ambienteBearer error="invalid_token"
403acesso-negadoToken válido, mas sem conta associadaBearer error="insufficient_scope"
403conta-inativaA conta foi desativada—

Num 401 com invalid_token, gere um token novo e repita a chamada uma vez. Se persistir, confira as credenciais do ambiente.

Nesta página