NFER
NFER APIREST JSON v1
Infraestrutura Fiscal para Desenvolvedores & ERPs

Uma única API para todas as notas fiscais do Brasil.

Automatize a emissão e gestão de NF-e (produto), NFC-e (balcão e varejo), NFS-e (padrão nacional e prefeituras), CT-e (transporte) e DC-e. Certificado digital A1 em nuvem, webhooks em tempo real e tolerância automática a falhas da SEFAZ.

Autenticação simples via X-API-KeyWebhooks HMAC em Tempo RealSandbox & Homologação Ilimitado
api.nfer.me/v1
SEFAZ 200 OK
API NF-e 55NF-e 55
API NFC-e 65NFC-e 65
API NFS-e NacionalNFS-e
API CT-e 57CT-e 57
API DC-eDC-e
POST /v1/nfe84ms · Authorized
{
  "status": "autorizada",
  "numero": 1042,
  "serie": 1,
  "chaveAcesso": "35260912345678000195550010000010421234567890",
  "protocolo": "135260000049281",
  "urls": {
    "danfe": "https://api.nfer.me/v1/nfe/nfe_.../danfe.pdf",
    "xml": "https://api.nfer.me/v1/nfe/nfe_.../xml"
  },
  "sefaz": {
    "cStat": 100,
    "xMotivo": "Autorizado o uso da NF-e"
  }
}
Tolerância a Falhas & Alta Disponibilidade

Emissão ininterrupta mesmo durante instabilidades na SEFAZ

Nosso motor gerencia filas assíncronas com retentativas inteligentes e comuta automaticamente para o Sistema Virtual de Contingência (SVC-AN / SVC-RS na NF-e) e contingência offline (NFC-e), garantindo que suas notas sejam liberadas sem travar suas vendas ou despacho.

Gerar Chave de Teste →

Catálogo de APIs Fiscais NFER

Todas as APIs que sua empresa precisa em um único lugar.

Endpoints REST JSON padronizados, com a mesma autenticação, webhooks e painel de controle centralizado para todos os modelos fiscais.

API de NF-e (Nota Fiscal de Produto)
Modelo 55 · Mercadorias

API de NF-e (Nota Fiscal de Produto)

POST /v1/nfe

Motor completo para operações de venda, devolução, remessa, consignação e exportação. Cálculo automático de tributos (ICMS, IPI, PIS, COFINS, DIFAL) e geração instantânea de DANFE oficial em PDF e XML assinado.

  • Emissão síncrona e assíncrona para lotes massivos
  • Contingência automática SVC-AN e SVC-RS sem travar despacho
  • Carta de Correção Eletrônica (CC-e) e Inutilização de Série
  • Manifestação do Destinatário (MDe) e captura de notas recebidas
API de NFC-e (Cupom Fiscal do Consumidor)
Modelo 65 · Balcão & PDV

API de NFC-e (Cupom Fiscal do Consumidor)

POST /v1/nfce

Latência ultrabaixa (< 200ms) construída especificamente para frentes de caixa e pedidos delivery. Automação de CSC, QR Code v2.0 oficial em alta resolução e layout de impressão contínua para bobinas térmicas de 80mm e 58mm.

  • Contingência offline automática (tpEmis 9) com sync posterior
  • Gestão centralizada de idCSC e tokenCSC por filial
  • Geração de QR Code 600 DPI para leitura rápida em scanners
  • Máscara de privacidade de CPF no cupom térmico (LGPD)
API de NFS-e (Nota Fiscal de Serviços)
Padrão ADN Nacional & Prefeituras

API de NFS-e (Nota Fiscal de Serviços)

POST /v1/nfse

Unificação da emissão de serviços no Brasil: integração direta ao Ambiente de Dados Nacional (ADN / DPS da Receita Federal) e provedores municipais tradicionais (GINFES, ISSNet, DSF, Bettha, Thema, e mais de 1.500 cidades).

  • Conversão automática de CNAE para Código de Tributação Nacional
  • Cálculo e retenções de ISS, PIS, COFINS, CSLL e IRRF
  • Download do DANFSE oficial em PDF e XML assinado padrão ABRASF
  • Cancelamento e substituição de NFS-e via endpoint unificado
API de CT-e (Conhecimento de Transporte)
Modelo 57 · Transporte de Cargas

API de CT-e (Conhecimento de Transporte)

POST /v1/cte

Emissão descomplicada de CT-e rodoviário e multimodal para frotistas, transportadoras e operadores de frete. Associação ágil de chaves de NF-e, cálculo de valor da prestação de serviço e geração do DACTE em PDF.

  • Vinculação em lote de chaves de NF-e e documentos anteriores
  • Cálculo automático de ICMS sobre frete normal e subcontratação
  • Geração do DACTE em formato A4 com código de barras
  • Cancelamento e eventos de desacordo do serviço de transporte
API de DC-e (Declaração de Conteúdo Eletrônica)
Declaração Oficial · Encomendas

API de DC-e (Declaração de Conteúdo Eletrônica)

POST /v1/dce

Emissão oficial de Declaração de Conteúdo Eletrônica exigida pelos Correios e transportadoras para despachos de pessoas físicas ou pessoas jurídicas não contribuintes. Geração instantânea de formulário A4 pronto para impressão.

  • Integração simples sem necessidade de inscrição estadual
  • Validação de CPF/CNPJ de remetente e destinatário
  • PDF oficial no padrão das agências de postagem brasileiras
  • Chave de acesso DFe e controle de rastreabilidade do envio
Consulta Cadastral · 27 Estados

API de Inscrição Estadual (Sintegra & CCC)

GET /api/tools/sintegra/:uf/:cnpj

Consulte a Inscrição Estadual (IE), endereço fiscal e situação de habilitado/não habilitado de qualquer cliente PJ nos 27 estados do Brasil via Cadastro Centralizado de Contribuintes (CCC) e webservices SEFAZ.

  • Validação instantânea antes de emitir NF-e (evita rejeição 232/233)
  • Detecção de contribuinte isento ou obrigado a inscrição estadual
  • Cache inteligente de alta velocidade com fallback dinâmico
  • Retorno estruturado em JSON com razão social e CNAEs
Receita Federal do Brasil

API de Consulta de CNPJ

GET /api/tools/cnpj/:cnpj

Consulta em tempo real da base da Receita Federal para enriquecer cadastros em ERPs e e-commerces: razão social, nome fantasia, endereço normalizado com CEP, CNAEs, quadro societário (QSA) e regime de tributação (Simples Nacional).

  • Autocompletar automático no checkout e cadastros de clientes
  • Identificação de optante pelo Simples Nacional e MEI
  • Normalização de logradouro, bairro, município e código IBGE
  • Tempo de resposta abaixo de 100ms via cache CDN distribuído
Monitoramento SEFAZ em Tempo Real

API de Status SEFAZ

GET /api/public/sefaz-status

Monitore programaticamente a saúde, latência e oscilações dos servidores autorizadores da SEFAZ nos 27 estados e servidores virtuais de contingência (SVC-AN e SVC-RS). Ideal para acionar fallbacks e alarmes no seu backend.

  • Status em tempo real de autorização, consulta de protocolo e lote
  • Histórico de indisponibilidade e latência média por estado
  • Detecção preventiva de janelas de manutenção de SEFAZs
  • Sem necessidade de autenticação para health-checks básicos
Pronto para Produção em Minutos

Integração simples em JSON via HTTP REST.

Não perca tempo configurando servidores SOAP, assinaturas XML manuais ou dependências locais complexas. Com o NFER, uma simples requisição HTTP POST autenticada autoriza o documento e retorna os links definitivos do PDF e XML.

Formato JSON Limpo & Intuitivo:

Esqueça schemas XML de 500 linhas. Passe apenas dados fiscais essenciais.

Assinatura A1 Transparente em Nuvem:

Seu certificado digital é armazenado com criptografia e assina na nuvem.

DANFE em PDF Pronto para Impressão:

Receba URLs públicas e seguras para download direto do PDF e XML autorizado.

cURLPOST https://api.nfer.me/v1/nfe
X-API-Key
curl -X POST https://api.nfer.me/v1/nfe \
  -H "X-API-Key: nfer_live_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "naturezaOperacao": "Venda de Mercadoria",
    "serie": 1,
    "destinatario": {
      "cpfCnpj": "12345678000199",
      "nome": "Empresa Destino LTDA",
      "ie": "123456789",
      "endereco": {
        "logradouro": "Av. Paulista",
        "numero": "1000",
        "cidade": "São Paulo",
        "UF": "SP",
        "CEP": "01310100"
      }
    },
    "itens": [
      {
        "codigo": "SKU-100",
        "descricao": "Mouse Sem Fio Ergonômico",
        "ncm": "84716053",
        "cfop": "5102",
        "quantidade": 1,
        "valorUnitario": 120.00,
        "fiscalProfileId": "perfil_produtos_eletronicos"
      }
    ],
    "pagamentos": [
      { "forma": "01", "valor": 120.00 }
    ]
  }'

Arquitetura de Emissão

Do request ao DANFE em milissegundos.

Como funciona o ciclo completo de autorização entre seu sistema, a API do NFER e a SEFAZ:

01

Autenticação & X-API-Key

Obtenha sua chave de API segura no painel NFER. Um único token concede acesso a todos os serviços com controle de permissões por empresa.

02

Envio do Payload JSON

Seu sistema faz um POST com os dados essenciais (cliente, itens, pagamento). Não precisa montar nem escapar XML manualmente.

03

Motor Fiscal & Assinatura A1

O NFER valida schemas, aplica perfis fiscais automáticos, calcula tributos e assina com seu certificado digital A1 em milissegundos.

04

Autorização SEFAZ & Webhooks

Transmissão transparente com fallback para contingência. Retorno imediato do DANFE (PDF), XML assinado e notificação via Webhook.

Feito para Engenheiros de Software

Ferramentas robustas para alta concorrência e escalabilidade.

Cada detalhe da API NFER foi projetado para eliminar dores de cabeça com certificados, rejeições SEFAZ e manutenções de layout.

Certificado Digital A1 em Nuvem Seguro

Chega de instalar DLLs ou configurar servidores Windows legados. Armazene seus certificados A1 criptografados com chaves KMS e proteção em nível de hardware (HSM).

Webhooks com Assinatura HMAC SHA-256

Receba notificações assíncronas no seu backend assim que uma nota for autorizada, rejeitada ou cancelada, com retentativas automáticas com backoff exponencial.

Perfis Fiscais Inteligentes

Reduza o payload da sua requisição em mais de 90%. Configure alíquotas de impostos (ICMS, PIS, COFINS, CFOP) por regras pré-definidas herdadas automaticamente.

Multi-CNPJ & Multi-Tenant Nativo

Gerencie holding, franquias e clientes sob uma única infraestrutura. Cada empresa possui séries, numerações e certificados digitais estritamente isolados.

Ambiente Sandbox / Homologação Ilimitado

Desenvolva e teste toda a sua esteira de emissão em ambiente de homologação SEFAZ sem custo adicional e sem risco de emissões fiscais reais.

Logs Completos de Requisições & Respostas

Depure problemas em segundos: visualize o payload exato enviado, o XML gerado, o retorno bruto da SEFAZ e os cabeçalhos de resposta no painel.

Perguntas Frequentes de Desenvolvedores

Dúvidas comuns sobre a API Fiscal NFER

Tire suas dúvidas sobre integração, homologação, webhooks, certificado digital e limites de requisição.

A autenticação é feita de forma simples e segura via cabeçalho HTTP `X-API-Key`. Você gera suas chaves no painel em `/dashboard/api` com suporte a chaves de produção e chaves de homologação/sandbox, com isolamento total entre empresas e filiais.

Ainda restou alguma dúvida?

Pergunte ao nosso agente fiscal de IA sobre regras, tributação, emissão ou integração.

Pronto para automatizar todas as suas notas fiscais via API?

Comece agora seu teste gratuito de 30 dias. Gere suas credenciais de API em segundos, teste em ambiente de homologação sem cartão de crédito e conte com o apoio dos nossos engenheiros fiscais.