Geração Rateio off-line
Criado por Igor Ribeiro em 14 de novembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Geração Rateio off-line
Módulo Contabilidade — distribuição (rateio) dos saldos das contas do DRE de um período entre contas e centros de custo/controle de destino, com base em um modelo de rateio previamente cadastrado.
Visão Geral da Geração Rateio off-line
A rotina “Geração Rateio off-line”, do módulo Contabilidade, permite ao usuário distribuir (ratear) os saldos das contas do DRE (Demonstrativo de Resultado do Exercício) de um período entre contas e centros de custo/controle de destino, com base em um modelo de rateio previamente cadastrado no sistema.
O usuário informa um modelo de rateio, a filial, o período e o lote contábil de destino; o sistema calcula automaticamente a proposta de distribuição dos saldos e apresenta o resultado em tela para conferência e ajuste. Só depois de o usuário revisar e confirmar é que os lançamentos contábeis do rateio são efetivamente gravados no lote informado.
Esta rotina é útil, por exemplo, para distribuir o resultado de uma conta de despesa ou receita entre diferentes centros de custo/controle da empresa, gerando automaticamente os lançamentos contábeis correspondentes, sem que o usuário precise digitar cada lançamento manualmente.
Vídeo Tutorial da Geração Rateio off-line
Pré-requisitos e Contexto de Acesso da Geração Rateio off-line
Para acessar a tela “Geração Rateio off-line” (menu Contabilidade / Rateio / Geração Rateio off-line), o usuário precisa ter o perfil de acesso liberado com a permissão “EditViewDeRateioOffLine”. Sem essa permissão, o menu da rotina não aparece para o usuário.
Permissões específicas dentro da rotina
Pré-requisitos de cadastro
Processo de Criação — Passo a Passo da Geração Rateio off-line
Informar os parâmetros do rateio
O usuário acessa a tela “Geração Rateio off-line” e, na aba “Parâmetros”, preenche: Modelo de rateio, Filial, Período base, Histórico (opcional), Complemento histórico (opcional), Num. docto. auxiliar (opcional), Série do lote e Número do lote. Os campos “Modelo de rateio”, “Filial”, “Período base” e “Série do lote”/”Número do lote” são obrigatórios.
Aplicar o modelo de rateio
O usuário aciona a ação de aplicar o modelo. O sistema consulta os saldos atuais do DRE da filial e período informados, identifica as contas com saldo diferente de zero e aplica as regras do modelo de rateio selecionado (rateio por critério cadastrado ou rateio direto para conta destino — ver seção 9, Regras 1 e 2). O resultado é apresentado na aba “DRE com modelo de rateio”, em forma de grade, com uma linha por combinação de conta/centro de custo de origem (ou já desdobrada em sublinhas quando o modelo utiliza critério de rateio percentual).
Revisar e ajustar as linhas do rateio
O usuário revisa cada linha proposta pelo sistema. Para cada linha, é possível abrir o formulário de detalhe e ajustar: Plano de contas envio, Plano de contas destino, Centro Custo/Controle Destino e o percentual (% do rateio) ou o valor (Vlr. do rateio) daquela linha, acionando o botão “Atualizar rateios” para recalcular. O sistema não redistribui automaticamente o restante das linhas do grupo ao alterar o percentual de uma linha — o usuário é responsável por garantir que a soma dos percentuais/valores do grupo (mesma conta/centro de custo de origem) não ultrapasse 100% do percentual, nem o saldo original da conta (ver seção 9, Regras 2 e 3).
Salvar o rateio
O usuário aciona a ação de salvar. Como a grade pode ter muitas linhas, a tela pode enviar os dados em blocos; enquanto não for enviado o último bloco (marcado como “finalizado”), o sistema apenas acumula os dados recebidos, sem gravar nada em definitivo. Quando o último bloco chega, o sistema valida o rateio completo (ver seção 9) e, se estiver correto, grava os lançamentos contábeis no lote informado, criando o lote se ele ainda não existir.
Descrição de Cada Campo da Tela da Geração Rateio off-line
Modelo de rateio
Filial
Período base
Histórico
Complemento histórico
Num. docto. auxiliar
Série do lote
Número do lote
Plano de contas envio
Plano de contas destino
Centro Custo/Controle Destino
% do rateio
Vlr. do rateio
Utilização e Consulta de Registros da Geração Rateio off-line
Esta rotina não é uma tela de cadastro com listagem e consulta de registros já salvos anteriormente. Ela funciona como um processo de geração: a cada execução, o usuário informa modelo de rateio, filial, período e lote, e o sistema recalcula a proposta de rateio a partir dos saldos atuais do DRE — não há filtro de busca por rateios já realizados dentro desta própria tela. O resultado gravado (lançamentos contábeis) passa a ser consultado através das rotinas de consulta de Lote Contábil/Lançamentos Contábeis do módulo Contabilidade, não pela tela de Geração Rateio off-line.
Processo de Edição da Geração Rateio off-line
Enquanto o usuário ainda está revisando a proposta de rateio na grade (antes de acionar “Salvar”), os campos de cada linha (contas de envio/destino, centro de custo destino, percentual e valor) podem ser livremente ajustados no formulário de detalhe da linha.
Estrutura Técnica e Comportamento do Sistema da Geração Rateio off-line
Integração com Contabilidade (Lote Contábil)
Ao ser salvo, o rateio gera automaticamente lançamentos contábeis (identificados com o tipo “Gerado por Rateio Off-line”) dentro do lote contábil informado pelo usuário, criando o lote se ele ainda não existir.
Integração com o cadastro de Modelo de Rateio
A proposta de distribuição depende inteiramente do modelo de rateio selecionado, incluindo o tipo de distribuição configurado em cada item do modelo (por critério de rateio cadastrado, ou direto para uma única conta/centro de custo destino).
Integração com Critério de Rateio
Quando o modelo utiliza rateio “com base no cadastro de rateio”, o sistema aciona o motor de cálculo de critério de rateio para desdobrar automaticamente o valor da conta de origem em múltiplas linhas de destino, conforme os percentuais configurados no critério.
Processamento em arquivo temporário no servidor
Durante o envio dos dados para salvamento (que pode ocorrer em vários blocos, dado o volume de linhas), o sistema usa um arquivo temporário no servidor (“arquivo_temporario_rateio_offline.json”, na pasta de arquivos de processamento da aplicação) para acumular os blocos recebidos antes da gravação definitiva. Esse arquivo é removido automaticamente ao final do processo (com sucesso ou com erro).
Regras de Negócio e Restrições da Geração Rateio off-line
Aplicação do modelo apenas sobre contas com saldo
Ao aplicar o modelo de rateio, o sistema considera somente as contas do DRE da filial/período informados cujo saldo atual seja diferente de zero. Contas com saldo zerado não entram na proposta de rateio.
Limite de 100% de rateio por conta de origem
A soma dos percentuais informados para todas as linhas de uma mesma conta/centro de custo de origem não pode ultrapassar 100%. Se ultrapassar, o salvamento é bloqueado.
Limite do valor total rateado por conta de origem
A soma dos valores (“Vlr. do rateio”) de todas as linhas de uma mesma conta/centro de custo de origem não pode ultrapassar o saldo original dessa conta no DRE. Se ultrapassar, o salvamento é bloqueado.
Bloqueio de rateio em lote já preenchido
Se o lote contábil informado (série + número + filial) já existir e já tiver itens de lançamento gravados, o rateio não pode ser salvo nesse lote.
Rateio sem conta de destino informada
Se, ao salvar, nenhuma linha do rateio tiver conta de destino preenchida, o processo é bloqueado.
Criação automática do lote contábil
Se o lote informado (série + número + filial) ainda não existir, o sistema cria esse lote automaticamente no momento do salvamento, vinculando a data do período, o modelo de rateio e o histórico padrão informados. O usuário não precisa cadastrar o lote em uma tela separada antes de usar esta rotina.
Direção do lançamento conforme sinal do saldo
Quando o saldo da conta de origem é positivo, o lançamento contábil gerado tem crédito na conta/centro de custo de destino e débito na conta/centro de custo de origem; quando o saldo é negativo, a direção é invertida (crédito na origem, débito no destino).
Envio em blocos e consolidação apenas no final
O salvamento do rateio pode ocorrer em múltiplas chamadas (blocos), acumulando as linhas em um arquivo temporário no servidor. Somente quando o último bloco é enviado (indicado pelo parâmetro que sinaliza finalização) é que o sistema valida o rateio completo (Regras 2, 3 e 5) e grava os lançamentos contábeis; blocos intermediários apenas ficam retidos no servidor até a confirmação final.
Resolução de contas sintéticas do modelo (dependente de configuração do sistema)
Caso o modelo de rateio contenha alguma conta sintética entre os itens de origem, o sistema só desdobra automaticamente essa conta em suas contas analíticas filhas se uma configuração específica do sistema (parâmetro de configuração de ID 8002) estiver habilitada com o valor “S”. [informação não disponível na análise de código — validar com analista/vídeo do sistema: nome/tela de configuração exata onde o parâmetro 8002 é definido para o usuário final]. Se essa configuração não estiver habilitada, uma conta sintética presente no modelo pode impedir a geração de lançamento, pois contas sintéticas não aceitam lançamento direto.
