Visão Geral da Plataforma
A Nota Fiscal API é uma solução corporativa projetada para conectar sistemas de faturamento, ERPs, e-commerces e plataformas SaaS diretamente aos órgãos fiscais autorizadores brasileiros:
- SEFAZ Estadual: Emissão e consulta de NF-e (Modelo 55) e NFC-e (Modelo 65) via SOAP mTLS e mensageria XML-DSig.
- ADN Receita Federal: Emissão de NFS-e Padrão Nacional via Declaração de Prestação de Serviços (DPS).
Diferenciais de Arquitetura
Ao contrário de agregadores de notas tradicionais que cobram por volume e introduzem filas opacas:
- Comunicação Direta: Os certificados digitais A1 da sua empresa (ou dos seus clientes em SaaS) comunicam-se de forma ponta a ponta com a SEFAZ.
- Determinismo & Idempotência: Cada requisição de emissão aceita um cabeçalho
Idempotency-Key(RFC 7231 / IETF draft). Em caso de timeout ou reconexão, o mesmo resultado é retornado sem gerar notas duplicadas ou números fiscais queimados. - Multi-Tenancy Estrito: Isolamento total entre clientes, com chaves de API específicas por empresa e separação inviolável entre Homologação e Produção.
- DANFE em PDF com Alta Fidelidade: Geração local instantânea em milissegundos sem depender de bibliotecas externas lentas ou serviços de terceiros.
Fluxo Geral de Integração
mermaid
sequenceDiagram
autonumber
actor Cliente as Seu Sistema / ERP
participant API as Nota Fiscal API
participant Sefaz as SEFAZ / Receita Federal
Cliente->>API: POST /v1/invoices/nfe (Payload JSON)
Note over API: Assina XML (XML-DSig)<br/>Gera Chave de Acesso (44 dígitos)<br/>Valida Regras Tributárias
API->>Sefaz: Envio do Lote SOAP (mTLS)
Sefaz-->>API: Protocolo de Autorização (cStat: 100)
API-->>Cliente: Retorno JSON com Chave, Protocolo e XML Autorizado
Cliente->>API: GET /v1/invoices/:id/pdf
API-->>Cliente: DANFE em PDF Oficial