TOTVS Protheus 12.1.2610: pontos de atenção obrigatórios antes de atualizar o ERP

A TOTVS publicou a documentação dos pontos de atenção mandatórios para a Release 12.1.2610 do Protheus. O material apresenta mudanças importantes em rotinas de Estoque e Custos, Financeiro e na experiência de utilização de diversas funcionalidades do ERP.

Para as equipes de Tecnologia da Informação, desenvolvimento ADVPL e sustentação, o documento merece atenção especial: algumas mudanças preservam o funcionamento padrão do sistema, mas podem exigir ajustes em customizações, integrações, consultas SQL e pontos de entrada utilizados pelas empresas.

Neste artigo, reunimos os principais destaques da documentação oficial e apresentamos recomendações para preparar o ambiente antes da atualização.

1. Estoque: novo agendamento para bloqueio de inventário

Uma das mudanças está relacionada ao bloqueio automático de produtos durante períodos de inventário.

Na Release 12.1.2610, a configuração do agendamento passa a ser realizada diretamente na rotina de Inventário, identificada pelo código MATA270, simplificando o processo e reduzindo a dependência de configurações complexas no módulo Configurador (SIGACFG).

A mudança proporciona maior autonomia operacional para os usuários e facilita a administração dos períodos de inventário.

O que a equipe deve validar?

• Revisar os procedimentos atuais de bloqueio de produtos.
• Validar a configuração do Schedule na rotina MATA270.
• Testar o comportamento dos bloqueios durante o inventário.
• Confirmar se os processos operacionais continuam funcionando conforme as regras da empresa.

2. Bloqueio automático de lotes vencidos

Outro destaque é a modernização do processo de bloqueio de lotes vencidos.

A identificação dos lotes passa a ser executada por meio de um Job agendado no Schedule, utilizando a data de validade como referência.

Com isso, o processo deixa de depender de uma sessão de usuário ativa para realizar o bloqueio, aumentando a confiabilidade da automação.

Para empresas que trabalham com controle de validade, rastreabilidade e movimentação de produtos por lote, essa mudança merece atenção durante a homologação.

Recomendação: teste o processamento dos lotes vencidos e valide se as movimentações que devem ser impedidas estão sendo tratadas corretamente.

3. Browser Smart X: mudanças visuais e pontos de entrada

A Release 2610 amplia a utilização do Browser Smart X em diversas rotinas dos módulos de Estoque e Custos.

A evolução moderniza as telas iniciais de listagem e a apresentação dos dados, mantendo, conforme a documentação, as regras originais de inclusão, edição e exclusão.

Apesar da preservação das regras funcionais padrão, existe um ponto importante para as equipes técnicas: a documentação indica que há pontos de entrada descontinuados associados às rotinas que receberam a atualização visual.

Esse aspecto exige uma análise prévia dos fontes customizados.

O que verificar nas customizações ADVPL?

• Identificar os pontos de entrada utilizados nas rotinas afetadas.
• Comparar a lista de pontos de entrada existentes com a documentação da nova versão.
• Avaliar as customizações que modificam telas, listagens ou comportamentos de interface.
• Adaptar os fontes quando necessário.
• Executar testes de regressão após a atualização.

A documentação oficial contém a relação das rotinas atualizadas e os detalhes das modificações visuais. Portanto, a análise deve ser feita sobre as funcionalidades efetivamente utilizadas em cada ambiente.

4. Stored Procedures: instalação automática em rotinas de estoque e custos

Uma das mudanças técnicas mais relevantes da Release 12.1.2610 é a instalação automática de determinadas Stored Procedures necessárias à execução de rotinas do sistema.

A TOTVS informa que a mudança unifica o processamento de operações com alto volume de dados e descontinua os trechos correspondentes anteriormente implementados em ADVPL.

Entre os processos impactados estão:

A instalação automática simplifica a manutenção dessas estruturas. Entretanto, a mudança exige atenção em ambientes que possuem customizações relacionadas aos processamentos impactados.

Pontos de validação:

• Executar os processos de estoque e custos em homologação.
• Verificar se as Stored Procedures necessárias são instaladas corretamente.
• Avaliar customizações que reproduzam ou complementem a lógica anterior.
• Comparar os resultados dos processamentos com os resultados esperados.
• Testar operações com volumes representativos da produção.

A atualização deve ser acompanhada de testes funcionais e técnicos, principalmente nos processos de recálculo de custos e fechamento de estoque.

5. Financeiro: mudança na referência do campo de título pai

A documentação também apresenta uma alteração estrutural nas rotinas financeiras que anteriormente realizavam leitura dos campos E1_TITPAI e E2_TITPAI.

A partir da nova release, diversas rotinas passam a utilizar o campo FK7_TITPAI como referência.

Segundo a TOTVS, a mudança não afeta a operação padrão do ERP. O objetivo é preparar a arquitetura para futuras expansões nos tamanhos dos campos de número e série dos documentos fiscais.

O ponto de atenção está nos desenvolvimentos específicos de cada cliente.

Impactos potenciais

Empresas que utilizam consultas SQL próprias, integrações ou pontos de entrada com acesso direto aos campos anteriores devem avaliar a necessidade de adequação.

A revisão deve incluir:

• Consultas SQL que utilizam E1_TITPAI ou E2_TITPAI.
• Relatórios financeiros customizados.
• Integrações com sistemas externos.
• Fontes ADVPL que acessam diretamente essas informações.
• Rotinas de conciliação e rastreabilidade relacionadas aos títulos.

A recomendação é identificar as dependências existentes antes da migração e validar a consistência das informações financeiras após os ajustes.

6. Compensações financeiras: mudança na identificação da origem

Outra alteração relevante envolve as rotinas de compensação financeira que anteriormente utilizavam o campo E5_DOCUMEN para identificar a origem das compensações.

Na Release 12.1.2610, essa identificação passa a utilizar os campos FK1_IDCOMP ou FK2_IDCOMP, conforme a carteira envolvida no processo.

A alteração também faz parte da evolução estrutural do modelo de dados e, de acordo com a documentação, ocorre de forma transparente para as operações padrão do Protheus.

Entretanto, empresas que mantêm relatórios, integrações ou consultas específicas sobre compensações financeiras precisam verificar se utilizam diretamente o campo anterior.

Checklist técnico para o Financeiro

• Mapear consultas que utilizam E5_DOCUMEN.
• Revisar relatórios de compensação e rastreabilidade.
• Avaliar integrações que identificam a origem das compensações.
• Verificar as customizações associadas às carteiras financeiras.
• Testar os processos de compensação em ambiente de homologação.

O objetivo é preservar a rastreabilidade das operações e evitar inconsistências nos relatórios e sistemas integrados.

7. Nova Visão baseada em Frame: quais rotinas são impactadas?

A documentação também apresenta uma extensa relação de rotinas que podem ser utilizadas como Nova Visão disponibilizada por Frame.

A lista contempla funcionalidades de diversos módulos, incluindo:

• SIGAEST: inventário, saldos em estoque, transferências, rastreamento e consultas de produtos.
• SIGAFIN: contas a pagar, contas a receber, compensações, movimentações bancárias e consultas financeiras.
• SIGACOM: fornecedores, compradores, central de compras, aprovadores e tabelas de preços.
• SIGAFAT: aprovação de vendas, análise de crédito, pedidos e controle de reservas.
• SIGACTB: plano de contas, centros de custo, lançamentos e visões gerenciais.
• SIGAGPE: funcionários, férias, verbas, afastamentos e demais rotinas de gestão de pessoal.
• SIGAPCP: ordens de produção, estruturas, recursos, operações e processos de planejamento e controle da produção.

A relação completa da TOTVS informa também os códigos das rotinas e os países aos quais cada funcionalidade se aplica.

É importante observar que a listagem de rotinas que podem ser utilizadas como Nova Visão não significa, por si só, que todas precisam ser migradas simultaneamente ou que todas sofreram a mesma alteração técnica.

Antes de planejar qualquer adaptação, identifique quais dessas rotinas são efetivamente utilizadas no ambiente e consulte a documentação específica de cada funcionalidade.