Consulta Balancete

Documentação Técnica Consulta balancete Módulo Contabilidade — consulta do Balancete de Verificação de uma filial em um determinado período, com saldo anterior, débitos, créditos, saldo atual e percentual de auditoria por conta. 01 — VISÃO GERAL Visão Geral da Rotina A rotina “Consulta balancete” (Contabilidade / Consultas / Consulta balancete) permite ao usuário consultar o Balancete de Verificação de uma filial em um determinado período. Para cada conta do plano de contas dentro da faixa de códigos informada, o sistema apresenta o saldo anterior, o total de débitos, o total de créditos e o saldo atual do período, além de indicar qual percentual dos lançamentos contábeis daquela conta já foi auditado. Tela exclusivamente de consulta Não existe cadastro, edição ou exclusão de registros por aqui. Os valores exibidos são sempre calculados no momento da consulta, a partir dos lançamentos contábeis já registrados no sistema e da estrutura do plano de contas. 02 — VÍDEO TUTORIAL Vídeo Tutorial ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso EditViewDeSaldoContabil Para visualizar a tela “Consulta balancete”, o usuário precisa ter esta permissão concedida ao seu perfil de acesso. Sem essa permissão, o item de menu “Contabilidade / Consultas / Consulta balancete” não aparece disponível para o usuário. Observação Não há permissões adicionais específicas para ações dentro da tela — toda a funcionalidade de consulta está coberta pela mesma permissão de acesso à rotina. Pré-requisitos de dados É necessário que a filial e o período pesquisados já possuam lançamentos contábeis registrados (via módulo de Movimentação Contábil) e que o plano de contas da filial esteja corretamente configurado com a “Divisão Contábil” de cada faixa de conta — essa divisão é usada internamente para ordenar as contas e ajustar o sinal do saldo apresentado. 04 — PASSO A PASSO Processo de Criação — Passo a Passo Não aplicável Esta rotina não possui processo de criação/cadastro — é uma tela somente de consulta. [informação não disponível na análise de código — validar com analista/vídeo do sistema: fluxo exato de navegação até a tela dentro do menu do sistema] 05 — CAMPOS Descrição de Cada Campo da Tela Filial Tipo: seleção (lookup de filial) Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: identifica a filial cujos lançamentos contábeis serão consultados no balancete Comportamento: aceita um ou mais códigos de filial; o valor selecionado é enviado como filtro da consulta Impacto: determina de qual base de lançamentos contábeis (TBMOVTOCTB) os saldos serão calculados Ano Base Tipo: número/seleção (ano) Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: ano de referência do período consultado Comportamento: o sistema usa o ano informado aqui, combinado com o dia e o mês dos campos “Data Inicial” e “Data Final”, para montar o período efetivo de consulta — mesmo que essas datas tragam um ano diferente, ele é substituído pelo ano base informado Impacto: define o intervalo real de datas usado para buscar os lançamentos contábeis; caso o usuário informe um ano base diferente do ano das datas, o período calculado pode não ser o esperado Data Inicial Tipo: data Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: dia/mês de início do período do balancete (o ano é sempre substituído pelo “Ano Base”) Comportamento: combinado com “Ano Base” para formar a data inicial efetiva do filtro Impacto: define o início do intervalo de lançamentos considerados no cálculo do saldo anterior e nos totais do período Data Final Tipo: data Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: dia/mês de fim do período do balancete (o ano é sempre substituído pelo “Ano Base”) Comportamento: combinado com “Ano Base” para formar a data final efetiva do filtro Impacto: define o fim do intervalo de lançamentos considerados no cálculo dos totais e do saldo atual do período Código da Conta Inicial Tipo: texto (código de conta contábil) Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: código da primeira conta da faixa do plano de contas a ser exibida no balancete Comportamento: delimita, junto com “Código da Conta Final”, a faixa de contas trazida na consulta Impacto: restringe quais contas aparecem na grade de resultado Código da Conta Final Tipo: texto (código de conta contábil) Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: código da última conta da faixa do plano de contas a ser exibida no balancete Comportamento: delimita, junto com “Código da Conta Inicial”, a faixa de contas trazida na consulta Impacto: restringe quais contas aparecem na grade de resultado Fechamento Tipo: seleção (Sim/Não) Obrigatoriedade: obrigatório — sem esse valor a consulta não retorna nenhum registro Descrição: indica se o balancete deve considerar o fechamento contábil do período (“Com fechamento”) ou não (“Sem fechamento”) Comportamento: quando marcado como “Sim”, o sistema aplica o valor de fechamento do mês no cálculo do saldo; diferente dos relatórios de Balanço e DRE, esta tela aceita livremente as duas opções, sem restrição Impacto: altera o valor de “Saldo Atual” e “Saldo Atual com Fechamento” exibidos na grade 06 — CONSULTAS Utilização e Consulta de Registros O usuário preenche todos os filtros descritos na seção anterior (filial, ano base, data inicial, data final, faixa de código de conta e opção de fechamento) e aciona a consulta. O sistema retorna, em formato de grade paginada, todas as contas do plano de contas dentro da faixa informada, com os respectivos saldos e o percentual de lançamentos auditados de cada conta analítica no período. Atenção Se qualquer um dos filtros obrigatórios não for preenchido, a grade é exibida vazia, sem mensagem de erro — o usuário deve revisar se todos os campos de filtro foram informados. 07 — EDIÇÃO Processo de Edição Edição não permitida Esta rotina não permite edição de nenhum dado. Todos os valores exibidos (saldos, percentuais de auditoria) são calculados dinamicamente a partir dos lançamentos contábeis já existentes no sistema; para

Consultas DRE

Documentação Técnica Consultas DRE (DRE Trimestral) Consulta do módulo Contabilidade que exibe a Demonstração do Resultado do Exercício de três meses consecutivos, lado a lado, a partir de um mês de referência informado. 01 — VISÃO GERAL Visão Geral das Consultas DRE A rotina “Consulta DRE” (DRE Trimestral), no módulo Contabilidade, permite ao usuário visualizar a Demonstração do Resultado do Exercício de três meses consecutivos, lado a lado, a partir de um mês de referência informado. O sistema calcula automaticamente os dois meses seguintes ao mês informado e apresenta, para cada conta contábil de resultado, o saldo em cada um dos três meses, o percentual de participação de cada mês (percentual vertical e horizontal), a média e o total do trimestre, além de uma linha final com o resultado líquido apurado em cada mês. Para que serve Essa rotina é usada por contadores e analistas financeiros para acompanhar a evolução trimestral de receitas e despesas por conta, sem precisar rodar três consultas de DRE separadas e comparar manualmente os resultados. 02 — VÍDEO TUTORIAL Vídeo Tutorial das Consultas DRE ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso das Consultas DRE Para acessar a tela “Contabilidade / Consultas / Consulta DRE” o usuário precisa ter o perfil de acesso vinculado à permissão “Visualização de DRE Trimestral” (ID 709). Sem essa permissão, o item de menu da Consulta DRE não é exibido. Exportação para Excel ID 1119 Necessária para exportar o resultado da consulta para Excel. Dependência Não há dependência de cadastro prévio específico para acessar a tela — a consulta é executada sobre lançamentos contábeis e o plano de contas já existentes na base do cliente. 04 — PASSO A PASSO Processo de Utilização — Passo a Passo Esta rotina é de consulta, não de cadastro — não existe processo de criação de registro. 1 Selecionar as filiais O usuário seleciona uma ou mais filiais para as quais deseja consultar o DRE trimestral. 2 Informar o mês de referência (período base) O usuário informa o mês/ano que servirá de ponto de partida. O sistema calcula automaticamente os dois meses seguintes e monta o relatório com os três meses lado a lado. 3 (Opcional) Informar o intervalo de contas O usuário pode restringir a consulta a um intervalo de contas contábeis, informando a conta inicial e a conta final. Se deixados em branco, o relatório considera todas as contas. 4 Escolher a base de cálculo do percentual vertical O usuário indica se o percentual de cada conta deve ser calculado com base na conta pai (hierarquia imediatamente superior) ou com base na conta de nível 1 correspondente. 5 Escolher o nível de detalhamento O usuário informa até qual nível hierárquico do plano de contas deseja visualizar. Informando 0, o sistema mostra todos os níveis. 6 Consultar O sistema executa a consulta e apresenta a lista de contas com os saldos, percentuais, médias e totais do trimestre, finalizando com a linha “RESULTADO LIQUIDO DO PERÍODO”. 7 (Opcional) Exportar para Excel O usuário pode exportar o resultado exibido em tela para um arquivo Excel, usando os mesmos filtros aplicados na consulta. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela das Consultas DRE Filiais Tipo: seleção múltipla Obrigatoriedade: obrigatório Descrição: filiais cujos lançamentos contábeis serão considerados no cálculo do DRE trimestral. Comportamento: aceita seleção de mais de uma filial; os valores selecionados são enviados como lista de códigos separados por vírgula. Impacto: define o escopo de filiais dos saldos exibidos em todas as linhas do relatório. Período Base Tipo: data (mês/ano) Obrigatoriedade: obrigatório Descrição: mês de referência a partir do qual o sistema monta o trimestre (mês informado + os dois meses seguintes). Comportamento: ao ser informado, dispara o cálculo dos três meses consecutivos que serão exibidos como colunas no relatório. Impacto: determina quais três meses aparecem nas colunas de saldo do relatório (mês 1, mês 2 e mês 3). Conta Inicial Tipo: texto (código de conta contábil) Obrigatoriedade: opcional Descrição: código da conta contábil que inicia o intervalo de contas a exibir no relatório. Comportamento: quando não informado, o relatório não aplica limite inferior de conta. Impacto: restringe as linhas exibidas no relatório ao intervalo de contas informado. Conta Final Tipo: texto (código de conta contábil) Obrigatoriedade: opcional Descrição: código da conta contábil que encerra o intervalo de contas a exibir no relatório. Comportamento: quando não informado, o relatório não aplica limite superior de conta. Impacto: restringe as linhas exibidas no relatório ao intervalo de contas informado. Percentual Vertical Tipo: seleção (Sim/Não) Obrigatoriedade: obrigatório Descrição: define se o percentual de participação de cada conta é calculado com base na conta pai (hierarquia imediatamente superior) ou com base na conta de nível 1 correspondente. Comportamento: “Sim” usa a conta pai como base do cálculo do percentual; “Não” usa a conta de nível 1 correspondente. Impacto: altera o valor exibido nas colunas de percentual (Percentual) de cada mês, para todas as contas de nível maior que 1. Nível Tipo: número Obrigatoriedade: obrigatório Descrição: nível hierárquico máximo do plano de contas a ser exibido no relatório. Comportamento: informando 0, o sistema exibe contas de todos os níveis; qualquer outro valor filtra as contas para exibir somente até aquele nível. Impacto: controla o grau de detalhamento (contas sintéticas vs. analíticas) exibido no relatório. 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros das Consultas DRE O usuário localiza o resultado desejado preenchendo os filtros descritos na seção anterior (filiais, período base, intervalo de contas, base do percentual vertical e nível) e executando a consulta. Não há busca por texto livre — os filtros são sempre estruturados (filial, período, conta, nível). 07 — EDIÇÃO Processo de Edição das Consultas DRE Esta rotina não permite edição de registros. Ela é exclusivamente de consulta e exportação: os saldos exibidos são resultado do cálculo em tempo real sobre os lançamentos contábeis já existentes, e nenhuma informação é alterada ou gravada a partir desta tela. 08 — ESTRUTURA

Propriedade Rural

Consultas

Documentação Técnica Consultas Módulo Contabilidade — telas de consulta e conferência que não alteram dados: comparam períodos, validam configurações e apoiam o fechamento contábil. VISÃO GERAL O que o sistema faz A área de Consultas reúne rotinas de leitura/conferência do módulo Contabilidade — nenhuma delas cadastra, edita ou exclui registros. Cada uma apoia um tipo diferente de análise: comparar a evolução do resultado contábil entre meses, validar a configuração de um Tipo de Movimento antes de liberá-lo para uso amplo, ou conferir o balancete de um período. ROTINAS DESTA ÁREA Rotinas de Consulta Consultas DRE Exibe a Demonstração do Resultado do Exercício de três meses consecutivos lado a lado, a partir de um mês de referência informado (o sistema calcula automaticamente os dois meses seguintes). Para cada conta de resultado, mostra o saldo em cada mês, o percentual de participação (vertical e horizontal), a média e o total do trimestre, além do resultado líquido apurado em cada mês — usado para acompanhar a evolução trimestral de receitas e despesas sem rodar três consultas separadas. Validação do TMV Permite consultar os Tipos de Movimento de Estoque (TMV) cadastrados e gerar, a partir de um documento real já lançado, um relatório de validação mostrando como aquele Tipo de Movimento está configurado (regras contábeis, fiscais, financeiras e de estoque) quando aplicado a esse documento — usada para conferência antes de liberar um Tipo de Movimento para uso amplo. Consulta Balancete Consulta de apoio à conferência do balancete de verificação de um período. CARACTERÍSTICA COMUM Sem Impacto nos Dados Todas as rotinas desta área são de leitura: apuram e exibem informações já lançadas em outras rotinas do sistema (Movimentação Contábil, Plano de Contas, documentos de entrada/saída), sem criar, alterar ou excluir nenhum registro.

Manutenção de Cadastro Geral

Validar Plano de Contas

Documentação Técnica Validar Plano de Contas Módulo Contabilidade > Movimentações — executa uma auditoria automática sobre toda a base de contas contábeis, corrigindo inconsistências estruturais e listando contas sem conta pai para avaliação manual. 01 — VISÃO GERAL Visão Geral da Rotina de Validar Plano de Contas A rotina “Validar plano de contas”, disponível em “Contabilidade > Movimentações > Validar plano de contas”, executa uma auditoria automática sobre toda a base de contas contábeis da empresa e corrige, na hora, um conjunto de inconsistências estruturais comuns: código de conta com espaços em branco, contas sintéticas ou analíticas com o indicador de “aceita lançamento” incoerente com o seu tipo, código de natureza contábil sem o zero à esquerda, e status patrimonial divergente do esperado para o código da conta. Ao final, o sistema também lista as contas que não possuem uma conta pai na estrutura hierárquica, para avaliação manual. Sem dados de entrada Esta rotina não pede nenhum dado de entrada — o usuário apenas dispara a execução e recebe um relatório com o resultado de cada verificação. 02 — VÍDEO TUTORIAL Vídeo Tutorial de Validar Plano de Contas ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso de Validar Plano de Contas O usuário precisa estar autenticado no sistema. O acesso ao item de menu “Contabilidade / Movimentações / Validar plano de contas” é controlado pela permissão “EditViewDeValidacaoDePlanoDeContas”. Observação técnica Não foi localizado, na análise do código-fonte do backend, um controller/rota dedicado com o nome “ValidacaoDePlanoDeContas” que corresponda diretamente a esta permissão pelo padrão usual de nomenclatura. Foi localizada uma action de nome “ValidarPlanoDeContas” (no controller “IntegridadeDeDadosController”, da área de integridade de saldos contábeis) que executa exatamente a lógica de correção descrita neste artigo — mas o nome da permissão registrada não segue a convenção que ligaria automaticamente essa permissão a essa rota específica. É possível que: (a) esta seja de fato a tela por trás da permissão, apenas com nomes internos diferentes; (b) exista uma tela client-side ainda não localizada nesta análise; ou (c) a permissão esteja órfã (cadastrada mas sem tela associada). Recomenda-se confirmar com o time técnico antes de orientar o usuário final sobre como acessar esta rotina na prática. 04 — PASSO A PASSO Processo de Execução — Passo a Passo Esta rotina não cadastra nem cria registros — ela executa uma verificação/correção automática sobre a base já existente do plano de contas. O fluxo de uso é: 1 Acessar a rotina O usuário acessa “Contabilidade > Movimentações > Validar plano de contas” (sujeito à ressalva da seção 3 sobre a tela ainda não confirmada). 2 Disparar a validação O usuário aciona o comando de validação (ex: um botão “Validar” ou equivalente — rótulo exato não confirmado na análise de código). O sistema executa, em sequência e sem etapas intermediárias de confirmação, todas as verificações e correções descritas na seção 9 deste artigo. 3 Consultar o resultado O sistema devolve uma lista de mensagens de texto, uma por verificação realizada — informando quantos registros foram corrigidos em cada verificação, ou listando individualmente as contas que precisam de atenção manual (contas sem conta pai). 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela de Validar Plano de Contas Não há campos de entrada nesta rotina — o comando de validação não recebe parâmetros do usuário. Resultado da validação (lista de mensagens) Tipo: texto (somente leitura, lista) Obrigatoriedade: não se aplica (campo de saída, não de entrada) Descrição: cada linha do resultado representa o desfecho de uma das verificações executadas pela rotina — uma contagem de registros corrigidos (ex: “3 atualização de plano de contas para que o código da conta não fique com espaços em branco”) ou a identificação de uma conta com pendência (ex: “Conta {nome da conta} não possui conta pai”). Comportamento: gerado automaticamente pelo sistema ao final da execução; não é editável pelo usuário. Impacto: apenas informativo nesta tela — mas as correções descritas nas mensagens já foram aplicadas diretamente no cadastro do plano de contas no momento em que a mensagem foi gerada (ver seção 9). 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros de Validar Plano de Contas Esta rotina não possui filtros de busca nem grade de registros — ela roda sobre toda a base de contas contábeis de uma só vez, sem seleção prévia de contas ou filiais pelo usuário. 07 — EDIÇÃO Processo de Edição de Validar Plano de Contas Não se aplica A rotina não abre um registro específico para edição manual — as correções descritas na seção 9 (itens 1 a 5, 7 e 8) são aplicadas automaticamente pelo próprio sistema a todas as contas que se enquadrarem nas condições verificadas, sem intervenção campo a campo do usuário. A única exceção é a verificação de contas sem conta pai (item 6 da seção 9), que é somente informativa: o sistema não corrige esse caso automaticamente, apenas lista as contas para que o usuário (ou o cadastro de Plano de Contas) resolva manualmente qual deve ser a conta pai correta. 08 — ESTRUTURA TÉCNICA Estrutura Técnica e Comportamento do Sistema de Validar Plano de Contas A rotina grava um registro de log técnico identificando o usuário que disparou a validação. Todas as correções (itens 1, 2, 3, 4, 5, 7 e 8 da seção 9) são gravadas diretamente no banco de dados no momento da execução — não existe uma etapa de simulação nem uma tela de confirmação antes de aplicar as mudanças. Por afetar diretamente o cadastro do Plano de Contas, o resultado desta rotina pode impactar qualquer módulo do ERP que dependa da classificação correta das contas contábeis (Contas a Pagar/Receber, Estoque, Patrimônio, Orçamento, Rateio, SPED Contábil, entre outros), já que esses módulos usam o tipo, a natureza e o status patrimonial da conta para seus próprios cálculos e obrigações acessórias. 09 — REGRAS DE NEGÓCIO Regras de Negócio e Restrições de Validar Plano de Contas 1 Remoção de espaços em branco

Cadastro Geral

Integridade de Saldos Contábeis

Documentação Técnica Integridade de Saldos Contábeis Módulo Contabilidade > Movimentações — permite conferir se os saldos contábeis gravados estão de acordo com a movimentação real lançada no período, corrigir divergências e validar o Plano de Contas. 01 — VISÃO GERAL Visão Geral da Rotina A rotina de Integridade de Saldos Contábeis, disponível em Contabilidade > Movimentações > Integridade de saldos contábeis, permite ao usuário conferir se os saldos contábeis gravados no sistema estão de acordo com a movimentação contábil real lançada no período. O sistema compara, conta a conta e mês a mês, o saldo armazenado com o que deveria existir com base nos lançamentos, apontando divergências de débito e crédito, além de divergências no saldo anterior de cada mês. Além da verificação de saldos, esta rotina também oferece um atalho para validar o Plano de Contas da empresa e para disparar a correção automática de saldos contábeis, um processo que roda em segundo plano no sistema. Público-alvo Esta rotina é voltada a usuários da área contábil responsáveis pela consistência dos saldos utilizados em relatórios contábeis e em obrigações acessórias, como o SPED Contábil. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Integridade de Saldos Contábeis ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Integridade de Saldos Contábeis O usuário precisa ter a permissão de acesso à rotina “Integridade de saldos contábeis” habilitada em seu perfil de usuário. Para executar cada ação específica dentro da tela (verificar saldos, corrigir saldos, validar plano de contas, disparar correção automática etc.), o perfil do usuário também precisa ter a permissão granular daquela ação especificamente atribuída — sem ela, o botão/ação correspondente não fica disponível ou é bloqueado. Pré-requisito de negócio A filial que será verificada precisa já ter ao menos um fechamento contábil realizado — a rotina usa o fechamento contábil da filial como ponto de partida da verificação. Se a filial nunca teve um período fechado, a verificação não pode ser executada (ver Regra de Negócio 4). 04 — PASSO A PASSO Processo de Verificação e Correção — Passo a Passo Esta rotina não cadastra registros novos — ela verifica e corrige dados já existentes. Por isso, o fluxo abaixo descreve o processo de verificação e correção de saldos, equivalente ao fluxo principal desta tela. 1 Selecionar a filial O usuário informa a filial que deseja verificar no campo “Filial”. O sistema busca automaticamente, em segundo plano, o primeiro período contábil aberto daquela filial — essa data é usada como ponto de partida da verificação, sem que o usuário precise informá-la manualmente. 2 Executar a verificação de saldos débito e crédito O usuário aciona a verificação de saldos débito e crédito. O sistema compara o saldo contábil gravado com o que foi apurado na movimentação real e exibe uma lista de divergências, cada uma classificada com uma ação sugerida: “Corrigir saldos”, “Inserir saldo” ou “Zerar saldo” (ver Regra de Negócio 1). 3 Selecionar os registros e corrigir O usuário seleciona, na lista de divergências exibida, quais registros deseja corrigir e aciona o botão de correção. O sistema aplica a ação correspondente a cada registro selecionado (corrige o valor, insere o saldo faltante ou zera o saldo) e grava as alterações de forma definitiva. 4 Executar a verificação de saldos anteriores De forma independente, o usuário pode acionar a verificação de saldo anterior. O sistema recalcula, mês a mês, o valor que o “saldo anterior” de cada conta deveria ter (a partir do saldo e da movimentação do mês anterior) e lista as contas em que o valor gravado está incorreto. 5 Corrigir saldos anteriores O usuário seleciona os registros divergentes de saldo anterior e aciona a correção. O sistema recalcula e regrava o saldo anterior correto de cada mês, avançando automaticamente até o período aberto mais recente da filial. 6 (Opcional) Validar o Plano de Contas O usuário pode acionar, na mesma tela, a validação do Plano de Contas da própria empresa. Essa validação segue exatamente a mesma regra já documentada na rotina de Plano de Contas — consulte o artigo de ajuda daquela rotina para o detalhamento completo (ver Regra de Negócio 8). 7 (Opcional) Executar correção automática de saldos contábeis O usuário pode acionar a execução de uma correção automática de saldos contábeis para uma ou mais filiais e uma data de fechamento. O sistema não corrige os saldos na hora — ele registra o pedido e delega o processamento a uma rotina que roda em segundo plano, podendo levar algum tempo para concluir (ver seção 8 — Estrutura Técnica). 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da Integridade de Saldos Contábeis Filial Tipo: seleção (combo/autocomplete de filiais) Obrigatoriedade: obrigatório para executar qualquer verificação Descrição: código da filial contábil cujos saldos serão verificados. Comportamento: ao selecionar a filial, o sistema busca automaticamente o primeiro período contábil aberto daquela filial, que será usado como data-base da verificação — o usuário não digita essa data. Impacto: define o escopo (filial) de toda a verificação e correção realizada na tela. Lista de divergências de saldo débito/crédito Tipo: grid (tabela de resultados) Obrigatoriedade: não se aplica (resultado de consulta) Descrição: lista de contas contábeis, por centro de custo e mês, em que o saldo gravado diverge da movimentação contábil real, com a ação sugerida para correção (“Corrigir saldos”, “Inserir saldo” ou “Zerar saldo”). Comportamento: cada linha pode ser selecionada individualmente para aplicar a correção correspondente. Impacto: os registros corrigidos afetam diretamente os saldos usados em relatórios contábeis (balancetes, razão, SPED Contábil). Lista de divergências de saldo anterior Tipo: grid (tabela de resultados) Obrigatoriedade: não se aplica (resultado de consulta) Descrição: lista de contas/centros de custo em que o “saldo anterior” gravado no mês não corresponde ao valor recalculado a partir do mês imediatamente anterior. Comportamento: cada linha pode ser selecionada para correção. Impacto: corrige a base de cálculo usada para apurar o saldo final de cada mês seguinte, evitando efeito cascata de erro em meses futuros. Filiais para verificação

Cadastro Geral (ERP)

Razão Auxiliar

Documentação Técnica 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). 01 — VISÃO GERAL Visão Geral da Rotina 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. Atenção — não confundir Esta rotina não deve ser confundida com outras duas telas do sistema também chamadas “Razão Auxiliar”: a de Implantação de Saldo e a de Financeiro x Contábil, que têm outra finalidade e são tratadas em documentações próprias. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Razão Auxiliar ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Razão Auxiliar Para acessar a tela de Razão Auxiliar — Movimentações, o usuário precisa ter a permissão “Visualizar Razão Auxiliar” (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 “Incluir Saldo Contábil” (ID 1044) e “Editar Saldo Contábil” (ID 1045). Exportar / Importar “Exportar Saldos” (ID 1046) e “Importar Saldos” (ID 1047). Pré-requisito de negócio É necessário que exista um cadastro prévio de Filiais, de Plano de Contas e de Cadastros Gerais (participantes), já que todo registro de saldo depende dessas três informações já existirem no sistema. Também é necessário que exista um controle de período contábil (aberto/encerrado) configurado para a filial, pois essa condição determina se a inclusão de um novo saldo é permitida. 04 — PASSO A PASSO Processo de Criação — Passo a Passo 1 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. 2 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. 3 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. 4 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.” 5 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). 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da 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