Data de publicação: 23/04/2026
🎯 Objetivo
Orientar como realizar a atualização da ECD 2026 (leiaute 9) no Protheus 12, com base no pacote CTBS001, destacando os artefatos necessários, a preparação das pastas e os passos técnicos indispensáveis para atualização do ambiente. (Central de Atendimento TOTVS)
🧩 Ambiente
Cross Segmento – Backoffice Linha Protheus – Contabilidade Gerencial (SIGACTB / CTBS001)
Aplicável a partir da versão 12. (Central de Atendimento TOTVS)
🔎 Visão geral
Para a entrega da ECD em 2026, a TOTVS informa que haverá atualização do manual, porém sem impacto para quem já realizou ou está preparando a escrituração do ano-calendário 2025, mantendo-se o uso do leiaute 9, adotado nas entregas a partir de 2021. Em termos práticos, isso significa que, estando o ambiente com as últimas atualizações do portal, ele já estará preparado para gerar o arquivo da ECD dentro desse leiaute. (Central de Atendimento TOTVS)
A orientação oficial também reforça que a atualização não se resume a um único pacote: ela envolve atualização do ambiente, download dos artefatos do pacote backoffice, criação da estrutura correta na pasta System, aplicação das procedures e execução do UPDDISTR. A ausência dessas etapas pode provocar erros no processo. (Central de Atendimento TOTVS)
📦 Pacotes e componentes envolvidos
Antes de iniciar o procedimento, a TOTVS recomenda manter o ambiente com as últimas liberações disponíveis no portal, incluindo os componentes de atualização da linha contábil e da infraestrutura do Protheus, como:
pacote acumulado de Contabilidade;
Pacote LIB;
Pacote DBAccess;
binário do AppServer;
binário do SmartClient. (Central de Atendimento TOTVS)
Esse conjunto é importante porque a geração da ECD depende não apenas dos arquivos específicos do leiaute, mas também da consistência do ambiente como um todo.
⚙️ Como realizar a atualização
1. Atualizar o ambiente com as últimas liberações
O primeiro passo é garantir que o Protheus esteja atualizado com as liberações mais recentes disponíveis no portal. A recomendação oficial é seguir o procedimento de atualização básica do Protheus 12 antes de avançar para os artefatos específicos da ECD. (Central de Atendimento TOTVS)
2. Baixar os artefatos do pacote backoffice
Depois da atualização base, deve-se baixar os artefatos de atualização disponíveis no pacote backoffice de expedição contínua. Segundo a TOTVS, esse pacote contém o Config.ZIP, que centraliza os arquivos necessários para a preparação do leiaute. (Central de Atendimento TOTVS)
3. Criar a pasta do leiaute dentro da System
Dentro da pasta System, deve ser criada a pasta leiaute9. Essa estrutura é obrigatória para receber os arquivos XML usados pelo processo de geração do arquivo texto da ECD. (Central de Atendimento TOTVS)
4. Baixar e descompactar os arquivos XML
Após criar a pasta leiaute9, os arquivos XML devem ser baixados e descompactados nessa pasta. Esse passo prepara o ambiente com os arquivos estruturais utilizados na geração da ECD no leiaute correspondente. (Central de Atendimento TOTVS)
5. Aplicar as procedures de atualização de saldos
Também é necessário aplicar as procedures responsáveis pela atualização de saldos, citando a própria documentação como exemplo a p12_01.sps. Essa etapa é indispensável para que a base esteja alinhada aos critérios exigidos pelo processo contábil da ECD. (Central de Atendimento TOTVS)
6. Desconsiderar arquivos internos que não precisam de cópia
A TOTVS destaca que os arquivos ECD.CH e ECF.CH são de uso interno do sistema e não precisam ser copiados para o ambiente. Esse ponto evita retrabalho e cópias desnecessárias durante a preparação do pacote. (Central de Atendimento TOTVS)
7. Copiar arquivos para a pasta Systemload
Na sequência, devem ser copiados para a pasta Systemload os seguintes arquivos:
hlpdfeng.txt
hlpdfpor.txt
hlpdfspa.txt
sdfbra.txt (Central de Atendimento TOTVS)
Se esses arquivos já existirem na pasta, a orientação é excluir a versão anterior e copiar a nova versão. (Central de Atendimento TOTVS)
8. Executar o UPDDISTR
Após a cópia dos arquivos para a Systemload, é necessário executar o UPDDISTR no ambiente. Essa é a etapa final do processo técnico de atualização informado pela TOTVS. (Central de Atendimento TOTVS)
⚠️ Atenção
A documentação oficial alerta de forma expressa que a não atualização do ambiente conforme os procedimentos descritos acarretará erros na execução do processo. Por isso, não é recomendável pular etapas, especialmente as relacionadas à atualização dos binários, procedures e carga via UPDDISTR. (Central de Atendimento TOTVS)
✅ Resultado esperado
Ao final do procedimento, o ambiente Protheus estará preparado para a geração da ECD 2026 no leiaute 9, sem impacto para as entregas relativas ao ano-calendário 2025 e com a estrutura técnica adequada para processamento da escrituração contábil digital. (Central de Atendimento TOTVS)
💡 Boas práticas
atualizar primeiro o ambiente base antes de aplicar os artefatos específicos da ECD;
validar a existência correta da pasta System\leiaute9 antes de descompactar os XMLs;
revisar cuidadosamente a aplicação das procedures de saldo;
substituir os arquivos da Systemload quando já existirem versões antigas;
executar o UPDDISTR somente após concluir toda a preparação anterior;
realizar testes de geração antes do fechamento definitivo da entrega. (Central de Atendimento TOTVS)
❓ FAQ
1. A ECD 2026 muda o leiaute utilizado no Protheus?
Não. A orientação informa que haverá atualização do manual, mas sem impacto para quem já gera ou prepara a entrega no leiaute 9, adotado desde 2021. (Central de Atendimento TOTVS)
2. Preciso atualizar somente o CTBS001?
Não. A TOTVS recomenda manter o ambiente com as últimas atualizações, incluindo pacote de Contabilidade, LIB, DBAccess, AppServer e SmartClient. (Central de Atendimento TOTVS)
3. Onde devo descompactar os arquivos XML?
Na pasta leiaute9, criada dentro da pasta System. (Central de Atendimento TOTVS)
4. Quais arquivos devem ser copiados para a Systemload?
Devem ser copiados os arquivos hlpdfeng.txt, hlpdfpor.txt, hlpdfspa.txt e sdfbra.txt. (Central de Atendimento TOTVS)
5. Os arquivos ECD.CH e ECF.CH precisam ser copiados?
Não. A TOTVS informa que esses arquivos são de uso interno do sistema e não precisam ser copiados para o ambiente. (Central de Atendimento TOTVS)
6. Qual etapa finaliza a atualização?
A execução do UPDDISTR no ambiente, após toda a preparação anterior. (Central de Atendimento TOTVS)
👤 Autor
Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria
“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”