Protheus 12.1.2610: principais novidades do novo release

Atualizar o ERP costuma gerar uma pergunta: o que pode acontecer com as rotinas que a empresa utiliza todos os dias? Na atualização do Protheus 12.1.2610, essa avaliação envolve adequações fiscais, integrações, relatórios, componentes técnicos e customizações construídas ao longo dos anos.

Uma atualização bem planejada começa pelo entendimento das mudanças e de seus efeitos sobre a operação. Emitir uma nota, compensar um título ou realizar o fechamento mensal do estoque são processos que precisam continuar funcionando, com resultados consistentes, depois da migração.

Neste artigo, você encontra as principais frentes de análise da versão e os cuidados para preparar o ambiente. Os exemplos são ilustrativos, baseados em situações operacionais e funcionalidades documentadas; não representam casos de clientes da BOA Digital.


Quando o Protheus 12.1.2610 foi lançado e o que muda no ciclo de vida?

A 12.1.2610 segue a nomenclatura 12.1.aamm adotada pela TOTVS: “26” indica o ano e “10”, o mês de expedição, outubro de 2026. Para registrar o dia exato de disponibilização, consulte a página oficial da versão e a Central de Downloads. A data de outra linha TOTVS, mesmo com numeração semelhante, não confirma o lançamento do Protheus.

O acompanhamento do ciclo de vida também deve fazer parte do planejamento. A TOTVS disponibiliza um calendário com datas de liberação e expiração, além das políticas de validade das versões. Essas informações orientam a decisão sobre quando atualizar e quais condições de manutenção se aplicam ao ambiente. [1]

Na prática, uma empresa precisa verificar sua release atual, os pacotes instalados e a cobertura contratada. A documentação da NF-e, por exemplo, apresenta pacotes para a 12.1.2610 e para outras versões, mas identifica a necessidade de garantia estendida em determinados releases. [2]

Portanto, a análise deve considerar a versão efetivamente utilizada e o calendário vigente, sem presumir que qualquer ambiente continuará recebendo as mesmas atualizações.


Entregas da Reforma Tributária: o que avaliar no ambiente

A Reforma Tributária exige uma avaliação integrada entre Fiscal, Financeiro, Faturamento e TI. A disponibilidade de uma funcionalidade não significa que ela esteja parametrizada ou que todos os cenários da empresa estejam contemplados.

Também é necessário separar as novidades exclusivas da release das adequações distribuídas anteriormente por pacotes. Essa distinção evita atribuir à 12.1.2610 recursos que já podiam ser utilizados em outras versões.


Faturamento de encargos e antecipações de IBS e CBS

A rotina FINA708 centraliza movimentos para geração de notas de débito relacionadas a juros, multas e antecipações. Segundo a TOTVS, os encargos são identificados na baixa dos títulos; nas antecipações, o recebimento antecipado precisa estar vinculado ao pedido de venda. A documentação indica disponibilidade na 12.1.2410 e superiores, observadas as atualizações necessárias. [3]

Imagine um cliente que paga uma venda atrasada, com juros. O teste deve acompanhar a baixa, o movimento disponibilizado na FINA708 e a geração da nota correspondente. Já em uma antecipação, deve conferir o vínculo entre recebimento e pedido.

Há uma limitação importante: o documento consultado informa que a primeira versão não contempla juros e multas originados pelo processo de liquidação (FINA460), que antecipa a quitação de dívidas pendentes e resulta em novos títulos a receber. O consultor deve verificar se pacotes posteriores alteraram esse escopo. [3]


Otimizador de perfis tributários e Configurador de Tributos

O Configurador de Tributos, identificado pela rotina FISA170, é o módulo central responsável por parametrizar e calcular regras fiscais, retenções financeiras e os novos tributos da Reforma Tributária (IBS, CBS e Imposto Seletivo). Por isso, exige atenção à qualidade dos cadastros. A orientação oficial informa que os novos tributos IBS e CBS não devem ser configurados pela TES tradicional. [4]

O Otimizador de Perfis Tributários é um facilitador para cadastrar e manter os perfis de produtos e de participantes usados nas regras do Configurador. Antes de adotá-lo, confirme a disponibilidade no pacote utilizado, as rotinas de cadastro compatíveis e os critérios de associação.

Considere uma distribuidora com muitos produtos. Automatizar o agrupamento fiscal só será útil se os atributos utilizados estiverem corretos. Um cadastro classificado incorretamente pode propagar uma associação inadequada. A homologação deve conferir quais registros entram em cada perfil e quais regras serão aplicadas.

A página de destaques também inclui o Indicador da Operação (IndOp) de IBS e CBS no Configurador, relevante para prestadores de serviço que emitem NFS-e, e o evento 211130, que comunica ao Fisco a incorporação ao ativo imobilizado de um bem adquirido por NF-e.


Códigos de tributos da DeRE e crédito presumido

A rotina CTBA028 mantém códigos de tributos da DeRE. A TOTVS também documenta o vínculo desses códigos com o plano de contas pela CTBA020 e orienta acessar a CTBA028 antes da amarração, para carregar os registros de referência. O procedimento se aplica às empresas enquadradas no regime correspondente. [5]

Para os cenários de crédito presumido de IBS e CBS previstos no escopo fiscal, a avaliação precisa começar pelo enquadramento da operação. Confirmar que existe um campo ou recurso no ERP não comprova o direito ao crédito.

A equipe fiscal deve definir o tratamento aplicável, enquanto a equipe técnica valida sua representação no sistema. Os testes precisam comparar documento, cálculo e escrituração, conforme a documentação vigente da funcionalidade.


Novidades no fiscal e no contábil: ECF e EFD Contribuições

As obrigações acessórias merecem uma frente específica de homologação. Um documento emitido corretamente não garante, por si só, que a geração dos arquivos fiscais e contábeis esteja adequada.

Na ECF, a TOTVS publicou orientação para atualização do Protheus ao leiaute 12, referente ao ano-calendário 2025, com recomendação de aplicação inicial em homologação. Os pacotes da ECF 2026 também foram liberados para as releases 12.1.2310, 12.1.2410 e 12.1.2510. Por isso, o leiaute da ECF 2026 não deve ser tratado como uma novidade exclusiva da 12.1.2610. [6]

Na EFD Contribuições, há procedimentos para os tributos genéricos relacionados à LC 224/2025 e à NT 012/2026. A orientação envolve o Configurador de Tributos e o facilitador de lançamentos, incluindo condições para gerar os registros de ajuste M220 e M620. [7]

Um teste representativo acompanha a operação desde o documento de origem até a apuração e o arquivo gerado. Também compara os resultados com a conferência do fiscal, em vez de considerar suficiente a conclusão da rotina sem mensagens de erro.


Financeiro: novas integrações e duplicata escritural

A avaliação das integrações financeiras deve considerar o fluxo completo entre o ERP e os serviços conectados. Entre as integrações do ERP Finance apresentadas nos destaques da release estão boleto híbrido, antecipação de recebíveis, prorrogação de pagamentos, capital de giro e duplicata escritural. Cada recurso precisa ter disponibilidade, contratação e requisitos técnicos confirmados para o ambiente.

A duplicata escritural é um tema relevante nesse contexto. O Banco Central a define como a versão digital da duplicata, emitida e registrada em sistemas eletrônicos autorizados, com rastreabilidade e controle da titularidade do crédito. [8]

Em uma venda a prazo, por exemplo, a conferência deve acompanhar o título, sua situação e o beneficiário correto do pagamento. Eventuais integrações precisam preservar essas informações ao longo do processo.

Antes de apresentar qualquer serviço financeiro como automaticamente habilitado pela atualização, confirme sua oferta para o Protheus, as condições comerciais e o procedimento de ativação. A troca da release, isoladamente, não comprova a contratação de uma solução.


Pontos de atenção mandatórios: o que pode afetar customizações

Customizações demandam uma avaliação específica e individualizada. O funcionamento correto do produto padrão não comprova que relatórios particulares, consultas SQL, integrações e funções de usuário continuarão compatíveis.

A página de pontos de atenção mandatórios deve orientar essa revisão. Os itens abaixo são frentes de verificação técnica: os pontos de entrada efetivamente afetados precisam ser confirmados nos canais oficiais de documentação, tutoriais e base de conhecimento da TOTVS, como o TDN, e confrontados com os fontes do cliente. [9]


Mudanças nas chaves do financeiro

Comece identificando consultas e programas que montam ou interpretam chaves de documentos pela concatenação de informações. Prefixo, número, parcela e tipo podem estar combinados em regras desenvolvidas há anos.

Segundo os pontos de atenção da release, as rotinas que liam E1_TITPAI e E2_TITPAI passam a usar o FK7_TITPAI como referência. Já as rotinas de compensação que identificavam a origem pelo E5_DOCUMEN passam a usar o FK1_IDCOMP ou o FK2_IDCOMP, conforme a carteira. A TOTVS informa que a mudança não impacta a operação padrão. O risco está em relatórios, integrações, consultas SQL, pontos de entrada e funções de usuário que acessam os campos antigos diretamente.

Um teste útil seleciona compensações e títulos relacionados conhecidos, comparando origem, vínculos e valores antes e depois do upgrade. A substituição de campos não deve ser feita mecanicamente, sem entender sua função.


Stored procedures em Estoque e Custos

Stored procedures executam processamento no banco de dados. Na 12.1.2610, algumas rotinas foram otimizadas para que o próprio sistema faça a instalação automática das procedures de que precisam, descontinuando os trechos equivalentes em AdvPL. Quando isso acontece, é necessário verificar como as customizações participam do novo fluxo.

Na revisão do escopo de Estoque e Custos, confronte a documentação de CALCEST, MATA216, MATA330 e MATA280, além das procedures do Custo em Partes, com os pontos de entrada utilizados pelo cliente. Pontos de entrada que interceptavam o processamento AdvPL podem deixar de ser chamados quando o cálculo passa a rodar no banco. Confirme instalação, permissões e alternativas de extensão previstas para a versão. Nessa análise, considere a combinação entre a release do Protheus, a versão do DBAccess, o banco de dados utilizado, como SQL Server ou Oracle, e o sistema operacional do servidor, como Linux.

Por exemplo, uma indústria que utiliza regras específicas no fechamento precisa comparar quantidades, valorização e resultados do custo. Encerrar o processamento sem erro não basta para demonstrar que a regra customizada foi executada.


Browse Smart X e pontos de entrada descontinuados

A revisão de interfaces deve abranger filtros, colunas, legendas e botões adicionados às listagens. O novo Browse Smart X chega a rotinas de Estoque e Custos, Financeiro, Ativo Fixo e Contabilidade Gerencial. Para essas rotinas, consulte a relação oficial de pontos de entrada preservados ou descontinuados em cada módulo.

Imagine uma tela que recebe um filtro customizado para destacar pedidos de uma unidade. Após a atualização, o teste deve reproduzir esse uso, com o perfil de acesso correspondente, e conferir o resultado esperado.

A homologação precisa avaliar tanto a apresentação quanto as ações disponíveis. Mudanças de interface podem exigir adaptação mesmo quando a regra funcional padrão permanece adequada.


TSS: usuários no banco de dados e cuidados com a migração

O TSS merece planejamento próprio, pois participa da operação com documentos eletrônicos. Sua atualização deve considerar credenciais, permissões e acesso às ferramentas administrativas.

Historicamente, o TSS mantinha dois cadastros de usuários em arquivos locais: um para ferramentas como VSCode e APSDU e outro para as rotinas TSSInterface, TSSMonitor e TSSManager. A centralização e a migração dessas credenciais para o banco de dados (tabela SYS_USR) foram introduzidas pela TOTVS na release 12.1.2510. A consolidação desse modelo e o detalhamento técnico completo estão associados ao ciclo da 12.1.2610 e ao documento de referência TSS0077. [10]

A mudança traz duas rotinas novas para o administrador: Gerenciar Usuários, para incluir, alterar e excluir usuários, e Vincular CNPJ, para definir quais CNPJs cada usuário enxerga. Apenas o Administrador mantém acesso à APSDU. Em uma instalação nova do TSS na 12.1.2610, o usuário Admin é criado sem senha, que deve ser definida logo na primeira configuração.

Em uma empresa com várias filiais, o teste deve verificar se cada usuário acessa as entidades necessárias e se os administradores mantêm as permissões previstas. Também deve validar monitoramento e tratamento de documentos após a migração.

O número da release do ERP, sozinho, não descreve a situação do componente. Registre a versão efetiva do TSS e siga o procedimento correspondente.


Relatórios bloqueados e migração para o Smart View

Relatórios fazem parte da rotina operacional e precisam entrar no inventário do upgrade. O levantamento deve identificar quais saídas são utilizadas, por quem, com quais filtros e para qual decisão.

Dois avisos da TOTVS se cruzam com a 12.1.2610. O primeiro trata dos relatórios do Backoffice brasileiro: descontinuados a partir da 12.1.2410, eles tiveram bloqueio definitivo de uso na 12.1.2510 e superiores em 01/07/2026. A lista abrange Ativo Fixo, Financeiro, Estoque, Compras, Faturamento e Contabilidade. [11]

O segundo é específico do Mercado Internacional: 45 rotinas de relatório usadas nas localizações da Argentina, Colômbia, México e Paraguai foram descontinuadas em 30 de outubro de 2026 e não estarão mais disponíveis a partir da 12.1.2610. [12] Nos dois casos, a TOTVS orienta a migração para o Smart View.

Para cada relatório afetado no ambiente, defina o substituto e compare informações, totalizadores e critérios de seleção. Um relatório de posição financeira, por exemplo, precisa manter a utilidade para a conciliação realizada pela equipe.

A validação deve acontecer antes da entrada em produção. A existência de uma alternativa técnica não comprova que ela já atende ao processo utilizado pela empresa.


Outras mudanças que merecem atenção

Alguns itens dos pontos de atenção e dos destaques da release também podem afetar rotinas e procedimentos já estabelecidos:

  • Novo extrator do TAF: a integração de documentos e movimentos financeiros com o SIGATAF passa a usar um mecanismo automático, que substitui o modelo baseado em EXTFISXTAF e FINA989. Agendamentos que disparam o extrator antigo precisam ser revistos.
  • Bloqueio de inventário: o agendamento do bloqueio automático de produtos passa a ser configurado na própria rotina de Inventário (MATA270), e não mais no Configurador.
  • Campo F4_CRDEST: a partir da 12.1.2610, o conteúdo do campo passa a ser ignorado. TES que dependiam dele precisam ser avaliadas.
  • Nova Home: a tela inicial do Protheus foi modernizada, o que pode exigir orientação aos usuários e revisão de materiais de treinamento.

Pré-requisitos de infraestrutura: License Server, DBAccess, AppServer e LIB

Os componentes técnicos precisam formar um conjunto compatível. A equipe deve registrar as versões atuais e confrontá-las com os pré-requisitos oficiais da 12.1.2610, incluindo atualizações posteriores da documentação.

atualização Protheus 12.1.2610

Outro cuidado documentado é a descontinuação das APIs e bibliotecas C-tree. A TOTVS orienta revisar fontes que utilizem CTREECDX ou CTREETMP e adequar código e configuração conforme as alternativas suportadas. [13]

O procedimento geral de upgrade também prevê cópia fria do ambiente, verificação de duplicidades, atualização dos arquivos e execução do UPDDISTR. [14]

O dimensionamento deve considerar usuários, integrações, agendamentos e volume de processamento. Atender a uma versão mínima de componente não demonstra que a infraestrutura possui capacidade suficiente para os horários de maior utilização.


Como planejar a atualização para o Protheus 12.1.2610

O projeto começa com um diagnóstico do ambiente e termina com a operação acompanhada após a entrada em produção. Entre essas etapas, a homologação deve envolver as pessoas responsáveis pelos processos.

Uma sequência prática é:

  1. Inventariar versões, componentes, módulos, integrações e customizações.
  2. Confrontar o ambiente com a documentação oficial da versão de destino.
  3. Preparar uma cópia para atualização e testes.
  4. Executar cenários fiscais, financeiros, contábeis e de estoque representativos.
  5. Corrigir diferenças e obter a validação das áreas responsáveis.
  6. Definir janela de produção, backups e procedimento de restauração testado.
  7. Acompanhar a operação e os primeiros processamentos relevantes.
 

Essa abordagem permite que o cronograma seja construído com base no ambiente real. Também evita descobrir, durante um fechamento ou emissão, uma dependência que poderia ter sido identificada em homologação.


Atualize seu Protheus com os especialistas da BOA Digital

Cada ambiente Protheus tem processos, integrações e customizações próprios. Entender essas particularidades é essencial para planejar a atualização e aproveitar as funcionalidades disponíveis com mais segurança operacional.

A BOA Digital é especialista em atualização de release Protheus. Fale com um dos nossos especialistas para avaliar seu ambiente e planejar a migração para o Protheus 12.1.2610.


Fontes e referências

Kelly Reis

Kelly Reis

Co-autora  |  Consultora especialista

2025 | Todos os direitos reservados | Política de privacidade