Upgrade no Protheus:
O que muda da versão 24.10 para a 25.10?
A atualização do TOTVS Protheus da versão 24.10 para a 25.10 traz uma série de mudanças relevantes que vão além de uma simples evolução técnica. Essa nova versão reforça o movimento de modernização da plataforma, com foco na substituição de rotinas legadas, evolução das integrações, atualização de ferramentas de relatórios e adequação a novos modelos operacionais, especialmente nas áreas fiscal, financeira e de compras.
Neste material, apresentamos uma visão objetiva dos principais impactos dessa atualização, destacando os pontos que merecem maior atenção por parte das empresas que possuem customizações, integrações externas ou utilizam processos antigos dentro do Protheus. O objetivo é apoiar uma análise preventiva, reduzindo riscos no projeto de upgrade e contribuindo para uma transição mais segura, estruturada e alinhada às novas diretrizes da TOTVS.
A versão 25.10 do Protheus segue a estratégia da TOTVS de modernização da plataforma, com foco em:
- Substituição de rotinas legado
- Modernização da arquitetura tecnológica
- Melhoria em integrações
- Evolução de ferramentas de relatórios
- Padronização de processos fiscais e financeiros
Grande parte das mudanças está relacionada à descontinuação de funcionalidades antigas e introdução de novos modelos operacionais.
I. Principais mudanças funcionais
- Módulo de Compras
As rotinas tradicionais de cotação do módulo de compras estão sendo substituídas pelo Novo Fluxo de Compras (NFC).
Análise da Cotação (MATA161) Cotações (NFCA020)
O Novo Fluxo de Compras oferece:
- Centralização das solicitações de compra
- Melhor controle das cotações
- Histórico de negociações com fornecedores
- Maior automação do processo
- Contabilidade
As rotinas abaixo foram descontinuadas:
- Refaz Saldos (CTBA190)
- Reprocessamento de Saldos (CTB192)
Elas passam a ser substituídas pela rotina:
Fechamento Contábil (CTBA960)
Essa nova rotina consolida o processo de fechamento contábil e validação de saldos.
- Mudanças no modelo de cálculo tributário
A TOTVS está descontinuando o uso de TES (Tipos de Entrada e Saída) no Protheus para cálculos fiscais, devido à Reforma Tributária.
A funcionalidade de TES não some por completo, mas perde funções de cálculo de impostos, focando apenas em logística (estoque/financeiro).
Está sendo substituído pelo Configurador de Tributos, que permite:
- Maior flexibilidade nas regras fiscais
- Manutenção centralizada das legislações
- Atualização mais rápida das regras tributárias
Deve ser realizada a migração fiscal para esse modelo, essencial para evitar riscos fiscais e travamentos.
Documentação:
https://tdn.totvs.com/pages/releaseview.action?pageId=923184811
https://centraldeatendimento.totvs.com/hc/pt-br/articles/34900857950615-CROSS-Segmentos-TOTVS-Backoffice-Linha-Protheus-FIS-FISA170-Campos-da-TES-ir%C3%A1-permanecer-com-a-implanta%C3%A7%C3%A3o-do-Configurador-de-Tributos
- Comunicação bancária – Contas a Receber
Foi descontinuada a Comunicação Bancária Online via API utilizada no módulo de Contas a Receber.
Essa funcionalidade passa a ser substituída pela solução:
Boleto Híbrido – TOTVS Techfin
- Integração com Gesplan
A integração entre o Protheus e o Gesplan – Gestão de Caixa e Tesouraria foi descontinuada e substituída por um novo modelo de integração.
- Impressão de documentos
O componente PDF Printer foi descontinuado e substituído pelo novo:
Printer
- Relatórios
Relatórios baseados em TReport serão gradualmente bloqueados.
A TOTVS recomenda a migração para o SmartView, nova plataforma de relatórios que oferece:
- Interface moderna
- Dashboards analíticos
- Melhor performance
- Maior flexibilidade de exportação de dados
II. Impactos em customizações e desenvolvimentos
A atualização para a versão 25.10 pode exigir ajustes em customizações ADVPL, relatórios personalizados e integrações externas.
- Funções descontinuadas
As seguintes funções deixam de ser suportadas:
- SEmpAnt
- SetFilAnt
A versão 25.10 bloqueia gravações diretas nas variáveis: - cEmpAnt
- __cUserId
Customizações que utilizam essas funções ou manipulam essas variáveis precisam ser revisadas.
- Alteração na gravação de campos financeiros
Alguns dados financeiros passam a ser gravados em novas tabelas do banco de dados.
Exemplo:
- Campo E5_DOCUMEN passa a ser gravado na tabela FK7
Relatórios ou programas que consultam diretamente os campos antigos devem ser adequados.
- Alterações obrigatórias em integrações
•Integrações REST: passa a ser obrigatório utilizar:
❖TenantId
•Integrações SOAP: passa a ser obrigatório utilizar:
❖PrepareIn
Integrações existentes devem ser avaliadas para garantir compatibilidade com a nova versão.
III. Ações recomendadas para o projeto de upgrade
Para garantir uma atualização segura, recomenda-se realizar as seguintes atividades.
- Revisão de customizações ADVPL
Identificar possíveis impactos relacionados a:
- Uso de funções descontinuadas
- Manipulação de variáveis globais
- Leitura de campos financeiros alterados
- Revisão das integrações
Verificar se existem integrações com:
- Gesplan
- API de comunicação bancária do Contas a Receber
- Serviços REST ou SOAP
- Avaliação do uso das rotinas antigas de compras
Identificar se a empresa utiliza:
- MATA131 – Geração de Cotação
- MATA150 – Atualização da Cotação
- MATA160 – Análise da Cotação
- MATA161 – Análise da Cotação
Caso estejam em uso, será necessária a migração para o Novo Fluxo de Compras.
- Adequação ao Configurador de Tributos
Realizar a migração das regras fiscais atualmente configuradas via TES para o Configurador de Tributos. - Implantação do SmartView
Para empresas que ainda não utilizam o SmartView:
- Realizar instalação da ferramenta
❖ Clientes TCloud: será necessário solicitar a instalação via chamado, diretamente com a Totvs
❖ Clientes com servidor próprio: utilizar instalador e seguir instruções disponibilizadas pelo Totvs.
Documentação:
https://centraldeatendimento.totvs.com/hc/pt-br/articles/13311540250007-Cross-Segmentos-Backoffice-RM-BI-Smart-View-Instala%C3%A7%C3%A3o-e-Configura%C3%A7%C3%A3o - Habilitar novos relatórios nos menus
A atualização para a versão 25.10 do Protheus traz avanços importantes na modernização do sistema e na padronização de processos.
A maioria das mudanças não afeta diretamente a operação diária dos usuários. No entanto, é fundamental realizar uma avaliação prévia das customizações, integrações e rotinas legadas, garantindo que todos os ajustes necessários sejam realizados antes da atualização.
Dessa forma, o processo de upgrade pode ser executado de forma segura, minimizando riscos e garantindo continuidade operacional.