A SE5 acaba na 12.1.2610?
Não. A TOTVS mantém a gravação da SE5 em paralelo às tabelas FK justamente para não quebrar customizações e integrações que ainda leem a tabela diretamente, e informa que não é possível desligar essa gravação. As tabelas FK existem desde o primeiro release do Protheus 12 e são a base oficial do financeiro: a movimentação bancária oficial, por exemplo, é a FK5, e a SE5 é gravada por compatibilidade com o legado.
A confusão vem de um guia de adequação de um segmento específico, o de escritórios de advocacia, que fala em "substituição total" das funcionalidades da SE5 pelas FKs na 12.1.2610. As notas gerais do financeiro e os documentos técnicos de 2026 não trazem data para desligar a SE5. O que eles trazem é outra mudança, mais concreta, que afeta customizações de qualquer empresa.
O que muda de fato: as chaves concatenadas
A partir da 12.1.2610, o Protheus permite aumentar os grupos de campos do número do documento (grupo 018) e da série (grupo 094). Nos testes documentados pela TOTVS, o número foi de 9 para 15 posições e a série de 3 para 5. Campos que guardam chaves montadas pela concatenação de prefixo, número, parcela e tipo deixam de ser confiáveis quando esses tamanhos mudam, e por isso as rotinas padrão pararam de lê-los.
| Campo antigo | O que o padrão usa agora | Para quê |
|---|---|---|
E1_TITPAI, E2_TITPAI | FK7_IDPAI e a classe BillRelated | Ligar títulos filhos (abatimentos e impostos) ao título pai |
E5_DOCUMEN | FK1_IDCOMP e FK2_IDCOMP, e a classe Movements | Achar o título da contrapartida numa compensação |
FK7_CHAVE | Campos quebrados da FK7 (filial, prefixo, número, parcela, tipo, cliente ou fornecedor e loja) | Localizar o título a partir da FK7 |
FK1_DOC, FK2_DOC | Classe Movements | Ler documentos ligados à baixa |
E3_PROCCOM | E3_IDDOC, com o identificador do título | Comissões |
A nota oficial de pontos de atenção da 12.1.2610 chama o novo campo de "FK7_TITPAI", mas os documentos técnicos e o dicionário usam FK7_IDPAI, que grava o identificador do título pai nos títulos filhos. A lista oficial de campos com chave concatenada inclui ainda FJU_TITPAI, FK5_DOC, AKD_CHAVE, AC9_CODENT e CT2_KEY.
Boa parte dessa troca já saiu em pacotes para as releases 12.1.2310, 2410 e 2510, com uma regra de proteção: as rotinas só usam as classes novas se elas existirem no RPO. Algumas leituras, como as da FINA090, FINA110, FINA290, FINA340 e FINA460, só passam a valer na 12.1.2610.
As 11 tabelas FK
| Tabela | O que guarda |
|---|---|
| FK1 | Baixas a receber |
| FK2 | Baixas a pagar |
| FK3 | Impostos calculados |
| FK4 | Impostos retidos |
| FK5 | Movimentos bancários |
| FK6 | Valores acessórios (juros, multas, descontos, acréscimos) |
| FK7 | Tabela auxiliar que liga os títulos da SE1 e da SE2 às demais FKs, com o identificador único do título (FK7_IDDOC) |
| FK8 | Dados contábeis complementares da FK5 |
| FK9 | Complemento da FK5 com dados de módulos que integram ao financeiro |
| FKA | Rastreio entre baixas, movimentos bancários, cheques e estornos |
| FKB | Tipos de movimento, de uso interno |
Duas diferenças de comportamento pesam em relatórios e integrações. As FKs não têm exclusão: um movimento desfeito gera um registro de estorno. Na SE5, a exclusão apaga o registro ou o marca como cancelado. E nem todo campo da SE5 tem equivalente nas FKs, o que exige cuidado em qualquer de/para montado por conta própria.
Rotinas padrão já adequadas
A TOTVS publicou documentos técnicos trocando as leituras antigas em rotinas como a baixa a receber e a pagar (FINA070 e FINA080), a compensação (FINA330 e FINA340), o borderô, as faturas, a DIRF, o LCDPR, o SPED PIS/COFINS, relatórios e consultas do financeiro, a mensagem única e a contabilização off-line (CTBAFIN), que passou a usar a classe Movements. A conciliação bancária antiga (FINA380 e FINA473) já foi bloqueada e substituída pelo Conciliador, baseado nas FKs.
O padrão se adapta sozinho quando o pacote e a release estão aplicados. O que não se adapta sozinho é o que foi construído em volta dele.
O que costuma quebrar nas customizações
- Relatórios customizados que leem o E5_DOCUMEN para achar a compensação ou o TITPAI para somar abatimentos e impostos de um título.
- Consultas SQL e extrações de BI que cruzam SE1, SE2 e SE5 pela chave concatenada ou que tratam a SE5 como se fosse só movimento bancário. A SE5 também grava juros, multas, descontos e correção.
- Integrações com bancos, conciliação, tesouraria e sistemas externos que leem a SE5 e não tratam estornos, que nas FKs viram registros próprios.
- Customizações que gravam a SE5 diretamente. A orientação da TOTVS é que elas gravem também nas FKs; quem usa as rotinas padrão por execução automática precisa ao menos validar o resultado.
- Pontos de entrada do financeiro que manipulam a SE5. A TOTVS indica os modelos MVC das baixas para esse tipo de ajuste.
Como levantar o impacto antes do upgrade
- Procure nos fontes customizados as referências a E1_TITPAI, E2_TITPAI, E5_DOCUMEN, FK7_CHAVE, FK1_DOC e FK2_DOC e as gravações diretas na SE5.
- Liste relatórios, consultas e integrações que cruzam títulos e baixas por essas chaves, inclusive as que rodam fora do Protheus.
- Troque as leituras antigas pelas classes Movements e BillRelated ou pelos campos FK7_IDPAI, FK1_IDCOMP e FK2_IDCOMP.
- Ajuste a base legada com as rotinas de correção indicadas pela TOTVS para o vínculo pai e filho antes de depender dele.
- Decida se a empresa vai aumentar o tamanho do número e da série. A TOTVS não recomenda fazer isso em base em produção sem manutenção de base.
- Homologue compensações, estornos, abatimentos, impostos retidos, contabilização e conciliação com dados reais antes da janela de produção.
O método para conduzir a virada com homologação e plano de retorno está em atualização de release Protheus com homologação, e o panorama da versão, em o que muda na 12.1.2610.
Em resumo
- A SE5 continua gravada na 12.1.2610, como espelho das tabelas FK.
- O padrão deixa de ler E1_TITPAI, E2_TITPAI, E5_DOCUMEN e FK7_CHAVE e passa a usar FK7_IDPAI, FK1_IDCOMP e FK2_IDCOMP.
- A razão é a possibilidade de aumentar o número e a série dos documentos a partir da 2610.
- Relatórios, integrações, consultas SQL e pontos de entrada que usam as chaves antigas precisam de revisão.
Próximo passo: levantar nos fontes e nas integrações o que depende das chaves antigas antes de marcar a janela do upgrade.
Fontes e referências
- TDN: Protheus 12.1.2610, pontos de atenção mandatórios.
- TDN: reestruturação da tabela SE5 na família de tabelas FKx.
- TDN: perguntas frequentes sobre a SE5 e as tabelas FK.
- TDN: campos com chave concatenada e aumento de grupos de campos.
- TDN: criação do campo FK7_IDPAI.
- TDN: classe Movements para compensações.
- TDN: classe BillRelated para títulos relacionados.
- TDN: grupos de campos de número e série na 12.1.2610.
- Central TOTVS: gravação da SE5 mantida em paralelo às FKs.
Perguntas frequentes
Principais dúvidas sobre o tema
A SE5 deixa de existir na 12.1.2610?
Não. A TOTVS mantém a gravação da SE5 em paralelo às tabelas FK e informa que não é possível desligá-la. O que muda é que as rotinas padrão deixam de ler campos com chave concatenada.
O que substitui o E5_DOCUMEN?
Os campos FK1_IDCOMP e FK2_IDCOMP, que guardam o identificador do título da contrapartida na compensação, e a classe Movements, que devolve essa informação para as rotinas e customizações.
O que substitui o E1_TITPAI e o E2_TITPAI?
O campo FK7_IDPAI, que grava o identificador do título pai nos títulos filhos, e a classe BillRelated, que consulta títulos relacionados.
Preciso ajustar customizações que gravam na SE5?
Sim. A orientação da TOTVS é que customizações que gravam a SE5 também gravem nas tabelas FK, e que as novas customizações usem as FKs.
Por que a TOTVS está mudando essas chaves agora?
Porque a partir da 12.1.2610 é possível aumentar o tamanho do número e da série dos documentos, e chaves montadas por concatenação deixam de ser confiáveis quando esses tamanhos mudam.
Nota: este conteúdo tem finalidade informativa. Questões contratuais, tributárias ou jurídicas devem ser validadas com os responsáveis da sua empresa.