Lote Contábil
Criado por Igor Ribeiro em 24 de setembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Lote Contábil
Módulo Contabilidade > Movimentações — rotina central de lançamentos manuais em lote, com digitação, importação por Excel, geração automática de zeramento/abertura de saldos e atualização para a Movimentação Contábil.
Visão Geral da Rotina
O Lote Contábil é a rotina central de lançamentos manuais da Contabilidade do ERP Atak, no submenu “Contabilidade / Movimentações”. Nela, o usuário digita, importa ou gera automaticamente um conjunto de lançamentos (débito/crédito) organizados por filial, série e número de lote, confere a partida contábil (dupla ou simples) e, ao final, “atualiza” o lote — a operação que transforma cada item do lote em um lançamento definitivo na Movimentação Contábil, base de todos os relatórios contábeis e obrigações fiscais (como o SPED Contábil).
Vídeo Tutorial do Lote Contábil
Pré-requisitos e Contexto de Acesso do Lote Contábil
Para acessar a tela de Lote Contábil, o usuário precisa da permissão de rotina “ListViewDeLoteContabil” (ID 645).
Cadastro Básico
“LoteContabil/Novo” (ID 644), “LoteContabil/Editar” (ID 643), “LoteContabil/Excluir” (ID 789).
Atualização
“LoteContabil/AtualizarLancamentoContabil” (ID 713) e “LoteContabil/DesatualizarLancamentoContabil” (ID 714).
Importação e Geração Automática
“LoteContabil/ImportarLancamentosDeArquivoExcel” (ID 790), “LoteContabil/GerarLancamentosDeZeramentos” (ID 661), “LoteContabil/GerarLancamentosDeSaldosContabeis” (ID 662), “LoteContabil/GerarEmLote” (ID 5625).
Padrão, Rateio e Exportação
“LoteContabil/GerarLancamentoPadrao” (ID 706), “LoteContabil/SalvarLancamentoPadrao” (ID 707), “LoteContabil/NovoLoteItemComFilhos” (ID 3189), “LoteContabil/ExportarParaExcel” (ID 653), “LoteContabil/Exportar” (ID 4258).
Processo de Criação — Passo a Passo
Criar o cabeçalho do lote
O usuário informa a filial, a série do lote, o número do lote, a data do lote e, opcionalmente, um modelo de rateio e um histórico padrão para o lote inteiro. Se já existir um lote com essa mesma combinação de filial, série e número, o sistema não cria um duplicado — apenas retorna o lote já existente.
Iniciar a digitação de um lançamento
Ao abrir o lote para digitação, o sistema calcula automaticamente os dados iniciais do próximo lançamento: se for o primeiro lançamento do lote, gera uma nova chave de fato; caso contrário, reaproveita a chave de fato do lançamento anterior do mesmo lote. Também informa se a partida simples (lançamento só de débito ou só de crédito) é permitida, conforme a configuração do sistema.
Informar o lançamento (plano de contas, centro de custo, valor)
O usuário informa o plano de contas de débito e/ou de crédito, o centro de custo correspondente, o histórico padrão, o valor do lançamento e, se necessário, o rateio do débito e/ou do crédito por critério de rateio. O sistema valida a partida contábil e o preenchimento obrigatório do centro de custo antes de aceitar o lançamento (ver Regras de Negócio 1 e 2).
Repetir a digitação para os demais lançamentos do lote
O usuário repete o passo anterior para cada lançamento necessário, podendo também usar lançamentos-padrão pré-cadastrados, importar lançamentos de um arquivo Excel, ou gerar automaticamente lançamentos de zeramento/abertura de saldos contábeis.
Conferir o total de débito e crédito
Antes de finalizar, o sistema recalcula o saldo total de débito e de crédito do lote a cada alteração de item, permitindo ao usuário conferir se a partida está batendo.
Atualizar o lote
Quando o lote estiver correto, o usuário aciona a opção “Atualizar”. Essa é a operação que efetivamente transforma cada item do lote em um lançamento definitivo na Movimentação Contábil e muda o status do lote de “Digitado” para “Atualizado” (ver Regra de Negócio 3 e Processo de Edição).
Descrição de Cada Campo da Tela do Lote Contábil
Filial
Tipo: seleção (lookup)
Obrigatoriedade: obrigatório
Descrição: código da filial à qual o lote contábil pertence.
Comportamento: compõe a chave do lote junto com a série e o número.
Impacto: define para qual filial os lançamentos serão gravados na Movimentação Contábil.
Série do Lote
Tipo: texto (3 caracteres)
Obrigatoriedade: obrigatório
Descrição: código que agrupa lotes de um mesmo tipo/origem.
Comportamento: compõe a chave do lote junto com a filial e o número.
Impacto: usada em relatórios e na identificação do lote na Movimentação Contábil.
Número do Lote
Tipo: número inteiro
Obrigatoriedade: obrigatório
Descrição: número sequencial do lote dentro da série/filial.
Comportamento: o sistema sugere o próximo número disponível para a filial/série; se o número informado já existir, o lote existente é retornado em vez de criar um novo.
Impacto: compõe a chave completa do lote (Filial + Série + Número), usada em todas as demais telas que referenciam o lote.
Data do Lote
Tipo: data
Obrigatoriedade: obrigatório
Descrição: data de referência do lote contábil.
Comportamento: usada para verificar se o exercício social e o período contábil da filial estão abertos naquela data; também delimita a data-mês/ano aceita nos lançamentos individuais do lote.
Impacto: define o período contábil em que os lançamentos do lote serão registrados.
Valor do Lote
Tipo: número decimal (15,2)
Obrigatoriedade: calculado pelo sistema
Descrição: valor total do lote.
Comportamento: recalculado automaticamente conforme os itens são incluídos, editados ou excluídos.
Impacto: usado para conferência do total lançado no lote.
Status
Tipo: texto (somente leitura)
Obrigatoriedade: calculado pelo sistema
Descrição: situação atual do lote — “Digitado” (editável) ou “Atualizado” (já gerou lançamentos definitivos).
Comportamento: muda para “Atualizado” ao acionar a ação de atualização, e volta para “Digitado” ao acionar a desatualização (quando permitido).
Impacto: controla se o lote e seus itens podem ser editados, excluídos ou receber novas gerações automáticas de lançamento.
Saldo Débito / Saldo Crédito
Tipo: número decimal (15,2, somente leitura)
Obrigatoriedade: calculado pelo sistema
Descrição: soma do valor de débito e de crédito de todos os itens do lote.
Comportamento: recalculado a cada alteração nos itens do lote.
Impacto: usado para verificar se a partida contábil está fechada (débito = crédito) antes de atualizar o lote.
Modelo de Rateio (Lote)
Tipo: seleção (lookup)
Obrigatoriedade: opcional
Descrição: modelo de rateio padrão vinculado ao lote inteiro, usado como referência para o rateio dos itens.
Comportamento: informado na criação do cabeçalho do lote.
Impacto: pode ser reaproveitado ao gerar rateios de débito/crédito dos itens.
Histórico Padrão (Lote)
Tipo: seleção (lookup)
Obrigatoriedade: opcional
Descrição: histórico padrão sugerido para os lançamentos do lote.
Comportamento: informado na criação do cabeçalho do lote.
Impacto: pode ser reaproveitado como histórico padrão de cada item lançado.
Chave de Fato (item)
Tipo: texto (9 caracteres)
Obrigatoriedade: obrigatório (gerado automaticamente quando não informado)
Descrição: chave que agrupa lançamentos do mesmo fato contábil — vários itens/lançamentos podem compartilhar a mesma chave de fato.
Comportamento: no primeiro lançamento do lote, uma nova chave é gerada; nos seguintes, a chave do lançamento anterior é reaproveitada, a menos que o usuário informe outra.
Impacto: usada para agrupar os lançamentos de uma mesma operação contábil na Movimentação Contábil.
Número do Lançamento (item)
Tipo: número inteiro (somente leitura)
Obrigatoriedade: calculado pelo sistema
Descrição: número sequencial do lançamento dentro da chave de fato.
Comportamento: calculado automaticamente ao atualizar o lote, na ordem das chaves de fato dos itens.
Impacto: compõe, junto com a filial, série, número do lote e chave de fato, o identificador completo do item.
Plano de Contas Débito / Crédito
Tipo: seleção (lookup, código reduzido)
Obrigatoriedade: obrigatório para o lado que estiver sendo lançado — os dois lados juntos são obrigatórios, a menos que a partida simples esteja habilitada, quando basta um dos dois
Descrição: conta analítica do plano de contas debitada e/ou creditada pelo lançamento.
Comportamento: o sistema valida que a conta exista e, quando aplicável, resolve o centro de custo padrão vinculado à conta.
Impacto: determina em quais contas contábeis o valor do lançamento será refletido.
Centro de Custo Débito / Crédito
Tipo: seleção (lookup)
Obrigatoriedade: obrigatório quando há plano de contas de débito e/ou crédito informado e não existe centro de custo padrão configurado no sistema
Descrição: centro de custo/controle vinculado ao lançamento de débito e/ou crédito.
Comportamento: se não informado, o sistema tenta usar o centro de custo padrão configurado; se nenhum dos dois existir, a operação é bloqueada (ver Regra de Negócio 2).
Impacto: usado nos relatórios gerenciais por centro de custo.
Histórico Padrão (item)
Tipo: seleção (lookup)
Obrigatoriedade: obrigatório
Descrição: histórico padrão do lançamento, que compõe o texto explicativo exibido nos relatórios contábeis.
Comportamento: deve existir previamente cadastrado.
Impacto: aparece no extrato/razão contábil do lançamento.
Complemento do Histórico
Tipo: texto (até 150 caracteres)
Obrigatoriedade: opcional
Descrição: texto complementar livre ao histórico padrão do lançamento.
Comportamento: concatenado ao texto do histórico padrão na exibição do lançamento.
Impacto: aparece detalhando o histórico do lançamento nos relatórios.
Valor do Lançamento / Valor do Lançamento M1
Tipo: número decimal (15,2)
Obrigatoriedade: obrigatório
Descrição: valor do lançamento na moeda corrente e, quando aplicável, na moeda auxiliar (M1).
Comportamento: validado quanto à precisão (15 dígitos, 2 casas decimais); valores fora desse formato são recusados.
Impacto: soma o saldo de débito/crédito do lote e, depois da atualização, o valor lançado na Movimentação Contábil.
Número do Documento Auxiliar
Tipo: texto (10 caracteres)
Obrigatoriedade: opcional
Descrição: número de um documento auxiliar referenciado pelo lançamento (ex: nota fiscal, contrato).
Comportamento: apenas informativo, sem validação de existência.
Impacto: aparece no detalhamento do lançamento em relatórios que exibem o documento de origem.
Cadastro Geral Débito / Crédito
Tipo: seleção (lookup)
Obrigatoriedade: opcional
Descrição: pessoa/entidade (cadastro geral) vinculada ao lado de débito e/ou crédito do lançamento.
Comportamento: quando informado na importação por Excel, o sistema valida sua existência.
Impacto: usado em relatórios que cruzam lançamentos contábeis com pessoas/entidades.
Rateio de Débito / Crédito
Tipo: lista (grid interna de percentuais)
Obrigatoriedade: condicional — obrigatório quando o lançamento é rateado por critério
Descrição: detalhamento do lançamento em múltiplas linhas, cada uma com seu percentual sobre o valor total.
Comportamento: o percentual total de cada lado rateado deve somar 100% (ou 200% quando ambos os lados são rateados simultaneamente); caso contrário a operação é bloqueada (ver Regra de Negócio 8).
Impacto: distribui o valor do lançamento entre diferentes centros de custo/contas conforme o critério de rateio vinculado.
Utilização e Consulta de Registros do Lote Contábil
O usuário localiza lotes contábeis já cadastrados na listagem principal, que aceita filtros por uma ou mais filiais, número do lote, período de data (inicial e final) e tipo de lançamento, além de uma busca por texto livre. Também é possível listar lotes em formato reduzido para uso em campos de busca/autocomplete (lookup) em outras telas, e listar as séries de lote contábil disponíveis.
Dentro de um lote específico, o usuário lista os itens (lançamentos) já digitados, também com paginação e filtro de texto.
Há ainda uma tela de acompanhamento que lista, paginado, o log de execução (sucesso ou erro) das rotinas assíncronas do lote — atualização, desatualização e importação —, filtrável por filial, data do lote e tipo (Sucesso/Erro), útil para conferir o resultado de operações mais demoradas.
Processo de Edição do Lote Contábil
Enquanto o lote estiver no status “Digitado”, o cabeçalho e os itens do lote podem ser editados livremente: o usuário pode alterar dados do cabeçalho e enviar uma nova lista de itens, que substitui os itens anteriores.
Estrutura Técnica e Comportamento do Sistema do Lote Contábil
A ação de “Atualizar” o lote é a integração central desta rotina com o restante da Contabilidade: cada item vira um lançamento definitivo na Movimentação Contábil, base para todos os relatórios contábeis e para o SPED Contábil. Esse processo é feito em blocos de 50 itens por vez (para controle de performance), e gera um arquivo de log de sucesso/erro em disco a cada execução — o mesmo vale para a desatualização.
A rotina também integra com o cadastro de Exercício Social: antes de aceitar qualquer lançamento novo, o sistema verifica se há exercício social aberto para a filial e para a data informada; se o exercício estiver fechado, a inclusão é recusada.
A importação de lançamentos por arquivo Excel processa até 600 linhas por bloco de confirmação (commit parcial), dentro de uma única transação — se qualquer linha causar um erro que interrompa o processo, toda a importação é desfeita. Já a geração automática de lançamentos de zeramento e de abertura de saldos contábeis usa como fonte o balancete contábil (relatório de saldos) do mês/ano da data do lote, considerando apenas contas marcadas como aceitando lançamento — e substitui integralmente os itens já existentes no lote de destino ao ser executada.
Regras de Negócio e Restrições do Lote Contábil
Validação da partida contábil
Todo lançamento incluído ou editado passa por uma checagem de partida: se o parâmetro de sistema “Permite Partida Simples” estiver ativado, basta informar o plano de contas de débito ou de crédito; se estiver desativado, os dois lados são obrigatórios.
Centro de custo obrigatório
Sempre que um item tem plano de contas de débito e/ou crédito informado, é exigido um centro de custo correspondente — informado no item ou herdado do centro de custo padrão configurado no sistema. Sem nenhum dos dois, a operação é bloqueada.
Ciclo de vida do lote (status)
Um lote nasce no status “Digitado” (editável, excluível). Ao ser “Atualizado”, seus itens são replicados como lançamentos definitivos na Movimentação Contábil e o lote passa a ser bloqueado para edição, exclusão e demais operações de geração/importação de itens. A única forma de reverter é a Desatualização, permitida apenas se o período contábil do último lançamento ainda estiver aberto.
Exercício social fechado impede novos lançamentos
Antes de calcular os dados iniciais de um novo lançamento (ou de salvar um lançamento-padrão), o sistema verifica se existe exercício social aberto para a filial e a data.
Condições para atualizar o lote
A atualização exige, nesta ordem: (1) que o período contábil da data do lote esteja aberto; (2) que o lote esteja no status “Digitado”; (3) que o total de débito seja igual ao total de crédito; (4) que o lote não tenha sido alterado por outra sessão desde a última leitura.
Condições para desatualizar o lote
A desatualização exige que o lote esteja no status “Atualizado” e que o período contábil do último lançamento do lote ainda esteja aberto.
Geração automática de zeramento e de saldos contábeis
Ambas as rotinas usam a mesma fonte de dados (o balancete contábil do mês/ano da data do lote) e o mesmo critério de inclusão (contas marcadas como “Aceita Lançamento”). No zeramento, o saldo da conta é transferido para a conta de transferência (zerando a conta original); na geração de saldos, o valor é transferido da conta de transferência para a conta de saldo (abrindo o saldo no novo período). Contas com saldo zero são ignoradas, e a operação substitui integralmente os itens já existentes no lote informado. Ambas são bloqueadas se o lote já estiver “Atualizado” (mesma mensagem da Regra 3).
Percentual de rateio deve somar 100%
Quando há rateio de débito e/ou crédito informado, o percentual total de cada lado deve somar 100% (ou 200%, quando os dois lados são rateados simultaneamente).
Importação de lançamentos via Excel — validações em cascata
A planilha aceita 15 colunas (padrão) ou 16 (com razão auxiliar). Cada linha é validada nesta ordem: filial da linha deve ser igual à filial do lote; chave de fato deve ter 9 caracteres (gerada automaticamente quando ausente); combinações de chave de fato + número de lançamento não podem se repetir dentro do próprio arquivo; código de plano de contas de débito e crédito são obrigatórios (a menos que a partida simples esteja habilitada); os planos de contas informados devem existir; os centros de custo informados devem ser numéricos e existir; o histórico padrão deve existir; a data do lançamento (quando informada) deve estar no mesmo mês/ano da data do lote; o valor deve ser numérico e maior que zero; os cadastros gerais de crédito/débito informados devem existir. A primeira validação que falhar interrompe a importação inteira, dentro de uma única transação de banco.
Aplicação de lançamento-padrão
Ao salvar um lançamento-padrão dentro de um lote, o sistema exige filial e série do lote informadas, e exercício social aberto para a filial na data do lote. Somente os itens com valor de lançamento maior que zero são efetivamente importados para o lote — os demais aparecem em um relatório de “não importados” retornado ao usuário.
Geração de lotes vazios em lote
Ao gerar vários lotes vazios de uma só vez para um período, o sistema bloqueia a geração se já existir algum lote para a filial/série/data inicial informada. O número de cada novo lote é derivado da própria data, garantindo um número diferente por dia dentro do período; datas que já têm lote existente são automaticamente puladas, sem duplicidade.
Código inválido na busca de item
Ao buscar um item específico do lote, se o código informado não contiver o separador esperado entre as partes da chave, a busca é rejeitada.
