Razão Auxiliar – Implantação de Saldo
Criado por Igor Ribeiro em 14 de novembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Razão Auxiliar – Implantação de Saldo
Módulo Contabilidade > Geração Arquivos — identifica títulos de contas a pagar/receber sem conta contábil patrimonial vinculada, corrige essa vinculação (automática ou manual) e exporta o saldo consolidado em CSV para implantação do razão auxiliar contábil.
Visão Geral da Razão Auxiliar – Implantação de Saldo
A rotina “Razão Auxiliar – Implantação de Saldo”, disponível em Contabilidade > Geração Arquivos > Razão Auxiliar – Implantação de saldo, ajuda o usuário a identificar títulos de contas a pagar e a receber que ainda não têm uma conta contábil patrimonial vinculada e a corrigir essa vinculação — automaticamente, quando o sistema encontra uma correspondência confiável no histórico contábil, ou manualmente, quando o usuário precisa decidir qual conta aplicar.
Vídeo Tutorial da Razão Auxiliar – Implantação de Saldo
Pré-requisitos e Contexto de Acesso da Razão Auxiliar – Implantação de Saldo
Para acessar a tela, o usuário precisa ter a permissão “EditViewDeGeracaoDeRazaoAuxiliar” concedida ao seu perfil. Cada ação dentro da tela também exige uma permissão própria: exportar o CSV, listar o consolidado completo, listar por conta, listar os erros, corrigir automaticamente e corrigir manualmente são liberados individualmente — ou seja, um perfil pode, por exemplo, visualizar os erros sem poder corrigi-los.
Processo de Correção — Passo a Passo
Esta rotina não cadastra um novo registro; ela processa e corrige a vinculação contábil de títulos já existentes. O fluxo de uso segue estes passos:
Informar os filtros de período e escopo
O usuário informa a filial e a data-base a partir da qual o sistema deve considerar os lançamentos financeiros no cálculo do saldo retroativo. Opcionalmente, pode refinar por código do fato, tipo de movimento, tipo de cadastro, participante (cliente/fornecedor) ou código contábil.
Consultar os títulos pendentes de vinculação
O usuário acessa a lista de erros (ação “Listar Erros”) para ver quais títulos ainda não possuem conta patrimonial confirmada. O sistema sinaliza, por indicadores, se existem títulos totalmente sem sugestão, com sugestão automática pendente de confirmação, ou já válidos.
Corrigir automaticamente
Para os títulos em que o sistema já encontrou uma conta contábil sugerida (por bater valor e histórico de lançamento com o razão contábil já existente), o usuário executa a correção automática. O sistema grava a conta sugerida diretamente no título.
Corrigir manualmente os casos restantes
Para os títulos sem nenhuma sugestão automática, o usuário localiza-os pelo filtro de busca, escolhe manualmente o código do plano de contas correto e aplica essa conta a todos os títulos filtrados de uma só vez.
Consultar o consolidado e exportar
Com os títulos corrigidos, o usuário consulta o saldo consolidado por conta (ação “Listar por Conta”) e, quando estiver satisfeito, exporta o arquivo CSV com o saldo final para implantação do razão auxiliar.
Descrição de Cada Campo da Tela da Razão Auxiliar – Implantação de Saldo
Filial
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: código da filial (empresa) para a qual o saldo do razão auxiliar está sendo apurado.
Comportamento: restringe todas as consultas e a exportação a essa filial.
Impacto: usado como filtro em todas as consultas SQL de apuração de saldo e no nome do arquivo CSV gerado.
Data-base
Tipo: data
Obrigatoriedade: obrigatório
Descrição: data retroativa a partir da qual o sistema soma os lançamentos financeiros para calcular o saldo do título.
Comportamento: todo lançamento financeiro posterior a essa data entra no cálculo do saldo retroativo do título.
Impacto: afeta diretamente o valor de saldo mostrado nas listagens e exportado no CSV.
Código do Fato / TMV / Tipo de Cadastro / Participante / Código Contábil
Tipo: texto/autocomplete
Obrigatoriedade: opcional
Descrição: filtros opcionais — código do fato gerador de estoque, tipo de movimento de estoque relacionado, tipo de cadastro do participante (cliente/fornecedor), código do participante, ou código reduzido da conta contábil (busca por trecho).
Comportamento: cada filtro, quando preenchido, restringe a consulta aos títulos que atendem ao critério correspondente.
Impacto: reduzem o volume de registros nas listagens e na exportação.
Busca (valor de consulta)
Tipo: texto
Obrigatoriedade: opcional
Descrição: campo de busca livre usado nas listagens (completo, por conta e de erros) para localizar registros por data, código de participante ou início do nome/código de plano, participante ou tipo de cadastro.
Comportamento: o sistema detecta automaticamente se o valor digitado é uma data, um número (código de participante) ou um texto, e aplica o filtro correspondente.
Impacto: afeta apenas a listagem em tela — não altera o cálculo do saldo em si.
Código do Plano de Contas (correção manual)
Tipo: texto/autocomplete
Obrigatoriedade: obrigatório (somente na correção manual)
Descrição: código do plano de contas que o usuário decide aplicar aos títulos ainda sem vinculação automática.
Comportamento: ao confirmar, o sistema grava esse código como a conta patrimonial de todos os títulos que atendem ao filtro de busca informado, em lotes internos de até 50 títulos por vez.
Impacto: passa a valer como a conta contábil patrimonial do(s) título(s) corrigido(s), refletindo nas listagens e na exportação do CSV.
Utilização e Consulta de Registros da Razão Auxiliar – Implantação de Saldo
O usuário consulta os títulos de três formas: (1) “Listar Completo”, mostrando cada título individualmente já com conta vinculada; (2) “Listar por Conta”, mostrando o saldo somado por conta contábil e participante — o mesmo agrupamento que sai no CSV; e (3) “Listar Erros”, mostrando apenas os títulos ainda sem vinculação confirmada. Em todas, o campo de busca livre aceita data, código de participante ou início de texto, e o resultado é paginado.
Processo de Edição da Razão Auxiliar – Implantação de Saldo
Não existe uma tela de edição tradicional de um registro específico. A “edição” possível é a correção da conta patrimonial de títulos pendentes, feita em lote: automaticamente (aplicando a sugestão já calculada pelo sistema) ou manualmente (aplicando o código de plano escolhido pelo usuário a todos os títulos que casarem com o filtro de busca no momento da correção). Não há histórico de alterações exibido nesta tela para o usuário final.
Estrutura Técnica e Comportamento do Sistema da Razão Auxiliar – Implantação de Saldo
A rotina lê lançamentos financeiros (contas a pagar e a receber) e o razão contábil já lançado para inferir, por semelhança de valor e histórico, qual conta patrimonial melhor representa cada título sem vinculação. Ao corrigir automaticamente ou manualmente, o sistema grava o código da conta diretamente nos títulos de contas a pagar/receber, e esses dados corrigidos passam a compor o saldo consolidado exportado no arquivo CSV, usado para implantar o razão auxiliar contábil — ou seja, há impacto direto na consistência entre os módulos de Contas a Pagar/Receber e Contabilidade.
Regras de Negócio e Restrições da Razão Auxiliar – Implantação de Saldo
Três situações possíveis para cada título
Todo título sem conta patrimonial é classificado pelo sistema em uma de três situações: já vinculado (aparece nas listagens de dados válidos e no CSV), com sugestão automática pendente de confirmação (aparece em Erros, disponível para correção automática), ou sem nenhuma sugestão (aparece em Erros, só pode ser resolvido manualmente).
A sugestão automática segue uma ordem de prioridade
O sistema tenta encontrar a conta correta em até 8 tentativas sucessivas, da mais precisa (mesmo cadastro, valor e histórico) até a mais genérica (mesma partida contábil), sempre usando como referência lançamentos contábeis que já existem no razão. Só avança para a tentativa seguinte o título que a tentativa anterior não conseguiu resolver.
Corrigir automaticamente só aplica o que já foi sugerido
A correção automática não recalcula a busca de conta na hora do clique — ela grava a sugestão que o sistema já havia determinado ao consultar a lista de erros. Se a operação falhar tecnicamente no banco de dados, o sistema informa apenas que a operação não teve sucesso, sem detalhar o motivo do erro para o usuário — não há uma mensagem de erro de negócio específica para esse caso.
Corrigir manualmente aplica o código a todos os títulos filtrados de uma vez
Ao confirmar a correção manual, o código de plano de contas informado é aplicado a todos os títulos ainda sem vinculação que atendam ao filtro de busca usado naquele momento — não é possível escolher título a título dentro dessa ação. O sistema não valida se o código informado é compatível com o tipo do título (pagar ou receber); a responsabilidade de conferir o código correto é do usuário.
A exportação usa somente dados já validados
O arquivo CSV gerado para implantação do razão auxiliar traz apenas os títulos com conta patrimonial já confirmada. Títulos ainda pendentes (com ou sem sugestão automática) não entram no arquivo até que sejam corrigidos.
Ausência de mensagens de erro específicas
[informação não disponível na análise de código — validar com analista/vídeo do sistema]: diferente de outras rotinas do sistema, esta funcionalidade não exibe mensagens de erro de negócio detalhadas (do tipo Erro/Motivo/Solução); tanto a exportação quanto as correções automática e manual comunicam apenas sucesso ou falha da operação, sem explicar a causa ao usuário quando a operação falha.
