Automação

Automação de Faturamento NF-e no E-commerce e ERP: CFOP, NCM, Carta de Correção e Cancelamento

Passo a passo para automatizar rotinas de faturamento de mercadorias (Modelo 55) no ERP: validação de NCM/CFOP, Carta de Correção (CC-e) e cancelamento na SEFAZ.

Fábio Magalhães CostaAtualizado em 22/10/2026
Fluxo automatizado de emissão de NF-e via API REST conectada à SEFAZ

Fluxo automatizado de emissão de NF-e via API REST conectada à SEFAZ

A automação do fluxo de faturamento de mercadorias em sistemas de e-commerce, atacadistas e ERPs exige sincronia entre pedido aprovado, validação cadastral de produtos (NCM/CEST/CFOP) e eventos pós-venda como Carta de Correção Eletrônica (CC-e).

📌 Buscando a documentação principal da API NF-e Gratuita (Modelo 55)?
Acesse o guia pilar oficial: API NF-e Gratuita: Como Emitir Nota Fiscal de Produto (Mod 55/65) via REST, com 20 emissões grátis/mês em produção real e exemplos rápidos de integração.

Em 2026, com o início das adaptações para a Reforma Tributária (campos de IBS/CBS estabelecidos pela NT 2025/2026), manter uma infraestrutura própria conectada diretamente via SOAP à SEFAZ tornou-se uma das tarefas mais caras e propensas a falhas na engenharia de software brasileira.

Neste guia técnico completo, você aprenderá a estruturar um fluxo robusto de emissão de NF-e via API REST utilizando o motor fiscal da Notaas com emissão em milissegundos e entrega de DANFE e XML em nuvem.


🏗️ Ciclo de Vida da Emissão de NF-e via API

⚡ Fluxo de Processamento NF-e na Notaas:

  • 1. Requisição JSON: Seu sistema envia os dados fiscais via POST /api/v1/emitir.
  • 2. Validação de Regras de Negócio (MOC 7.0): Validação prévia de NCM, CFOP, CRT e regras interestaduais de ICMS.
  • 3. Assinatura Digital em HSM: O XML é assinado com seu Certificado Digital A1 em ambiente isolado e seguro.
  • 4. Transmissão para a SEFAZ Autorizadora: Envio para a SEFAZ do estado de origem (ou SVRS/SVAN em contingência).
  • 5. Webhook com DANFE e XML: Recebimento do status de autorização, chave de acesso de 44 dígitos e link do PDF.

📡 Exemplo Completo de Payload JSON para NF-e (Modelo 55)

Esqueça as centenas de linhas de XML aninhado. Veja como emitir uma NF-e com produtos, tributação Simples Nacional e pagamento via PIX:

curl -X POST https://platform.notaas.com.br/api/v1/emitir \
  -H "Content-Type: application/json" \
  -H "X-API-Key: sk_live_sua_chave_aqui" \
  -d '{
    "tipo": "nfe",
    "ambiente": "producao",
    "referencia": "pedido_ecommerce_10928",
    "naturezaOperacao": "Venda de mercadoria",
    "prestador": {
      "cnpj": "12345678000195"
    },
    "tomador": {
      "cpfCnpj": "01234567890",
      "razaoSocial": "Consumidor Final Exemplo",
      "email": "cliente@email.com",
      "indicadorIe": 9,
      "endereco": {
        "logradouro": "Rua das Flores",
        "numero": "123",
        "bairro": "Centro",
        "codigoMunicipio": "3550308",
        "cep": "01001000",
        "uf": "SP"
      }
    },
    "itens": [
      {
        "codigo": "SKU-MONITOR-27",
        "descricao": "Monitor Gamer 27 polegadas 165Hz IPS",
        "ncm": "85285200",
        "cfop": "5102",
        "unidadeComercial": "UN",
        "quantidade": 1,
        "valorUnitario": 1250.00,
        "tributos": {
          "icms": {
            "origem": 0,
            "cst": "102"
          }
        }
      }
    ],
    "transporte": {
      "modalidadeFrete": 0
    },
    "pagamento": {
      "formas": [
        {
          "meio": "pix",
          "valor": 1250.00
        }
      ]
    }
  }'

Resposta Imediata (HTTP 202 Accepted):

{
  "id": "not_nfe_789123456",
  "status": "processing",
  "referencia": "pedido_ecommerce_10928",
  "chaveAcesso": null,
  "createdAt": "2026-09-04T22:30:00.000Z"
}

🛑 Como Lidar com Rejeições Comuns da SEFAZ

Quando a SEFAZ rejeita um lote, entender o motivo em sistemas legados é um pesadelo de parsing de XML. Na Notaas, a rejeição é devolvida em JSON semântico:

Código SEFAZ Motivo Como Resolver
Rejeição 228 Data de Emissão muito atrasada Ajustar o fuso horário (dhEmi) de acordo com o limite de tolerância da SEFAZ.
Rejeição 778 Informado NCM inexistente Validar o código na tabela de NCMs vigentes antes da transmissão.
Rejeição 539 Duplicidade de NF-e Utilizar uma nova numeração ou consultar a chave original emitida.
Rejeição 232 IE do destinatário não informada Definir indicadorIe: 9 para não contribuinte ou enviar a IE válida.

❓ Perguntas Frequentes (FAQ)

Como funciona o cancelamento de uma NF-e via API?

Basta realizar uma chamada POST /api/v1/cancelar enviando a chave de acesso da nota e a justificativa legal (com no mínimo 15 caracteres), respeitando o prazo legal de 24 horas estabelecido pela SEFAZ.

A Notaas gera o DANFE em PDF automaticamente?

Sim. Assim que a SEFAZ autoriza a nota, a Notaas renderiza o DANFE em alta resolução e disponibiliza uma URL em CDN segura, pronta para impressão ou envio por e-mail para o comprador.


📚 Referências Oficiais & Guias Técnicos:


🚀 Comece a Emitir NF-e via API Hoje Mesmo

  • 🎁 20 notas fiscais gratuitas por mês em ambiente de produção real.
  • ⚡ Sem fidelidade e sem burocracia: Crie sua conta e configure em minutos.
  • 📦 Suporte a NF-e (Mod 55), NFC-e (Mod 65) e NFS-e Nacional.

👉 Criar Conta Gratuita na Notaas Platform
👉 Documentação Completa da API

Notaas — Infraestrutura Fiscal Multi-Tenant para SaaS, ERPs e BPOs

Escale a emissão de NFS-e, NF-e, NFC-e, CT-e e MDF-e para dezenas de CNPJs

Integre a API de Nota Fiscal da Notaas no seu software: provisione clientes via Org API Multi-CNPJ, isole certificados A1 em nuvem, receba webhooks assinados com HMAC e gere DANFSe v2.0 local. Sandbox ilimitado e planos sob medida para operações em escala.

Artigos Relacionados em Automação

Automação • 19/11/2026

Tomador do Serviço no CT-e (Frete CIF, FOB, Expedidor, Recebedor e Outros): Diferença entre toma3 e toma4 via API JSON

Entenda quem é o tomador do serviço no CT-e 4.00 (Frete CIF remetente, FOB destinatário, expedidor, recebedor e terceiros), a diferença entre os grupos toma3 e toma4 no XML da SEFAZ e como emitir via API JSON vinculando múltiplas NF-es.

Automação • 18/11/2026

Rejeição 531 no CT-e 4.00 e a Tag vTotDFe (Reforma Tributária): Por que a SEFAZ Rejeita vRec Igual a vTPrest e Como Resolver

Entenda por que a SEFAZ e a SVRS retornam a Rejeição 531 (Valor a receber deve ser menor ou igual ao Valor da Prestação) mesmo quando vRec e vTPrest são iguais, o papel da nova tag vTotDFe na Reforma Tributária e como emitir CT-e 4.00 via API JSON.

Automação • 18/11/2026

Tributação de ICMS no CT-e 4.00 via API: Guia Prático de CST (00, 20, 40, 60 ST, 90, Outra UF e Simples Nacional)

Guia técnico para desenvolvedores de TMS e ERPs sobre como preencher o grupo de ICMS no CT-e 4.00: CST 00, redução de base (CST 20), isenção/diferimento (40/41/51), substituição tributária (CST 60), transporte iniciado em outra UF (CFOP 5932/6932) e Simples Nacional.

Automação • 09/11/2026

Como Automatizar NFS-e de MEI no Stripe, Asaas, Kiwify, Hotmart e WooCommerce via Webhook (Sem Comprar Certificado A1)

Tutorial prático com código em Node.js/TypeScript para automatizar a emissão de NFS-e de MEI e Simples Nacional após vendas no Stripe, Asaas, Kiwify, Hotmart e WooCommerce usando webhooks e Procuração Eletrônica RFB (00233) sem arquivo .pfx.

Guias Pilares de Integração Fiscal