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.
Primeiros passos
Do token à primeira NFS-e em homologação.
Referência da API
Todos os endpoints, parâmetros e respostas.
Autenticação
Client credentials, conta e validade do token.
Novidades
O que mudou na API e no portal.
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
| Garantia | Como funciona |
|---|---|
| Segurança | OAuth 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íncrona | A 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ência | Idempotency-Key obrigatória em toda emissão: repetir a chamada nunca emite duas notas. Veja Idempotência. |
| Isolamento | Todo dado pertence a um emitente da sua conta. Recurso de outra conta responde 404. |
| Erros padronizados | Todo erro sai em Problem Details (RFC 9457), com o caminho JSON de cada campo inválido. |
| Rastreabilidade | Toda resposta traz o header X-Request-Id. Informe-o no Atendimento. |
| Limite de uso | 60 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.