Razão Auxiliar
Criado por Igor Ribeiro em 24 de setembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Razão Auxiliar
Módulo Contabilidade > Movimentações — consulta, inclusão, edição, exportação e importação de saldos contábeis apurados por período, segmentados por conta, filial e cadastro (participante).
Visão Geral do Razão Auxiliar
A rotina de Razão Auxiliar — Movimentações, dentro do módulo Contabilidade, permite ao usuário consultar, incluir, editar, exportar e importar os saldos contábeis apurados por período, segmentados por conta do plano de contas, por filial e por cadastro (participante). Cada registro do razão auxiliar representa a posição contábil de um cadastro específico dentro de uma conta em um determinado período, trazendo o saldo anterior, os totais de débito e crédito do período e o saldo atual resultante.
Vídeo Tutorial do Razão Auxiliar
Pré-requisitos e Contexto de Acesso do Razão Auxiliar
Para acessar a tela de Razão Auxiliar — Movimentações, o usuário precisa ter a permissão “ListViewDeSaldoContabilPorCadastro” (ID 1043) atribuída ao seu perfil de acesso. Sem essa permissão, o item de menu “Contabilidade / Movimentações / Razão Auxiliar” não é exibido.
Incluir / Editar
“SaldoContabilPorCadastro/Novo” (ID 1044) e “SaldoContabilPorCadastro/Editar” (ID 1045).
Exportar / Importar
“SaldoContabilPorCadastro/Exportar” (ID 1046) e “SaldoContabilPorCadastro/Importar” (ID 1047).
Processo de Criação — Passo a Passo do Razão Auxiliar
Acessar a rotina
O usuário acessa “Contabilidade / Movimentações / Razão Auxiliar”. O sistema exibe a listagem de registros já cadastrados, com valores iniciais zerados para os campos de saldo até que uma pesquisa ou inclusão seja realizada.
Abrir o formulário de novo registro
O usuário aciona a opção de incluir um novo registro de Saldo Contábil por Cadastro. O sistema apresenta o formulário com os campos de Filial, Plano de Contas, Cadastro, Data do Período, Saldo Anterior, Saldo Débito e Saldo Crédito.
Preencher os dados do saldo
O usuário informa a Filial, o Plano de Contas (conta contábil), o Cadastro (participante), a Data do Período e o valor de Saldo Anterior. Os campos Saldo Débito e Saldo Crédito são opcionais — se não informados, o sistema assume o valor zero.
Confirmar a inclusão
O usuário confirma o salvamento. O sistema verifica, nesta ordem: (1) se o período informado (filial + data) já está encerrado; (2) se não existe período posterior já encerrado para essa filial; (3) se não existe já um registro idêntico (mesma filial, conta, cadastro e período). Se todas as verificações passarem, o sistema calcula o Saldo Atual (Saldo Anterior + Débito − Crédito) e grava o novo registro, exibindo a mensagem “Saldo Contábil Por Cadastro inserida(o) com sucesso.”
Tratamento de bloqueios
Se qualquer uma das verificações do Passo 4 falhar, o sistema não grava o registro e exibe a mensagem de erro correspondente (detalhadas na seção 9 — Regras de Negócio e Restrições).
Descrição de Cada Campo da Tela do Razão Auxiliar
Filial
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: identifica a filial da empresa à qual o saldo contábil pertence.
Comportamento: usado como parte da chave de verificação de duplicidade e de abertura/encerramento do período contábil.
Impacto: usado como filtro na listagem, na exportação e na importação; determina qual controle de período contábil é consultado.
Plano de Contas
Tipo: autocomplete/seleção
Obrigatoriedade: obrigatório
Descrição: conta contábil (código reduzido) do plano de contas à qual o saldo está associado.
Comportamento: ao ser selecionado, o sistema resolve o nome e o código completo da conta para exibição.
Impacto: aparece na listagem como “Código do Plano de Contas” e “Nome do Plano de Contas”; usado nos filtros de consulta e na geração do razão auxiliar.
Cadastro
Tipo: autocomplete/seleção
Obrigatoriedade: obrigatório
Descrição: identifica o cadastro geral (participante — cliente, fornecedor, ou outro tipo de cadastro) ao qual o saldo pertence dentro da conta contábil.
Comportamento: ao ser selecionado, o sistema resolve o nome do cadastro para exibição na listagem.
Impacto: usado como filtro de “participante” na listagem e como parte da chave de verificação de duplicidade.
Data do Período
Tipo: data
Obrigatoriedade: obrigatório
Descrição: data de referência do período de apuração ao qual o saldo se refere.
Comportamento: usada para verificar se o período contábil da filial está aberto ou encerrado antes de permitir a inclusão do registro; também usada nos filtros de data inicial/final da listagem.
Impacto: determina a ordem cronológica dos saldos no razão auxiliar e é usada como filtro de intervalo na consulta.
Saldo Anterior
Tipo: número (decimal)
Obrigatoriedade: obrigatório
Descrição: saldo acumulado antes do início do período informado.
Comportamento: usado no cálculo do Saldo Atual (Saldo Anterior + Débito − Crédito).
Impacto: aparece na listagem e é utilizado como base para o cálculo do Saldo Atual editado.
Saldo Débito
Tipo: número (decimal)
Obrigatoriedade: opcional — se não informado, o sistema assume o valor zero
Descrição: total de lançamentos a débito ocorridos dentro do período.
Comportamento: somado ao Saldo Anterior no cálculo do Saldo Atual.
Impacto: aparece na listagem e no cálculo do saldo final do período.
Saldo Crédito
Tipo: número (decimal)
Obrigatoriedade: opcional — se não informado, o sistema assume o valor zero
Descrição: total de lançamentos a crédito ocorridos dentro do período.
Comportamento: subtraído do Saldo Anterior + Débito no cálculo do Saldo Atual.
Impacto: aparece na listagem e no cálculo do saldo final do período.
Saldo Atual
Tipo: número (decimal), calculado
Obrigatoriedade: não aplicável — campo calculado automaticamente pelo sistema
Descrição: resultado do cálculo Saldo Anterior + Saldo Débito − Saldo Crédito; representa a posição contábil final do cadastro na conta, no período.
Comportamento: recalculado automaticamente pelo sistema a cada inclusão ou edição — o usuário não o digita diretamente.
Impacto: valor final exibido na listagem e usado como referência de saldo acumulado para o próximo período.
Utilização e Consulta de Registros do Razão Auxiliar
O usuário localiza registros de saldo contábil por cadastro na listagem principal da rotina, que oferece: um campo de busca livre, que interpreta automaticamente o texto digitado (data → filtra pela Data do Período; número inteiro → filtra pelo ID do Cadastro ou pelo ID da Filial; qualquer outro texto → busca por Filial, por prefixo do Código da Conta, ou por trecho contido no Nome do Cadastro ou no Nome do Plano de Contas); filtro por Filial (uma ou mais); filtro por Participante/Cadastro (um ou mais); filtro por Plano de Contas (uma ou mais contas); e filtro por intervalo de datas (Data Inicial e Data Final do período).
Os resultados são ordenados, por padrão, por Filial, Plano de Contas e Cadastro (dentro de cada data de período, do mais recente para o mais antigo), podendo o usuário reordenar clicando nas colunas do grid (Filial, Código do Plano de Contas, Nome do Plano de Contas, Cadastro, Nome do Cadastro, Data do Período, Saldo Anterior ou Saldo Atual).
Processo de Edição do Razão Auxiliar
Após localizar um registro na listagem, o usuário pode abri-lo para edição. Os campos de Saldo Anterior, Saldo Débito e Saldo Crédito podem ser alterados; ao salvar, o sistema recalcula automaticamente o Saldo Atual com base nos novos valores informados (Saldo Anterior + Saldo Débito − Saldo Crédito).
A exclusão de um registro de saldo contábil por cadastro não está disponível nesta tela atualmente: a funcionalidade de excluir existe no código, porém está desativada (comentada) tanto na tela quanto na regra de negócio que a suportaria (ver Regra de Negócio 13).
Estrutura Técnica e Comportamento do Sistema do Razão Auxiliar
Os registros desta rotina alimentam a apuração de saldo contábil por participante, servindo de base para relatórios de razão auxiliar (que cruzam esses saldos com as movimentações contábeis lançadas no período) e para a apuração de saldo inicial de contas de Ativo e Passivo segmentadas por cadastro.
A importação em lote (ver seção 9) grava diretamente na tabela de saldos do banco de dados e, antes de inserir os novos dados, executa a exclusão prévia dos registros já existentes para o intervalo de datas do período de apuração e filial selecionados — ou seja, uma nova importação para o mesmo período substitui os dados anteriores daquele período/filial.
Regras de Negócio e Restrições do Razão Auxiliar
Inclusão exige período contábil encerrado
Um novo saldo (via tela de inclusão ou via importação) só pode ser gravado se o período informado (filial + data) já estiver encerrado no controle de período contábil.
Bloqueio quando existe período posterior já encerrado
Mesmo com o período informado encerrado, se já existir um período posterior (para a mesma filial) também encerrado, a inclusão é bloqueada, pois isso indicaria uma inconsistência na sequência de encerramentos.
Bloqueio de registro duplicado na inclusão manual
Ao incluir um novo registro pela tela, se já existir exatamente um registro com a mesma Filial, Plano de Contas, Cadastro e Data do Período, a inclusão é bloqueada.
Cálculo automático do Saldo Atual
Em toda inclusão ou edição, o sistema recalcula o Saldo Atual como Saldo Anterior + Saldo Débito − Saldo Crédito, sem permitir que o usuário o digite diretamente.
Importação de arquivo CSV com layout obrigatório
O arquivo de importação deve conter, nesta ordem de colunas: Código reduzido da conta, Código do Cadastro, Saldo e Módulo. Se algum registro do arquivo não tiver o Módulo (Tipo) preenchido, a importação inteira do arquivo é rejeitada.
Somente arquivos “.csv” são aceitos na importação
Qualquer outro tipo de arquivo enviado é rejeitado antes do processamento.
Regra de sinal do saldo por módulo de origem, na importação
O sistema classifica o valor do saldo importado como débito ou crédito combinando o Módulo informado no arquivo (Receber ou Pagar) com o sinal do valor: Módulo Receber com valor positivo é tratado como Débito, e com valor negativo como Crédito; Módulo Pagar com valor positivo é tratado como Crédito, e com valor negativo como Débito.
Três modos de tratamento de duplicidade na importação
O comportamento da importação diante de registros já existentes depende do modo escolhido (parâmetro “importar”, padrão “1” quando não informado): no modo 1, registros duplicados não são importados e aparecem na lista de itens não importados (“Registro já existe” ou “Informação correta, porém está duplicada” se a duplicidade for dentro do próprio arquivo); no modo 2, registros existentes são atualizados com os novos valores; no modo 3, a verificação de duplicidade é ignorada e o registro é sempre incluído como novo.
Importação exclui previamente os saldos do período antes de reinserir
Antes de processar o arquivo, o sistema apaga da base todos os registros de saldo da filial informada dentro do intervalo de datas correspondente ao período de apuração escolhido (Mensal, Trimestral ou Anual), e só então grava os novos saldos calculados.
Período de apuração deve ser Mensal, Trimestral ou Anual
O campo de período de apuração da importação só aceita os valores “M” (Mensal), “T” (Trimestral) ou “A” (Anual).
Cadastro inexistente interrompe a importação do item
Se o Código do Cadastro informado em uma linha do arquivo não existir na base de Cadastros Gerais, o processamento é interrompido para aquele item.
Falha inesperada durante a importação
Qualquer erro não previsto durante o processamento do arquivo interrompe a importação.
Exclusão de registro não disponível
A opção de excluir um registro de saldo contábil por cadastro não está disponível nesta rotina: embora exista no código-fonte, a funcionalidade está desativada (comentada) tanto no controlador quanto na regra de negócio correspondente.
