Casos de Uso (Use Cases)
Arquiteturas de integração e fluxos para SaaS, e-commerce, marketplaces, PDVs e transportes.
A plataforma NFER foi projetada para unificar toda a infraestrutura fiscal brasileira em uma única camada programática. Atendemos desde criadores digitais e SaaS até grandes e-commerces, transportadoras, imobiliárias e contabilidades.
Você pode operar 100% via API REST JSON integrada ao seu produto ou pelo Painel Web Executivo (Dashboard) para gestão financeira, auditoria e emissões manuais. Abaixo você encontra os padrões arquiteturais, cenários reais e os principais casos de uso suportados nativamente.
Digital & Creators
Soluções completas para automação de checkout, blindagem contra reembolsos e divisão tributária exata entre co-produtores e afiliados.
Infoprodutores
NFS-e emitida a cada venda aprovada com retenção e regra do CDC (7 dias de garantia para evitar cancelamentos).
Coprodutores
Emissão proporcional ao percentual de split contratual, evitando bitributação fiscal entre sócios de lançamento.
Afiliados
Emissão automatizada de NFS-e sobre comissões liberadas de plataformas (Hotmart, Kiwify, Eduzz, Braip).
Dropshipping
NFS-e faturada exclusivamente sobre a taxa de intermediação de negócios (margem líquida), sem tributar o produto importado.
Vendas & Tech
APIs de alta performance para emissão em tempo real, integração com gateways de pagamento, esteiras de armazém e frotas.
SaaS & Recorrência
NFS-e disparada a cada fatura paga via Stripe, Asaas ou Pagar.me com resolução automática do código de tributação nacional.
E-commerce & D2C
NF-e modelo 55 a cada pedido pago com DANFE simplificado para expedição, cálculo de DIFAL e contingência SVC automática.
Desenvolvedores & ERPs
API REST moderna, Servidor MCP nativo, webhooks em tempo real e SDKs para embutir emissão fiscal completa na sua aplicação.
Logística & Cargas
CT-e (57), MDF-e (58) de transporte interestadual e DC-e para encomendas enviadas via Correios e transportadoras.
Serviços & Imóveis
Emissão descomplicada de taxas de gestão, retainers mensais de consultoria, contratos fixos e esteiras contábeis em lote.
Agência & Consultoria
NFS-e automática de retainers mensais de publicidade, desenvolvimento, tráfego pago e consultorias com disparo por e-mail.
Imobiliária & Aluguel
NFS-e faturada exclusivamente sobre a taxa de administração e corretagem, blindando o repasse do aluguel ao proprietário.
Corretor de Imóveis
NFS-e de intermediação imobiliária e comissões de fechamento de venda ou locação, sem precisar de sistemas legados de prefeitura.
Prestador de Serviços B2B
Emissão simplificada via NFS-e Nacional com cálculo automático de retenções federais (IRRF, PIS, COFINS, CSLL e ISSQN).
Mensalidades Recorrentes
Cobrança de aluguel e contratos fixos com macros dinâmicas ({MES_EXTENSO}/{ANO}) no texto fiscal sem tocar no código todo mês.
Contador & BPO Fiscal
Emita e concilie notas de toda a carteira de clientes pelo mesmo painel com programa de parceiros e comissões vitalícias.
Padrões Arquiteturais de Integração
Exemplos de fluxo e chamadas de API mais utilizadas em produção pelos nossos clientes.
1. SaaS & Cobrança Recorrente (Assinaturas via Webhook)
Plataformas de software recebem confirmação de fatura via webhook do gateway de pagamento (Stripe, Asaas, Pagar.me, Iugu). O backend da sua aplicação aciona a NFER para emissão da NFS-e Nacional:
- Chamada Imediata: Disparo de
POST /v1/nfsecom tomador inline e código tributário (cTribNac: "010701"para licenciamento de software). - Webhook Reverso: Ao autorizar no Ambiente de Dados Nacional (ADN), o webhook
nfse.autorizadaenvia o link do PDF do DANFSE e o XML para você enviar por e-mail ao cliente. - Operação Manual: O time financeiro pode emitir notas complementares, corrigir e-mails ou cancelar no painel com 1 clique.
2. E-commerce & D2C (Mercadorias, Armazém & Expedição)
Em lojas virtuais (Shopify, WooCommerce, VTEX ou checkout próprio), a velocidade de autorização libera a esteira de embalagem imediatamente:
- Emissão Resiliente: Envio de
POST /v1/nfe. Se a SEFAZ do estado do emitente estiver fora do ar, o motor chaveia automaticamente para contingência SVC (SVC-AN ou SVC-RS). - DANFE Simplificado: URL direta em alta resolução para imprimir a etiqueta de caixa e despachar aos Correios/transportadora.
- Pós-Venda: Emissão de devoluções com vínculo à chave original (
chaveReferenciada) e cancelamento em até 24 horas.
3. Infoprodutos, Coprodução & Split Fiscal Híbrido
Para lançamentos digitais com múltiplos parceiros de negócio e vendas híbridas (curso online + livro físico/e-book):
- Split Híbrido de Checkout: Um carrinho único contendo mentoria (NFS-e de serviço municipal) e material físico (NF-e mercantil estadual) é faturado com duas notas distintas sem complicação para o comprador.
- Coprodução Proporcional: O produtor e o coprodutor emitem suas notas cada um com sua porcentagem exata, sem repasse informal e com contabilidade 100% blindada.
- Regra de 7 Dias do CDC: Programe a emissão automática para o 8º dia pós-compra, eliminando cancelamentos causados por reembolsos solicitados na garantia legal.
4. Contratos Fixos e Mensalidades com Macros Dinâmicas
Ideal para imobiliárias, agências, condomínios e contabilidades que cobram valores fixos mensalmente:
- Macros Automáticas no Texto Fiscal: Utilize variáveis como
{MES_EXTENSO},{ANO}e{COMPETENCIA}no corpo da discriminação. A NFER substitui em tempo de emissão (ex.: "Honorários ref. Outubro/2026"). - Disparo Agendado: As notas são emitidas automaticamente no dia fixado do mês, com envio de XML e DANFE ao cliente por e-mail sem precisar de intervenção manual.
5. Varejo Físico e Pontos de Venda (PDVs com NFC-e)
Em caixas de lojas, mercados e quiosques com fila de clientes:
- NFC-e em Milissegundos: Retorno imediato do cupom fiscal com texto ESC/POS para impressoras térmicas de 80mm e 58mm e URL do QR Code da SEFAZ.
- Contingência Offline Segura: Se a internet cair, a NFC-e é emitida localmente pelo PDV em contingência offline e transmitida automaticamente assim que a conexão retornar.
6. Monitor Fiscal DF-e (Captura de Notas de Fornecedores e Compras)
Capture todas as notas fiscais emitidas contra o CNPJ da sua empresa sem depender de envio manual de XML por fornecedores:
- Varredura via NSU: Consulta automática no Ambiente Nacional da SEFAZ trazendo NF-e, NFS-e e CT-e recebidos.
- Manifestação do Destinatário (MD-e): Realize Ciência da Emissão ou Confirmação da Operação via API (
POST /v1/mde) ou com 1 clique pelo Painel. - Download Automático: XML completo com validade jurídica e DANFE em PDF disponibilizados imediatamente para seu ERP e contabilidade.
Comparativo: Via API REST vs. Painel Web
Toda operação fiscal pode ser realizada tanto de forma 100% programática quanto manualmente pelo seu time:
| Operação Fiscal | Via API REST (Backend) | Pelo Painel Web (Dashboard) |
|---|---|---|
| Emissão de Notas | 100% programática via chamadas POST em milissegundos. | Emissão manual através de formulário guiado passo a passo. |
| Auditoria e Consultas | Webhooks em tempo real e endpoints de polling (GET). | Visualização em listagens com filtros por CPF/CNPJ, status e datas. |
| Download de DANFE / XML | URLs públicas assinadas retornadas no payload JSON. | Botões de download individual ou exportação em lote (ZIP mensal). |
| Cancelamento e CC-e | Endpoints dedicados para cancelamento e carta de correção. | Ações diretas na página de detalhes de cada documento emitido. |
| Configuração Cadastral | Provisionamento de empresas, certificados e séries via API. | Upload visual de Certificado Digital A1 e configuração de CSC. |
| Notas Recorrentes | Criação de contratos de assinatura via endpoint POST. | Agendamento visual de mensalidades com controle de status e macros. |