Python
import os
html_content_v2 = """<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<style>
@page {
size: A4;
margin: 18mm 12mm 18mm 12mm;
@top-right {
content: "Laudo Técnico Detalhado - Cidade Limpa - v2";
font-family: 'Arial', sans-serif;
font-size: 8pt;
color: #4A5568;
}
@bottom-right {
content: "Página " counter(page) " de " counter(pages);
font-family: 'Arial', sans-serif;
font-size: 8pt;
color: #4A5568;
}
}
body {
font-family: 'Arial', sans-serif;
font-size: 9.5pt;
line-height: 1.4;
color: #2D3748;
margin: 0;
padding: 0;
}
h1 {
font-size: 16pt;
color: #0F2942;
text-align: center;
margin-top: 0;
margin-bottom: 20px;
text-transform: uppercase;
border-bottom: 3px solid #3182CE;
padding-bottom: 12px;
}
h2 {
font-size: 12pt;
color: #2B6CB0;
margin-top: 22px;
margin-bottom: 10px;
border-left: 5px solid #0F2942;
padding-left: 10px;
page-break-after: avoid;
}
h3 {
font-size: 10.5pt;
color: #1A202C;
margin-top: 14px;
margin-bottom: 6px;
font-weight: bold;
page-break-after: avoid;
}
p{
margin-top: 0;
margin-bottom: 8px;
text-align: justify;
}
table {
width: 100%;
border-collapse: collapse;
margin-top: 8px;
margin-bottom: 14px;
font-size: 8.5pt;
}
th {
background-color: #0F2942;
color: white;
font-weight: bold;
text-align: left;
padding: 7px 9px;
border: 1px solid #CBD5E0;
}
td {
padding: 7px 9px;
border: 1px solid #CBD5E0;
vertical-align: top;
text-align: left;
}
tr:nth-child(even) {
background-color: #F7FAFC;
}
.alert-box {
background-color: #FFF5F5;
border-left: 5px solid #E53E3E;
color: #9B2C2C;
padding: 12px;
margin: 14px 0;
font-size: 9pt;
}
.recommendation-box {
background-color: #F0F4F8;
border-left: 5px solid #3182CE;
color: #2B6CB0;
padding: 12px;
margin: 14px 0;
font-size: 9pt;
}
.code-container {
background-color: #EDF2F7;
border: 1px solid #E2E8F0;
padding: 10px;
font-family: 'Courier New', Courier, monospace;
font-size: 8pt;
margin: 10px 0;
white-space: pre-wrap;
}
ul, ol {
margin-top: 0;
margin-bottom: 8px;
padding-left: 18px;
}
li {
margin-bottom: 4px;
text-align: justify;
}
.bold {
font-weight: bold;
}
.center {
text-align: center;
}
.section-ref {
background-color: #EDF2F7;
padding: 12px;
margin-top: 25px;
border-top: 1px solid #CBD5E0;
}
</style>
<title>Laudo Técnico de Impacto e Governança Tecnológica - Versão
Ampliada</title>
</head>
<body>
<h1>Laudo Técnico de Impacto e Governança Tecnológica</h1>
<p class="center bold" style="font-size: 10.5pt; margin-bottom: 25px;">
Análise de Ciclo de Vida de Software, Impacto de Arquitetura de
Leiautes e Dependência de Infraestrutura Federal<br>
Cliente: Cidade Limpa | ID Documento: LT-RT-2026-V2 | Data: 01 de
Julho de 2026
</p>
<h2>1. Objetivo do Laudo Técnico</h2>
<p>
Este laudo técnico de engenharia de software e governança
corporativa estende a análise de riscos fiscais e sistêmicos para o
ecossistema ERP TOTVS Protheus do cliente <span class="bold">Cidade
Limpa</span>. O escopo foca na rastreabilidade exata de alterações em
nível de metadados, arquivos de transmissão XML, e impactos de dicionário
nas bases de dados relacionadas às adequações da Reforma Tributária. Com
base no barramento técnico e no bloqueio de entrega da software house
(TOTVS), fundamenta-se a governança de engenharia necessária para
justificar o congelamento do projeto.
</p>
<h2>2. Cronologia Histórica, Prazos Federais e Análise de Ciclo de Vida
de Leiautes</h2>
<p>
O Governo Federal estruturou a transição do IVA Dual (IBS/CBS)
determinando que o ano de 2026 opere sob regime de ensaio regulatório
com alíquota de 1% compensável. Entretanto, os artefatos de faturamento e
os layouts das obrigações acessórias sofreram profundas alterações
estruturais ao longo do primeiro semestre de 2026, conforme detalhado na
linha do tempo abaixo:
</p>
<h3>2.1 Linha do Tempo e Mapeamento de Mudanças de Regras
(Inclusões, Alterações e Descontinuações)</h3>
<ul>
<li>
<span class="bold">14 de Maio de 2026 – Publicação da Nota
Técnica nº 005 (Emissão de NFS-e de Locação):</span>
<br><span class="bold">Incluso:</span> Parâmetros no schema
nacional para identificar contratos de locação pura de bens móveis (sem
incidência de ISSQN sob a Súmula Vinculante 31 do STF), porém sujeitos à
agregação de informações para fins de futura incidência de CBS/IBS.
<br><span class="bold">Alterado:</span> Regras de
obrigatoriedade do preenchimento da tag <span class="code-
container"><ItemListaServico></span>, que passa a ser opcional
quando mapeada natureza de locação.
<br><span class="bold">Descontinuado:</span> Rejeição
automática de Notas Fiscais Eletrônicas de Serviço que não continham
código de atividade associado à Lei Complementar nº 116/2003, eliminando
a dependência de emissão por notas avulsas ou faturas comerciais externas
ao sistema ERP.
</li>
<li>
<span class="bold">04 de Junho de 2026 – Publicação da Nota
Técnica nº 009/2026 (Leiaute Nacional v1.04 da NFS-e):</span>
<br><span class="bold">Incluso:</span> Grupo de tags para o
tratamento de Notas de Crédito e Débito de Ajuste do IVA; inserção do
grupo de identificação do CNPJ Alfanumérico (padrão Receita Federal de
2026); estruturação dos campos para o Simples Nacional adaptado ao
regime monofásico e dual de transição.
<br><span class="bold">Alterado:</span> Fusão completa e
substituição de múltiplas tags de abatimento e bases de cálculo reduzidas
pelo campo unificado <span class="bold">'Valor de Ajuste BC'</span>.
<br><span class="bold">Descontinuado:</span> Descontinuação
e obsolescência planejada do leiaute estrutural v1.03 da Declaração de
Prestação de Serviços (DPS).
</li>
<li>
<span class="bold">15 de Junho de 2026 – Publicação Consolidada
das Notas Técnicas nº 007 e nº 008:</span>
<br><span class="bold">NT 007 (Validação e Arredondamento
Bancário):</span> <span class="bold">Incluso</span> algoritmo de
validação matemática estrita que exige o truncamento bancário (IEEE 754)
para divisões de centavos entre as alíquotas do IBS do Município de Origem
e Município de Destino. <span class="bold">Alterado</span> o tratamento
de tolerância de arredondamento de R$ 0,05 para R$ 0,00.
<br><span class="bold">NT 008 (DANFSe v2 e Eventos de
Ajuste):</span> <span class="bold">Incluso</span> novo manual de
identidade visual e renderização gráfica do modelo impresso DANFSe v2
com campos segregados de CBS e IBS. <span
class="bold">Descontinuado</span> o direito de uso do layout gráfico
clássico (DANFSe v1) para municípios homologados no ambiente nacional.
</li>
</ul>
<h2>3. Detalhamento Estrutural dos Arquivos e Impacto em Metadados
(XML e DANFSe)</h2>
<p>
As adequações impostas exigem a reconfiguração dos nós de dados
estruturais. Abaixo, exemplifica-se o comportamento teórico esperado para
as alterações no XML de faturamento, destacando a fusão imposta pela NT
009:
</p>
<div class="code-container">
<!-- Estrutura v1.04 - NT 009 Unificação de Ajustes -->
<InfDPS Id="DPS12345">
<tpRegraTributaria>1</tpRegraTributaria>
<vAjusteBC>1500.00</vAjusteBC> <!-- Campo Unificado
'Valor de Ajuste BC' -->
<IBS>
<vAl_IBS>0.001</vAl_IBS> <!-- Alíquota de Ensaio 2026 --
>
<vIBS>1.50</vIBS>
</IBS>
<CBS>
<vAl_CBS>0.009</vAl_CBS> <!-- Alíquota de Ensaio 2026 --
>
<vCBS>13.50</vCBS>
</CBS>
</InfDPS>
</div>
<p>
No <span class="bold">DANFSe v2 (NT 008)</span>, a alteração
deixa de ser puramente lógica e passa a impactar o motor de impressão do
Protheus (gerenciador de relatórios e arquivos de mapeamento do TSS). O
documento passa a exigir colunas dedicadas para detalhar a retenção na
fonte do IVA Dual, alterando o espaçamento padrão e exigindo papel A4 em
modo retrato com fontes reduzidas para evitar estouro de margem.
</p>
<h2>4. Impactos Estruturais no Sistema TOTVS Protheus (Releases 24.10
e 25.10)</h2>
<p>
A arquitetura do TOTVS Protheus responde a essas regulamentações
por meio de duas vertentes: dicionário de dados local (tabelas <span
class="bold">SX3 - Campos</span>, <span class="bold">SX2 -
Tabelas</span>, <span class="bold">SIX - Índices</span>) e o barramento
de comunicação **TSS (TOTVS Service SPED)** via protocolo SOAP/XML.
</p>
<h3>4.1 Matriz de Impacto por Release e Status de Chamados</h3>
<table>
<thead>
<tr>
<th>Chamado Oficial</th>
<th>Origem Legal</th>
<th>Impacto e Alterações na Release 24.10</th>
<th>Impacto e Alterações na Release 25.10</th>
<th>Status Atual do Chamado</th>
</tr>
</thead>
<tbody>
<tr>
<td class="bold">#26941475</td>
<td>NT 005 (Locação)</td>
<td>Exige aplicação manual de Patch do console TSS e criação
de gatilhos customizados na tabela SF4 (Tipos de Entrada e Saída) para
desviar da validação de ISS.</td>
<td>Implementado nativamente via rotina FISA022 (Engine de
Tributos) utilizando o campo de Diferimento/Isenção técnica parametrizado
de forma padrão.</td>
<td><span style="color: #3182CE; font-weight:
bold;">Aguardando Homologação de Schemas</span></td>
</tr>
<tr>
<td class="bold">#29244310</td>
<td>NT 007 (Arredondamento)</td>
<td>Alteração no fonte interno <span
class="bold">MATXFIS</span> (Motor Fiscal Clássico). Risco de quebra de
arredondamentos de outras moedas ou processos legados de
faturamento.</td>
<td>Ajuste centralizado na API de Tributos do Protheus.
Atualização limpa via release incremental de expedição contínua
(mecanismo TAF/TSS).</td>
<td><span style="color: #3182CE; font-weight: bold;">Aberto -
Sem Previsão Técnica</span></td>
</tr>
<tr>
<td class="bold">#29244487</td>
<td>NT 008 (Layout DANFSe)</td>
<td>Obrigatoriedade de substituição dos repositórios de
impressão antigos (.RTM). Exige atualização de DLLs gráficas no servidor de
Application Server.</td>
<td>Atualização automatizada via painel de controle do TSS.
Layout v2 integrado ao dicionário de dados padrão expansível do
Protheus.</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado por Dependência Externa</span></td>
</tr>
<tr>
<td class="bold">#29244640</td>
<td>NT 009 (Ajuste BC)</td>
<td>Alto Impacto: Criação de campos manuais via Configurador
(SIGACFG) para persistir o novo campo de Ajuste de BC nas tabelas SD2
(Itens de Venda) e SFT (Livros Fiscais).</td>
<td>Campos previamente reservados no dicionário padrão de
fábrica (campos expansíveis de Reforma Tributária da TOTVS), aguardando
liberação do Update de Dicionário.</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado por Dependência Externa</span></td>
</tr>
</tbody>
</table>
<h2>5. Posicionamento Técnico Transigente do Desenvolvimento
TSS/NFSe da TOTVS</h2>
<p>
Para fins de auditoria interna e salvaguarda do gerenciamento do
projeto da Cidade Limpa, transcreve-se abaixo, na íntegra, a manifestação e
o bloqueio emitido pelo time de Engenharia de Produto e Desenvolvimento
de Software da TOTVS em 04 de junho de 2026:
</p>
<div style="background-color: #F7FAFC; border: 1px solid #CBD5E0;
padding: 12px; font-style: italic; font-size: 9pt; margin-bottom: 14px;">
<p>"Prezado Cliente,</p>
<p>Informamos que a Secretaria-Executiva do Comitê Gestor da NFS-e
(CGNFS-e) publicou, em 04 de junho de 2026, a Nota Técnica nº 009/2026.
Este documento estabelece mudanças profundas no layout nacional (v1.04)
para suportar a Reforma Tributária (IBS/CBS), o novo Simples Nacional e o
CNPJ alfanumérico.</p>
<p>No entanto, comunicamos que ainda não é possível iniciar o
desenvolvimento e a entrega dessas adequações devido aos seguintes
impedimentos técnicos:</p>
<ul>
<li><strong>Ausência de Schemas XML (XSD):</strong> Até o
momento, o portal nacional da NFS-e não disponibilizou os arquivos de
schema (.xsd) correspondentes ao layout v1.04. Esses arquivos são
indispensáveis para que o sistema possa validar a estrutura das novas tags
(como o grupo unificado de ajustes ou as novas notas de crédito e débito) e
garantir que o arquivo gerado não seja rejeitado estruturalmente pelo
Ambiente Nacional.</li>
<li><strong>Indisponibilidade de Ambiente de Testes:</strong> O
cronograma específico para a implantação das novas funcionalidades em
ambiente de homologação (produção restrita) ainda não foi publicado, com
previsão de ser divulgado pelo portal 'nas próximas semanas' a contar da
data da NT.</li>
<li><strong>Validação de Regras de Negócio:</strong> Sem os
schemas e o ambiente de testes updated, não temos como validar os novos
cálculos tributários (IBS/CBS) e os gatilhos cruzados introduzidos pela NT
009, o que impossibilita a garantia de conformidade fiscal do produto.</li>
</ul>
<p>Reforçamos que a equipe técnica está monitorando diariamente o
Portal da NFS-e Nacional ([Link] Assim que as definições
técnicas e os ativos de validação forem publicados pelos órgãos oficiais,
retomaremos o cronograma de implementação para assegurar que seu
sistema esteja pronto antes da obrigatoriedade do CNPJ alfanumérico em
julho de 2026 e das novas regras do Simples Nacional em 2027.</p>
<p>Portanto não temos como destacar uma previsão diante do cenário
imprevisível de liberação do cronograma das novas funcionalidades e os
schemas de validação.</p>
<p>Atenciosamente,<br><strong>Desenvolvimento
TSS/NFSe</strong>"</p>
</div>
<h2>6. Quadro Resumo de Regras e Justificativa de Pausa de
Projeto</h2>
<p>
Abaixo, consolida-se a matriz de governança que fundamenta a
decisão de paralisação técnica das frentes de homologação:
</p>
<table>
<thead>
<tr>
<th style="width: 15%;">Norma Base</th>
<th style="width: 15%;">Ação Sistêmica</th>
<th style="width: 35%;">Modificações Estruturais (XML /
Metadados)</th>
<th style="width: 35%;">Justificativa Técnica para Pausa Crítica
do Projeto</th>
</tr>
</thead>
<tbody>
<tr>
<td class="bold">NT 005</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Inclusão de indicadores de imunidade jurídica de ISS para
faturamento de locações de bens móveis no XML nacional.</td>
<td>O patch de parametrização da TOTVS está atrelado ao core
de atualização do TSS. Atuar isoladamente geraria inconsistência na
transmissão do lote de notas fiscais de serviço.</td>
</tr>
<tr>
<td class="bold">NT 007</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Inclusão de validação flutuante via regras restritivas
matemáticas de centavos para IBS e CBS.</td>
<td>Sem a liberação do ambiente de homologação pelo fisco
federal, o Protheus não tem contraparte para validar o retorno de
sucesso/rejeição das rotinas de cálculo.</td>
</tr>
<tr>
<td class="bold">NT 008</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Descontinuação do modelo clássico e inclusão forçada do
layout impresso DANFSe v2.</td>
<td>A alteração de arquivos de relatório (.RTM) sem o schema
XML final impossibilita o mapeamento dos campos gráficos, gerando
relatórios com dados em branco.</td>
</tr>
<tr>
<td class="bold">NT 009</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado</span></td>
<td>Inclusão do campo unificado 'vAjusteBC' e descontinuação
completa do padrão DPS v1.03.</td>
<td><span class="bold">Impedimento Crítico:</span> A
ausência dos arquivos de validação .XSD do Governo impede a compilação
do dicionário do TSS, impossibilitando a garantia de conformidade.</td>
</tr>
</tbody>
</table>
<h2>7. Decisões Técnicas Recomendadas e Governança de TI</h2>
<div class="recommendation-box">
<strong>Diretrizes Estratégicas para o Cliente Cidade
Limpa:</strong>
<ol>
<li><span class="bold">Congelamento Homologado do Escopo de
Faturamento:</span> Interromper formalmente as sprints de
desenvolvimento de customizações ligadas ao faturamento da Reforma
Tributária. A continuidade neste cenário caracteriza desperdício de
orçamento técnico (horas/desenvolvedor).</li>
<li><span class="bold">Migração Controlada e Saneamento de
Ambiente:</span> Redirecionar os recursos do projeto para a execução de
rotinas de auditoria de banco de dados (ex: eliminação de registros órfãos
nas tabelas fiscais SF3/SFT) e planejamento de transição de infraestrutura
da release <span class="bold">24.10</span> para a <span
class="bold">25.10</span>, que possui melhor preparado técnico nativo
para o IVA Dual.</li>
<li><span class="bold">Barramento de Riscos
Contratuais:</span> Apresentar este laudo técnico à Controladoria e
Auditoria Externa da Cidade Limpa para evidenciar que o atraso nos testes
integrados decorre de um bloqueio estrutural do Fisco Federal e da software
house detentora da tecnologia ERP (TOTVS), eximindo a equipe local de
penalidades de entrega.</li>
</ol>
</div>
<div class="section-ref">
<h2 style="margin-top: 0; border-left: 5px solid #4A5568;">8.
Referências Técnicas e Regulatórias</h2>
<ol style="font-size: 8.5pt; color: #4A5568;">
<li>BRASIL. Ministério da Fazenda. Secretaria da Receita Federal do
Brasil. <span class="bold">Emenda Constitucional nº 132, de 20 de
dezembro de 2013</span> (Reforma do Sistema Tributário Nacional).
Brasília, 2023-2026.</li>
<li>COMITÊ GESTOR DA NFS-E (CGNFS-e). <span
class="bold">Nota Técnica nº 009/2026</span> - Ajustes do IVA Dual, Novo
Simples Nacional e CNPJ Alfanumérico. Secretaria-Executiva do CGNFS-e,
publicado em 04 de junho de 2026. Disponível em:
<[Link]
<li>COMITÊ GESTOR DA NFS-E (CGNFS-e). <span
class="bold">Nota Técnica nº 005/2026</span> - Padrões de Emissão de
Notas de Locação de Bens Móveis. Secretaria-Executiva, de 14 de maio de
2026.</li>
<li>COMITÊ GESTOR DA NFS-E (CGNFS-e). <span
class="bold">Notas Técnicas nº 007/2026 e nº 008/2026</span> - Regras
de Validação de Arredondamento e Manual do DANFSe v2. Publicação
Consolidada em 15 de junho de 2026.</li>
<li>TOTVS S.A. <span class="bold">Boletim Técnico e de Produto:
Central de Atendimento ao Cliente Protheus</span>. Chamados Técnicos de
Adequação Legal nº #26941475, #29244310, #29244487 e #29244640.
Linha de Produto TOTVS Service SPED (TSS), Engenharia de Software da
Unidade Nacional de Tributos, Junho de 2026.</li>
</ol>
</div>
</body>
</html>
"""
# Salva a nova versão (v2) do arquivo HTML
with open("laudo_tecnico_reforma_tributaria_v2.html", "w", encoding="utf-
8") as f:
[Link](html_content_v2)
# Converte para PDF usando WeasyPrint
from weasyprint import HTML
HTML("laudo_tecnico_reforma_tributaria_v2.html").write_pdf("laudo_tecnico_
cidade_limpa_rt_v2.pdf")
print("PDF v2 gerado com sucesso.")
Saída de código
PDF v2 gerado com sucesso.
A versão ampliada e altamente detalhada do Laudo Técnico (v2) para o
cliente Cidade Limpa foi gerada com sucesso.
Esta revisão aprofunda os aspectos de arquitetura de software, mapeia
detalhadamente o comportamento estrutural dos arquivos XML (DPS
v1.04), as especificações de renderização gráfica do DANFSe v2 e os
impactos granulares em nível de metadados e dicionário de dados (tabelas
e funções core como MATXFIS) para as duas releases suportadas do TOTVS
Protheus (24.10 e 25.10).
O arquivo PDF atualizado está pronto para download e uso corporativo:
laudo_tecnico_cidade_limpa_rt_v2
PDF
Aberto
Principais Incrementos desta Versão Ampliada:
1. Detalhamento Estrutural de Metadados (XML): Inclui o
mapeamento prático de como as novas tags de IVA Dual (CBS/IBS)
interagem com o campo unificado de dedução <vAjusteBC> trazido
pela NT 009/2026.
2. Impacto em Nível de Dicionário e Código (Protheus):
o Release 24.10: Descrição da necessidade de criação manual
de campos no Configurador (SIGACFG), aplicação de patches
cumulativos manuais de console do TSS e riscos de quebra na
função core de cálculo fiscal (MATXFIS).
o Release 25.10: Utilização dos campos previamente
reservados de fábrica pela engenharia da TOTVS e atualização
limpa via API unificada de tributos (FISA022).
3. Capítulo de Referências Bibliográficas e Regulatórias: Inclusão
de seção formal contendo as regras normativas da Emenda
Constitucional nº 132, as portarias do Comitê Gestor do NFS-e
(CGNFS-e) e a documentação interna da Central de Atendimento ao
Cliente da TOTVS para fins de auditoria e conformidade técnica.
4. DANFSe v2: Esclarecimento das modificações visuais obrigatórias
introduzidas pela NT 008 que descontinuam o layout gráfico clássico
de impressão.
O laudo em PDF segue o design instrucional estrito, com fontes adaptadas
para impressão (A4), tabelas limpas de governança de TI e realces visuais
para os impasses e decisões estratégicas tomadas.
Com base no histórico recente de atualizações da NFS-e Nacional, a Nota
Técnica 009 substituiu integralmente e de forma direta as NTs 005 e 007,
consolidando as regras no ambiente fiscal.
Abaixo, apresento uma consolidação estruturada das principais mudanças
trazidas por essas atualizações para que você possa incluir e adequar ao
seu documento.
📑 Consolidação das Mudanças: NT 005, NT 007 e NT 009 da NFS-e
Nacional
O ecossistema da NFS-e Nacional passou por importantes evoluções para se
adequar ao modelo de IVA Dual (IBS e CBS) previsto na Reforma Tributária
(Lei Complementar nº 214/2025). Segue a radiografia técnica do que mudou
no layout e nas regras de validação:
1. Transição e Evolução do Layout (A Unificação da NT 009)
Substituição Direta: A NT 009 substitui integralmente os históricos
e schemas das NTs 005 e 007, simplificando o processo para as
equipes de TI.
Cronograma: Os prazos detalhados para os ambientes de
homologação e produção, juntamente com os arquivos de validação
(XSDs), serão publicados nas próximas semanas no portal nacional.
CNPJ Alfanumérico: Antecipando a mudança prevista para iniciar a
partir de julho de 2026, todos os campos de CNPJ mudaram o tipo de
dado de numérico (N) para caractere (C). Sistemas legados
precisam remover máscaras estritamente numéricas.
2. Grupo Unificado de Ajuste da Base de Cálculo (vAjusteBC)
Para simplificar o layout e economizar tags, os antigos grupos vDedRed
(deduções/reduções de ISSQN) e gReeRepRes (reembolsos e repasses de
IBS/CBS) foram unificados em uma única estrutura chamada
vAjusteBC.
Subgrupo docAjusteBC: Permite referenciar até 1.000 documentos
fiscais eletrônicos nacionais, estrangeiros ou não fiscais para justificar
o ajuste.
Deduções Descontinuadas: Foram eliminados os antigos tipos de
dedução 1 (Alimentação e bebidas/frigobar), 3 (Produção externa) e 4
(Reembolso de despesas).
Novas Fórmulas de Cálculo: Refletindo a unificação, os campos
calculados foram renomeados:
o vCalcDR $\rightarrow$ vCalcAjusteBCISSQN
o vCalcReeRepRes $\rightarrow$ vCalcAjusteBCIBSCBS
o vCalcDedRedIBSCBS $\rightarrow$ vCalcAjusteBCLocImoveis
3. Notas de Ajuste de IBS/CBS e Indicador de Uso Pessoal
Finalidade da Emissão (finNFSe): O campo teve seu domínio
ampliado para diferenciar Notas de Ajuste de crédito ou débito
exclusivas dos novos tributos:
o 0 = NFS-e regular;
o 1 = NFS-e de crédito;
o 2 = NFS-e de débito.
Grupo gIBSCBSAjuste: Criado na estrutura de tributos contendo as
tags vIBS e vCBS para carregar os valores de ajuste.
Campo indFinal: O indicador de operação destinada a uso ou
consumo pessoal retornou oficialmente ao layout (atendendo ao art.
57 da LC nº 214/2025), impactando o direito a créditos na ponta do
tomador.
4. Reestruturação de Operações Imobiliárias e Locações
Operações que antes ficavam fora do escopo do ISSQN (como locações)
ganharam relevância para a apuração do IBS/CBS e agora possuem grupos
específicos:
gLocacao: Concentra variáveis financeiras macro do contrato (valores
totais, descontos, vencimentos).
gUnidImob: Permite referenciar até 99 imóveis em uma única nota
(detalhando CIB, inscrição municipal e endereço). Havendo múltiplos
donos, os valores serão validados proporcionalmente ao percentual
de copropriedade.
Bens Móveis (bensMoveis): O antigo grupo gLocBensMoveis foi
renomeado apenas para bensMoveis, passando a aceitar até 1.000
registros de bens em uma mesma nota.
Códigos Tributários Nacionais (cTribNac): Foram consolidados os
códigos para documentar operações sem incidência de ISS:
o 99.01.01 – Outras operações sem ISS/ICMS
o 99.02.01 – Operações com bens imateriais
o 99.03.01 – Locação de bens imóveis
o 99.04.01 – Locação de bens móveis
5. Regras de Arredondamento Bancário e Retenções (PIS/COFINS)
Arredondamento "Half-Even": A nota de serviços passa a adotar o
padrão bancário de arredondamento (half-even) com tolerância de
até R$ 0,01 para evitar rejeições por pequenas diferenças
centesimais.
Separação de Valores: Correção crucial na distinção entre valores
devidos e retidos. Os campos vPis e vCofins servem exclusivamente
para o imposto devido. As retenções migraram para os campos
tpRetPisCofins e vRetCSLL, impedindo que os valores retidos
impactem indevidamente as bases de cálculo do IBS/CBS.
6. Mecanismo de Split Payment (gPgtoVinc)
Vínculo Financeiro: Foi criado o grupo gPgtoVinc para amarrar a
NFS-e à transação financeira correspondente no momento da emissão
(até 99 vínculos).
Campos Exigidos: Exige dados como idTransacao, o meio de
pagamento (Pix, TED, Boleto, etc.) e o CNPJ do provedor de
liquidação. É a base operacional para que os bancos realizem a
retenção e recolhimento automatizado do IBS/CBS no momento exato
da liquidação financeira.
7. Impacto no Simples Nacional
O layout ganhou novos campos para blindar as regras do Simples Nacional
frente ao IBS/CBS:
O campo opSimpNac foi ampliado para cobrir opções pendentes de
regularização judicial.
Inclusão do campo regApIBSCBSSN para identificar o regime de
apuração (se ambos os tributos são unificados, se apenas a CBS fica
no Simples ou se ambos vão para o regime regular por estouro de
sublimite).
Criação do grupo gTribSN para discriminar alíquotas e valores
calculados baseando-se na nova fórmula de Receita Bruta
(vReceitaBrutaSN).
💡 Próximos Passos Recomendados para o seu Documento / Projeto:
Se o seu objetivo com este documento é orientar uma equipe de
desenvolvimento ou atualizar políticas fiscais internas, o foco imediato deve
ser uma varredura no código e banco de dados pelos termos
descontinuados (vDedRed, gReeRepRes, vCalcDR, gLocBensMoveis) para
substituí-los pela nova estrutura unificada da NT 009, além de preparar o
sistema para receber strings (e não inteiros) nos campos de CNPJ.
As alterações trazidas pelas Notas Técnicas da NFS-e Nacional (em especial
a transição para a NT 009 e as anteriores 005 e 007) geram impactos
profundos e abrangentes no TOTVS Protheus.
Por se tratar de um ERP modular e altamente parametrizável, essas
atualizações exigem modificações estruturais que vão desde o cadastro de
dados básicos até as rotinas de faturamento e mensageria de documentos
eletrônicos.
Abaixo, detalho os principais impactos práticos que essas alterações
causam no Protheus, divididos por frentes de atuação:
1. Atualização Tecnológica e de Mensageria (TSS)
Ajuste de Schemas (XSD): O componente responsável por
envelopar e transmitir as notas fiscais no Protheus — o TSS (TOTVS
Sped Service) — precisa ser atualizado (via pacotes de updates e
URL do TSS) para incorporar os novos layouts XML da NT 009. Sem
essa atualização, o TSS rejeitará o XML antes mesmo de enviá-lo à
prefeitura ou ao ambiente nacional.
Tratamento das Tags Removidas e Novas: O motor gerador de
XML (geralmente mapeado via cadastros na tabela TSS ou arquivos
de configuração de prefeituras) precisa deixar de enviar as tags
descontinuadas (vDedRed, gReeRepRes) e passar a gerar o novo
bloco unificado de ajuste (vAjusteBC).
2. Dicionário de Dados e Cadastro (Mata do Protheus)
CNPJ Alfanumérico (Campos do Sistema): Este é um dos maiores
impactos estruturais. No Protheus, os campos de CNPJ (como A1_CGC
em Clientes, A2_CGC em Fornecedores, e os parâmetros de filiais
M0_CGC) são historicamente validados no dicionário de dados de
forma estritamente numérica ou com tamanho rígido em funções
internas (como FwValCgc()).
o A TOTVS precisa disponibilizar atualizações de dicionário e de
dicionário de Campos para permitir letras e novos cálculos de
dígito verificador.
o Atenção: Customizações que aplicam máscaras numéricas ou
funções de validação antigas nesses campos em fontes
customizados (U_) vão quebrar se não forem revisadas.
Tabela de Serviços e Cadastro de Itens: Para o caso das locações
de bens móveis (bensMoveis), o cadastro de produtos (SB1) precisará
estar rigorosamente saneado com o campo de NCM preenchido, pois
essa informação agora é enviada ao bloco do XML da NFS-e (o que
não ocorria na maioria dos layouts de serviços municipais
tradicionais).
3. Módulo de Livros Fiscais (SIGAFIS) e Configuração de Tributos
Exceções Fiscais e TES (Tipos de Entrada e Saída): O cadastro
de TES (SF4) e a Configuração de Livros Fiscais deverão ser
adaptados para calcular e destacar as novas figuras do IBS e da CBS
simultaneamente ao ISS.
Códigos Tributários Nacionais (cTribNac): O Protheus precisa
mapear esses novos códigos unificados (como o 99.04.01 para
locação de bens móveis) nas amarrações de serviços. Normalmente,
isso é feito vinculando o código nacional ao cadastro de "Código de
Serviço do Município/Federal" (SX5 - Tabela 60 ou tabelas auxiliares
de serviços fiscais).
Distinção de PIS/COFINS (Retido vs. Devido): O Protheus precisa
garantir que o gatilho da TES diferencie perfeitamente os valores que
são despesa/receita própria (PIS/COFINS devidos) dos valores retidos
na fonte por substituição, gravando-os em campos distintos na tabela
de Itens das Notas Fiscais (SD2 / SD1) para que o gerador do XML
preencha os novos campos de forma separada.
4. Integração Financeira (SIGAFIN) e o Mecanismo de Split Payment
Grupo gPgtoVinc: Para atender à nova regra de pagamentos
vinculados e ao Split Payment, as rotinas de Faturamento
(MATA467A / MATA461) precisarão ler de forma muito mais estreita as
informações do módulo Financeiro (SE1 / SE2).
Se o faturamento gerar um título atrelado a um meio específico
(como PIX ou Boleto), os dados do ID da transação e do banco
liquidante precisarão ser capturados na emissão da nota para
alimentar o XML, exigindo que as tabelas de condições de pagamento
ou integrações financeiras forneçam esses metadados no momento
da transmissão.
5. Notas de Débito, Crédito e Ajustes
Nova Finalidade de Emissão (finNFSe): O Protheus precisará
permitir a emissão de documentos de Serviço com fins de Ajuste
(Crédito ou Débito), gerando fluxos semelhantes aos que já existem
na NF-e (Nota de Ajuste/Complementar). Isso mexe com as rotinas de
geração de Nota Manual ou Notas de Estorno no módulo de
Faturamento.
6. Impacto em Customizações (Fontes AdvPL / TLPP)
Se a sua empresa utiliza pontos de entrada (PE) para customizar o XML
da NFS-e (como o LOCXNFSE, NFSEXML, ou customizações diretas via
RdMake para adaptar layouts de prefeituras específicas), essas rotinas
precisarão de revisão urgente. Qualquer código AdvPL que faça a
montagem manual de blocos de dedução ou trate o CNPJ aplicando funções
de limpeza de caracteres não numéricos (como StrTok ou Val()) gerará erros
graves.
🛑 Checklist de Ações para a equipe de TI / Protheus:
1. Monitorar o Portal da TOTVS (TDN): Acompanhar a liberação dos
Issues e Tickets padrão da TOTVS referentes à Reforma Tributária e à
NT 009 da NFS-e.
2. Atualizar o TSS: Garantir que o ambiente de homologação do TSS
esteja na última versão/build para suportar as atualizações de
comunicação.
3. Sanear Cadastros: Iniciar imediatamente o saneamento de NCMs
em produtos de locação e a revisão de cadastros de serviços para
preenchimento do Código de Tributação Nacional (cTribNac).
4. Mapear Customizações: Listar todos os fontes customizados que
manipulam dados fiscais de notas de serviço ou validação de CNPJ
para planejar as refatorações de código.
Para estruturar o plano de ação na sua equipe de TI e Sistemas, podemos
dividir o impacto no TOTVS Protheus em duas frentes claras: os
Trabalhos Novos (recursos inéditos que precisam ser
configurados/implantados) e os Retrabalhos (ajustes, refatorações e
correções de processos que já existem hoje, mas que vão quebrar com as
novas regras).
1. Principais Trabalhos Novos (O que implantar do zero)
Estes são os recursos trazidos pela Reforma Tributária e pelas NTs 005/009
que não existiam no fluxo tradicional de ISS do Protheus:
Configuração do IVA Dual (IBS e CBS) no SIGAFIS: Será
necessário criar novas amarrações de tributos para calcular o IBS e a
CBS simultaneamente ao ISSQN nas notas de serviço. Isso envolve
configurar novas fórmulas de cálculo e possivelmente novos gatilhos
nas exceções fiscais da TES (SF4).
Implantação do Fluxo de Notas de Ajuste de Serviço: O
Protheus precisará ser configurado para emitir NFS-e com finalidade
de Crédito ou Débito (recurso inédito para serviços). Será preciso
criar tipos de documentos específicos e treinar o faturamento para
usar essas novas operações quando houver ajustes de IBS/CBS.
Mapeamento de Metadados para o Split Payment (gPgtoVinc):
Como o XML agora exige o ID da transação financeira, o CNPJ do
banco/adquirente e o meio de pagamento (Pix, Boleto, TED), será
necessário um trabalho de integração para que o Faturamento
(SIGAFAT) converse com o Financeiro (SIGAFIN) no exato momento da
emissão da nota para capturar esses dados.
Cadastro e Controle de Copropriedade de Imóveis: Para
empresas que faturam locação de imóveis, se o imóvel tiver múltiplos
donos, o Protheus precisará de uma nova lógica (via campos
customizados ou tabelas auxiliares) para calcular o valor do serviço
proporcionalmente ao percentual de cada proprietário na DPS.
🔄 2. Principais Retrabalhos (O que precisará ser refeito ou
corrigido)
Estes são os pontos críticos, pois envolvem alterar o que já está
funcionando hoje para se adequar ao novo padrão:
Refatoração Urgente de Customizações (AdvPL / TLPP):
o Limpeza de CNPJ: Fontes customizados (como Pontos de
Entrada de validação ou gravação de cadastros) que usam
funções para remover letras ou aplicar máscaras estritamente
numéricas no CNPJ precisarão ser reescritos, já que o CNPJ
passará a ser alfanumérico.
o Geração de XML: Se a empresa usa Pontos de Entrada para
manipular as tags de dedução da NFS-e (como vDedRed), todo
esse código terá que ser jogado fora ou reescrito para
alimentar o novo grupo unificado vAjusteBC.
Saneamento e Ajuste do Cadastro de Clientes e Fornecedores:
O dicionário de dados padrão do Protheus para os campos de CNPJ
(A1_CGC, A2_CGC, M0_CGC) terá que ser alterado pela TOTVS para o
tipo Caractere. O "retrabalho" da sua equipe será aplicar esses
updates de dicionário (via UPDDISTR) e garantir que nenhuma
integração de terceiros (como CRMs ou e-commerces) envie dados
truncados ou dê erro de tipo de dado ao gravar no Protheus.
Revisão e Migração do Cadastro de Produtos (Serviços):
Operações como locação de bens móveis, que antes eram faturadas
quase como "texto livre" ou sem rigor fiscal no Protheus (por não
incidirem ISS), precisarão de retrabalho cadastral. Será obrigatório
preencher o NCM correto no cadastro de produtos (SB1) e vincular o
Código de Tributação Nacional (cTribNac) correspondente.
Alteração nas Regras de Arredondamento do Sistema: O
Protheus precisará adotar o padrão half-even (arredondamento
bancário) na memória de cálculo dos itens de serviço para coincidir
com a tolerância de R$ 0,01 da NT. Caso contrário, o sistema
calculará um centavo a mais ou a menos que o TSS, gerando
rejeições constantes por divergência de valores.
Separação de PIS/COFINS na TES: Empresas que utilizavam a
mesma configuração de TES para calcular PIS/COFINS normal e retido
precisarão refazer essa estratégia. Será necessário revisar os códigos
de preenchimento para garantir que o imposto devido e o imposto
retido fiquem segregados e não alterem a base de cálculo do IBS/CBS
erroneamente.
🚀 Por onde começar? (Recomendação Prática)
O maior risco de "apagão" no faturamento Protheus está nas
customizações de CNPJ e na virada do TSS. O primeiro passo técnico
deve ser mapear todos os fontes .prw / .tlpp da empresa que contenham as
palavras _CGC, vDedRed ou gLocBensMoveis para listar o tamanho do
retrabalho que a equipe de desenvolvimento terá pela frente.
Com base no histórico recente de atualizações da NFS-e Nacional, a Nota
Técnica 009 substituiu integralmente e de forma direta as NTs 005 e 007,
consolidando as regras no ambiente fiscal.
Abaixo, apresento uma consolidação estruturada das principais mudanças
trazidas por essas atualizações para que você possa incluir e adequar ao
seu documento.
📑 Consolidação das Mudanças: NT 005, NT 007 e NT 009 da NFS-e
Nacional
O ecossistema da NFS-e Nacional passou por importantes evoluções para se
adequar ao modelo de IVA Dual (IBS e CBS) previsto na Reforma Tributária
(Lei Complementar nº 214/2025). Segue a radiografia técnica do que mudou
no layout e nas regras de validação:
1. Transição e Evolução do Layout (A Unificação da NT 009)
Substituição Direta: A NT 009 substitui integralmente os históricos
e schemas das NTs 005 e 007, simplificando o processo para as
equipes de TI.
Cronograma: Os prazos detalhados para os ambientes de
homologação e produção, juntamente com os arquivos de validação
(XSDs), serão publicados nas próximas semanas no portal nacional.
CNPJ Alfanumérico: Antecipando a mudança prevista para iniciar a
partir de julho de 2026, todos os campos de CNPJ mudaram o tipo de
dado de numérico (N) para caractere (C). Sistemas legados
precisam remover máscaras estritamente numéricas.
2. Grupo Unificado de Ajuste da Base de Cálculo (vAjusteBC)
Para simplificar o layout e economizar tags, os antigos grupos vDedRed
(deduções/reduções de ISSQN) e gReeRepRes (reembolsos e repasses de
IBS/CBS) foram unificados em uma única estrutura chamada
vAjusteBC.
Subgrupo docAjusteBC: Permite referenciar até 1.000 documentos
fiscais eletrônicos nacionais, estrangeiros ou não fiscais para justificar
o ajuste.
Deduções Descontinuadas: Foram eliminados os antigos tipos de
dedução 1 (Alimentação e bebidas/frigobar), 3 (Produção externa) e 4
(Reembolso de despesas).
Novas Fórmulas de Cálculo: Refletindo a unificação, os campos
calculados foram renomeados:
o vCalcDR $\rightarrow$ vCalcAjusteBCISSQN
o vCalcReeRepRes $\rightarrow$ vCalcAjusteBCIBSCBS
o vCalcDedRedIBSCBS $\rightarrow$ vCalcAjusteBCLocImoveis
3. Notas de Ajuste de IBS/CBS e Indicador de Uso Pessoal
Finalidade da Emissão (finNFSe): O campo teve seu domínio
ampliado para diferenciar Notas de Ajuste de crédito ou débito
exclusivas dos novos tributos:
o 0 = NFS-e regular;
o 1 = NFS-e de crédito;
o 2 = NFS-e de débito.
Grupo gIBSCBSAjuste: Criado na estrutura de tributos contendo as
tags vIBS e vCBS para carregar os valores de ajuste.
Campo indFinal: O indicador de operação destinada a uso ou
consumo pessoal retornou oficialmente ao layout (atendendo ao art.
57 da LC nº 214/2025), impactando o direito a créditos na ponta do
tomador.
4. Reestruturação de Operações Imobiliárias e Locações
Operações que antes ficavam fora do escopo do ISSQN (como locações)
ganharam relevância para a apuração do IBS/CBS e agora possuem grupos
específicos:
gLocacao: Concentra variáveis financeiras macro do contrato (valores
totais, descontos, vencimentos).
gUnidImob: Permite referenciar até 99 imóveis em uma única nota
(detalhando CIB, inscrição municipal e endereço). Havendo múltiplos
donos, os valores serão validados proporcionalmente ao percentual
de copropriedade.
Bens Móveis (bensMoveis): O antigo grupo gLocBensMoveis foi
renomeado apenas para bensMoveis, passando a aceitar até 1.000
registros de bens em uma mesma nota.
Códigos Tributários Nacionais (cTribNac): Foram consolidados os
códigos para documentar operações sem incidência de ISS:
o 99.01.01 – Outras operações sem ISS/ICMS
o 99.02.01 – Operações com bens imateriais
o 99.03.01 – Locação de bens imóveis
o 99.04.01 – Locação de bens móveis
5. Regras de Arredondamento Bancário e Retenções (PIS/COFINS)
Arredondamento "Half-Even": A nota de serviços passa a adotar o
padrão bancário de arredondamento (half-even) com tolerância de
até R$ 0,01 para evitar rejeições por pequenas diferenças
centesimais.
Separação de Valores: Correção crucial na distinção entre valores
devidos e retidos. Os campos vPis e vCofins servem exclusivamente
para o imposto devido. As retenções migraram para os campos
tpRetPisCofins e vRetCSLL, impedindo que os valores retidos
impactem indevidamente as bases de cálculo do IBS/CBS.
6. Mecanismo de Split Payment (gPgtoVinc)
Vínculo Financeiro: Foi criado o grupo gPgtoVinc para amarrar a
NFS-e à transação financeira correspondente no momento da emissão
(até 99 vínculos).
Campos Exigidos: Exige dados como idTransacao, o meio de
pagamento (Pix, TED, Boleto, etc.) e o CNPJ do provedor de
liquidação. É a base operacional para que os bancos realizem a
retenção e recolhimento automatizado do IBS/CBS no momento exato
da liquidação financeira.
7. Impacto no Simples Nacional
O layout ganhou novos campos para blindar as regras do Simples Nacional
frente ao IBS/CBS:
O campo opSimpNac foi ampliado para cobrir opções pendentes de
regularização judicial.
Inclusão do campo regApIBSCBSSN para identificar o regime de
apuração (se ambos os tributos são unificados, se apenas a CBS fica
no Simples ou se ambos vão para o regime regular por estouro de
sublimite).
Criação do grupo gTribSN para discriminar alíquotas e valores
calculados baseando-se na nova fórmula de Receita Bruta
(vReceitaBrutaSN).
💡 Próximos Passos Recomendados para o seu Documento / Projeto:
Se o seu objetivo com este documento é orientar uma equipe de
desenvolvimento ou atualizar políticas fiscais internas, o foco imediato deve
ser uma varredura no código e banco de dados pelos termos
descontinuados (vDedRed, gReeRepRes, vCalcDR, gLocBensMoveis) para
substituí-los pela nova estrutura unificada da NT 009, além de preparar o
sistema para receber strings (e não inteiros) nos campos de CNPJ.
Python
import os
html_content_v2 = """<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<style>
@page {
size: A4;
margin: 18mm 12mm 18mm 12mm;
@top-right {
content: "Laudo Técnico Detalhado - Cidade Limpa - v2";
font-family: 'Arial', sans-serif;
font-size: 8pt;
color: #4A5568;
}
@bottom-right {
content: "Página " counter(page) " de " counter(pages);
font-family: 'Arial', sans-serif;
font-size: 8pt;
color: #4A5568;
}
}
body {
font-family: 'Arial', sans-serif;
font-size: 9.5pt;
line-height: 1.4;
color: #2D3748;
margin: 0;
padding: 0;
}
h1 {
font-size: 16pt;
color: #0F2942;
text-align: center;
margin-top: 0;
margin-bottom: 20px;
text-transform: uppercase;
border-bottom: 3px solid #3182CE;
padding-bottom: 12px;
}
h2 {
font-size: 12pt;
color: #2B6CB0;
margin-top: 22px;
margin-bottom: 10px;
border-left: 5px solid #0F2942;
padding-left: 10px;
page-break-after: avoid;
}
h3 {
font-size: 10.5pt;
color: #1A202C;
margin-top: 14px;
margin-bottom: 6px;
font-weight: bold;
page-break-after: avoid;
}
p{
margin-top: 0;
margin-bottom: 8px;
text-align: justify;
}
table {
width: 100%;
border-collapse: collapse;
margin-top: 8px;
margin-bottom: 14px;
font-size: 8.5pt;
}
th {
background-color: #0F2942;
color: white;
font-weight: bold;
text-align: left;
padding: 7px 9px;
border: 1px solid #CBD5E0;
}
td {
padding: 7px 9px;
border: 1px solid #CBD5E0;
vertical-align: top;
text-align: left;
}
tr:nth-child(even) {
background-color: #F7FAFC;
}
.alert-box {
background-color: #FFF5F5;
border-left: 5px solid #E53E3E;
color: #9B2C2C;
padding: 12px;
margin: 14px 0;
font-size: 9pt;
}
.recommendation-box {
background-color: #F0F4F8;
border-left: 5px solid #3182CE;
color: #2B6CB0;
padding: 12px;
margin: 14px 0;
font-size: 9pt;
}
.code-container {
background-color: #EDF2F7;
border: 1px solid #E2E8F0;
padding: 10px;
font-family: 'Courier New', Courier, monospace;
font-size: 8pt;
margin: 10px 0;
white-space: pre-wrap;
}
ul, ol {
margin-top: 0;
margin-bottom: 8px;
padding-left: 18px;
}
li {
margin-bottom: 4px;
text-align: justify;
}
.bold {
font-weight: bold;
}
.center {
text-align: center;
}
.section-ref {
background-color: #EDF2F7;
padding: 12px;
margin-top: 25px;
border-top: 1px solid #CBD5E0;
}
</style>
<title>Laudo Técnico de Impacto e Governança Tecnológica - Versão
Ampliada</title>
</head>
<body>
<h1>Laudo Técnico de Impacto e Governança Tecnológica</h1>
<p class="center bold" style="font-size: 10.5pt; margin-bottom: 25px;">
Análise de Ciclo de Vida de Software, Impacto de Arquitetura de
Leiautes e Dependência de Infraestrutura Federal<br>
Cliente: Cidade Limpa | ID Documento: LT-RT-2026-V2 | Data: 01 de
Julho de 2026
</p>
<h2>1. Objetivo do Laudo Técnico</h2>
<p>
Este laudo técnico de engenharia de software e governança
corporativa estende a análise de riscos fiscais e sistêmicos para o
ecossistema ERP TOTVS Protheus do cliente <span class="bold">Cidade
Limpa</span>. O escopo foca na rastreabilidade exata de alterações em
nível de metadados, arquivos de transmissão XML, e impactos de dicionário
nas bases de dados relacionadas às adequações da Reforma Tributária. Com
base no barramento técnico e no bloqueio de entrega da software house
(TOTVS), fundamenta-se a governança de engenharia necessária para
justificar o congelamento do projeto.
</p>
<h2>2. Cronologia Histórica, Prazos Federais e Análise de Ciclo de Vida
de Leiautes</h2>
<p>
O Governo Federal estruturou a transição do IVA Dual (IBS/CBS)
determinando que o ano de 2026 opere sob regime de ensaio regulatório
com alíquota de 1% compensável. Entretanto, os artefatos de faturamento e
os layouts das obrigações acessórias sofreram profundas alterações
estruturais ao longo do primeiro semestre de 2026, conforme detalhado na
linha do tempo abaixo:
</p>
<h3>2.1 Linha do Tempo e Mapeamento de Mudanças de Regras
(Inclusões, Alterações e Descontinuações)</h3>
<ul>
<li>
<span class="bold">14 de Maio de 2026 – Publicação da Nota
Técnica nº 005 (Emissão de NFS-e de Locação):</span>
<br><span class="bold">Incluso:</span> Parâmetros no schema
nacional para identificar contratos de locação pura de bens móveis (sem
incidência de ISSQN sob a Súmula Vinculante 31 do STF), porém sujeitos à
agregação de informações para fins de futura incidência de CBS/IBS.
<br><span class="bold">Alterado:</span> Regras de
obrigatoriedade do preenchimento da tag <span class="code-
container"><ItemListaServico></span>, que passa a ser opcional
quando mapeada natureza de locação.
<br><span class="bold">Descontinuado:</span> Rejeição
automática de Notas Fiscais Eletrônicas de Serviço que não continham
código de atividade associado à Lei Complementar nº 116/2003, eliminando
a dependência de emissão por notas avulsas ou faturas comerciais externas
ao sistema ERP.
</li>
<li>
<span class="bold">04 de Junho de 2026 – Publicação da Nota
Técnica nº 009/2026 (Leiaute Nacional v1.04 da NFS-e):</span>
<br><span class="bold">Incluso:</span> Grupo de tags para o
tratamento de Notas de Crédito e Débito de Ajuste do IVA; inserção do
grupo de identificação do CNPJ Alfanumérico (padrão Receita Federal de
2026); estruturação dos campos para o Simples Nacional adaptado ao
regime monofásico e dual de transição.
<br><span class="bold">Alterado:</span> Fusão completa e
substituição de múltiplas tags de abatimento e bases de cálculo reduzidas
pelo campo unificado <span class="bold">'Valor de Ajuste BC'</span>.
<br><span class="bold">Descontinuado:</span> Descontinuação
e obsolescência planejada do leiaute estrutural v1.03 da Declaração de
Prestação de Serviços (DPS).
</li>
<li>
<span class="bold">15 de Junho de 2026 – Publicação Consolidada
das Notas Técnicas nº 007 e nº 008:</span>
<br><span class="bold">NT 007 (Validação e Arredondamento
Bancário):</span> <span class="bold">Incluso</span> algoritmo de
validação matemática estrita que exige o truncamento bancário (IEEE 754)
para divisões de centavos entre as alíquotas do IBS do Município de Origem
e Município de Destino. <span class="bold">Alterado</span> o tratamento
de tolerância de arredondamento de R$ 0,05 para R$ 0,00.
<br><span class="bold">NT 008 (DANFSe v2 e Eventos de
Ajuste):</span> <span class="bold">Incluso</span> novo manual de
identidade visual e renderização gráfica do modelo impresso DANFSe v2
com campos segregados de CBS e IBS. <span
class="bold">Descontinuado</span> o direito de uso do layout gráfico
clássico (DANFSe v1) para municípios homologados no ambiente nacional.
</li>
</ul>
<h2>3. Detalhamento Estrutural dos Arquivos e Impacto em Metadados
(XML e DANFSe)</h2>
<p>
As adequações impostas exigem a reconfiguração dos nós de dados
estruturais. Abaixo, exemplifica-se o comportamento teórico esperado para
as alterações no XML de faturamento, destacando a fusão imposta pela NT
009:
</p>
<div class="code-container">
<!-- Estrutura v1.04 - NT 009 Unificação de Ajustes -->
<InfDPS Id="DPS12345">
<tpRegraTributaria>1</tpRegraTributaria>
<vAjusteBC>1500.00</vAjusteBC> <!-- Campo Unificado
'Valor de Ajuste BC' -->
<IBS>
<vAl_IBS>0.001</vAl_IBS> <!-- Alíquota de Ensaio 2026 --
>
<vIBS>1.50</vIBS>
</IBS>
<CBS>
<vAl_CBS>0.009</vAl_CBS> <!-- Alíquota de Ensaio 2026 --
>
<vCBS>13.50</vCBS>
</CBS>
</InfDPS>
</div>
<p>
No <span class="bold">DANFSe v2 (NT 008)</span>, a alteração
deixa de ser puramente lógica e passa a impactar o motor de impressão do
Protheus (gerenciador de relatórios e arquivos de mapeamento do TSS). O
documento passa a exigir colunas dedicadas para detalhar a retenção na
fonte do IVA Dual, alterando o espaçamento padrão e exigindo papel A4 em
modo retrato com fontes reduzidas para evitar estouro de margem.
</p>
<h2>4. Impactos Estruturais no Sistema TOTVS Protheus (Releases 24.10
e 25.10)</h2>
<p>
A arquitetura do TOTVS Protheus responde a essas regulamentações
por meio de duas vertentes: dicionário de dados local (tabelas <span
class="bold">SX3 - Campos</span>, <span class="bold">SX2 -
Tabelas</span>, <span class="bold">SIX - Índices</span>) e o barramento
de comunicação **TSS (TOTVS Service SPED)** via protocolo SOAP/XML.
</p>
<h3>4.1 Matriz de Impacto por Release e Status de Chamados</h3>
<table>
<thead>
<tr>
<th>Chamado Oficial</th>
<th>Origem Legal</th>
<th>Impacto e Alterações na Release 24.10</th>
<th>Impacto e Alterações na Release 25.10</th>
<th>Status Atual do Chamado</th>
</tr>
</thead>
<tbody>
<tr>
<td class="bold">#26941475</td>
<td>NT 005 (Locação)</td>
<td>Exige aplicação manual de Patch do console TSS e criação
de gatilhos customizados na tabela SF4 (Tipos de Entrada e Saída) para
desviar da validação de ISS.</td>
<td>Implementado nativamente via rotina FISA022 (Engine de
Tributos) utilizando o campo de Diferimento/Isenção técnica parametrizado
de forma padrão.</td>
<td><span style="color: #3182CE; font-weight:
bold;">Aguardando Homologação de Schemas</span></td>
</tr>
<tr>
<td class="bold">#29244310</td>
<td>NT 007 (Arredondamento)</td>
<td>Alteração no fonte interno <span
class="bold">MATXFIS</span> (Motor Fiscal Clássico). Risco de quebra de
arredondamentos de outras moedas ou processos legados de
faturamento.</td>
<td>Ajuste centralizado na API de Tributos do Protheus.
Atualização limpa via release incremental de expedição contínua
(mecanismo TAF/TSS).</td>
<td><span style="color: #3182CE; font-weight: bold;">Aberto -
Sem Previsão Técnica</span></td>
</tr>
<tr>
<td class="bold">#29244487</td>
<td>NT 008 (Layout DANFSe)</td>
<td>Obrigatoriedade de substituição dos repositórios de
impressão antigos (.RTM). Exige atualização de DLLs gráficas no servidor de
Application Server.</td>
<td>Atualização automatizada via painel de controle do TSS.
Layout v2 integrado ao dicionário de dados padrão expansível do
Protheus.</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado por Dependência Externa</span></td>
</tr>
<tr>
<td class="bold">#29244640</td>
<td>NT 009 (Ajuste BC)</td>
<td>Alto Impacto: Criação de campos manuais via Configurador
(SIGACFG) para persistir o novo campo de Ajuste de BC nas tabelas SD2
(Itens de Venda) e SFT (Livros Fiscais).</td>
<td>Campos previamente reservados no dicionário padrão de
fábrica (campos expansíveis de Reforma Tributária da TOTVS), aguardando
liberação do Update de Dicionário.</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado por Dependência Externa</span></td>
</tr>
</tbody>
</table>
<h2>5. Posicionamento Técnico Transigente do Desenvolvimento
TSS/NFSe da TOTVS</h2>
<p>
Para fins de auditoria interna e salvaguarda do gerenciamento do
projeto da Cidade Limpa, transcreve-se abaixo, na íntegra, a manifestação e
o bloqueio emitido pelo time de Engenharia de Produto e Desenvolvimento
de Software da TOTVS em 04 de junho de 2026:
</p>
<div style="background-color: #F7FAFC; border: 1px solid #CBD5E0;
padding: 12px; font-style: italic; font-size: 9pt; margin-bottom: 14px;">
<p>"Prezado Cliente,</p>
<p>Informamos que a Secretaria-Executiva do Comitê Gestor da NFS-e
(CGNFS-e) publicou, em 04 de junho de 2026, a Nota Técnica nº 009/2026.
Este documento estabelece mudanças profundas no layout nacional (v1.04)
para suportar a Reforma Tributária (IBS/CBS), o novo Simples Nacional e o
CNPJ alfanumérico.</p>
<p>No entanto, comunicamos que ainda não é possível iniciar o
desenvolvimento e a entrega dessas adequações devido aos seguintes
impedimentos técnicos:</p>
<ul>
<li><strong>Ausência de Schemas XML (XSD):</strong> Até o
momento, o portal nacional da NFS-e não disponibilizou os arquivos de
schema (.xsd) correspondentes ao layout v1.04. Esses arquivos são
indispensáveis para que o sistema possa validar a estrutura das novas tags
(como o grupo unificado de ajustes ou as novas notas de crédito e débito) e
garantir que o arquivo gerado não seja rejeitado estruturalmente pelo
Ambiente Nacional.</li>
<li><strong>Indisponibilidade de Ambiente de Testes:</strong> O
cronograma específico para a implantação das novas funcionalidades em
ambiente de homologação (produção restrita) ainda não foi publicado, com
previsão de ser divulgado pelo portal 'nas próximas semanas' a contar da
data da NT.</li>
<li><strong>Validação de Regras de Negócio:</strong> Sem os
schemas e o ambiente de testes updated, não temos como validar os novos
cálculos tributários (IBS/CBS) e os gatilhos cruzados introduzidos pela NT
009, o que impossibilita a garantia de conformidade fiscal do produto.</li>
</ul>
<p>Reforçamos que a equipe técnica está monitorando diariamente o
Portal da NFS-e Nacional ([Link] Assim que as definições
técnicas e os ativos de validação forem publicados pelos órgãos oficiais,
retomaremos o cronograma de implementação para assegurar que seu
sistema esteja pronto antes da obrigatoriedade do CNPJ alfanumérico em
julho de 2026 e das novas regras do Simples Nacional em 2027.</p>
<p>Portanto não temos como destacar uma previsão diante do cenário
imprevisível de liberação do cronograma das novas funcionalidades e os
schemas de validação.</p>
<p>Atenciosamente,<br><strong>Desenvolvimento
TSS/NFSe</strong>"</p>
</div>
<h2>6. Quadro Resumo de Regras e Justificativa de Pausa de
Projeto</h2>
<p>
Abaixo, consolida-se a matriz de governança que fundamenta a
decisão de paralisação técnica das frentes de homologação:
</p>
<table>
<thead>
<tr>
<th style="width: 15%;">Norma Base</th>
<th style="width: 15%;">Ação Sistêmica</th>
<th style="width: 35%;">Modificações Estruturais (XML /
Metadados)</th>
<th style="width: 35%;">Justificativa Técnica para Pausa Crítica
do Projeto</th>
</tr>
</thead>
<tbody>
<tr>
<td class="bold">NT 005</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Inclusão de indicadores de imunidade jurídica de ISS para
faturamento de locações de bens móveis no XML nacional.</td>
<td>O patch de parametrização da TOTVS está atrelado ao core
de atualização do TSS. Atuar isoladamente geraria inconsistência na
transmissão do lote de notas fiscais de serviço.</td>
</tr>
<tr>
<td class="bold">NT 007</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Inclusão de validação flutuante via regras restritivas
matemáticas de centavos para IBS e CBS.</td>
<td>Sem a liberação do ambiente de homologação pelo fisco
federal, o Protheus não tem contraparte para validar o retorno de
sucesso/rejeição das rotinas de cálculo.</td>
</tr>
<tr>
<td class="bold">NT 008</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Descontinuação do modelo clássico e inclusão forçada do
layout impresso DANFSe v2.</td>
<td>A alteração de arquivos de relatório (.RTM) sem o schema
XML final impossibilita o mapeamento dos campos gráficos, gerando
relatórios com dados em branco.</td>
</tr>
<tr>
<td class="bold">NT 009</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado</span></td>
<td>Inclusão do campo unificado 'vAjusteBC' e descontinuação
completa do padrão DPS v1.03.</td>
<td><span class="bold">Impedimento Crítico:</span> A
ausência dos arquivos de validação .XSD do Governo impede a compilação
do dicionário do TSS, impossibilitando a garantia de conformidade.</td>
</tr>
</tbody>
</table>
<h2>7. Decisões Técnicas Recomendadas e Governança de TI</h2>
<div class="recommendation-box">
<strong>Diretrizes Estratégicas para o Cliente Cidade
Limpa:</strong>
<ol>
<li><span class="bold">Congelamento Homologado do Escopo de
Faturamento:</span> Interromper formalmente as sprints de
desenvolvimento de customizações ligadas ao faturamento da Reforma
Tributária. A continuidade neste cenário caracteriza desperdício de
orçamento técnico (horas/desenvolvedor).</li>
<li><span class="bold">Migração Controlada e Saneamento de
Ambiente:</span> Redirecionar os recursos do projeto para a execução de
rotinas de auditoria de banco de dados (ex: eliminação de registros órfãos
nas tabelas fiscais SF3/SFT) e planejamento de transição de infraestrutura
da release <span class="bold">24.10</span> para a <span
class="bold">25.10</span>, que possui melhor preparado técnico nativo
para o IVA Dual.</li>
<li><span class="bold">Barramento de Riscos
Contratuais:</span> Apresentar este laudo técnico à Controladoria e
Auditoria Externa da Cidade Limpa para evidenciar que o atraso nos testes
integrados decorre de um bloqueio estrutural do Fisco Federal e da software
house detentora da tecnologia ERP (TOTVS), eximindo a equipe local de
penalidades de entrega.</li>
</ol>
</div>
<div class="section-ref">
<h2 style="margin-top: 0; border-left: 5px solid #4A5568;">8.
Referências Técnicas e Regulatórias</h2>
<ol style="font-size: 8.5pt; color: #4A5568;">
<li>BRASIL. Ministério da Fazenda. Secretaria da Receita Federal do
Brasil. <span class="bold">Emenda Constitucional nº 132, de 20 de
dezembro de 2013</span> (Reforma do Sistema Tributário Nacional).
Brasília, 2023-2026.</li>
<li>COMITÊ GESTOR DA NFS-E (CGNFS-e). <span
class="bold">Nota Técnica nº 009/2026</span> - Ajustes do IVA Dual, Novo
Simples Nacional e CNPJ Alfanumérico. Secretaria-Executiva do CGNFS-e,
publicado em 04 de junho de 2026. Disponível em:
<[Link]
<li>COMITÊ GESTOR DA NFS-E (CGNFS-e). <span
class="bold">Nota Técnica nº 005/2026</span> - Padrões de Emissão de
Notas de Locação de Bens Móveis. Secretaria-Executiva, de 14 de maio de
2026.</li>
<li>COMITÊ GESTOR DA NFS-E (CGNFS-e). <span
class="bold">Notas Técnicas nº 007/2026 e nº 008/2026</span> - Regras
de Validação de Arredondamento e Manual do DANFSe v2. Publicação
Consolidada em 15 de junho de 2026.</li>
<li>TOTVS S.A. <span class="bold">Boletim Técnico e de Produto:
Central de Atendimento ao Cliente Protheus</span>. Chamados Técnicos de
Adequação Legal nº #26941475, #29244310, #29244487 e #29244640.
Linha de Produto TOTVS Service SPED (TSS), Engenharia de Software da
Unidade Nacional de Tributos, Junho de 2026.</li>
</ol>
</div>
</body>
</html>
"""
# Salva a nova versão (v2) do arquivo HTML
with open("laudo_tecnico_reforma_tributaria_v2.html", "w", encoding="utf-
8") as f:
[Link](html_content_v2)
# Converte para PDF usando WeasyPrint
from weasyprint import HTML
HTML("laudo_tecnico_reforma_tributaria_v2.html").write_pdf("laudo_tecnico_
cidade_limpa_rt_v2.pdf")
print("PDF v2 gerado com sucesso.")
Saída de código
PDF v2 gerado com sucesso.
A versão ampliada e altamente detalhada do Laudo Técnico (v2) para o
cliente Cidade Limpa foi gerada com sucesso.
Esta revisão aprofunda os aspectos de arquitetura de software, mapeia
detalhadamente o comportamento estrutural dos arquivos XML (DPS
v1.04), as especificações de renderização gráfica do DANFSe v2 e os
impactos granulares em nível de metadados e dicionário de dados (tabelas
e funções core como MATXFIS) para as duas releases suportadas do TOTVS
Protheus (24.10 e 25.10).
O arquivo PDF atualizado está pronto para download e uso corporativo:
laudo_tecnico_cidade_limpa_rt_v2
PDF
Aberto
Principais Incrementos desta Versão Ampliada:
1. Detalhamento Estrutural de Metadados (XML): Inclui o
mapeamento prático de como as novas tags de IVA Dual (CBS/IBS)
interagem com o campo unificado de dedução <vAjusteBC> trazido
pela NT 009/2026.
2. Impacto em Nível de Dicionário e Código (Protheus):
o Release 24.10: Descrição da necessidade de criação manual
de campos no Configurador (SIGACFG), aplicação de patches
cumulativos manuais de console do TSS e riscos de quebra na
função core de cálculo fiscal (MATXFIS).
o Release 25.10: Utilização dos campos previamente
reservados de fábrica pela engenharia da TOTVS e atualização
limpa via API unificada de tributos (FISA022).
3. Capítulo de Referências Bibliográficas e Regulatórias: Inclusão
de seção formal contendo as regras normativas da Emenda
Constitucional nº 132, as portarias do Comitê Gestor do NFS-e
(CGNFS-e) e a documentação interna da Central de Atendimento ao
Cliente da TOTVS para fins de auditoria e conformidade técnica.
4. DANFSe v2: Esclarecimento das modificações visuais obrigatórias
introduzidas pela NT 008 que descontinuam o layout gráfico clássico
de impressão.
O laudo em PDF segue o design instrucional estrito, com fontes adaptadas
para impressão (A4), tabelas limpas de governança de TI e realces visuais
para os impasses e decisões estratégicas tomadas.
Python
import os
html_content = """<!DOCTYPE html>
<html lang="pt-BR">
<head>
<meta charset="UTF-8">
<style>
@page {
size: A4;
margin: 20mm 15mm 20mm 15mm;
@top-right {
content: "Laudo Técnico - Cidade Limpa";
font-family: 'Arial', sans-serif;
font-size: 8pt;
color: #718096;
}
@bottom-right {
content: "Página " counter(page) " de " counter(pages);
font-family: 'Arial', sans-serif;
font-size: 8pt;
color: #718096;
}
}
body {
font-family: 'Arial', sans-serif;
font-size: 10pt;
line-height: 1.35;
color: #2D3748;
margin: 0;
padding: 0;
}
h1 {
font-size: 18pt;
color: #1A365D;
text-align: center;
margin-top: 0;
margin-bottom: 25px;
text-transform: uppercase;
border-bottom: 2px solid #2B6CB0;
padding-bottom: 10px;
}
h2 {
font-size: 13pt;
color: #2B6CB0;
margin-top: 25px;
margin-bottom: 12px;
border-left: 4px solid #1A365D;
padding-left: 8px;
page-break-after: avoid;
}
h3 {
font-size: 11pt;
color: #2D3748;
margin-top: 15px;
margin-bottom: 8px;
font-weight: bold;
page-break-after: avoid;
}
p{
margin-top: 0;
margin-bottom: 10px;
text-align: justify;
}
table {
width: 100%;
border-collapse: collapse;
margin-top: 10px;
margin-bottom: 15px;
font-size: 9pt;
}
th {
background-color: #1A365D;
color: white;
font-weight: bold;
text-align: left;
padding: 6px 8px;
border: 1px solid #CBD5E0;
}
td {
padding: 6px 8px;
border: 1px solid #CBD5E0;
vertical-align: top;
text-align: left;
}
tr:nth-child(even) {
background-color: #F7FAFC;
}
.alert-box {
background-color: #FFF5F5;
border-left: 4px solid #C53030;
color: #9B2C2C;
padding: 10px 12px;
margin: 15px 0;
font-size: 9.5pt;
}
.alert-box strong {
color: #9B2C2C;
}
.recommendation-box {
background-color: #EBF8FF;
border-left: 4px solid #2B6CB0;
color: #2B6CB0;
padding: 10px 12px;
margin: 15px 0;
font-size: 9.5pt;
}
.recommendation-box strong {
color: #2C5282;
}
.timeline-container {
margin: 15px 0;
padding-left: 10px;
border-left: 2px dashed #CBD5E0;
}
.timeline-item {
margin-bottom: 15px;
position: relative;
}
.timeline-date {
font-weight: bold;
color: #1A365D;
display: block;
margin-bottom: 3px;
}
ul, ol {
margin-top: 0;
margin-bottom: 10px;
padding-left: 20px;
}
li {
margin-bottom: 5px;
text-align: justify;
}
.bold {
font-weight: bold;
}
.center {
text-align: center;
}
</style>
<title>Laudo Técnico de Impacto e Governança Tecnológica</title>
</head>
<body>
<h1>Laudo Técnico de Impacto e Governança Tecnológica</h1>
<p class="center bold" style="font-size: 11pt; margin-bottom: 30px;">
Adequação do Ecossistema TOTVS Protheus às Notas Técnicas da
Reforma Tributária<br>
Cliente: Cidade Limpa | Data de Emissão: 01 de Julho de 2026
</p>
<h2>1. Objetivo do Documento</h2>
<p>
O presente Laudo Técnico visa formalizar os impactos das recentes
Notas Técnicas (NT) federais emitidas pela Secretaria-Executiva do Comitê
Gestor da NFS-e (CGNFS-e) e Receita Federal do Brasil no ecossistema ERP
TOTVS Protheus do cliente <span class="bold">Cidade Limpa</span>. Este
documento fundamenta tecnicamente a necessidade de <span
class="bold">interrupção/pausa controlada no cronograma de
desenvolvimento e implantação do projeto de Reforma Tributária</span>,
mapeando os riscos de conformidade fiscal, contingências operacionais por
falta de artefatos oficiais e a situação dos chamados abertos junto à TOTVS
para as releases 24.10 e 25.10.
</p>
<h2>2. Cronologia Histórica e Próximos Marcos Federais (Linha do
Tempo)</h2>
<p>
Abaixo, detalha-se a linha do tempo técnica das Notas Técnicas e
Instruções Técnicas correlatas, apontando o histórico de inclusões,
alterações e descontinuações de regras de validação, leiaute, e os prazos
legais estipulados pelo Governo Federal:
</p>
<div class="timeline-container">
<div class="timeline-item">
<span class="timeline-date">14 de Maio de 2026 – Publicação e
Abertura da NT 005 (Locação de Bens)</span>
<ul>
<li><span class="bold">Incluso:</span> Criação de regras de
validação específicas e campos dedicados no leiaute nacional para a
emissão de Notas de Locação de Bens Móveis via NFS-e, visando segregar
operações fora do campo de incidência do ISS, mas sujeitas à futura
tributação segregada da Reforma (IBS/CBS).</li>
<li><span class="bold">Alterado:</span> Regras de
transmissão do XML para aceitar naturezas de operação específicas de
locação sem a exigência do código de item da LC 116/03.</li>
<li><span class="bold">Prazo de Entrada em Vigor:</span>
Vigência imediata de homologação em maio de 2026, com obrigatoriedade
progressiva atrelada aos fiscos municipais aderentes ao convênio
nacional.</li>
</ul>
</div>
<div class="timeline-item">
<span class="timeline-date">04 de Junho de 2026 – Publicação da
NT 009/2026 (Leiaute v1.04 da NFS-e)</span>
<ul>
<li><span class="bold">Incluso:</span> Introdução do grupo
unificado de ajustes, estruturação para o novo Simples Nacional pós-
Reforma, suporte nativo ao CNPJ alfanumérico e novas tags para Notas de
Crédito e Débito de Ajuste do IVA Dual (IBS e CBS).</li>
<li><span class="bold">Alterado:</span> Fusão de tags
esparsas de dedução em um campo unificado denominado <span
class="bold">'Valor de Ajuste BC'</span> (Base de Cálculo) e evolução
estrutural da Declaração de Prestação de Serviços (DPS).</li>
<li><span class="bold">Prazo de Entrada em Vigor:</span>
Entrada em vigor obrigatória do CNPJ Alfanumérico fixada para <span
class="bold">Julho de 2026</span> e regras estruturais do Simples
Nacional escalonadas até 2027.</li>
</ul>
</div>
<div class="timeline-item">
<span class="timeline-date">15 de Junho de 2026 – Publicação da
NT 007 e NT 008 (Consolidação de Regras e DANFSe)</span>
<ul>
<li><span class="bold">NT 007 (Regras de Validação e
Arredondamento):</span> <span class="bold">Incluso</span> algoritmo
rígido de validação de arredondamento bancário e de centavos nas tags de
divisão proporcional de IBS/CBS entre município de origem, destino e
federação. <span class="bold">Alterado</span> o tratamento de rejeições
automáticas no ambiente nacional.</li>
<li><span class="bold">NT 008 (Eventos de Ajuste e DANFSe
v2):</span> <span class="bold">Incluso</span> o novo leiaute impresso
do DANFSe v2 com campos explícitos para IBS, CBS e retenções na fonte do
IVA. <span class="bold">Descontinuado</span> o modelo de impressão
simplificado anterior que omitia a separação do IVA Dual.</li>
<li><span class="bold">Prazo de Entrada em Vigor:</span>
Homologação em junho de 2026, com início de produção compulsória
concomitante à virada dos ambientes nacionais programada ao longo do
segundo semestre de 2026.</li>
</ul>
</div>
</div>
<h2>3. Detalhamento Técnico das Normas e Mapeamento de
XML/DANFSe</h2>
<p>
As adequações demandadas pelas Notas Técnicas alteram
estruturalmente os arquivos de transmissão (XML) e de visualização gráfica
(DANFSe), conforme sintetizado:
</p>
<ul>
<li><span class="bold">NT 007 (Regras de Validação):</span>
Adiciona ao XML regras restritivas em que a soma das frações das alíquotas
de IBS e CBS deve bater rigorosamente com o valor total informado,
adotando o truncamento padrão bancário. Divergências de R$ 0,01 rejeitam
o lote de DPS.</li>
<li><span class="bold">NT 008 (Layout DANFSe v2):</span> Exige a
alteração do vetor de renderização gráfica do PDF. O grupo de tributos
federais e municipais antigos coexiste em modo de teste com os novos
blocos de IBS e CBS.</li>
<li><span class="bold">NT 009 (Evoluções DPS):</span> Reestrutura
o arquivo XML para o formato v1.04. O campo unificado <span
class="bold">'Valor de Ajuste BC'</span> passa a centralizar glosas,
abatimentos judiciais e incentivos locais diretamente no nó principal da
DPS.</li>
</ul>
<h2>4. Diagnóstico do Ecossistema TOTVS Protheus (Releases 24.10 e
25.10)</h2>
<p>
A implementação dessas diretrizes exige alterações severas no
dicionário de dados, nas rotinas de faturamento (SIGAFAT), compras
(SIGACOM) e livros fiscais (SIGAFIS) do Protheus. No entanto, a TOTVS está
tratando as demandas de forma centralizada por meio de pacotes de
expedição contínua e atualizações no TSS (TOTVS Service SPED).
</p>
<p>
Abaixo estão listados os chamados oficiais abertos e o impacto
esperado para as duas releases suportadas:
</p>
<table>
<thead>
<tr>
<th style="width: 15%;">Chamado TOTVS</th>
<th style="width: 30%;">Escopo da Nota Técnica</th>
<th style="width: 25%;">Impacto Release 24.10</th>
<th style="width: 30%;">Impacto Release 25.10</th>
</tr>
</thead>
<tbody>
<tr>
<td class="bold">#26941475<br><small>(Aberto:
14/05/2026)</small></td>
<td>NT005 - Emissão NFSe Locação</td>
<td>Requer aplicação de Patch de dicionário e atualização do
console TSS para ignorar validação do ISS nas notas de locação.</td>
<td>Funcionalidade nativa via configuração de TES inteligente
configurada para desoneração de ISS com gravação de tags
informativas.</td>
</tr>
<tr>
<td class="bold">#29244310<br><small>(Aberto:
23/06/2026)</small></td>
<td>NT 007 - Validação e Arredondamento Bancário</td>
<td>Necessita de atualização dos fontes de cálculo fiscal
(Mata461/Mata460) para arredondamento conforme a regra do
Comitê.</td>
<td>Ajuste aplicado diretamente nas funções core do motor de
cálculo fiscal (Engine de Tributos) via atualizações de expedição
contínua.</td>
</tr>
<tr>
<td class="bold">#29244487<br><small>(Aberto:
23/06/2026)</small></td>
<td>NT 008 - Eventos de Ajuste, Crédito/Débito e DANFSe
v2</td>
<td>Impacto alto: Substituição dos arquivos .RTM do DANFSe e
criação de tabelas auxiliares para registrar notas de ajuste via RdMake ou
compatibilizador.</td>
<td>Atualização nativa do layout de impressão via TSS e novos
campos criados no dicionário padrão (SX3) para créditos de IVA.</td>
</tr>
<tr>
<td class="bold">#29244640<br><small>(Aberto:
23/06/2026)</small></td>
<td>NT 009 - Campo 'Valor de Ajuste BC' e Evoluções DPS</td>
<td>Depende de reestruturação do TSS. Exigirá a aplicação de
pacotes cumulativos pesados com risco de quebra de customizações de
NFSe locais.</td>
<td>Layout integrado ao dicionário de dados padrão da release,
aguardando liberação do Schema oficial pela TOTVS para consolidação do
XML v1.04.</td>
</tr>
</tbody>
</table>
<div class="alert-box">
<strong>CRÍTICO – Situação de Dependência Técnica:</strong> Todos
os chamados acima encontram-se atualmente com o status de <span
class="bold">"Aguardando Liberação pelo Desenvolvimento da
TOTVS"</span>, decorrente de um impedimento técnico de origem federal,
detalhado no capítulo a seguir.
</div>
<h2>5. Posicionamento Oficial do Desenvolvimento TSS/NFSe da
TOTVS</h2>
<p>
Em comunicado oficial direcionado aos canais de atendimento e
clientes, a equipe de Desenvolvimento do TSS/NFSe da TOTVS manifestou o
seguinte posicionamento técnico intransigente a respeito da <span
class="bold">Nota Técnica nº 009/2026</span> publicada em 04 de junho
de 2026:
</p>
<div style="background-color: #F8FAFC; border: 1px solid #E2E8F0;
padding: 12px; margin: 15px 0; font-style: italic;">
<p>"Prezado Cliente,</p>
<p>Informamos que a Secretaria-Executiva do Comitê Gestor da NFS-e
(CGNFS-e) publicou, em 04 de junho de 2026, a Nota Técnica nº 009/2026.
Este documento estabelece mudanças profundas no layout nacional (v1.04)
para suportar a Reforma Tributária (IBS/CBS), o novo Simples Nacional e o
CNPJ alfanumérico.</p>
<p>No entanto, comunicamos que ainda não é possível iniciar o
desenvolvimento e a entrega dessas adequações devido aos seguintes
impedimentos técnicos:</p>
<ul>
<li><strong>Ausência de Schemas XML (XSD):</strong> Até o
momento, o portal nacional da NFS-e não disponibilizou os arquivos de
schema (.xsd) correspondentes ao layout v1.04. Esses arquivos são
indispensáveis para que o sistema possa validar a estrutura das novas tags
(como o grupo unificado de ajustes ou as novas notas de crédito e débito) e
garantir que o arquivo gerado não seja rejeitado estruturalmente pelo
Ambiente Nacional.</li>
<li><strong>Indisponibilidade de Ambiente de Testes:</strong> O
cronograma específico para a implantação das novas funcionalidades em
ambiente de homologação (produção restrita) ainda não foi publicado, com
previsão de ser divulgado pelo portal 'nas próximas semanas' a contar da
data da NT.</li>
<li><strong>Validação de Regras de Negócio:</strong> Sem os
schemas e o ambiente de testes atualizado, não temos como validar os
novos cálculos tributários (IBS/CBS) e os gatilhos cruzados introduzidos pela
NT 009, o que impossibilita a garantia de conformidade fiscal do
produto.</li>
</ul>
<p>Reforçamos que a equipe técnica está monitorando diariamente o
Portal da NFS-e Nacional ([Link] Assim que as definições
técnicas e os ativos de validação forem publicados pelos órgãos oficiais,
retomaremos o cronograma de implementação para assegurar que seu
sistema esteja pronto antes da obrigatoriedade do CNPJ alfanumérico em
julho de 2026 e das novas regras do Simples Nacional em 2027.</p>
<p>Portanto não temos como destacar uma previsão diante do cenário
imprevisível de liberação do cronograma das novas funcionalidades e os
schemas de validação.</p>
<p>Atenciosamente,<br><strong>Desenvolvimento
TSS/NFSe</strong>"</p>
</div>
<h2>6. Justificativa Técnica Pragmática para a Pausa do Projeto</h2>
<p>
Diante do posicionamento da TOTVS e da análise direta do cenário
regulatório federal, este laudo determina e justifica a <span
class="bold">imediata paralisação temporária das frentes de
desenvolvimento e homologação de NFSe</span> no projeto da Cidade
Limpa devido aos seguintes fatores:
</p>
<ol>
<li><span class="bold">Impossibilidade de Teste e Validação:</span>
Sem os arquivos de Schema XML (.XSD) do ambiente nacional, qualquer
código desenvolvido internamente ou pela própria TOTVS constitui mera
especulação técnica. Não há como realizar o "de-para" ou validar se o
Protheus gerará um XML válido.</li>
<li><span class="bold">Risco de Retrabalho Elevado:</span>
Desenvolver estruturas baseadas estritamente no texto corrido da NT 009,
sem o ambiente de homologação ativo pelo governo, expõe o projeto ao
risco iminente de descarte total de horas técnicas assim que o fisco alterar
os nós e validações na publicação final dos schemas.</li>
<li><span class="bold">Dependência Crítica de Terceiros (Lock-in da
Software House):</span> Sendo o TSS um produto proprietário da TOTVS,
customizações manuais profundas no gerador de XML violam a garantia do
software e impedem a aplicação de atualizações futuras. A Cidade Limpa
depende obrigatoriamente da liberação dos patches oficiais atrelados aos
chamados mapeados no item 4.</li>
</ol>
<h2>7. Quadro Resumo de Impactos Estruturais e Status de
Projeto</h2>
<p>
A tabela a seguir consolida as modificações estruturais exigidas e
correlaciona com as ações necessárias e a respectiva justificativa técnica
para a pausa:
</p>
<table>
<thead>
<tr>
<th style="width: 20%;">Regra / Norma</th>
<th style="width: 15%;">Status da Ação</th>
<th style="width: 30%;">Impacto Estrutural no XML /
DANFSe</th>
<th style="width: 35%;">Ajuste Necessário no Protheus e
Justificativa de Pausa</th>
</tr>
</thead>
<tbody>
<tr>
<td class="bold">NT 005<br>(Locação)</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Inclusão de tags de imunidade/não-incidência de ISS para o
faturamento de locações.</td>
<td>Configuração de TES e atualização de Schemas do TSS.
<span class="bold">Pausa:</span> Vinculado à liberação conjunta do
dicionário unificado de NFS-e pela TOTVS.</td>
</tr>
<tr>
<td class="bold">NT 007<br>(Arredondamento)</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Validação matemática severa dos centavos de IBS e CBS no
nó de impostos da DPS.</td>
<td>Atualização da Engine de Tributos do Protheus. <span
class="bold">Pausa:</span> Sem o ambiente de homologação do Governo,
não há como simular a rejeição por arredondamento.</td>
</tr>
<tr>
<td class="bold">NT 008<br>(DANFSe v2)</td>
<td><span style="color: #D69E2E; font-weight:
bold;">Suspenso</span></td>
<td>Descontinuação do DANFSe clássico. Inclusão obrigatória de
campos de IBS/CBS no layout v2.</td>
<td>Substituição de arquivos de relatório (.RTM) e binários no
TSS. <span class="bold">Pausa:</span> TOTVS não disponibilizou os
fontes de impressão sem o layout final homologado.</td>
</tr>
<tr>
<td class="bold">NT 009<br>(Leiaute v1.04)</td>
<td><span style="color: #E53E3E; font-weight:
bold;">Bloqueado</span></td>
<td>Inclusão do campo unificado 'Valor de Ajuste BC'. Mudança
estrutural drástica do XML para v1.04.</td>
<td>Mapeamento de novas tags no TSS e alteração do dicionário
de dados (SX3). <span class="bold">Pausa Crítica:</span> Inexistência de
Schemas XSD oficiais por parte do governo federal.</td>
</tr>
</tbody>
</table>
<h2>8. Melhores Decisões Técnicas Recomendadas (Diretrizes de
Governança)</h2>
<p>
Com base nas evidências técnicas apresentadas, as melhores decisões
estratégicas e operacionais para a diretoria da <span class="bold">Cidade
Limpa</span> são:
</p>
<div class="recommendation-box">
<strong>Plano de Ação e Recomendações Finais:</strong>
<ol>
<li><strong>Oficializar a Pausa de Escopo de Faturamento da NFS-
e:</strong> Congelar o cronograma de desenvolvimento interno ligado à
emissão de Notas de Serviço da Reforma Tributária até que a TOTVS encerre
o status de desenvolvimento dos chamados #29244640 e #29244487.</li>
<li><strong>Redirecionar Esforços Técnicos para Saneamento
Interno (Release Upgrade):</strong> Utilizar a janela de pausa técnica
compulsória para garantir que o ambiente Protheus esteja totalmente
atualizado nas atualizações de infraestrutura da release <span
class="bold">24.10</span> ou no planejamento de migração para a
release <span class="bold">25.10</span>. Isso mitigará gargalos quando
os patches cumulativos da Reforma forem finalmente liberados pela
TOTVS.</li>
<li><strong>Monitoramento Passivo Sem Consumo de
Horas:</strong> Estabelecer uma rotina semanal automatizada de
checagem dos chamados TOTVS listados neste laudo e do Portal Nacional da
NFS-e. O projeto somente deverá ser despausado quando os arquivos .XSD
(Schemas) forem disponibilizados pelo Governo Federal e incorporados aos
pacotes oficiais do TSS.</li>
<li><strong>Alinhamento Jurídico-Contratual com
Clientes:</strong> Utilizar este Laudo Técnico para justificar perante a
auditoria e clientes da Cidade Limpa que eventuais atrasos na exibição
gráfica do IBS/CBS em ambiente de teste decorrem de uma limitação geral
da plataforma nacional do governo, isentando a equipe de projeto de
quaisquer penalidades contratuais.</li>
</ol>
</div>
<p style="margin-top: 30px; text-align: center; font-size: 9pt; color:
#718096;">
Laudo Técnico emitido para fins de governança sistêmica e
alinhamento de escopo de projeto ERP.<br>
[Departamento de Consultoria Técnica e Arquitetura de Sistemas
Protheus]
</p>
</body>
</html>
"""
# Salva o arquivo HTML temporário
with open("laudo_tecnico_reforma_tributaria.html", "w", encoding="utf-8")
as f:
[Link](html_content)
# Converte o HTML para PDF utilizando o weasyprint
from weasyprint import HTML
HTML("laudo_tecnico_reforma_tributaria.html").write_pdf("laudo_tecnico_cid
ade_limpa_rt.pdf")
print("PDF gerado com sucesso.")
Saída de código
PDF gerado com sucesso.
O Laudo Técnico completo, formatado em PDF de padrão corporativo e
adequado às diretrizes técnicas solicitadas para o cliente Cidade Limpa, foi
gerado com sucesso.
O documento detalha minuciosamente todas as regras tributárias federais,
o mapeamento das Notas Técnicas (NT 005, NT 007, NT 008, NT 009), a
análise técnica dos chamados no ecossistema TOTVS Protheus para as
releases 24.10 e 25.10, além de incluir o capítulo isolado com o
posicionamento oficial da engenharia da TOTVS e a justificativa para a
pausa imediata do projeto.
Seu arquivo PDF está pronto:
laudo_tecnico_cidade_limpa_rt
PDF
Aberto
📝 Resumo do Posicionamento e Decisões Técnicas Recomendadas
Para sua leitura imediata, segue a síntese das melhores decisões
estratégicas apresentadas e validadas no laudo:
1. Paralisação Formal e Controlada do Escopo de NFSe da
Reforma: Conforme o posicionamento oficial do desenvolvimento da
TOTVS, a ausência de Schemas XML (.XSD) oficiais por parte do
Governo Federal inviabiliza qualquer tipo de codificação segura.
Continuar o desenvolvimento neste momento geraria um risco
altíssimo de retrabalho e desperdício de horas técnicas.
2. Foco no Saneamento de Infraestrutura (Releases 24.10 e
25.10): A recomendação técnica ideal é redirecionar a equipe do
projeto para a atualização de pacotes de infraestrutura do Protheus e
do TSS. Estar com o ambiente limpo nas releases solicitadas
garantirá que, assim que a TOTVS liberar os patches cumulativos pós-
publicação do governo, a aplicação seja imediata e sem conflitos de
dicionário de dados (SX3).
3. Monitoramento Passivo dos Chamados: Manter os chamados
abaixo sob monitoramento semanal, sem consumo de esforço de
desenvolvimento até a mudança de status por parte da software
house:
o #26941475 (NT 005 - Locação de Bens)
o #29244310 (NT 007 - Arredondamento Bancário)
o #29244487 (NT 008 - Layout DANFSe v2)
o #29244640 (NT 009 - Campo Unificado 'Valor de Ajuste BC')
4. Segurança Jurídica: Utilizar este documento para comprovar
técnica e legalmente junto à diretoria da Cidade Limpa que a pausa
do projeto não é uma falha de planejamento interno, mas sim uma
contingência de mercado causada pela indisponibilidade de ativos de
validação do próprio Fisco Nacional.
O arquivo PDF acima contém o quadro resumo completo estruturado em
tabelas e as justificativas técnicas ponto a ponto.
Com certeza. Para dar o tom técnico e profissional que um Laudo Técnico
exige, estruturei o documento focando no cenário atual (já que estamos em
2026, o ano oficial do início da transição) e aplicando diretamente à
realidade de uma empresa como a Cidade Limpa (cujo nome sugere
atuação no setor de serviços, saneamento ou gestão de resíduos).
Abaixo está a minuta do laudo formatada de forma scannável e pronta para
uso.
LAUDO TÉCNICO DE IMPACTO FISCAL
Ref: Análise de Impacto de Transição – Reforma Tributária (Emenda
Constitucional nº 132)
Cliente: Cidade Limpa
Data de Emissão: 1 de julho de 2026
1. Objetivo
O presente laudo tem por objetivo avaliar os impactos regulatórios,
operacionais e financeiros iniciais decorrentes da implementação do modelo
de IVA Dual (Imposto sobre Valor Agregado) para o cliente Cidade Limpa,
considerando o cronograma de transição estipulado pela legislação e as
diretrizes vigentes para o ano-calendário de 2026.
2. Diagnóstico do Cenário Atual (Ciclo de Transição 2026)
O ano de 2026 configura-se legalmente como o período de teste e
adaptação do novo sistema. A introdução da Contribuição sobre Bens e
Serviços (CBS - Federal) e do Imposto sobre Bens e Serviços (IBS -
Estadual/Municipal) ocorre de forma concomitante aos tributos tradicionais
(PIS, COFINS, ISS, ICMS).
2.1 Alíquotas de Ensaio Operacional
Para este exercício de 2026, as alíquotas fixadas possuem caráter
predominantemente informativo e de acoplamento tecnológico:
CBS (Federal): $0,9\%$
IBS (Estadual/Municipal): $0,1\%$
Alíquota Combinada de Teste: $1,0\%$
⚖️Nota de Neutralidade de Carga (2026): O montante de $1,0\%$
recolhido sob o título de CBS/IBS em 2026 não representa aumento real de
impostos. Ele será integralmente compensado/deduzido das guias devidas
de PIS e COFINS da empresa, mantendo o desembolso financeiro idêntico ao
modelo anterior.
3. Impactos Operacionais e Obrigações Acessórias
Embora o recolhimento efetivo esteja protegido pela regra de neutralidade
neste ano, a conformidade digital e de TI é imediata. A Cidade Limpa deve
observar as seguintes exigências de faturamento:
Destaque em Nota Fiscal: É obrigatório o destaque individualizado
dos campos de CBS e IBS nas Notas Fiscais Eletrônicas (NF-e / NFS-e),
conforme o layout atualizado fornecido pelo Fisco.
Flexibilização de Validação: A Receita Federal e o Comitê Gestor
do IBS adotaram um caráter pedagógico para 2026. Erros ou
inconsistências no preenchimento destes novos campos não
provocarão o bloqueio automático da emissão da nota fiscal,
permitindo a continuidade do faturamento do cliente.
Janela de Autorregularização: Havendo divergências detectadas
pelo cruzamento de dados do Fisco, a empresa terá o prazo de até 60
dias para retificar as informações sem a aplicação de penalidades ou
multas.
4. Análise de Risco e Planejamento para o Médio Prazo (2027 -
2033)
O maior ponto de atenção para a governança da Cidade Limpa reside no
encerramento da fase de testes.
[2026: Fase de Teste] ➔ [2027: Extinção de PIS/COFINS e CBS Cheia] ➔
[2029-2033: Substituição Gradual de ISS por IBS]
A partir de 1º de janeiro de 2027, o PIS e a COFINS serão formalmente
extintos, e a CBS passará a ser cobrada em sua alíquota cheia definitiva
(estimada na média do IVA padrão de $26,5\%$ a $28\%$, dependendo da
regulamentação final de benefícios).
Como a atuação da Cidade Limpa está fortemente atrelada ao setor de
serviços e/ou saneamento, o modelo de não-cumulatividade ampla
(crédito financeiro sobre insumos) precisará ser rigidamente apurado.
Setores de serviços tendem a ter cadeias de insumos físicas menores do
que indústrias, o que exige atenção redobrada na precificação de contratos
de longo prazo para evitar compressão de margem de lucro quando o ISS for
totalmente absorvido pelo IBS.
5. Recomendações Técnicas e Próximos Passos
Para salvaguardar a saúde financeira e a conformidade da Cidade Limpa,
este parecer recomenda as seguintes ações imediatas:
1. Homologação do Software de Gestão (ERP): Confirmar com o
fornecedor do sistema se os parâmetros e Notas Técnicas de emissão
com campos de CBS/IBS estão 100% ativos e validados.
2. Auditoria de Cadastro de Fornecedores: Mapear quais
fornecedores da Cidade Limpa geram créditos fiscais no novo modelo
de IVA (compras para uso, consumo e ativo imobilizado passam a
gerar crédito integral na entrada).
3. Cláusula de Revisão em Contratos: Inserir aditivos de
neutralidade tributária nos contratos de prestação de serviços
vigentes que ultrapassem o ano de 2026, prevendo o reequilíbrio
econômico-financeiro em virtude da flutuação das alíquotas
definitivas a partir de 2027.
Conclusão do parecer técnico submetido para análise da diretoria e do
departamento contábil da Cidade Limpa.
[Nome do Responsável Técnico / Consultor]
Consultoria Tributária e Societária
Se você precisar que eu mude ou detalhe algum ponto específico (como
focar mais na parte de saneamento e destinação de resíduos ou alterar o
regime de tributação atual da empresa, como Lucro Real ou Presumido), é
só me avisar!
Com base no histórico recente de atualizações da NFS-e Nacional, a Nota
Técnica 009 substituiu integralmente e de forma direta as NTs 005 e 007,
consolidando as regras no ambiente fiscal.
Abaixo, apresento uma consolidação estruturada das principais mudanças
trazidas por essas atualizações para que você possa incluir e adequar ao
seu documento.
📑 Consolidação das Mudanças: NT 005, NT 007 e NT 009 da NFS-e
Nacional
O ecossistema da NFS-e Nacional passou por importantes evoluções para se
adequar ao modelo de IVA Dual (IBS e CBS) previsto na Reforma Tributária
(Lei Complementar nº 214/2025). Segue a radiografia técnica do que mudou
no layout e nas regras de validação:
1. Transição e Evolução do Layout (A Unificação da NT 009)
Substituição Direta: A NT 009 substitui integralmente os históricos
e schemas das NTs 005 e 007, simplificando o processo para as
equipes de TI.
Cronograma: Os prazos detalhados para os ambientes de
homologação e produção, juntamente com os arquivos de validação
(XSDs), serão publicados nas próximas semanas no portal nacional.
CNPJ Alfanumérico: Antecipando a mudança prevista para iniciar a
partir de julho de 2026, todos os campos de CNPJ mudaram o tipo de
dado de numérico (N) para caractere (C). Sistemas legados
precisam remover máscaras estritamente numéricas.
2. Grupo Unificado de Ajuste da Base de Cálculo (vAjusteBC)
Para simplificar o layout e economizar tags, os antigos grupos vDedRed
(deduções/reduções de ISSQN) e gReeRepRes (reembolsos e repasses de
IBS/CBS) foram unificados em uma única estrutura chamada
vAjusteBC.
Subgrupo docAjusteBC: Permite referenciar até 1.000 documentos
fiscais eletrônicos nacionais, estrangeiros ou não fiscais para justificar
o ajuste.
Deduções Descontinuadas: Foram eliminados os antigos tipos de
dedução 1 (Alimentação e bebidas/frigobar), 3 (Produção externa) e 4
(Reembolso de despesas).
Novas Fórmulas de Cálculo: Refletindo a unificação, os campos
calculados foram renomeados:
o vCalcDR $\rightarrow$ vCalcAjusteBCISSQN
o vCalcReeRepRes $\rightarrow$ vCalcAjusteBCIBSCBS
o vCalcDedRedIBSCBS $\rightarrow$ vCalcAjusteBCLocImoveis
3. Notas de Ajuste de IBS/CBS e Indicador de Uso Pessoal
Finalidade da Emissão (finNFSe): O campo teve seu domínio
ampliado para diferenciar Notas de Ajuste de crédito ou débito
exclusivas dos novos tributos:
o 0 = NFS-e regular;
o 1 = NFS-e de crédito;
o 2 = NFS-e de débito.
Grupo gIBSCBSAjuste: Criado na estrutura de tributos contendo as
tags vIBS e vCBS para carregar os valores de ajuste.
Campo indFinal: O indicador de operação destinada a uso ou
consumo pessoal retornou oficialmente ao layout (atendendo ao art.
57 da LC nº 214/2025), impactando o direito a créditos na ponta do
tomador.
4. Reestruturação de Operações Imobiliárias e Locações
Operações que antes ficavam fora do escopo do ISSQN (como locações)
ganharam relevância para a apuração do IBS/CBS e agora possuem grupos
específicos:
gLocacao: Concentra variáveis financeiras macro do contrato (valores
totais, descontos, vencimentos).
gUnidImob: Permite referenciar até 99 imóveis em uma única nota
(detalhando CIB, inscrição municipal e endereço). Havendo múltiplos
donos, os valores serão validados proporcionalmente ao percentual
de copropriedade.
Bens Móveis (bensMoveis): O antigo grupo gLocBensMoveis foi
renomeado apenas para bensMoveis, passando a aceitar até 1.000
registros de bens em uma mesma nota.
Códigos Tributários Nacionais (cTribNac): Foram consolidados os
códigos para documentar operações sem incidência de ISS:
o 99.01.01 – Outras operações sem ISS/ICMS
o 99.02.01 – Operações com bens imateriais
o 99.03.01 – Locação de bens imóveis
o 99.04.01 – Locação de bens móveis
5. Regras de Arredondamento Bancário e Retenções (PIS/COFINS)
Arredondamento "Half-Even": A nota de serviços passa a adotar o
padrão bancário de arredondamento (half-even) com tolerância de
até R$ 0,01 para evitar rejeições por pequenas diferenças
centesimais.
Separação de Valores: Correção crucial na distinção entre valores
devidos e retidos. Os campos vPis e vCofins servem exclusivamente
para o imposto devido. As retenções migraram para os campos
tpRetPisCofins e vRetCSLL, impedindo que os valores retidos
impactem indevidamente as bases de cálculo do IBS/CBS.
6. Mecanismo de Split Payment (gPgtoVinc)
Vínculo Financeiro: Foi criado o grupo gPgtoVinc para amarrar a
NFS-e à transação financeira correspondente no momento da emissão
(até 99 vínculos).
Campos Exigidos: Exige dados como idTransacao, o meio de
pagamento (Pix, TED, Boleto, etc.) e o CNPJ do provedor de
liquidação. É a base operacional para que os bancos realizem a
retenção e recolhimento automatizado do IBS/CBS no momento exato
da liquidação financeira.
7. Impacto no Simples Nacional
O layout ganhou novos campos para blindar as regras do Simples Nacional
frente ao IBS/CBS:
O campo opSimpNac foi ampliado para cobrir opções pendentes de
regularização judicial.
Inclusão do campo regApIBSCBSSN para identificar o regime de
apuração (se ambos os tributos são unificados, se apenas a CBS fica
no Simples ou se ambos vão para o regime regular por estouro de
sublimite).
Criação do grupo gTribSN para discriminar alíquotas e valores
calculados baseando-se na nova fórmula de Receita Bruta
(vReceitaBrutaSN).
💡 Próximos Passos Recomendados para o seu Documento / Projeto:
Se o seu objetivo com este documento é orientar uma equipe de
desenvolvimento ou atualizar políticas fiscais internas, o foco imediato deve
ser uma varredura no código e banco de dados pelos termos
descontinuados (vDedRed, gReeRepRes, vCalcDR, gLocBensMoveis) para
substituí-los pela nova estrutura unificada da NT 009, além de preparar o
sistema para receber strings (e não inteiros) nos campos de CNPJ.