Ambientes
URLs da API e do servidor de autorização, e o ambiente fiscal de cada emitente.
| Ambiente | API | Token (OAuth 2.0) |
|---|---|---|
| Produção | https://api.u2dnotafiscal.com.br | https://auth.u2dtecnologia.com.br/realms/u2d-nota-fiscal/protocol/openid-connect/token |
| Sandbox | https://api-sandbox.u2dnotafiscal.com.br | https://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:
ambiente | Para onde a nota vai | Efeito |
|---|---|---|
HOMOLOGACAO | Homologação da SEFAZ / produção restrita da Sefin Nacional | Sem valor fiscal. O DANFE sai com "SEM VALOR FISCAL" e o DANFSe com "NFS-e SEM VALIDADE JURÍDICA". |
PRODUCAO | Produção da SEFAZ / Sefin Nacional | Nota 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.