Data de publicação: 22/07/2026

🎯 Objetivo

Orientar a configuração e a utilização da rotina CTBA980 – Correção Automática de Saldos, responsável por analisar e corrigir divergências nos saldos contábeis do TOTVS Protheus por meio do Schedule.

A rotina foi desenvolvida para reduzir a necessidade de reprocessamentos manuais recorrentes e contribuir para que os saldos contábeis permaneçam consistentes e atualizados. (Central de Atendimento TOTVS)

🧩 Ambiente

Cross Segmento – TOTVS Backoffice Linha Protheus – Contabilidade Gerencial (SIGACTB)
Rotina: CTBA980
Versão indicada no artigo: 12.1.2410 (Central de Atendimento TOTVS)

🔎 Visão geral

A CTBA980 é uma rotina automatizada de correção de saldos integrada ao Schedule do Protheus.

Depois de configurada, ela executa verificações periódicas nos saldos contábeis do intervalo selecionado. Caso sejam encontradas divergências, a rotina realiza a correção automaticamente, conforme os parâmetros definidos no agendamento. (Central de Atendimento TOTVS)

Na prática, a solução ajuda a:

• identificar divergências entre lançamentos e saldos contábeis;

• reduzir a execução manual de rotinas de reprocessamento;

• manter uma verificação recorrente do período contábil;

• automatizar a correção por empresa, filial, moeda e tipo de saldo.

✅ Requisitos para utilização

Antes de configurar a CTBA980 no Schedule, é importante validar se o ambiente possui os requisitos técnicos necessários.

1. ⚙️ Procedures contábeis

A documentação técnica relacionada à rotina informa a necessidade das seguintes procedures:

• Procedure 01 – Reprocessamento Contábil;

• Procedure 29 – Gravação das inconsistências de saldos na tabela QLJ.

A instalação e a conferência das procedures devem ser realizadas pela rotina de Gestão de Procedures, disponível no módulo Configurador. (TDN)

2. 🗃️ Tabela QLJ

A CTBA980 utiliza a tabela QLJ, vinculada ao projeto de Fechamento Contábil, para registrar informações relacionadas às inconsistências identificadas.

Antes do agendamento, deve-se confirmar se a tabela está disponível no dicionário de dados do ambiente. (TDN)

3. 🧾 Grupo de perguntas CTB980

Também é necessário que o grupo de perguntas:

CTB980

esteja disponível no cadastro SX1.

Esse grupo contém os parâmetros utilizados pelo Schedule para definir o período, a moeda e o tipo de saldo que serão verificados. (TDN)

4. 🐘 Ambientes PostgreSQL

Nos ambientes que utilizam banco de dados PostgreSQL, a documentação técnica orienta conferir:

• a configuração da fonte de dados ODBC;

• a comunicação do DBAccess com o banco;

• a habilitação da chave MemoInQuery no arquivo DBAccess.ini.

Essas configurações são importantes para o correto funcionamento das rotinas relacionadas ao Fechamento Contábil e à análise de inconsistências. (TDN)

🛠️ Como configurar a CTBA980 no Schedule

1. Acessar os agendamentos

Acesse a área de Agendamentos do Schedule no Protheus e inclua uma nova rotina.

No campo correspondente ao programa, informe:

CTBA980

2. Definir a periodicidade

Na configuração da recorrência, selecione:

Sempre ativo

Essa periodicidade mantém o processo disponível para execução automática conforme o funcionamento do Schedule. (Central de Atendimento TOTVS)

3. Selecionar empresas e filiais

Na etapa seguinte, informe para quais:

• empresas;

• unidades;

• filiais;

a rotina deverá ser executada.

A definição deve considerar somente as empresas e filiais que realmente serão submetidas à análise e à correção automática de saldos. (Central de Atendimento TOTVS)

4. Preencher os parâmetros

Na seção de parâmetros, devem ser configurados os critérios utilizados na verificação:

• Período a retroagir?

• Quantidade (Meses/Dias)?

• Moeda específica?

• Moeda?

• Tipo de saldo? (Central de Atendimento TOTVS)

📅 Parâmetros de período

Período a retroagir

Esse parâmetro determina se a retroação será calculada por:

• Meses; ou

• Dias.

O parâmetro deve ser utilizado em conjunto com Quantidade (Meses/Dias). (Central de Atendimento TOTVS)

Quantidade de meses ou dias

Nesse campo, informe quantos meses ou dias deverão ser analisados retroativamente.

A verificação considera sempre como data final o dia anterior à data atual:

Data final = Data atual - 1 dia

Esse comportamento, conhecido como D-1, evita que a rotina concorra com operações realizadas no dia corrente, como inclusões, alterações e exclusões de lançamentos contábeis. (Central de Atendimento TOTVS)

📆 Processamento por meses

Quando o parâmetro estiver configurado como Meses, o sistema retroage a quantidade informada com base no calendário contábil aberto.

A verificação por meses possui as seguintes características:

• considera o ano corrente da data atual;

• limita a análise aos meses existentes no ano corrente;

• divide o processamento por mês quando mais de um mês for informado. (Central de Atendimento TOTVS)

Exemplo

Considerando a data atual:

19/06/2024

O processamento será:

Mesmo que sejam informados 12 meses, a rotina considerará apenas o período disponível no ano corrente. (Central de Atendimento TOTVS)

🗓️ Processamento por dias

Quando o parâmetro estiver configurado como Dias, o sistema calcula a data inicial retroagindo a quantidade informada e utiliza como data final o D-1.

Diferentemente do processamento por meses, a verificação por dias é executada em um único intervalo. (Central de Atendimento TOTVS)

Exemplo

Considerando:

Data atual = 19/06/2024
Quantidade = 15 dias

O intervalo será:

03/06/2024 até 18/06/2024

(Central de Atendimento TOTVS)

⚠️ Recomendação sobre períodos superiores a 30 dias

A TOTVS recomenda não utilizar a opção Dias para intervalos superiores a 30 dias.

Para períodos maiores, deve-se selecionar Meses e informar a quantidade correspondente. Esse modelo permite que o processamento seja dividido mensalmente, favorecendo sua organização e execução. (Central de Atendimento TOTVS)

💱 Parâmetros de moeda

Moeda específica?

Esse parâmetro define se a rotina analisará:

• todas as moedas; ou

• apenas uma moeda específica.

Quando for selecionada a opção Todas, não é necessário preencher o parâmetro seguinte de moeda. (Central de Atendimento TOTVS)

Moeda

Quando a verificação estiver limitada a uma moeda específica, informe nesse parâmetro o código correspondente à moeda que deverá ser considerada no processamento. (Central de Atendimento TOTVS)

📊 Tipo de saldo

O parâmetro Tipo de saldo define qual saldo contábil será analisado e corrigido pela CTBA980.

A escolha deve ser coerente com os saldos utilizados pela empresa, como:

• saldo real;

• previsto;

• gerencial;

• empenhado;

• outros tipos cadastrados no ambiente.

A rotina utilizará o tipo informado para localizar e corrigir as divergências dentro do período definido. (Central de Atendimento TOTVS)

🚀 Execução automática

Depois de concluir o cadastro do agendamento, a CTBA980 ficará disponível para execução no Schedule.

Durante o processamento, o serviço poderá ser acompanhado pelas informações do agendamento e pelos detalhes do AppServer responsável pela execução.

Caso sejam identificadas divergências no período configurado, a rotina realizará a correção automática dos saldos. (Central de Atendimento TOTVS)

🔄 Fluxo de funcionamento

O processo pode ser resumido da seguinte forma:

1. o Schedule inicia a CTBA980;

2. a rotina identifica as empresas e filiais selecionadas;

3. calcula o período conforme a retroação configurada;

4. considera como data final o dia anterior à data atual;

5. analisa a moeda e o tipo de saldo;

6. identifica eventuais divergências;

7. registra as inconsistências conforme a estrutura da rotina;

8. executa o reprocessamento necessário;

9. atualiza os saldos contábeis.

⚠️ Pontos de atenção

Antes de colocar a CTBA980 em funcionamento, valide:

• instalação das procedures 01 e 29;

• existência da tabela QLJ;

• existência do grupo de perguntas CTB980 no SX1;

• empresas e filiais selecionadas;

• período de retroação;

• moeda;

• tipo de saldo;

• configuração do Schedule;

• disponibilidade do serviço responsável pelo agendamento;

• configuração do DBAccess quando utilizado PostgreSQL.

✅ Checklist de configuração

•  Procedures 01 e 29 instaladas;

•  tabela QLJ disponível no dicionário;

•  grupo CTB980 disponível no SX1;

•  ODBC validado, quando utilizado PostgreSQL;

• MemoInQuery configurado, quando aplicável;

•  rotina CTBA980 incluída no Schedule;

•  periodicidade definida como Sempre ativo;

•  empresas e filiais selecionadas;

•  período a retroagir definido;

•  quantidade de meses ou dias informada;

•  moeda configurada;

•  tipo de saldo informado;

•  execução acompanhada no Schedule e no AppServer;

•  resultados conferidos após o primeiro processamento.

✅ Resultado esperado

Após a configuração correta, a CTBA980 passará a verificar automaticamente os saldos contábeis conforme o período, moeda, tipo de saldo, empresas e filiais selecionadas.

Quando forem identificadas divergências, a rotina realizará o tratamento e a correção automática, reduzindo a necessidade de reprocessamentos manuais frequentes. (Central de Atendimento TOTVS)

💡 Boas práticas

• configurar inicialmente a rotina em ambiente de homologação;

• executar a primeira validação com um período reduzido;

• evitar intervalos extensos configurados por dias;

• utilizar o processamento por meses para períodos superiores a 30 dias;

• acompanhar o consumo de recursos do AppServer;

• revisar os registros da QLJ após as primeiras execuções;

• manter as procedures atualizadas;

• documentar empresas, filiais, moedas e tipos de saldo incluídos no Schedule;

• acompanhar os resultados da rotina antes de ampliar o período analisado.

❓ FAQ

1. Para que serve a CTBA980?

A CTBA980 analisa e corrige automaticamente divergências nos saldos contábeis do Protheus, por meio de execução agendada no Schedule. (Central de Atendimento TOTVS)

2. A rotina precisa ser executada manualmente?

Não. Ela foi desenvolvida para trabalhar integrada ao Schedule, permitindo execução automática conforme a configuração realizada. (Central de Atendimento TOTVS)

3. Qual data final é considerada?

A rotina considera sempre o dia anterior à data atual, ou seja, D-1. (Central de Atendimento TOTVS)

4. Por que o dia atual não é considerado?

Para evitar concorrência com inclusões, alterações e exclusões de lançamentos que ainda estejam sendo realizadas no período corrente. (Central de Atendimento TOTVS)

5. Posso configurar 90 dias de retroação?

Tecnicamente o parâmetro permite a configuração por dias, porém a TOTVS recomenda utilizar Meses quando o intervalo ultrapassar 30 dias. (Central de Atendimento TOTVS)

6. A rotina pode analisar todas as moedas?

Sim. O parâmetro Moeda específica? permite selecionar todas as moedas ou limitar o processamento a uma moeda determinada. (Central de Atendimento TOTVS)

7. Quais procedures são necessárias?

A documentação técnica relacionada indica as procedures 01 – Reprocessamento Contábil e 29 – Gravação das inconsistências na QLJ. (TDN)

8. Onde as inconsistências são registradas?

A CTBA980 utiliza a tabela QLJ, vinculada ao projeto de Fechamento Contábil. (TDN)

9. Existe configuração específica para PostgreSQL?

Sim. Deve-se revisar a fonte de dados ODBC e habilitar a chave MemoInQuery no DBAccess.ini, conforme a documentação técnica relacionada. (TDN)

🔗 Referências

• TOTVS — CTBA980: Correção automática de Saldos. (Central de Atendimento TOTVS)

• TOTVS TDN — Correção automática de Saldos (CTBA980). (TDN)

• TOTVS TDN — Saldos Contábeis (CTBA130). (TDN)

👤 Autor

Fabrizio Augusto Ventavolo
Consultor Especialista TOTVS — Mastersiga Consultoria

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