Atendimento

Ambientes

URLs da API e do servidor de autorização, e o ambiente fiscal de cada emitente.

AmbienteAPIToken (OAuth 2.0)
Produçãohttps://api.u2dnotafiscal.com.brhttps://auth.u2dtecnologia.com.br/realms/u2d-nota-fiscal/protocol/openid-connect/token
Sandboxhttps://api-sandbox.u2dnotafiscal.com.brhttps://auth.u2dtecnologia.com.br/realms/u2d-nota-fiscal-sandbox/protocol/openid-connect/token
  • Sandbox é o ambiente de testes da integração: mesmo contrato da produção, com dados separados. Comece por ele.
  • Produção é onde ficam os seus emitentes e notas reais.

As credenciais são por ambiente: um token de um ambiente responde 401 no outro.

Ambiente fiscal do emitente

Separado do ambiente da API, cada emitente tem um ambiente fiscal obrigatório, escolhido no cadastro:

ambientePara onde a nota vaiEfeito
HOMOLOGACAOHomologação da SEFAZ / produção restrita da Sefin NacionalSem valor fiscal. O DANFE sai com "SEM VALOR FISCAL" e o DANFSe com "NFS-e SEM VALIDADE JURÍDICA".
PRODUCAOProdução da SEFAZ / Sefin NacionalNota com valor jurídico.

Nota autorizada em produção não se desfaz

Uma nota autorizada com o emitente em PRODUCAO tem efeito fiscal e só pode ser cancelada dentro do prazo legal. A API nunca assume produção por padrão: troque o ambiente do emitente só depois de validar o fluxo em homologação.

A nota usa o ambiente que o emitente tinha no momento da emissão.

Status

O botão API Status, no topo do portal, consulta cada ambiente na hora, direto do seu navegador:

  • Operacional: a API está respondendo normalmente.
  • Indisponível: a API respondeu, mas um serviço interno está fora do ar. Novas emissões podem falhar.
  • Sem resposta: a API não respondeu em 5 segundos (rede, DNS ou indisponibilidade total).

O mesmo dado está em GET <API>/public/status de cada ambiente, sem autenticação, para quem quiser monitorar:

{ "status": "UP", "checkedAt": "2026-11-14T13:02:11.512Z" }

A rota responde 200 com UP ou 503 com DOWN. O resultado é reaproveitado por até 15 segundos. O status dos web services da SEFAZ de cada UF é outra rota: veja Status da SEFAZ.

Nesta página