{"id":146,"date":"2026-11-06T16:57:22","date_gmt":"2026-11-06T19:57:22","guid":{"rendered":"https:\/\/www.itworks.com.br\/blog\/?p=146"},"modified":"2026-11-06T16:57:22","modified_gmt":"2026-11-06T19:57:22","slug":"homologacao-nf-e-ibs-cbs-checklist-tecnico-para-emissores-e-erps","status":"publish","type":"post","link":"https:\/\/www.itworks.com.br\/blog\/homologacao-nf-e-ibs-cbs-checklist-tecnico-para-emissores-e-erps\/","title":{"rendered":"Homologa\u00e7\u00e3o NF-e IBS CBS: checklist t\u00e9cnico para emissores e ERPs"},"content":{"rendered":"<h2>O cen\u00e1rio da homologa\u00e7\u00e3o t\u00e9cnica da NF-e para a Reforma Tribut\u00e1ria<\/h2>\n<p>A transi\u00e7\u00e3o dos sistemas de faturamento para o modelo da Reforma Tribut\u00e1ria exige que as software houses ajustem suas estruturas antes da virada das regras fiscais. Segundo a Nota T\u00e9cnica 2025.002, publicada pelo ENCAT em conjunto com a Receita Federal e o Comit\u00ea Gestor do IBS, o ambiente de homologa\u00e7\u00e3o passou a exigir o preenchimento dos grupos de tributa\u00e7\u00e3o do IBS e da CBS para contribuintes do Regime Normal desde 01\/07\/2026, com ativa\u00e7\u00e3o nos autorizadores da SEFAZ Virtual do RS a partir de 06\/07\/2026. Esse movimento transferiu a discuss\u00e3o te\u00f3rica dos tributos sobre o consumo diretamente para o c\u00f3digo dos ERPs e das APIs emissoras, demandando rotinas de valida\u00e7\u00e3o de schemas, confer\u00eancia de regras de totaliza\u00e7\u00e3o e tratamento de novas respostas dos servidores autorizadores.<\/p>\n<p>Embora a vers\u00e3o 1.51 da Nota T\u00e9cnica 2025.002 tenha classificado a regra UB12-10, referente \u00e0 rejei\u00e7\u00e3o por aus\u00eancia de IBS e CBS no ambiente de produ\u00e7\u00e3o, como implementa\u00e7\u00e3o futura, os testes em homologa\u00e7\u00e3o permanecem ativos e indispens\u00e1veis. O ano de 2026 foi desenhado como per\u00edodo de teste com al\u00edquotas experimentais de 0,1% para o IBS e 0,9% para a CBS, conforme estabelecido na Lei Complementar n\u00ba 214\/2025, o que torna o ambiente de testes o \u00fanico espa\u00e7o seguro para mapear inconsist\u00eancias antes que a produ\u00e7\u00e3o comece a rejeitar notas ou calcular reten\u00e7\u00f5es de forma inadequada.<\/p>\n<h2>Checklist t\u00e9cnico de homologa\u00e7\u00e3o para o schema XML da NT 2025.002<\/h2>\n<p>Para conduzir os testes de homologa\u00e7\u00e3o NF-e IBS CBS com seguran\u00e7a, a equipe de engenharia do emissor precisa cobrir pontos espec\u00edficos do layout e da comunica\u00e7\u00e3o com os web services. A lista de verifica\u00e7\u00f5es a seguir organiza os pontos de maior atrito registrados durante os testes nos autorizadores estaduais:<\/p>\n<ul>\n<li><strong>Extens\u00e3o do campo cStat:<\/strong> verificar se o banco de dados e os parsers de retorno suportam a extens\u00e3o para 4 d\u00edgitos no c\u00f3digo de status de retorno, conforme padronizado pela Nota T\u00e9cnica 2025.002, evitando estouro de campo nas respostas da SEFAZ.<\/li>\n<li><strong>Tamanho do protocolo de autoriza\u00e7\u00e3o (nProt):<\/strong> ajustar o armazenamento interno para suportar at\u00e9 17 posi\u00e7\u00f5es no n\u00famero do protocolo retornado pelos autorizadores, de acordo com o MOC da NF-e referenciado na Nota T\u00e9cnica 2025.002.<\/li>\n<li><strong>Novas finalidades de emiss\u00e3o (finNFe):<\/strong> implementar o tratamento dos c\u00f3digos 5 (Nota de Cr\u00e9dito) e 6 (Nota de D\u00e9bito), criados pela Nota T\u00e9cnica 2025.002 para permitir os ajustes e estornos pr\u00f3prios do novo modelo tribut\u00e1rio.<\/li>\n<li><strong>Preenchimento dos novos grupos de tributa\u00e7\u00e3o:<\/strong> gerar as tags filhas de IBS e CBS no detalhamento dos itens e nos blocos de totais da nota fiscal, respeitando as al\u00edquotas de teste de 0,1% para IBS e 0,9% para CBS fixadas na Lei Complementar n\u00ba 214\/2025 para o exerc\u00edcio de 2026.<\/li>\n<li><strong>Regras de arredondamento e totalizadores:<\/strong> validar se o somat\u00f3rio dos valores de IBS e CBS destacados em cada item coincide exatamente com os campos de totaliza\u00e7\u00e3o do documento fiscal, impedindo rejei\u00e7\u00f5es matem\u00e1ticas na SEFAZ.<\/li>\n<li><strong>Controle de conting\u00eancia:<\/strong> testar se as notas geradas em conting\u00eancia mant\u00eam os novos grupos tribut\u00e1rios \u00edntegros na assinatura digital e no posterior envio ao ambiente da SEFAZ.<\/li>\n<\/ul>\n<h2>Desafios de banco de dados e regras de neg\u00f3cio nos ERPs<\/h2>\n<p>A altera\u00e7\u00e3o do layout n\u00e3o se restringe \u00e0 camada de envio do XML, porque ela repercute diretamente na modelagem relacional dos sistemas de gest\u00e3o. O acr\u00e9scimo das novas finalidades de emiss\u00e3o para notas de d\u00e9bito e cr\u00e9dito, identificadas pelos c\u00f3digos 5 e 6 na tag finNFe segundo a Nota T\u00e9cnica 2025.002, obriga os sistemas a repensarem o v\u00ednculo entre notas fiscais e movimenta\u00e7\u00e3o f\u00edsica de estoque, uma vez que tais documentos realizam ajustes financeiros e tribut\u00e1rios sem necessariamente representarem circula\u00e7\u00e3o de mercadoria.<\/p>\n<p>Outro ponto cr\u00edtico est\u00e1 na capacidade de armazenar o retorno dos servi\u00e7os autorizadores. A mudan\u00e7a do campo cStat para 4 d\u00edgitos e a expans\u00e3o do campo nProt para at\u00e9 17 posi\u00e7\u00f5es, conforme previsto na Nota T\u00e9cnica 2025.002, podem provocar falhas silenciosas de persist\u00eancia se as tabelas de hist\u00f3rico de mensagens e logs do sistema mantiverem os limites legados. A homologa\u00e7\u00e3o precisa incluir testes de estresse em que o sistema receba c\u00f3digos de rejei\u00e7\u00e3o novos e continue operando sem travar a fila de processamento ass\u00edncrono.<\/p>\n<p>Tamb\u00e9m \u00e9 preciso considerar a coexist\u00eancia dos tributos vigentes com os novos impostos. A Lei Complementar n\u00ba 214\/2025, sancionada com 544 artigos em 16\/01\/2025, estabelece o in\u00edcio da vig\u00eancia plena da CBS para 01\/01\/2027, momento em que o PIS e a Cofins ser\u00e3o extintos e a transi\u00e7\u00e3o do IBS ter\u00e1 in\u00edcio progressivo. Durante o per\u00edodo de teste regulamentado pela Lei Complementar n\u00ba 214\/2025, os sistemas precisam conviver com os campos legados de ICMS, ISS, PIS e Cofins operando em conjunto com os blocos novos, o que duplica as vari\u00e1veis tribut\u00e1rias dentro de cada item faturado.<\/p>\n<h2>Integra\u00e7\u00e3o simplificada via NFeCerta para software houses<\/h2>\n<p>Para evitar a reformula\u00e7\u00e3o profunda de todos os motores legados de mensageria e regras de valida\u00e7\u00e3o tribut\u00e1ria, muitas plataformas optam por delegar a comunica\u00e7\u00e3o com a SEFAZ a componentes especializados. A API do NFeCerta atua diretamente nessa camada t\u00e9cnica, recebendo a estrutura de dados comerciais do ERP e gerando o XML em conformidade estrita com as regras da Nota T\u00e9cnica 2025.002.<\/p>\n<p>Ao centralizar as chamadas na API do NFeCerta, a software house reduz o esfor\u00e7o de acompanhar as frequentes atualiza\u00e7\u00f5es de esquemas, como as vers\u00f5es 1.51 e 1.52 da Nota T\u00e9cnica 2025.002, mantendo seu time focado na experi\u00eancia de venda e gest\u00e3o do cliente final. A mensageria especializada absorve os ajustes de tamanho de campos, como os 4 d\u00edgitos do cStat e as 17 posi\u00e7\u00f5es do nProt, garantindo que o retorno seja entregue tratado e estruturado para o sistema de retaguarda.<\/p>\n<h2>Perguntas frequentes sobre homologa\u00e7\u00e3o NF-e IBS CBS<\/h2>\n<p><strong>A emiss\u00e3o de IBS e CBS j\u00e1 gera rejei\u00e7\u00e3o obrigat\u00f3ria em ambiente de produ\u00e7\u00e3o?<\/strong><br \/>N\u00e3o. Conforme a vers\u00e3o 1.51 da Nota T\u00e9cnica 2025.002, a regra UB12-10, que previa a rejei\u00e7\u00e3o em produ\u00e7\u00e3o para notas sem IBS e CBS, teve sua data alterada para implementa\u00e7\u00e3o futura por determina\u00e7\u00e3o do comit\u00ea gestor, mantendo a obrigatoriedade apenas em ambiente de homologa\u00e7\u00e3o.<\/p>\n<p><strong>Quais al\u00edquotas de teste devem ser informadas na homologa\u00e7\u00e3o em 2026?<\/strong><br \/>De acordo com a Lei Complementar n\u00ba 214\/2025 e a Emenda Constitucional n\u00ba 132\/2023, as al\u00edquotas experimentais fixadas para o ano de 2026 s\u00e3o de 0,1% para o IBS e 0,9% para a CBS.<\/p>\n<p><strong>O que mudou no tamanho dos campos de retorno da SEFAZ na NT 2025.002?<\/strong><br \/>A Nota T\u00e9cnica 2025.002 expandiu o c\u00f3digo de status de retorno (cStat) para 4 d\u00edgitos e ampliou o n\u00famero de protocolo de autoriza\u00e7\u00e3o (nProt) para at\u00e9 17 posi\u00e7\u00f5es.<\/p>\n<p><strong>Quais s\u00e3o os novos c\u00f3digos de finalidade de emiss\u00e3o criados para a Reforma Tribut\u00e1ria?<\/strong><br \/>A Nota T\u00e9cnica 2025.002 introduziu na tag finNFe o c\u00f3digo 5 para Nota de Cr\u00e9dito e o c\u00f3digo 6 para Nota de D\u00e9bito, ambos direcionados a ajustes tribut\u00e1rios.<\/p>\n<hr>\n<p><strong>Acompanhe a Reforma sem virar especialista.<\/strong> A IT Works envia por e-mail as principais not\u00edcias e insights tribut\u00e1rios da semana. Para receber, assine a <a href=\"https:\/\/www.itworks.com.br\/blog\">Newsletter da Reforma<\/a> no formul\u00e1rio desta p\u00e1gina.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>O cen\u00e1rio da homologa\u00e7\u00e3o t\u00e9cnica da NF-e para a Reforma Tribut\u00e1ria A transi\u00e7\u00e3o dos sistemas de faturamento para o modelo da Reforma Tribut\u00e1ria exige que as software houses [&hellip;]<\/p>\n","protected":false},"author":5,"featured_media":157,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[9],"tags":[],"class_list":["post-146","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tecnologia-fiscal"],"_links":{"self":[{"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/posts\/146","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/comments?post=146"}],"version-history":[{"count":1,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/posts\/146\/revisions"}],"predecessor-version":[{"id":158,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/posts\/146\/revisions\/158"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/media\/157"}],"wp:attachment":[{"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/media?parent=146"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/categories?post=146"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.itworks.com.br\/blog\/wp-json\/wp\/v2\/tags?post=146"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}