Data de publicação: 23/04/2026

🎯 Objetivo

Orientar como deve ser organizada a pasta do leiaute para geração do arquivo texto (.TXT) na rotina da Central de Escrituração (CTBS001) do Protheus, permitindo o uso de mais de uma versão de leiaute no mesmo repositório. (tdn.totvs.com)

🧩 Ambiente

Linha Microsiga Protheus – Controladoria – Contabilidade Gerencial – CTBS001.
A página técnica consultada no TDN está posicionada dentro da trilha de Protheus 12 > Controladoria > Contabilidade Gerencial > Central de Escrituração > ECD e foi modificada em 31/03/2021. (tdn.totvs.com)

🔎 Visão geral

Conforme a documentação técnica da TOTVS, a partir dessa atualização, para gerar o arquivo texto (.TXT) passou a ser necessária a criação de pastas contendo os arquivos XML referentes ao leiaute que será executado. Essa estrutura permite manter mais de uma versão de leiaute dentro do repositório do ambiente. (tdn.totvs.com)

Na prática, isso significa que o Protheus deixa de trabalhar apenas com um conjunto fixo de XMLs soltos e passa a depender de uma organização por versão de leiaute. Essa separação facilita a convivência entre versões distintas, especialmente em cenários de transição entre obrigações ou atualizações de layout. Essa interpretação decorre diretamente da orientação da TOTVS sobre manter mais de uma versão na mesma estrutura. (tdn.totvs.com)

⚙️ Como funciona a estrutura

A orientação da TOTVS é objetiva: deve ser criada uma pasta com o nome do leiaute a ser executado e, dentro dela, devem ficar todos os arquivos XML referentes aos livros daquele leiaute. (tdn.totvs.com)

O exemplo apresentado pela documentação mostra a pasta System contendo subpastas como:

• leiaute9

• leiaute8 (tdn.totvs.com)

Dentro de cada uma dessas pastas devem ficar os XMLs correspondentes aos livros da ECD, como:

• ecdlivro_a.xml

• ecdlivro_b.xml

• ecdlivro_g.xml

• ecdlivro_r.xml

• ecdlivro_z.xml
  A página exibida no TDN mostra “ecdlivro_z.xm”, mas pelo padrão do conjunto apresentado trata-se do arquivo XML do livro Z. (tdn.totvs.com)

🛠️ Exemplo prático de organização

A estrutura esperada pode ser compreendida da seguinte forma:

System
├── leiaute9
│   ├── ecdlivro_a.xml
│   ├── ecdlivro_b.xml
│   ├── ecdlivro_g.xml
│   ├── ecdlivro_r.xml
│   └── ecdlivro_z.xml
└── leiaute8
    ├── ecdlivro_a.xml
    ├── ecdlivro_b.xml
    ├── ecdlivro_g.xml
    ├── ecdlivro_r.xml
    └── ecdlivro_z.xml

Esse modelo segue exatamente o conceito apresentado no TDN: cada versão de leiaute deve possuir sua própria pasta, contendo o conjunto de XMLs que será utilizado no processamento do arquivo texto. (tdn.totvs.com)

✅ Resultado esperado

Com a estrutura corretamente criada, o ambiente passa a ter os arquivos XML organizados por versão de leiaute, permitindo que a rotina utilize o conjunto adequado para a geração do arquivo texto (.TXT) e viabilizando a coexistência de diferentes versões no mesmo repositório. (tdn.totvs.com)

💡 Boas práticas

• criar a subpasta com o nome exato do leiaute que será utilizado;

• manter dentro dela somente os XMLs correspondentes àquela versão;

• evitar misturar arquivos de leiautes diferentes na mesma pasta;

• revisar a estrutura sempre que houver atualização de leiaute da obrigação;

• validar se todos os XMLs dos livros necessários foram disponibilizados antes da geração.
  Essas recomendações são compatíveis com a lógica estrutural descrita pela TOTVS para separação por leiaute. (tdn.totvs.com)

❓ FAQ

1. Para que serve a pasta do leiaute?

Ela serve para armazenar os arquivos XML referentes ao leiaute que será usado na geração do arquivo texto (.TXT). (tdn.totvs.com)

2. Posso ter mais de um leiaute no mesmo ambiente?

Sim. A documentação informa que essa estrutura foi criada justamente para possibilitar mais de uma versão de leiaute no repositório. (tdn.totvs.com)

3. Onde a pasta deve ser criada?

Na estrutura do ambiente, dentro da pasta System, criando-se uma subpasta com o nome do leiaute, como leiaute8 ou leiaute9. (tdn.totvs.com)

4. Quais arquivos devem ficar dentro da pasta do leiaute?

Os arquivos XML dos livros, como os exemplos mostrados pela TOTVS: ecdlivro_a.xml, ecdlivro_b.xml, ecdlivro_g.xml, ecdlivro_r.xml e ecdlivro_z.xml. (tdn.totvs.com)

5. O que acontece se os XMLs não estiverem organizados por leiaute?

A documentação não detalha a mensagem de erro, mas deixa claro que a geração do arquivo texto passa a depender dessa organização por pasta de leiaute. (tdn.totvs.com)

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

“Conectamos tecnologia, processos e pessoas para acelerar resultados com excelência em sistemas TOTVS.”