Changelog
Histórico de atualizações, novos recursos e melhorias contínuas na API e na plataforma NFER.
Retorno com Pré-visualização Fiscal Imediata no Rascunho de NF-e e NFC-e
API RESTA chamada de criação de notas (POST /v1/nfe e POST /v1/nfce) agora devolve instantaneamente na mesma resposta HTTP (201 Created) o espelho tributário completo: array de itens calculados, CFOPs auto-resolvidos, identificação do perfil fiscal acionado e o grupo consolidado de totais fiscais, eliminando consultas secundárias e transformando o rascunho em um simulador tributário em tempo real para ERPs.
- Memória de Cálculo Completa nos Itens: Cada item do array itens[] passa a retornar com a estrutura impostos detalhando base de cálculo e alíquota de ICMS, ICMS-ST (com MVA), PIS, COFINS e o totalTributos aproximado.
- Consolidação de Totais Fiscais (totais): A resposta passa a incluir o objeto totais (ICMSTot), consolidando vProd, vBC, vICMS, vBCST, vST, vPIS, vCOFINS, vFrete, vDesc e o valor total final da nota (vNF).
- Rastreabilidade do Perfil Fiscal (perfil_fiscal): Quando o cliente emite sem tributos manuais, a API informa o id, nome e segmento do perfil fiscal aplicado (ex.: "Revenda Consumidor Final Inter"). Se o cliente enviou tributos próprios, a API retorna origem_fiscal: "impostos_manual" e perfil_fiscal: null, comprovando que seus dados foram integralmente respeitados.
- Economia de Latência e Requisições: ERPs e sistemas parceiros não precisam mais efetuar uma chamada GET /v1/nfe/:id posterior para exibir o espelho da nota na tela ou realizar conferência prévia.
- Retrocompatibilidade Absoluta (100% Aditivo): Clientes existentes que consomem apenas os campos originais de cabeçalho (id, numero, serie, status, valor_total) continuam funcionando normalmente sem qualquer alteração de contrato.
Proteção Ativa contra Bloqueio SEFAZ (cStat 656 / Consumo Indevido): Circuit Breaker de 1 Hora
Infra & SegurançaBlindagem automática para evitar o bloqueio permanente de CNPJs na SEFAZ. Quando a Fazenda retorna cStat 656 por excesso de requisições ou falhas repetitivas, o NFER ativa um Circuit Breaker via Redis no CNPJ por 3600 segundos (1 hora), impedindo retransmissões que reiniciariam a penalidade no Fisco.
- O Problema do Loop Infinito no Fisco: De acordo com a NT 2014.002 e o Manual do Contribuinte (MOC), se um CNPJ rejeitado com cStat 656 retransmitir antes de 60 minutos, a SEFAZ zera o contador de espera e aplica mais 60 minutos a partir da nova tentativa. Sistemas sem controle entram em lockout perpétuo.
- Circuit Breaker Inteligente via Redis: O NFER intercepta requisições de emissão e sincronização na entrada da API. Se o CNPJ estiver em cooldown fiscal, a chamada é bloqueada imediatamente sem sobrecarregar a SEFAZ.
- Novo Código de Erro SEFAZ_COOLDOWN (HTTP 429): Separamos o erro de bloqueio fiscal do rate limit de aplicação (TOO_MANY_REQUESTS). A resposta traz cStat: "656", mensagem orientando a pausa e retryAfter: 3600 (com cabeçalho HTTP Retry-After padronizado).
- Auto-healing de NSU no Monitor Fiscal (cStat 589): Quando o cursor de sincronização de notas recebidas ou fretes CT-e ultrapassa o maior NSU da base nacional da SEFAZ, o NFER recalibra automaticamente o cursor para o maxNSU oficial com intervalo seguro, recuperando o sync sem intervenção manual.
Separação Arquitetural de Códigos HTTP 429: TOO_MANY_REQUESTS vs SEFAZ_COOLDOWN
API RESTPadronização das respostas de recusa temporária para que os clientes e ERPs saibam exatamente se a pausa decorre do plano contratado ou de penalidade imposta pela autoridade fazendária.
- TOO_MANY_REQUESTS: Limite de requisições por minuto da API NFER atingido (ex: 30 req/min). Backoff curto (3 a 60 segundos).
- SEFAZ_COOLDOWN: Bloqueio estrito da SEFAZ por cStat 656. Exige pausa completa de 60 minutos (3600 segundos) para liberação na Fazenda.
NF-e de Devolução com Transmissão One-Shot: Parâmetro `transmitir`
NF-e / NFC-eEstendemos a transmissão em etapa única para o endpoint de geração de devoluções (POST /v1/nfe/:id/devolucao), permitindo gerar a nota fiscal de devolução (finalidade 4) com chave referenciada e autorizar na SEFAZ imediatamente.
- Devolução e Envio em Chamada Única: O endpoint POST /v1/nfe/:id/devolucao agora aceita { itens, transmitir: true } no corpo ou ?transmitir=true na querystring. A nota de devolução é criada com a tag <NFref> apontando para a nota original e despachada na hora para o worker da SEFAZ.
- Fluxo Ágil de Logística Reversa: Elimina a necessidade de criar o rascunho e depois chamar /send, simplificando automações de RMA, devoluções de e-commerce e estornos fiscais de vendas canceladas.
- Status Imediato "processando": O retorno já entrega a nota em processamento, disparando os webhooks usuais de nfe.autorizada ou nfe.erro assim que a SEFAZ responder.
Importação Manual de Notas de Saída Já Emitidas (Sem Contabilizar na Cota)
Painel & UIAgora é possível importar para o NFER notas fiscais de saída que já foram autorizadas em outros sistemas ou emissores legados, unificando o histórico fiscal sem consumir o limite de emissões do seu plano.
- Importação sem Consumo de Cota: Documentos fiscais importados via XML avulso ou pacote ZIP (tanto pelo painel quanto via POST /v1/nfe/import-xml) são registrados com origem "importacao" e não são contabilizados no limite mensal de notas emitidas da assinatura.
- Histórico e Centralização Fiscal: O NFER armazena o XML assinado com protocolo da SEFAZ, permitindo visualizar dados, consultar status, gerar DANFE em PDF e emitir eventos posteriores (como Cancelamento e Carta de Correção CC-e).
- Exportação Contábil Completa: Notas importadas passam a compor os relatórios financeiros, gráficos do dashboard e o fechamento fiscal mensal enviado ao contador da empresa.
Emissão One-Shot em Requisição Única: Suporte ao Parâmetro `transmit` (ou `transmitir`)
API RESTAgora é possível criar e transmitir a nota fiscal diretamente para a SEFAZ ou prefeitura em uma única requisição HTTP, eliminando a obrigatoriedade da chamada secundária POST /v1/nfe/:id/send.
- Suporte aos Parâmetros transmit, transmitir e emitir: Ao incluir transmit: true (ou transmitir: true / emitir: true) no payload JSON de POST /v1/nfe, POST /v1/nfce ou POST /v1/nfse, a API cria o documento fiscal, aloca a numeração sequencial e enfileira imediatamente a autorização no worker de transmissão.
- Retorno com Status Imediato "processando": A resposta HTTP 201 já retorna o objeto com status: "processando", pronto para acompanhamento em tempo real via Webhooks (eventos nfe.autorizada, nfe.erro) ou consulta.
- Otimização de Latência para PDVs e Checkouts: Reduz à metade os round-trips de rede em sistemas de frente de caixa, totens de autoatendimento e checkouts de e-commerce, eliminando esperas desnecessárias.
- Clonagem com Disparo Automático: O endpoint de duplicação POST /v1/nfe/:id/clone também passa a aceitar o parâmetro ?transmitir=true (ou body { transmitir: true }), gerando e transmitindo o novo documento instantaneamente.
- Retrocompatibilidade Total: O fluxo clássico em duas etapas (1. POST rascunho -> 2. POST /send) continua perfeitamente suportado para sistemas que realizam conferência prévia.
Reforma Tributária (IBS / CBS e Imposto Seletivo): Envio Antecipado via API com Travas Temporais
Regras FiscaisAtualizamos a documentação de referência e o motor de emissão para suportar os grupos reformaTributaria e impostoSeletivo em itens[], permitindo que sistemas parceiros e ERPs já enviem a classificação tributária e alíquotas com proteção total contra rejeições indevidas na SEFAZ.
- Suporte aos Grupos reformaTributaria e impostoSeletivo por Item: Disponibilizados os campos de IBS/CBS (cClassTrib, cst, aliquotaCbs, aliquotaIbsEstadual, aliquotaIbsMunicipal, percentualReducao, percentualDiferimento) e do Imposto Seletivo (cst, classificacao, aliquota, aliquotaEspecifica, quantidade, valor) na API de rascunho e emissão.
- Trava e Vigência do Imposto Seletivo (IS): O IS não possui alíquota de teste em 2026 (Art. 343 da LC 214/2025 vigora em 01/01/2027). A API aceita o payload normalmente e libera em Homologação, mas omite as tags <IS> e <ISTot> no XML de Produção durante 2026 para blindar a empresa contra rejeições da SEFAZ, liberando automaticamente na virada de 2027.
- Blindagem Temporal para Simples Nacional (2026): A SEFAZ não aceita o grupo <IBSCBS> e a legislação veda o IS para empresas optantes do Simples Nacional (CRT 1 e 2) durante 2026. O motor NFER processa o payload sem erros, mas omite as tags do XML.
- Ativação Automática Pós-Virada: Assim que a obrigatoriedade entrar em vigor legalmente e os ambientes SEFAZ liberarem o grupo para cada perfil, o NFER passará a gerar as tags de IBS/CBS e IS automaticamente no XML sem necessidade de novas intervenções no código do integrador.
- Documentação e Guias Fiscais: Criada página dedicada de campos da Reforma Tributária e documentação técnica no arquivo TRAVAS-DE-DATA-E-VIGENCIAS.md.
NF-e Referenciada (chaveReferenciada) para Retorno de Conserto e Operações Gerais (finNFe: 1)
NF-e / NFC-eDocumentamos formalmente o campo chaveReferenciada na raiz do payload da NF-e para vincular documentos fiscais anteriores em operações normais, gerando a tag <ide><NFref><refNFe> no XML.
- Chave Referenciada em Operações Normais: Suporte ao envio de chaveReferenciada (44 dígitos) com finalidade: 1, essencial para emissão de Retorno de Conserto (CFOP 5916/6916), Remessa para Industrialização e Exportação Indireta.
- Novo Guia de Emissão para Retorno de Conserto: Adicionada a "Opção E — Retorno de Conserto e NF Referenciada (CFOP 5916 / 5915)" na documentação da API, com exemplo completo de payload e curl.
- Busca Inteligente por Chave Referenciada: Se a criação do rascunho sofrer timeout ou instabilidade de rede, o integrador pode consultar GET /v1/nfe?search=<chaveReferenciada> para reencontrar a nota gerada com idempotência.
Valor Líquido do Produto (NT 2026.008), Dados de Cartão, Informações Adicionais e Badges na Docs
API RESTExpandimos a documentação dos itens com os novos campos de valor líquido previstos na NT 2026.008, refinamos a estrutura de pagamentos, enriquecemos as informações complementares e padronizamos badges na documentação.
- Valor Líquido do Produto (NT 2026.008): Inclusão dos campos opcionais valorLiquidoUnitario (vUnComLiq) e valorLiquido (vProdLiq) no array itens[], detalhando o valor unitário e total do item deduzido de desonerações.
- Informações Adicionais Enriquecidas: Documentação aprofundada do campo informacoesAdicionais (tag <infCpl>) com exemplos para número de pedido/OC, detalhes de entrega, motivo de conserto/RMA e instruções de pagamento.
- Badges Opcional na Documentação: Implementação automática de badge "opcional" em todos os parâmetros que não são obrigatórios nos endpoints da API.
- Detalhamento de Pagamentos com Cartão: Documentação da estrutura pagamentos[].cartao (tipoIntegracao, cnpjCredenciadora, bandeira, codigoAutorizacao) com fallback inteligente para evitar a Rejeição 391.
- Padronização de Paginação (limit): O endpoint GET /v1/nfe padroniza o parâmetro limit (máximo 200, padrão 20) com suporte ao filtro search ampliado.
Documentação: Cobertura Completa de MDF-e (Manifestos e Cargas Recebidas)
API RESTAdicionamos a documentação oficial para auditoria de Manifestos Eletrônicos de Documentos Fiscais (MDF-e modelo 58) recebidos perante a SEFAZ Nacional, com guias práticos e endpoints de API.
- Documentação de MDF-e (Modelo 58) Recebidos: Adicionado o MDF-e na introdução geral (/docs) e criada a página especializada de guia /docs/monitor-fiscal/mdfe-recebidos com explicação de rastreamento de cargas, auditoria de encerramento e cruzamento de rota.
- Endpoints de MDF-e na API Reference: Adicionados 6 novos endpoints na referência da API (/api/mdfe/received, /sync-status, /sync, /:id, /:id/xml e /:id/damdfe) com parâmetros, filtros, retornos e download de DAMDFE (PDF).
Motor de CT-e 4.00 Completo: Roteamento Dinâmico Multi-UF, CT-e Simplificado (NT 2024.002) e Modelos Especiais
CT-e TransporteEvoluímos o motor próprio de CT-e no backend da NFER, substituindo a comunicação legada vinculada apenas ao SVRS por um barramento inteligente com suporte nativo a todas as 27 Secretarias de Fazenda estaduais, autorização síncrona/assíncrona e novos layouts logísticos.
- Roteamento Dinâmico Multi-UF: O NFER agora detecta a UF do emitente e direciona o tráfego SOAP diretamente para os WebServices estaduais autorizadores (SP, MG, PR, MS, MT e autorizadoras virtuais SVRS/SVSP), eliminando rejeições de comunicação por circunscrição fiscal.
- CT-e Simplificado (NT 2024.002): Suporte oficial para prestação de serviço de transporte com múltiplos remetentes ou múltiplos destinatários vinculado a um único tomador do serviço (tpCTe = 5 ou flag simplificado: true na API).
- CT-e Outros Serviços (Modelo 67) & GTV-e (Modelo 64): Emissão nativa de CT-e OS para transporte de passageiros/fretamento e Guia de Transporte de Valores eletrônica com assinatura e validação digital de schemas.
- Eventos Logísticos e Gestão de Entrega: Suporte a eventos de Comprovante de Entrega eletrônico (tpEvento 110180/110181), Insucesso na Entrega (tpEvento 110190/110191) e Prestação em Desacordo emitida pelo tomador (tpEvento 610110/610111).
- Failover Defensivo Zero-Downtime: Arquitetura resiliente que mantém fallback automático para contingência transparente sem interrupções operacionais.
Novos Endpoints de Telemetria SEFAZ e Consulta de Protocolo para CT-e
API RESTDisponibilizamos rotas dedicadas para monitoramento de disponibilidade da SEFAZ autorizadora e consulta da situação em tempo real de documentos emitidos.
- GET /cte/status-servico: Telemetria em tempo real que verifica se os servidores da SEFAZ da UF da empresa estão em operação (cStat 107) ou paralisados (cStat 108/109), permitindo contingência preventiva.
- GET /cte/:id/protocolo: Consulta a situação do CT-e diretamente no Fisco pelo número da chave de acesso de 44 dígitos, sincronizando status e protocolos oficiais.
Redesign da Gestão Financeira Master (/master/billing): Foco no Usuário, Inadimplência e Navegação Fluida
Painel & UIModernizamos a visualização de cobrança e receita recorrente do painel Master com foco direto nos usuários e inteligência de faturas em atraso.
- Novo Card de Faturas Vencidas & Inadimplência: Substituição de gráficos estáticos por métricas críticas de contas em atraso, impacto financeiro na receita e contador de clientes com suspensão ativa.
- Listagem de Faturas com Foco no Usuário: Redesign da tabela com foto/avatar redondo, nome do responsável em destaque, sigla da UF, email e botão direto [Ver Cliente] para acesso ao plano.
- Assistente Copiloto de Atendimento (Live Chat): Prompts refinados para respostas curtas, diretas e humanizadas, ideais para comunicação ágil em chat de suporte e WhatsApp.
Novo Portal de Parceiros & Afiliados: Painel Dedicado, Funil de Aquisição, Links UTM e Autenticação Isolada
Painel & UIReformulamos por completo a infraestrutura do Programa de Parceiros e Afiliados NFER (/parceiros/dashboard), desacoplando a experiência do painel de emissão fiscal e entregando ferramentas avançadas de aquisição, funil analítico em tempo real, links rastreados com UTM e login independente.
- Portal Isolado e Experiência Dedicada (/parceiros/dashboard): O programa agora opera em rota e layout próprios com navegação contextual por abas (Visão Geral, Funil, Meus Indicados, Kit de Divulgação, Extrato & Repasses e Dados & Chave PIX) e cabeçalhos dinâmicos alinhados a cada seção.
- Autenticação Desacoplada e Acesso Direto (/parceiros/login): Parceiros, contadores e afiliados podem se cadastrar e gerenciar seus ganhos com credenciais próprias de parceiro, sem a obrigatoriedade de possuir uma empresa emissora ativa no sistema fiscal.
- Funil de Conversão & Métricas de Aquisição: Nova aba analítica com acompanhamento completo em tempo real de toda a jornada dos visitantes: cliques no link exclusivo, contas cadastradas e assinaturas ativas com filtros temporais (7, 30, 90 dias ou todo o período).
- Gerador de Links Rastreados (UTMs): Modal interativo para criação de links personalizados com parâmetros de campanha (utm_source, utm_medium, utm_campaign) para mensurar canais isolados (Instagram, YouTube, WhatsApp, tráfego pago) com contador de cliques individual.
- Gestão Completa de Comissões e Repasses PIX: Redesign total das tabelas de indicados e do histórico de comissões com busca instantânea por empresa/origem, filtros por status (Liberado, Em Carência D+8, Repassado), ordenação avançada e paginação fluida.
- Gamificação & Isenção da Própria Mensalidade: Banners inteligentes com metas automáticas: 5 clientes pagantes ativos garantem 100% de isenção no Plano Start (R$ 49,90/mês) e 10 clientes desbloqueiam o Plano Growth (R$ 99,90/mês) totalmente grátis.
Reforma Tributária: Tabela cClassTrib Atualizada (IT 2025.002 v1.70) com 9 Novos Códigos
Regras FiscaisIncorporamos a atualização oficial do Informe Técnico nº 2025.002 versão 1.70 nas tabelas nacionais de Classificação Tributária (cClassTrib) da Reforma Tributária do Consumo (LC 214/2025), sincronizando 173 códigos oficiais com prazo de implantação SEFAZ até 16/10/2026.
- Novos Códigos para Autônomos: Inclusão dos códigos 000006 (situações tributadas integralmente pelo IBS e CBS realizadas por autônomo), 200055 (serviços com redução de alíquota de 60%) e 200056 (serviços com redução de alíquota de 30%).
- Operações Especiais e Internacionais: Cadastro dos códigos 400003 (Bagagens) e 400004 (Remessas internacionais) com enquadramento de não incidência/imunidade (CST 400).
- Regimes Aduaneiros Especiais, ZFM e ZPE: Códigos 550026 (admissão temporária com suspensão total de tributos na ZFM), 550027 (regimes de aperfeiçoamento - Drawback), 550028 (admissão temporária) e 550029 (Zona de Processamento de Exportação - ZPE).
- Script de Sincronização Automatizado: Novo comando CLI "npm run cclasstrib:sync" (e scripts/sync_cclasstrib.py) com ingestão direta do Portal da Conformidade Fácil (SVRS / ENCAT / SEFAZ).
Motor de DIFAL: Base Simples (B2C) e Nova Modalidade de Base Dupla por Grupos de UFs (B2B)
Regras FiscaisEvoluímos nossa calculadora e API de Diferencial de Alíquota (/v1/tools/tax/calculate-difal) para suportar tanto o DIFAL de Não Contribuinte quanto o cálculo avançado de Base Dupla para Contribuinte conforme a legislação da UF de destino.
- Modalidade Base Simples (Não Contribuinte / B2C — EC 87/2015): Padrão mantido para vendas a consumidor final sem IE, com preenchimento do grupo <ICMSUFDest> no XML da NF-e e blindagem constitucional do Simples Nacional (STF ADI 5464).
- Nova Modalidade Base Dupla (Contribuinte / B2B — LC 190/2022 & RICMS): Apuração do DIFAL para empresas com IE adquirindo mercadorias para uso, consumo ou ativo imobilizado, com cálculo por dentro estruturado por grupos estaduais.
- As 4 Metodologias Estaduais: Grupo 1 (20 UFs incluindo SP, MG, RJ, PR, RS, BA e DF com base dupla clássica), Grupo 2 (AL, GO, SC com base cheia reconstituída), Grupo 3 (SE com divisor por margem diferencial) e Grupo 4 (AM, PB, PE com exclusão de origem e multiplicação diferencial).
- Detalhamento Completo na API: Retorno com base reconstituída, débito no destino, dedução da origem, percentual de FCP e fundamentação legal de cada estado.
Substituição Tributária: Cálculo Oficial de MVA Ajustada (Convênio ICMS 142/2018)
Regras FiscaisImplementamos o cálculo automático de Margem de Valor Agregado Ajustada (MVA Ajustada) para operações interestaduais sujeitas a ICMS-ST entre contribuintes.
- Fórmula do Convênio ICMS 142/2018: Aplicação oficial da fórmula de ajuste sempre que a alíquota interestadual (4%, 7% ou 12%) for inferior à alíquota interna de destino.
- Parâmetro na API: Novo campo "ajustarMva: true" no endpoint POST /v1/tools/tax/calculate-st e cálculo dinâmico no endpoint GET /v1/tools/tax/st-lookup.
- Transparência no Retorno: A resposta entrega pMVAOriginal, pMVAAjustada, mvaFoiAjustada e o valor final de ICMS-ST recalculado com precisão centesimal.
Reforma Tributária: Suporte aos Campos de Valor Líquido (NT 2026.008) em Homologação
Regras FiscaisImplementamos suporte aos novos campos de Valor Líquido Unitário (<vUnComLiq>) e Valor Líquido do Produto (<vProdLiq>) instituídos pela NT 2026.008 v.1.00, com totalização em <vProdLiqTot>.
- Ativação em Homologação SEFAZ: Conforme o cronograma fazendário oficial (liberado em 05/10/2026), o NFER já autoriza a transmissão desses campos em ambiente de testes para modelos 55 e 65.
- Trava de Segurança para Produção: Os novos campos no XML só começam a ser transmitidos em Produção a partir de 03/11/2026 (data oficial da virada dos schemas XSD nos servidores da SEFAZ), blindando clientes contra a Rejeição 215.
- Validação da Regra I11c-20 e W01a-10: Cálculo automático e validação de consistência (vProdLiq = vUnComLiq * quantidade) e soma precisa no totalizador <vProdLiqTot> do grupo ICMSTot.
- Campos na API REST: Suporte nos itens via valorLiquidoUnitario, valorLiquido, vUnComLiq, vProdLiq ou dentro do objeto reformaTributaria.
DANFE da Reforma Tributária: Especificações da NT 2026.010 (IBS, CBS e Imposto Seletivo)
Regras FiscaisMapeamento e preparação técnica do Documento Auxiliar da NF-e (DANFE modelo 55) conforme a Nota Técnica 2026.010 v.1.00 com entrada em vigor em 01/12/2026.
- Novo Bloco Total do IBS/CBS/IS: Consolidação dos valores de vCBS, vIBSUF, vIBSMun, vIS e valores monofásicos logo após o quadro do ICMS/IPI.
- Identificação do CRT no Emitente: Destaque do Código de Regime Tributário e reserva para tipo de regime de apuração do IBS/CBS.
- Detalhamento nos Itens: Exibição do código de classificação tributária (cClassTrib), bases de cálculo, alíquotas efetivas e valores dos novos tributos por item.
Atualização e Saneamento da Tabela CEST x NCM (Convênio ICMS 142/2018)
Regras FiscaisAtualizamos integralmente a correlação oficial entre CEST (Código Especificador da Substituição Tributária) e NCM com base no texto consolidado do Convênio ICMS 142/18 do CONFAZ e seus anexos atualizados.
- Base CONFAZ Consolidada: Incorporação dos Anexos I a XXVIII do Convênio ICMS 142/18 atualizados, totalizando mais de 1.050 códigos CEST ativos e catalogados.
- Saneamento e Normalização de NCMs: Padronização rigorosa dos códigos NCM e capítulos fiscais (incluindo correção de zeros à esquerda em capítulos como 02, 04, 07, 08 e 09), eliminando falsos positivos no autocompletar de produtos.
- Desmembramento de Códigos Múltiplos: Indexação atômica de NCMs agrupados na legislação, garantindo resolução direta e precisa na busca por qualquer um dos 8 dígitos do produto.
- Códigos Recentes e Venda Direta: Inclusão de desdobramentos recentes do CONFAZ (como CEST 17.062.01 para panificação e pizzas) e mapeamento integral dos itens de venda porta a porta (Segmento 28).
Reforma Tributária: Suporte aos Novos Tributos (IBS, CBS e IS) em NF-e, NFC-e e NFS-e
Regras FiscaisImplementamos a infraestrutura nativa para os tributos da Reforma Tributária sobre o Consumo (Emenda Constitucional 132/2023, LC 214/2025 e NT 2025.002) em todo o ecossistema NFER.
- Suporte Multidocumento (NF-e, NFC-e e NFS-e): Geração estruturada dos novos grupos <IBSCBS> por item e totalizadores <IBSCBSTot> para NF-e modelo 55 e NFC-e modelo 65, alinhado ao suporte já existente na NFS-e Nacional (Padrão ADN/SEFIN).
- Cálculo e Enquadramento Inteligente: Aplicação automática das alíquotas de teste da fase de transição (CBS 0,9% e IBS 0,1%) para empresas do Regime Normal (CRT 3), com dispensa automática para optantes do Simples Nacional (CRT 1, 2 e 4/MEI) conforme diretrizes da RFB e Comitê Gestor do IBS.
- Customização via Payload: Suporte opcional ao objeto reformaTributaria nos itens para informar códigos de classificação tributária (cClassTrib), CST de IBS/CBS, alíquotas diferenciadas ou regimes específicos sem impactar emissões padrão.
- Total Retrocompatibilidade: Zero quebra para integrações existentes. Sistemas que emitem sem informar os novos campos continuam operando normalmente sem necessidade de alterações imediatas.
DIFAL Automatizado (EC 87/2015 & LC 190/2022) e Mensagens Fiscais do Simples Nacional
Regras FiscaisAprimoramos o motor fiscal para cálculo automático do Diferencial de Alíquotas interestadual e padronização rigorosa dos textos de crédito do Simples Nacional em infCpl.
- DIFAL Interestadual com FCP: Geração do grupo <ICMSUFDest> em operações interestaduais destinadas a consumidor final não contribuinte (indFinal=1 e indIEDest=9) para empresas do Regime Normal (CRT 3).
- Blindagem Simples Nacional (ADI 5464): Garantia de que empresas do Simples Nacional (CRT 1, 2 e 4) não sofram destaque indevido de DIFAL, em estrito cumprimento à decisão do STF.
- Benefícios Fiscais e Alíquotas de Destino: Suporte a operações com isenção ou equivalência de alíquotas na UF de destino, resultando em DIFAL = 0,00 quando aplicável por benefício fiscal estadual.
- Mensagens Legais Dinâmicas: Textos de infCpl do Simples Nacional agora são gerados com base no CSOSN efetivo dos itens, distinguindo operações com direito a crédito (CSOSN 101/201/900 com pCredSN e vCredICMSSN) de itens sem crédito.
Monitor SEFAZ: Telemetria Precisa e Desacoplamento de Disponibilidade e Latência
Painel & UIAprimoramos o algoritmo de telemetria e a régua de qualidade do Monitor SEFAZ (/status-sefaz) para refletir com fidelidade absoluta a saúde operacional dos autorizadores fiscais.
- Separação entre Disponibilidade e Qualidade de Resposta: Respostas com cStat 107 (Serviço em Operação) e cStat 114 (Contingência em Standby) mantêm o índice de disponibilidade integral (~99%+), sem penalizar o uptime apenas por variações temporárias na latência da rede pública.
- Novas Classificações Transparentes: Introdução das categorias "Operacional · Latência elevada" (3.5s a 8s), "Degradação" (8s a 15s), "Instável" (> 15s ou cStat 108) e "Indisponível" (cStat 109 ou falhas consecutivas), evitando falsos alarmes de instabilidade no panorama geral nacional.
- Painel Detalhado por Estado: Cada UF agora exibe badge contextualizado, tempo de resposta com indicador sutil, validação visual do cStat oficial e aviso informativo esclarecendo que o serviço permanece ativo mesmo sob lentidão momentânea.
Otimização e Maior Resiliência no Canal com a SEFAZ-PE (Pernambuco)
NF-e / NFC-eImplementamos aprimoramentos arquiteturais no handshake de comunicação e no protocolo de autorização com os servidores da SEFAZ Pernambuco.
- Refinamento de Transporte SOAP mTLS: Padronização estrita de cabeçalhos SOAPAction para garantir compatibilidade com as rotas de homologação e produção do autorizador estadual.
- Fallback Automático de Envio: Mecanismo resiliente com alternância suave entre processamento síncrono e assíncrono durante picos de transmissão.
- Garantia de Integridade de Payload: Imutabilidade rigorosa dos nós do XML durante retentativas, assegurando autorizações fluidas para empresas de todos os regimes tributários.
Simulador de Tributos (POST /v1/fiscal-profiles/preview) e Endpoints de Perfis Fiscais
API RESTChegaram os endpoints dedicados para gerenciamento e simulação em tempo real do motor de Perfis Fiscais. Agora é possível prever e simular o cálculo de impostos antes mesmo de emitir a nota fiscal, além de gerenciar regras programaticamente via API REST.
- Simulação em Tempo Real (POST /v1/fiscal-profiles/preview): Endpoint ultrarrápido (~15ms) para simular o resultado tributário exato (CFOP, CSOSN/CST, alíquotas de ICMS, PIS, COFINS e flags de Substituição Tributária) informando apenas o perfil ou tipo de item, UF de destino, tipo de pessoa (F/J) e presença de Inscrição Estadual.
- CRUD Completo de Perfis Fiscais (/v1/fiscal-profiles): Novos endpoints REST (GET, POST, PUT, DELETE) para consultar, criar, atualizar e excluir perfis fiscais e suas respectivas matrizes de regras por estado diretamente via API.
- Try It Interativo na Documentação: Teste requisições em tempo real diretamente na Referência da API (/docs/api-reference/fiscal-profiles/preview) com suporte a cURL, Node.js, Python, Kotlin e Swift.
- Suporte Nativo a destinatario no Payload: Tanto na emissão de NF-e (modelo 55) quanto de NFC-e (modelo 65), o payload agora aceita a chave em português destinatario em paralelo a customer, preservando total retrocompatibilidade com integrações ativas.
Novo Guia de Perfis Fiscais e Resolução Tributária Automática
Regras FiscaisPublicamos a documentação oficial sobre o motor de Perfis Fiscais Inteligentes (/docs/perfis-fiscais), explicando detalhadamente a resolução tributária determinística em 4 dimensões e a colaboração com o escritório de contabilidade.
- Motor de 4 Dimensões: Explicação detalhada de como o NFER cruza direção geográfica (intra vs interestadual), perfil do comprador (Físico vs Jurídico com/sem IE), regime do emitente (CRT 1, 2 ou 3) e finalidade do item (SPED tipoItem).
- Perfis Prontos de Fábrica: Esclarecimento de que a conta já nasce com regras e perfis configurados para o regime da empresa, permitindo ajustes visuais finos em Configurações > Perfis Fiscais pelo usuário ou contador sem alterar código no ERP.
- Exemplos Práticos Lado a Lado: Comparativo entre o payload enxuto enviado pelo ERP/PDV e o XML completo gerado automaticamente para a SEFAZ.
Novas Páginas Oficiais de SDK: Node.js/TypeScript, Android (Kotlin) e iOS (Swift)
API RESTGuias práticos com exemplos prontos de integração para backends em Node.js e dispositivos móveis (incluindo maquininhas Smart POS das adquirentes Stone, Cielo e PagBank).
- SDK Node.js & TypeScript (/docs/integracoes/nodejs-typescript): Cliente tipado completo, validação de webhooks com HMAC SHA-256 e exemplos de emissão em lote.
- SDK Android Kotlin (/docs/integracoes/android-kotlin): Guia otimizado para Smart POS e PDVs Android com retrofit/coroutines, impressão direta de DANFE ESC/POS e contingência offline.
- SDK iOS Swift (/docs/integracoes/ios-swift): Implementação nativa com async/await e URLSession para apps de frente de caixa no iPad e iPhone.
Novo Parâmetro tipoItem (SPED 0200) na API e Resolução Automática de Perfil Fiscal
API RESTAgora é possível enviar o campo tipoItem tanto no cadastro de produtos (POST /v1/products) quanto diretamente nos itens inline da emissão de NF-e e NFC-e (POST /v1/nfe e /v1/nfce). Altamente recomendado para integrações que não enviam os blocos de impostos completos: com a classificação da Tabela 4.3.3 do SPED Fiscal (Registro 0200), o NFER seleciona automaticamente o Perfil Fiscal correspondente e calcula CFOP e impostos em qualquer modalidade.
- Suporte no Cadastro de Produtos e nos Itens da Emissão (Inline): Envie o tipoItem no cadastro (/v1/products) ou diretamente no array itens ao emitir notas avulsas inline ({ descricao, ncm, quantidade, valorUnitario, tipoItem: "04" }), usando os códigos SPED 0200 ('00' Revenda [padrão], '04' Fabricação Própria, '01' Matéria-Prima, '02' Embalagem, etc.).
- Recomendado para quem não envia impostos completos: Caso sua aplicação não informe os blocos detalhados de tributação (ICMS, PIS, COFINS) na emissão, recomendamos fortemente enviar o tipoItem (no cadastro via productId ou direto no item inline) — assim o NFER descobre e aplica o Perfil Fiscal exato da sua empresa (revenda vs industrialização), calculando CFOP (ex: 5102/6102 ou 5101/6101), CSOSN/CST e alíquotas de forma 100% automatizada.
- Seleção Automática de Perfil Fiscal em Qualquer Cenário: Ao emitir NF-e ou NFC-e com productId ou com itens inline, o NFER identifica o tipoItem informado e seleciona o perfil fiscal correto da empresa, definindo o CFOP adequado e regras tributárias sem necessidade de overrides manuais.
- Compatibilidade Transparente: Produtos ou itens inline enviados sem tipoItem assumem automaticamente o padrão '00' (Revenda), garantindo compatibilidade total com integrações já existentes.
Importação em Massa de Produtos e Clientes (Excel / CSV) e Nova Paginação Dinâmica
Painel & UIImporte catálogos inteiros de produtos e bases completas de clientes de uma só vez a partir de planilhas Excel (.xlsx, .xls) e CSV, com mapeamento inteligente compatível com MarketUP, Bling, Tiny e outros ERPs, além de novo controle dinâmico de paginação.
- Importação em Massa via Planilha: Novos importadores dedicados em /dashboard/products e /dashboard/customers com leitura no navegador, prévia em modo tabela e processamento em lote com relatório detalhado.
- Mapeamento Inteligente com Suporte a ERPs: Reconhecimento automático de colunas como Código/SKU, Código de Barras (EAN), NCM, CEST, Tipo do Item, Estoque, Peso Bruto/Líquido, CPF/CNPJ, Inscrição Estadual e Endereço com auto-preenchimento IBGE.
- Seletor de Quantidade por Página: As telas de Clientes e Produtos agora permitem escolher a densidade de visualização (15, 50 ou 100 registros por página) com navegação ágil e sincronização de filtros.
Emissão Própria de NFS-e para Barueri (SP) com Suporte aos Novos Tributos da Reforma
NFS-e (Serviços)A NFER agora conta com conector nativo para o Web Service próprio municipal da Prefeitura de Barueri (SP). Emita notas de serviços para empresas de Alphaville e Tamboré — o maior polo de tecnologia e serviços do Brasil — com total conformidade ao Layout V4.4 (IBS, CBS e ADN Nacional).
- Conector Municipal Proprietário: Comunicação direta via Web Service SOAP com autenticação mútua TLS (mTLS) utilizando o Certificado Digital A1 da empresa prestadora.
- Layout Oficial V4.4 Atualizado: Geração e transmissão de arquivos RPS posicionais com suporte completo aos novos campos da Reforma Tributária (IBS, CBS, cClassTrib, CST e ADN Nacional).
- Roteamento Inteligente & Transparente: Empresas estabelecidas em Barueri (cMun 3505708) não MEI são direcionadas automaticamente para o emissor municipal, enquanto MEIs seguem o fluxo obrigatório do Padrão Nacional.
- Ciclo Assíncrono com Polling Automatizado: Envio do lote de RPS, checagem contínua de status na prefeitura e download automático do retorno com número da NF-e e código de autenticidade.
- Diagnóstico no Setup e Configurações: Reconhecimento automático do município de Barueri no onboarding com badge de homologação e validação de Inscrição Municipal (IM).
Novo App: Integração Oficial com WooCommerce & WordPress
Painel & UIO WooCommerce agora faz parte da Central de Apps da NFER! Conecte sua loja virtual em menos de 2 minutos via Webhook nativo para emitir NF-e e NFS-e automaticamente a cada pedido pago, com suporte completo ao checkout brasileiro.
- Disponível na Central de Apps: Novo aplicativo pronto para ativação rápida em /apps/woocommerce e no painel em Apps & Integrações.
- Emissão 100% Automática: NF-e de mercadorias (modelo 55) com frete e impostos ou NFS-e de infoprodutos autorizadas diretamente na SEFAZ assim que a compra é concluída.
- Conexão No-Code via Webhook Nativo: Integração direta pelas configurações do WooCommerce, sem sobrecarregar seu WordPress com plugins pesados de banco de dados.
- Compatibilidade com Checkout Brasil: Reconhecimento automático de CPF, CNPJ, número e bairro dos principais plugins nacionais (como Extra Checkout Fields do Claudio Sanches).
- Cancelamento Automático em Estornos: Pedidos cancelados ou reembolsados no painel do WooCommerce disparam o cancelamento formal da nota fiscal na SEFAZ sem trabalho manual.
- Envio Imediato para o Cliente: DANFE em PDF e XML oficial enviados por e-mail para o comprador logo após a autorização da nota.
Importação em Lote de XMLs e Arquivos .ZIP (NF-e 55 e NFC-e 65)
NF-e / NFC-eMigre seu histórico fiscal ou importe notas emitidas em outros emissores com facilidade: arraste arquivos XML avulsos ou pastas compactadas .zip e processe centenas de notas de saída de uma só vez.
- Arrastar e Soltar Global (Drag & Drop): Solte arquivos XML ou pastas .zip em qualquer lugar da tela de NF-e e NFC-e para abrir o importador inteligente.
- Descompactação Automática de .ZIP: Extrai e processa recursivamente todos os XMLs de notas fiscais contidos dentro de arquivos zipados.
- Validação Inteligente & Anti-duplicidade: Verifica a titularidade do CNPJ da empresa e impede duplicidades de chave ou série/número no sistema.
- Sincronização de Clientes & Armazenamento Seguro: Cadastra os clientes automaticamente na base e armazena os XMLs oficiais na nuvem com DANFE em PDF disponível para download.
Webhooks de Notas Recebidas em Tempo Real
API RESTEsteira completa de notificações via Webhook com assinatura HMAC para documentos fiscais recebidos (NF-e de compras, NFS-e de serviços e CT-e de fretes) emitidos contra o CNPJ da sua empresa.
- Novos Webhooks de NF-e: nfe.recebida.detectada (resumo resNFe identificado na SEFAZ), nfe.recebida.completa (XML procNFe completo pronto com itens e impostos), nfe.recebida.manifestada (confirmação, ciência ou recusa da operação) e nfe.recebida.evento (eventos de terceiros vinculados à nota).
- Webhooks de Fretes e Serviços: cte.recebido (novos fretes de transportadoras), cte.desacordo (prestação em desacordo evento 610110), nfse.recebida, nfse.cancelada e nfse.substituida (Ambiente Nacional ADN).
- Endpoints Flexíveis de Download: rotas dedicadas /danfe, /dacte, /pdf e /xml em todas as notas recebidas, aceitando parâmetros de formato a4 ou simplificado (bobina 80mm).
- Manifesto em Massa via API: novo endpoint POST /api/nfe/received/manifest-batch para transmissão em lote de até 20 notas com espaçamento automático anti-bloqueio.
- Endpoint /sync-status: consulta em tempo real do estado da fila SEFAZ, data da última busca, próximo ciclo agendado e cursor ultNSU.
Manifesto em Massa & Cadastro de Produtos no Estoque em 1 Clique
Painel & UIAutomação na entrada de mercadorias: selecione múltiplas notas para manifestação conjunta na SEFAZ e cadastre produtos no seu catálogo e estoque com 1 clique.
- Manifesto em Massa no Painel: seleção por checkboxes de até 20 notas simultâneas na tela com barra de ações flutuante e modal de transmissão em lote.
- Importação Inteligente de Itens: parsing completo de <det><prod> extraindo descrição, EAN/código de barras, NCM, CFOP, quantidade faturada e valor unitário de aquisição.
- Ação em 1 Clique no Painel: botão "Cadastrar Produtos" para alimentar o catálogo da empresa e atualizar o inventário físico sem digitação manual.
- DANFE Bobina Térmica (Simplificado Tipo 2): visualização e download em PDF otimizado para impressoras térmicas de 80mm com QR Code oficial e código de barras 128C para conferência na recepção.
- Painel de Configuração de Webhooks: seleção visual de eventos de notas recebidas com chips informativos e disparo de teste imediato.
Sincronização Contínua e Proteção Contra Bloqueio SEFAZ
Regras FiscaisAprimoramento da esteira de sincronização de notas recebidas, com rotina otimizada para capturar novas compras e fretes sem risco de bloqueio por consumo indevido.
- Captura Ágil e Automatizada: Consulta periódica em segundo plano na SEFAZ Nacional para identificar notas emitidas contra o CNPJ da sua empresa.
- Proteção Contra Consumo Indevido: Tratamento inteligente de regras e limites da SEFAZ (cStat 656) para manter a consulta contínua e estável.
- Autorrecuperação em Oscilações: Retenção do cursor de busca para sincronização resiliente sem perder nenhum documento fiscal.
Lançamento do Monitor Fiscal: Captura de NF-e, NFS-e e CT-e Recebidos (DF-e)
API RESTRadar fazendário contínuo que captura automaticamente todos os documentos fiscais eletrônicos emitidos contra o seu CNPJ em âmbito nacional, em conformidade estrita com a NT 2014.002 v1.40 (Julho/2026), download do XML procNFe com itens, Manifestação do Destinatário (MD-e) e Webhooks em tempo real.
- Conformidade NT 2014.002 v1.40 (Julho/2026): alinhamento integral com a norma oficial mais recente do Web Service de Distribuição de DF-e de Interesse dos Atores da NF-e.
- Suporte Nativo a CNPJ Alfanumérico: compatibilidade plena com o padrão alfanumérico da Receita Federal (IN RFB nº 2.229/2024 - formato [0-9A-Z]{12}[0-9]{2}) e suporte a atores pessoa física via tag <CPF>.
- NF-e Recebidas (Ambiente Nacional): varredura sequencial no webservice NfeDistribuicaoDFe com tratamento inteligente de cStat 656 e autorrecuperação do cursor ultNSU devolvido pela SEFAZ.
- Manifestação do Destinatário (MD-e Completo): suporte aos 4 eventos oficiais via API REST e Painel — Ciência da Emissão (210210), Confirmação da Operação (210200), Desconhecimento da Operação (210220) e Operação não Realizada/Recusa de Carga (210240).
- NFS-e Tomadas (Ambiente de Dados Nacional): conexão direta ao ADN da Receita Federal (Resoluções CGSN 169/189) eliminando a dependência de robôs de 5.565 prefeituras, com auditoria de retenções federais (CSRF 4,65% e IRRF 1,5%) e créditos IBS/CBS da Reforma Tributária.
- CT-e Recebidos & Auditoria de Fretes: sincronização direta no Ambiente Nacional (CteDistribuicaoDFe), conciliação automática de cláusulas CIF vs FOB cruzando com a NF-e e registro formal da Prestação do Serviço em Desacordo (Evento 610110) no prazo legal de 45 dias.
- Novos Eventos Fiscais Suportados: captura de Insucesso na Entrega da NF-e (110190/110191), Insucesso na Entrega do CT-e (610130/610131) e Carta de Correção Eletrônica (110110).
- Webhooks em Tempo Real: notificações assinadas com HMAC SHA-256 no header X-NFER-Signature contendo dados parseados e links para download de XML e DANFE/DACTE em PDF.
- Disponibilidade nos Planos: funcionalidade inclusa nativamente nos planos Corporate e Enterprise com 7 dias de teste grátis no onboarding.
Novas Telas de Gestão de Documentos Recebidos & Ativação Sob Demanda
Painel & UIMódulos visuais dedicados no painel web para visualização de notas de entrada, conferência cega de mercadorias no almoxarifado, ações rápidas de manifestação e controle granular de ativação.
- Ativação Voluntária da Busca Automática (Opt-in): novo fluxo que impede concorrência de NSU e penalidade cStat 656 para empresas que já utilizam outro ERP, permitindo ativar a sincronização quando for o momento certo.
- Hub /monitor-fiscal: visão consolidada de compras de mercadorias, serviços tomados e fretes faturados contra a empresa.
- Páginas Especializadas: /monitor-fiscal/nfe-recebidas, /monitor-fiscal/nfse-tomadas e /monitor-fiscal/cte-recebidos com mockups interativos, métricas e documentação de integração.
Tabela Oficial de CFOP v2.10 e NF-e sem Inscrição Estadual (Reforma Tributária)
Regras FiscaisSincronização integral com o Informe Técnico 2023.002 versão 2.10 e liberação para empresas sem Inscrição Estadual (IE) emitirem NF-e modelo 55 como Contribuintes Exclusivos de IBS e CBS (NT 2026.007).
- Tabela de CFOP v2.10 Completa: incorporação de todos os 619 códigos fiscais com títulos oficiais e notas explicativas do Convênio SINIEF s/nº/1970.
- Emissão sem Inscrição Estadual: empresas prestadoras de serviço, locadoras de bens e não-contribuintes de ICMS agora podem configurar NF-e no setup inicial sem travas.
- Regra I08-191 da SEFAZ: validação em tempo real no preflight fiscal garantindo que emissores sem IE usem exclusivamente os 72 CFOPs autorizados (indExcIBSCBS = 1), evitando rejeições na Fazenda.
- Atalhos e Cadastro de Produtos: seleção de CFOP padrão no cadastro de produtos e botões rápidos com códigos oficiais de transporte (5353, 6353, 5352) na emissão de CT-e.
Agentes de IA Fiscais e Servidor MCP com Consulta Semântica de CFOP
API RESTO assistente inteligente de IA e o servidor MCP público ganham novas ferramentas para pesquisar, entender e validar códigos fiscais por linguagem natural.
- Tools MCP Públicas (consultar_cfop e validar_cfop): agentes de IA e clientes externos (Cursor, Claude Desktop, LLMs) agora podem consultar descrições completas e validar CFOPs pré-SEFAZ diretamente pelo MCP da NFER.
- Assistente Fiscal com IA (Sofia e Yaan): pesquisa automática de códigos por termos operacionais como "locação de equipamentos", "remessa para demonstração" ou "devolução de mercadoria".
- Endpoints REST Dedicados: novas rotas GET /v1/cfops, GET /v1/cfops/:cfop e POST /v1/cfops/validar com alta performance e cache em memória.
NF-e de Devolução: Suporte à NT 2025.002-RTC (Regra VC02-14)
Regras FiscaisConformidade integral com as novas regras da SEFAZ para NF-e de devolução (finalidade 4), exigindo amarração obrigatória item a item no grupo XML <det><DFeReferenciado> e eliminando rejeições como 321 e 1010.
- DFeReferenciado por item: inclusão automática da chave de acesso (44 dígitos) e do nItem correspondente do XML original em cada linha devolvida.
- Eliminação de conflitos de cabeçalho: o grupo NFref em <ide> é suprimido em devoluções, evitando a Rejeição 1010 (duplicidade de referência) e atendendo à regra VC02-14.
- Mapeamento reverso automático de CFOPs: derivação inteligente para devolução de venda interna (1202, 1201, 1411) e interestadual (2202, 2201, 2411).
- Enquadramento de Pagamentos: preenchimento automático obrigatório de tPag = "90" (Sem Pagamento) com valor = 0.00 (regras SEFAZ YA02-20 e W16c).
Assistente Expresso de Devolução (1 Clique) e Devolução Parcial
Painel & UINova experiência no painel para emissão de devoluções totais ou parciais em segundos diretamente da listagem de notas fiscais, sem precisar carregar o formulário completo.
- Emissão em 1 Clique: gere e transmita a devolução completa com um único clique a partir de qualquer NF-e autorizada.
- Seleção de Itens e Devolução Parcial: selecione quais produtos devolver com checkboxes, defina a quantidade desejada de cada item e visualize o recálculo do valor total em tempo real.
- Atalho para o Editor Completo: botão para abrir a tela de edição avançada caso queira alterar transportadora, dados adicionais ou frete antes de transmitir.
API REST: Endpoint de Devolução Rápida e Flexibilidade de Pagamentos
API RESTFacilidades para sistemas integrados e ERPs realizarem devoluções completas ou parciais sem refazer cálculos fiscais.
- POST /v1/nfe/:id/devolucao: clona a nota original, inverte CFOPs, vincula DFeReferenciado e prepara o rascunho de devolução total ou parcial com { itens: [...] }.
- Validação Tolerante de Pagamentos: campo pagamentos tornado opcional na criação manual de NF-e (POST /v1/nfe) quando finalidade for 4 (Devolução) ou 3 (Ajuste).
NFS-e Pronta para a Reforma Tributária (IBS / CBS e NT 008/2026)
NFS-e (Serviços)Suporte completo e pioneiro à Reforma Tributária na emissão da NFS-e Nacional: destaque opcional de IBS/CBS na DPS, validação automática da Regra 627 SEFIN e impressão oficial no DANFSe.
- Emissão com IBS/CBS via API REST (POST /api/nfse) e no Painel de Emissão (/dashboard/nfe/create-nfse).
- Conformidade com a Regra 627 do SEFIN Nacional: derivação automática do CST a partir dos 3 primeiros dígitos do cClassTrib, garantindo 100% de consistência.
- Novo quadro oficial de tributação IBS e CBS desenhado no DANFSe em PDF conforme a NT 008/2026 SE/CGNFS-e.
- Operação ponta a ponta: emissão própria (Outbound) e captura automática de notas de fornecedores (Inbound via ADN) com persistência de valores de IBS e CBS.
Reforma Tributária Interativa no Painel de NFS-e
Painel & UIInterface intuitiva com toggle opcional para preenchimento de Classificação Tributária Nacional (cClassTrib) e alíquotas com cálculo instantâneo.
- Campos de Alíquota IBS Municipal, IBS Estadual e CBS Federal com apuração automática de valores em tempo real.
- Totalmente retrocompatível: empresas no modelo tradicional (Simples Nacional / ISSQN puro) continuam emitindo sem nenhuma alteração.
Documentação e Exemplos de IBS/CBS na NFS-e
API RESTGuia técnico atualizado com contratos do bloco ibsCbs, exemplos práticos de payloads JSON e detalhamento das regras de transição (2026-2032).
- Exemplos de requisição com destaque de alíquotas oficiais de 2026 (IBS Estadual 0,10%, IBS Municipal 0,00% e CBS Federal 0,90%).
- Referência completa das propriedades no schema Zod e na documentação pública para desenvolvedores.
Emissão de CT-e (Modelo 57)
CT-e TransporteSuporte completo para emissão, assinatura digital e transmissão de Conhecimento de Transporte Eletrônico rodoviário.
- Emissão facilitada pelo Painel (/dashboard/cte) e via API REST (POST /v1/cte).
- Suporte a fretes intermunicipais e interestaduais com cálculo automático de pedágios e taxas.
- Geração instantânea do DACTE em PDF com QR Code e download do XML autorizado.
Eventos de CT-e: CC-e, Inutilização e Substituição
CT-e TransporteGestão completa do ciclo de vida do CT-e perante a SEFAZ.
- Carta de Correção Eletrônica (CC-e) pelo Painel e API com envio assíncrono.
- Inutilização de numeração integrada diretamente aos webservices oficiais da SEFAZ.
- Emissão guiada de CT-e de Substituição e Anulação com vínculo às chaves anteriores.
Cancelamento de CT-e
CT-e TransporteCancelamento regulamentar de conhecimentos autorizados dentro dos prazos legais de transporte.
- Disponível diretamente no menu de ações do painel ou via endpoint POST /v1/cte/:id/cancel.
- Validação de justificativa mínima e transmissão assíncrona com retorno de protocolo em tempo real.
Documentação e Exemplos de CT-e
API RESTPublicação do guia técnico de integração com referências de endpoints, conceitos e payloads práticos.
- Exemplos prontos em cURL e JSON cobrindo todo o fluxo de rascunho, envio e consulta.
- Detalhamento de tomadores de serviço, amarração de NF-es de carga e download de DACTE/XML.
Retransmissão Automática em Contingência
NF-e / NFC-eSincronização autônoma de notas fiscais emitidas em contingência offline (NFC-e) e EPEC.
- Sondagem contínua de retorno da SEFAZ com reenvio em lotes a cada 15 minutos.
- Conformidade com os prazos legais de 24h para NFC-e e 168h para EPEC.
Alertas e Contadores de Contingência no Painel
Painel & UIAcompanhamento em tempo real de documentos aguardando transmissão à SEFAZ.
- Banner com contagem no Dashboard principal com link direto para a listagem filtrada.
- Filtro rápido dedicado e métricas em tempo real no Painel Master.
Chaveamento Automático para SVC (Zero Timeout)
NF-e / NFC-eEnvio imediato para contingência nacional (SVC-AN ou SVC-RS) em caso de instabilidade na SEFAZ de origem.
- Consulta prévia instantânea de saúde da UF, evitando travamentos e lentidões na emissão.
- Proteção nativa contra rejeições de chaveamento indevido.
Histórico de 7 Dias no Monitor SEFAZ
Painel & UIVisão diária e detalhada da disponibilidade de todos os autorizadores fiscais em /status-sefaz.
- Histórico organizado por data com horários e duração consolidada de cada incidente.
- Confirmação ativa em três camadas antes de declarar indisponibilidade.
DANFSe em PDF no Padrão Nacional
NFS-e (Serviços)Renderização de alta fidelidade do DANFSe conforme a especificação oficial da NFS-e Nacional.
- Cabeçalho oficial com logotipo da NFS-e e marca d’água automática conforme o status da nota.
- Resolução automática do nome do município a partir do código IBGE.
Substituição de NFS-e Nacional
NFS-e (Serviços)Fluxo unificado para emissão de nota substituta e vinculação à nota anterior.
- Disponível via API (POST /v1/nfse/:id/substituir) ou com o bloco de substituição na emissão.
- Ação rápida no Painel com pré-preenchimento dos dados do tomador e do serviço.
Status SEFAZ em Tempo Real
Painel & UIPágina pública de telemetria cobrindo os 27 estados e servidores de contingência SVC em /status-sefaz.
- Sondagens a cada 60 segundos com medição de latência e tempos médios de resposta.
- Endpoint público GET /api/public/sefaz-status com cache em memória para integrações.
Telemetria SEFAZ nos Assistentes de IA
API RESTAssistentes de inteligência artificial agora consultam a disponibilidade real dos servidores estaduais.
- Respostas precisas e fundamentadas sobre oscilações da SEFAZ e notas em contingência.
- Disponível no chat da plataforma e para conexões externas via protocolo MCP.
Operações Isentas no Regime Normal
Regras FiscaisGeração do XML otimizada para empresas do Regime Normal em operações com CST 40, 41 e 50 (isentas, imunes ou com suspensão de ICMS).
Normalização de Tributação Mista e CSTs Especiais
NF-e / NFC-eTratamento automático para grupos com Substituição Tributária (CST 60) e enquadramentos fiscais especiais, prevenindo rejeições na SEFAZ.
Validação de Esquema XML Pré-Transmissão
NF-e / NFC-eChecagem estrutural do XML (XSD 4.00) diretamente no servidor antes do envio, bloqueando dados inválidos e evitando penalidades por consumo indevido.
Identificação de Origem e Ajuda com IA nas Rejeições
Painel & UIExibição da origem da emissão (Painel Web ou API) e botão de ajuda rápida com IA contextualizada para corrigir erros da SEFAZ.
Novo Fluxo de Cancelamento com Timer SEFAZ
NF-e / NFC-eInterface aprimorada de cancelamento no Painel com contagem regressiva do prazo legal (24h para NF-e e 30min para NFC-e) e justificativas rápidas.
Visão Rápida de Clientes e Filtros Avançados
Painel & UIFicha rápida ao clicar na linha do cliente para consultar dados fiscais, endereço, histórico de notas e novos filtros por Inscrição Estadual.
Validação Offline de Inscrição Estadual (IE)
Regras FiscaisCálculo algorítmico do dígito verificador para todas as 27 UFs no frontend, alertando sobre regras de não contribuinte e consumidor final.
Preenchimento Automático de Endereço via CEP
Painel & UIBusca instantânea de logradouro, bairro e cidade pelo CEP com posicionamento automático de foco no campo de número do formulário.
Comprovante de Carta de Correção (DACCE em PDF)
Regras FiscaisGeração automática do DACCE em PDF com QR Code de autenticidade fiscal via endpoint GET /v1/nfe/:id/dacce e no Painel Web.
Controle de Status em Clientes e Produtos
API RESTNovo campo opcional status (ativo ou rascunho) nos cadastros, mantendo total retrocompatibilidade com integrações ativas.
Novo Cadastro Dinâmico de Empresas
Painel & UIFluxo inicial com busca automática de razão social e endereço pelo CNPJ na Receita Federal e auxílio guiado pela assistente Sofia.
Ambientes e Séries Isoladas por Modelo Fiscal
Regras FiscaisConfiguração independente de séries, numeração e ambientes de transmissão (Homologação e Produção) para NF-e, NFC-e e NFS-e.
Módulo de NFS-e Nacional Unificada (DPS/SEFIN)
NFS-e (Serviços)Adequação à Resolução CGSN nº 189 com motor unificado de notas de serviço e busca por códigos de atividade LC 116 e NBS.
Monitoramento de Vencimento do Certificado A1
Painel & UIAvisos visuais no painel e alertas automáticos por e-mail com 30, 15, 7, 3 e 1 dia de antecedência antes de expirar o certificado.
Assistente IA Integrado à Documentação
API RESTBarra flutuante para tirar dúvidas de desenvolvimento e diagnosticar snippets de payload ou mensagens de retorno da SEFAZ.
Cálculo Automático de Tributos da Lei do IBPT
Regras FiscaisCálculo da carga tributária estimada (federal, estadual e municipal) e inclusão automática nas observações do DANFE conforme a Lei 12.741/2012.
Correção e Retransmissão sem Perda de Numeração
NF-e / NFC-ePossibilidade de editar notas rejeitadas pela SEFAZ e reenviar mantendo o mesmo número fiscal e série.
Identificação Automática do Código IBGE
API RESTA API resolve o código oficial do município diretamente a partir do CEP ou do par UF e cidade informados nos cadastros.
Cadastro Automático de Destinatários na Emissão
API RESTSuporte ao envio dos dados completos do cliente diretamente no payload da nota, criando ou atualizando o cadastro de forma transparente.
Contingência Automática SVC
NF-e / NFC-eDetecção de instabilidade na SEFAZ estadual com redirecionamento contínuo para os servidores SVC-AN ou SVC-RS sem interrupção de serviço.
Emissão de NF-e em Lote
NF-e / NFC-eNovo endpoint POST /v1/nfe/batch para envio simultâneo de até 50 notas fiscais em uma única requisição com acompanhamento via webhook.
Políticas de Rate Limit por Plano
Infra & SegurançaControle de vazão distribuído por empresa com limites escalonados por plano e cabeçalhos padrão Retry-After.
Webhooks com Assinatura Criptográfica (HMAC SHA-256)
API RESTNotificações de autorização, cancelamento e eventos com cabeçalho de assinatura de segurança X-Nfer-Signature e histórico de envios.
Gráficos e Indicadores de Emissão
Painel & UINovo painel analítico com volumes de notas autorizadas, canceladas e rejeitadas, com filtros por período e ambiente.
Rateio de Frete e Múltiplas Formas de Pagamento
Regras FiscaisDistribuição proporcional de despesas e frete entre os itens e suporte a pagamentos combinados conforme NT 2020.006.
Processamento Assíncrono com Filas (BullMQ)
Infra & SegurançaComunicação com a SEFAZ desacoplada em workers dedicados com retentativas exponenciais automáticas e suporte a alto volume simultâneo.
Exportação Mensal de XMLs para Contabilidade
Regras FiscaisGeração periódica de pacotes compactados (.ZIP) com todos os XMLs emitidos no mês para envio ao contador.
White-Label com Domínio Personalizado
Painel & UIPersonalização de links públicos de consulta de DANFE e download de XML utilizando a marca e o domínio próprio da sua empresa.
Primeira Versão do Módulo de NFS-e
NFS-e (Serviços)Lançamento da emissão de notas de serviço com suporte aos principais provedores municipais e apuração de retenções federais.
Ambiente de Testes (Sandbox)
API RESTChaves de API separadas para testes no ambiente de homologação da SEFAZ antes de iniciar emissões em produção.
Gestão Multi-Empresas e Perfis para Contabilidade
Painel & UITroca rápida entre diferentes CNPJs na mesma conta, convite de membros e permissão de acesso exclusiva para escritórios contábeis.
Trilha de Auditoria e Logs de Ações
Infra & SegurançaRegistro detalhado de chamadas da API e ações realizadas no painel (emissões, cancelamentos e alterações de dados).
Eventos de Cancelamento e Carta de Correção (CC-e)
NF-e / NFC-eSuporte completo a eventos fiscais posteriores com validação de prazos da SEFAZ e emissão de comprovantes em PDF.
Validação Automatizada de Inscrição Estadual (IE)
Regras FiscaisMotor de checagem dos dígitos verificadores de IE para todos os 27 estados, reduzindo rejeições comuns de cadastro.
Lançamento do Emissor de NFC-e
NF-e / NFC-eEmissão de cupom fiscal eletrônico (modelo 65) para varejo físico com QR Code oficial e suporte a impressoras térmicas (80mm e 58mm).
Contingência Offline para NFC-e
NF-e / NFC-ePossibilidade de vender mesmo sem internet no caixa, com armazenamento local seguro e transmissão em segundo plano ao reconectar.
Novo Motor de Visualização de DANFE em PDF
Painel & UIRenderizador veloz com suporte a logotipo colorido da empresa emitente, códigos de barras nítidos e layout adaptado para telas móveis.
Envio Automático de Notas por E-mail
API RESTDisparo imediato do DANFE em PDF e arquivo XML diretamente para o e-mail do cliente informado na emissão.
Perfis Fiscais para Cálculo Automático
Regras FiscaisConfiguração de regras tributárias pré-definidas (ICMS, CSOSN, PIS, COFINS), permitindo referenciar o perfil para cálculo automático na nota.
Controle de Séries e Numeração Sequencial
API RESTGestão atômica de numeração por série e CNPJ emitente, prevenindo furos ou duplicidades de numeração na SEFAZ.
Lançamento da API NFER
NF-e / NFC-eEstreia da API REST em nuvem para emissão de NF-e (modelo 55), assinatura digital de XML via Certificado A1 e comunicação direta com a SEFAZ.
Painel de Controle Web
Painel & UIInterface moderna para consulta de notas fiscais autorizadas, gestão de certificados digitais e credenciais de API.