Protheus 12.1.2610: o que muda

A 12.1.2610 do Protheus sai em outubro de 2026. Veja o que muda na Reforma Tributária, no financeiro, no TSS e nas customizações, e o que conferir antes de atualizar.

Por WeePulse02 de outubro de 202636 min de leitura

A release 12.1.2610 do TOTVS Protheus chega em outubro de 2026, dentro do calendário anual da TOTVS: na nomenclatura 12.1.aamm, “26” é o ano e “10” é o mês de expedição. A data exata fica na página oficial da release no TDN e na Central de Downloads.

O que já está documentado é suficiente para planejar. A 12.1.2610 traz um bloco grande de entregas da Reforma Tributária (faturamento de encargos e antecipações de IBS e CBS, códigos de tributos da DeRE, conciliador integrado ao Configurador, otimizador de perfis tributários), uma lista de pontos de atenção mandatórios que mexem em customizações do financeiro e do estoque, a migração dos usuários do TSS para o banco de dados, um novo extrator do TAF e pré-requisitos novos de License Server, DBAccess, AppServer e Lib.

Este guia organiza o que muda, o que a TOTVS classifica como mandatório e o que conferir no seu ambiente antes de marcar a janela de atualização. Se o seu Protheus ainda está na 12.1.2410 ou em uma release mais antiga, leia junto o nosso guia sobre a expiração da 12.1.2410 e a garantia estendida, porque a chegada da 2610 muda a conta.

Quando sai a 12.1.2610 e o que ela muda no ciclo de vida

O nome da release segue a regra 12.1.aamm adotada pela TOTVS desde outubro de 2022: “26” é o ano e “10” é o mês de lançamento. Por isso as releases do Protheus saem sempre em outubro, e a 2610 vem na sequência da 12.1.2310, 12.1.2410 e 12.1.2510.

A política de ciclo de vida da linha Protheus, publicada no TDN, diz que a TOTVS libera atualização de legislação e manutenção no release corrente ou no release anterior não expirado. Release expirada só recebe manutenção com contrato de garantia estendida. Na prática:

A 12.1.2410 expirou em 30/06/2026, com garantia estendida vigente desde 01/07/2026.
A 12.1.2510 é a release corrente até a expedição da 2610. Quando a 2610 entrar no ar, a 2510 passa a ser “a anterior”, e a janela para decidir entre atualizar e contratar garantia estendida começa a correr.
A data de expiração da 2510 é publicada no calendário do portal de ciclo de vida da TOTVS, no Portal do Cliente. Vale consultar antes de decidir o caminho.

Isso importa até para quem não pretende atualizar agora. Cada release nova empurra as antigas para fora da janela de suporte, e em 2026 a janela de suporte é a mesma que entrega os pacotes da Reforma Tributária.

O que a 12.1.2610 entrega para a Reforma Tributária

A página de destaques do release para o Backoffice, atualizada pela TOTVS em 29 de setembro de 2026, concentra as entregas fiscais em cinco frentes. A tabela resume o que é cada uma e onde ela se encaixa no que você já pode estar fazendo no Protheus.

Entrega	O que faz	Onde entra no seu dia a dia
Faturamento de encargos e antecipações (IBS/CBS)	Monitor centralizador que captura juros e multas na baixa de títulos a receber e recebimentos antecipados vinculados a documentos com IBS e CBS, e dispara a geração das Notas de Débito correspondentes	Financeiro e faturamento. É a rotina que fecha o circuito das notas de débito e crédito da Reforma sem lançamento manual
Códigos de tributos da DeRE	Rotina de manutenção com a estrutura padronizada de códigos definidos no manual da declaração	Quem tem regime específico. Detalhe no nosso guia da DeRE no Protheus
Conciliador x Configurador de Tributos	O Conciliador passa a contemplar os novos campos do Configurador	Fechamento fiscal. Conversa direto com a apuração assistida de IBS e CBS
Otimizador de perfis tributários (produtos e participantes)	Facilitador para cadastrar e manter os perfis usados nas regras do Configurador	Parametrização. Reduz o trabalho de quem ainda está levando as TES para o Configurador de Tributos
Indicador da operação (IndOp)	Código de indicador de operação para IBS e CBS no Configurador, exigido pela NT SE/CGNFS-e nº 004/2025 para a NFS-e	Prestadores de serviço. Base para a NFS-e com IBS e CBS
Crédito presumido de IBS e CBS	Implementação do crédito presumido no contexto da RTC	Setores com crédito presumido (a tabela cCredPres do Informe Técnico 2025.002)
Evento 211130 (imobilização de item)	Comunica ao Fisco que um bem adquirido por NF-e foi incorporado ao ativo imobilizado	Ativo fixo. Entra na mesma família dos eventos 211128 e 211150 do TAF

Fora da Reforma, mas na mesma página, há entregas que o fiscal e o contábil vão sentir: a ECF no leiaute 12 (ano-calendário 2025 e situações especiais de 2026, pelo Ato Declaratório Cofis nº 02/2026), o facilitador de ajustes de PIS e COFINS no Bloco M da EFD Contribuições por documento fiscal (Lei Complementar 224/2025, que exige o tributo genérico calculado pelo Configurador), o operando “T” nas fórmulas do Configurador (referência ao ID padrão da tabela F2C, para a mesma fórmula servir a vários cenários) e a tabela progressiva de IRPF em serviços de pessoa física.

Um ponto de contexto: os pacotes da Nota Técnica 2025.002 continuam sendo entregues para a 12.1.2510 e a 12.1.2610. Para a 2310 e a 2410, só com garantia estendida. Está na nossa tabela de versões do guia sobre as 14 versões da NT 2025.002 no Protheus.

As mudanças que mexem nas customizações

A TOTVS mantém, para esta release, uma página separada chamada “Pontos de atenção mandatórios para o release”, criada em 23 de julho de 2026. É curta e vale ser lida inteira, porque cada item dela é um lugar onde uma customização pode parar de funcionar sem avisar.

Financeiro: as chaves concatenadas deixam de ser lidas

Duas mudanças estruturais no financeiro, apresentadas pela TOTVS como preparação para campos maiores de número e série de documentos fiscais:

Rotinas que liam E1_TITPAI e E2_TITPAI passam a usar FK7_TITPAI como referência.
Rotinas de compensação que identificavam a origem pelo E5_DOCUMEN passam a usar FK1_IDCOMP ou FK2_IDCOMP, conforme a carteira.

A TOTVS diz que isso não impacta a operação padrão. O risco está no que não é padrão: relatórios, integrações, consultas SQL, pontos de entrada e User Functions que acessam esses campos diretamente. Se o seu ambiente tem conciliação bancária customizada, extrator para BI ou integração com sistema de cobrança lendo a SE5 pela coluna de documento, esse código precisa ser revisado antes da virada.

Estoque e custos: stored procedures instaladas automaticamente

A partir da 12.1.2610, algumas rotinas passam a instalar sozinhas as stored procedures de que precisam e descontinuam os trechos equivalentes em AdvPL. A lista nesta release: a função CALCEST (MATXFUNB), o Refaz Poder de Terceiros (MATA216), o Recálculo do Custo Médio (MATA330) e a Virada de Saldos (MATA280), além das procedures do Custo em Partes.

O que isso significa para quem customizou: pontos de entrada que interceptavam o processamento AdvPL dessas rotinas deixam de ser chamados quando o cálculo passa a rodar no banco. É o tipo de mudança que não gera erro na tela; ela simplesmente para de executar a lógica customizada.

Browse Smart X: pontos de entrada descontinuados

O novo Browse Smart X chega em diversas rotinas de Estoque e Custos, Financeiro, Ativo Fixo e Contabilidade Gerencial, trocando a tela inicial de listagem. A TOTVS afirma que as regras de inclusão, edição e exclusão ficam preservadas, mas a documentação de cada módulo lista pontos de entrada descontinuados para adaptação. Customizações de filtro, legenda, botões adicionais e colunas no browse são as candidatas a revisão.

Bloqueios de inventário e de lote saem do Configurador

O bloqueio automático de produtos em período de inventário passa a ser agendado dentro da própria rotina de Inventário (MATA270), e o bloqueio de lotes vencidos vira um job no Schedule, sem depender de uma sessão de usuário ativa. Quem configurou esses bloqueios por parâmetro ou por rotina agendada no SIGACFG precisa migrar a configuração.

Novo extrator do TAF

A integração dos documentos e movimentos financeiros com o SIGATAF ganha um mecanismo novo, que substitui o modelo baseado em EXTFISXTAF e FINA989. As integrações passam a ocorrer de forma automática. Se o seu ambiente tem schedule, script ou procedimento operacional que dispara o extrator antigo, ele precisa ser aposentado junto.

TSS: os usuários saem dos arquivos e vão para o banco

Esta é a mudança da 2610 que mais afeta o dia a dia de quem administra o ambiente fiscal. Até a 12.1.2510, o TSS usava dois cadastros de usuário em arquivos locais: um para ferramentas como VSCode e APSDU (arquivo sigapss.spf) e outro para as rotinas TSSInterface, TSSMonitor e TSSManager (arquivo smallapppss.spf).

A partir da 12.1.2610, segundo a documentação TSS0077 do TDN, os cadastros são unificados e migrados para tabelas do banco de dados. O mesmo usuário e senha valem para as ferramentas administrativas e para as rotinas. Surgem duas rotinas novas no menu do usuário administrador: Gerenciar Usuários (inclusão, alteração e exclusão) e Vincular CNPJ (quais CNPJs cada usuário enxerga nas interfaces).

Três detalhes práticos da documentação:

Só o usuário Administrador mantém acesso à APSDU. Os demais usuários enxergam apenas as rotinas do TSS, limitadas aos CNPJs vinculados.
Em uma instalação nova do TSS direto na 12.1.2610, o usuário “Admin” é criado sem senha, e a senha deve ser definida na rotina Gerenciar Usuários. Isso é item de checklist de segurança, não de conveniência.
Em releases anteriores, o comportamento legado é mantido.

Se a sua operação emite por várias filiais com perfis de acesso separados no TSS, a vinculação de CNPJ precisa ser refeita na migração. O procedimento de atualização do componente em si está no nosso guia de atualização do TSS sem parar a NF-e.

Relatórios bloqueados e rotinas descontinuadas

Dois avisos de descontinuação se cruzam com a 2610.

Relatórios do Backoffice. A página do TDN “Relatórios do BackOffice Protheus - Descontinuados a partir de 31/10/2024” diz que esses relatórios foram descontinuados a partir da 12.1.2410, com bloqueio definitivo de uso na 12.1.2510 e superiores, em 01/07/2026. A lista cobre Ativo Fixo, Financeiro, Estoque, Compras, Faturamento e Contabilidade. Nos destaques da 2610, cada módulo repete o item “Descontinuidade de relatórios: bloqueio de diversos relatórios”. O substituto indicado é o Smart View, e a TOTVS informa que os fontes dos relatórios podem ser baixados no Portal do Cliente (categoria “Programa Fonte de Relatório”) e convertidos em User Function. Se a operação ainda imprime um desses relatórios, ele tem que ter substituto antes da virada. O nosso guia do Smart View no Protheus cobre o caminho.

Rotinas do Mercado Internacional. Em comunicado na Central de Atendimento, a TOTVS avisa que 45 rotinas de relatório dos módulos SIGAFIN, SIGAFIS, SIGACOM, SIGAFAT e SIGACTB usadas nas localizações do Mercado Internacional (Argentina, Colômbia, México e Paraguai) serão descontinuadas em 30 de outubro de 2026 e que, a partir da release 12.1.2610, não estarão mais disponíveis. A migração para o Smart View não tem custo para quem usa as rotinas hoje. Só afeta quem opera filiais fora do Brasil no mesmo Protheus, mas para essas empresas é uma data dura.

Pré-requisitos de infraestrutura para a 12.1.2610

A página “Upgrade de Release do Protheus 12” do TDN, revisada em 18 de setembro de 2026, lista as versões mínimas dos componentes para migrar para a 2610:

Componente	Versão mínima
License Server	3.7.2 ou superior
DBAccess	26.1.0.0 ou superior
AppServer (build)	26.3.0.0 ou superior
Lib	20261005 ou superior

Além das versões, a mesma página traz regras que vêm das releases anteriores e continuam valendo:

Dicionários no banco de dados são obrigatórios desde a 12.1.2210. Ambiente que ainda tem dicionário em arquivo precisa migrar antes.
CHECKDUPL antes da atualização, para eliminar chaves duplicadas em SX2 e SX3 (e, desde a 2410, em SX5 e SX6, que travam a migração).
Dicionário de referência obrigatório desde a 2410. Se faltar, é preciso reprocessá-lo.
Banco de dados e sistema operacional homologados são validados desde a 2410, e a atualização é barrada em ambiente não homologado. Só ambientes marcados como desenvolvimento escapam da validação do sistema operacional.
Repositório de imagens no banco de dados passa a ser recomendado na 2610.
Bloqueio de retrocesso: se alguma empresa do ambiente já estiver em uma release posterior, a atualização para uma release anterior não é permitida.
O UPDDISTR tem modo de simulação, que roda a análise sem gravar nada na base. É o jeito certo de descobrir inconsistências de dicionário antes da janela de produção. Desde a Lib 20250113, a chave MAXTHREADUPD na seção GENERAL do appserver.ini controla quantas threads a atualização de tabelas usa, entre 15 e 50.

Duas novidades da Lib que acompanha a release, documentadas na página “Versão LIB 20261016_P12” do TDN (atualizada até a data oficial de lançamento): novos usuários passam a receber o Grupo Default automaticamente, sem possibilidade de remoção, com permissões concedidas por políticas; e a rotina Aplicar Pacote Local permite aplicar pacotes a partir da SystemLoad sem vincular a um projeto nem passar pela Gestão de Projetos. A primeira muda a rotina de quem administra acessos. A segunda simplifica a aplicação de patches no dia a dia da sustentação.

O que muda para quem ainda está na 2410 ou em release mais antiga

Se o seu Protheus está na 12.1.2410, você já está em release expirada desde 30/06/2026, e só recebe pacotes com garantia estendida. A chegada da 2610 cria uma decisão de três caminhos:

Atualizar direto para a 12.1.2610. O arquivo de dicionário diferencial (SDF) permite ir de qualquer release da versão 12 para a última sem passar pelas intermediárias. O custo é absorver, de uma vez, as mudanças da 2510 e da 2610.
Atualizar para a 12.1.2510. É a release que já está estabilizada no mercado há um ano e recebe os pacotes da NT 2025.002. O risco é a janela: quando a 2610 sai, a 2510 vira “anterior” e a sua expiração passa a ser a próxima data a vigiar.
Contratar garantia estendida e manter a 2410 por mais um período. Serve como ponte, mantém correções e legislação já existente, não traz evolução funcional.

Em qualquer dos três caminhos, quem vem de releases anteriores à 2410 herda junto as viradas que chegaram com ela: o SmartClient WebApp obrigatório no lugar do SmartClient Desktop, a autenticação de REST e SOAP ligada por padrão sem possibilidade de desligar, e a validação de banco e sistema operacional homologados. Isso vale um inventário à parte de integrações e automações que dependiam do cliente desktop.

Checklist: o que conferir antes de marcar a janela

A atualização em si cabe em um fim de semana. O que garante a segunda-feira é a preparação. Com base nos pontos de atenção mandatórios e nos pré-requisitos publicados, este é o roteiro que usamos:

Confirmar a release atual, a data de expiração e o caminho escolhido (2610 direta, 2510 ou garantia estendida).
Levantar tudo que lê E1_TITPAI, E2_TITPAI, E5_DOCUMEN: fontes customizados, relatórios, consultas SQL de BI, integrações bancárias e de cobrança.
Mapear pontos de entrada usados em CALCEST, MATA216, MATA330 e MATA280 e nas rotinas que recebem o Browse Smart X.
Listar os relatórios bloqueados que a operação ainda usa e definir o substituto (Smart View ou User Function a partir do fonte).
Verificar schedules e scripts que disparam EXTFISXTAF e FINA989, e os bloqueios de inventário e lote configurados no SIGACFG.
Planejar a migração dos usuários do TSS para o banco, com a vinculação de CNPJ por usuário e a senha do Admin definida.
Atualizar License Server, DBAccess, AppServer e Lib para as versões mínimas, primeiro em homologação.
Rodar CHECKDUPL e o UPDDISTR em modo simulação em uma cópia fria do ambiente e tratar as inconsistências antes de qualquer janela de produção.
Homologar o fiscal de ponta a ponta: NF-e com grupo de IBS e CBS, NFS-e com IndOp, notas de débito geradas pelo novo monitor de encargos, DeRE, apuração e conciliação.
Fechar o plano de virada com cópia fria consistente, janela acordada com as áreas e plano de retorno.

Dois lembretes que a própria TOTVS faz: a cópia fria (todos os serviços parados) e consistente da base e das pastas do Protheus deixa de ser recomendação e vira obrigação em sistema de missão crítica; e não é para abrir o Protheus depois de trocar os arquivos, é para rodar direto o compatibilizador.

Como a WeePulse conduz a atualização de release

Atualizar release não é instalar um pacote. É um projeto de sustentação, e a parte mais cara não é a virada: é o inventário do que o seu ambiente carrega de diferente do padrão. A WeePulse trabalha com empresas que já operam o Protheus, e o roteiro é sempre o mesmo: levantar customizações, integrações e pontos de entrada afetados pelos pontos de atenção da release; montar a homologação espelhada; compatibilizar e testar com peso extra no fiscal, no financeiro e no contábil; e conduzir a virada com plano de retorno. Quando o prazo não fecha, ajudamos a decidir se a garantia estendida é a ponte certa e por quanto tempo.

Perguntas frequentes

Quando sai a release 12.1.2610 do Protheus?

Em outubro de 2026, seguindo o calendário anual da linha Protheus (nomenclatura 12.1.aamm). O dia da disponibilização é publicado na página da release no TDN e na Central de Downloads do Portal do Cliente.

A TES acaba na 12.1.2610?

Nada na documentação publicada da 12.1.2610 descontinua o cadastro de TES. O que a release entrega é o otimizador de perfis tributários e o operando “T”, que facilitam levar as regras para o Configurador de Tributos. IBS, CBS e Imposto Seletivo, porém, só são configurados no Configurador.

Preciso atualizar para receber os pacotes da Reforma Tributária?

Depende da release. A 12.1.2510 e a 12.1.2610 recebem os pacotes da NT 2025.002. A 12.1.2310 e a 12.1.2410 só recebem com garantia estendida contratada.

Quais são as versões mínimas para instalar a 12.1.2610?

License Server 3.7.2, DBAccess 26.1.0.0, AppServer 26.3.0.0 e Lib 20261005 ou superiores, além dos dicionários completo e diferencial da release, do RPO, dos helps e da execução do UPDDISTR, conforme a página de upgrade do TDN.

O que muda no TSS com a 12.1.2610?

Os cadastros de usuário saem dos arquivos locais e vão para o banco de dados, unificados em um único acesso. Surgem as rotinas Gerenciar Usuários e Vincular CNPJ. Só o Administrador acessa a APSDU, e em instalação nova o Admin nasce sem senha.

Minhas customizações do financeiro vão quebrar?

As rotinas padrão deixam de ler E1_TITPAI, E2_TITPAI e E5_DOCUMEN e passam a usar FK7_TITPAI, FK1_IDCOMP e FK2_IDCOMP. Customizações, relatórios, integrações e consultas que acessam os campos antigos diretamente precisam ser avaliadas e adequadas.

Posso pular da 12.1.2410 direto para a 12.1.2610?

Sim. O arquivo de dicionário diferencial (SDF) permite atualizar de qualquer release da versão 12 para a última sem passar pelas intermediárias. Os pré-requisitos de componentes e as validações de ambiente homologado continuam valendo.

Dá para voltar para a release anterior depois de atualizar?

Não pela ferramenta. O UPDDISTR bloqueia o retrocesso quando existe empresa em release posterior. O caminho de volta é a cópia fria feita antes da atualização, e por isso ela é obrigatória em ambiente de missão crítica.