Atendimento

Sobre a API U2D Nota Fiscal

Emita NFS-e, NF-e e NFC-e a partir do seu sistema com uma única integração REST.

A API U2D Nota Fiscal é a forma de emitir e acompanhar notas fiscais eletrônicas a partir do seu ERP, e-commerce ou PDV. Você envia um JSON com os dados da operação; a U2D calcula tributos e totais, numera, assina com o certificado A1 do emitente, transmite à SEFAZ ou à Sefin Nacional e guarda o XML autorizado.

O que a API oferece

  • NFS-e do Padrão Nacional (DPS na Sefin Nacional): emissão, cancelamento, substituição e DANFSe.
  • NF-e (modelo 55) para qualquer UF: emissão com cálculo de ICMS, ST, DIFAL, IPI, PIS, COFINS e IBS/CBS, cancelamento, carta de correção, inutilização e DANFE.
  • NFC-e (modelo 65): emissão por código de produto, contingência offline automática, DANFCe em bobina de 80 ou 58 mm, cancelamento e inutilização.
  • Cadastros por emitente: certificado A1, CSC, séries, clientes, produtos e tabelas fiscais oficiais (NCM, CEST, cClassTrib).
  • Webhook a cada mudança de status de uma nota, assinado com HMAC.

Cada tipo de nota é um produto contratado pela sua conta. Produto não contratado responde 403 (veja Conta e emitentes).

Garantias da plataforma

GarantiaComo funciona
SegurançaOAuth 2.0 (client credentials) com tokens de 5 minutos e TLS em toda chamada. Certificado A1 e CSC ficam cifrados e nunca voltam pela API.
Emissão assíncronaA emissão responde 202 na hora e transmite em segundo plano: a SEFAZ lenta ou fora do ar não trava o seu sistema. Veja Ciclo de status.
IdempotênciaIdempotency-Key obrigatória em toda emissão: repetir a chamada nunca emite duas notas. Veja Idempotência.
IsolamentoTodo dado pertence a um emitente da sua conta. Recurso de outra conta responde 404.
Erros padronizadosTodo erro sai em Problem Details (RFC 9457), com o caminho JSON de cada campo inválido.
RastreabilidadeToda resposta traz o header X-Request-Id. Informe-o no Atendimento.
Limite de uso60 requisições por minuto por client, com 429 e Retry-After ao exceder. Veja Rate limit.

URL base

https://api.u2dnotafiscal.com.br          # Produção
https://api-sandbox.u2dnotafiscal.com.br  # Sandbox (testes)

Todas as rotas começam com /api/v1. O status de cada ambiente pode ser conferido no botão API Status, no topo da página.

Nesta página