Pular para o conteúdo principal
Ver como MarkdownDocs para agentes

Emissão RTC (Reforma Tributária do Consumo)

O leiaute RTC (grupos IBS, CBS e IS) é selecionado pelo payload — os endpoints são os mesmos da emissão atual. O SDK expõe recursos dedicados para deixar o opt-in explícito e tipado.

  • nfe.serviceInvoicesRtc — NFS-e no leiaute RTC (grupo ibsCbs).
  • nfe.productInvoicesRtc — NF-e/NFC-e no leiaute RTC (IBS estadual/municipal, CBS, IS).

Os recursos de emissão existentes (serviceInvoices/productInvoices) permanecem inalterados; RTC é opt-in.

NFS-e RTC (com polling)​

serviceInvoicesRtc.create retorna a mesma união discriminada de serviceInvoices; createAndWait faz polling até o estado terminal.

const invoice = await nfe.serviceInvoicesRtc.createAndWait(companyId, {
  borrower: { federalTaxNumber: 52998224725, name: 'Cliente Teste' },
  cityServiceCode: '10677',
  description: 'Serviço (RTC)',
  servicesAmount: 100.0,
  ibsCbs: { /* grupo RTC conforme a NT_2025.002 */ },
});

Também há retrieve e downloadCancellationXml (XML do evento de cancelamento, Ambiente Nacional).

NF-e/NFC-e RTC (webhook-driven)​

productInvoicesRtc.create não faz polling (202 = enfileirada; conclusão via webhook), espelhando productInvoices.

const invoice = await nfe.productInvoicesRtc.create(companyId, {
  buyer: { federalTaxNumber: 52998224725, name: 'Cliente Teste' },
  items: [{ code: '001', description: 'Produto', quantity: 1, unitAmount: 100.0 }],
  ibsCbsIs: { /* grupos RTC conforme a NT_2025.002 */ },
});
Tipos de request

NFSeRtcRequest (NFS-e) e ProductInvoiceRtcRequest (NF-e/NFC-e) são derivados das specs oficiais. A proveniência das specs está registrada em openapi/spec/SOURCES.json (NT_2025.002_v1.30).

Próximos passos​

NFE.io

A NFE.io é uma empresa de tecnologia que fornece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas. Com suas ferramentas, as empresas podem economizar tempo e reduzir erros, aumentando a eficiência e precisão do processo de emissão de notas fiscais.

Um dos principais cases de sucesso da NFE.io é a implementação da solução na empresa de transporte Rodonaves. Com a automatização da emissão e gestão de notas fiscais eletrônicas, a Rodonaves conseguiu reduzir em até 80% o tempo gasto nesse processo, o que se traduziu em uma significativa melhoria na eficiência operacional. Além disso, a empresa também conseguiu eliminar erros e atrasos na emissão de notas fiscais, o que melhorou a relação com seus clientes e aumentou a confiança dos órgãos fiscais.

Outro exemplo é a implementação da NFE.io na empresa de comércio eletrônico, a Loja Integrada. Com a automatização da emissão de notas fiscais, a Loja Integrada conseguiu aumentar a velocidade de emissão de notas em até 10 vezes, o que permitiu que a empresa atendesse a uma maior quantidade de clientes e, consequentemente, aumentar as suas vendas.

Além desses exemplos, a NFE.io também tem outros cases de sucesso com empresas de setores como indústria, construção, varejo e serviços, mostrando a versatilidade e eficácia da sua solução.

Em resumo, a NFE.io é uma empresa de tecnologia que oferece soluções para automatizar e simplificar a emissão e gestão de notas fiscais eletrônicas, ajudando as empresas a economizar tempo e reduzir erros, melhorando a eficiência e precisão do processo. Com cases de sucesso em diferentes setores, a NFE.io tem se destacado como uma empresa líder em automação fiscal.