Lançamentos Contábeis
Criado por Igor Ribeiro em 14 de novembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Lançamentos Contábeis
Módulo Contabilidade > Geração Arquivos — extração para planilha Excel (.xlsx) de todos os lançamentos contábeis (débitos e créditos) de um período e conjunto de filiais escolhidos.
Visão Geral dos Lançamentos Contábeis
A rotina “Lançamentos Contábeis”, localizada no módulo Contabilidade, dentro do grupo de menu “Contabilidade > Geração Arquivos > Lançamentos Contábeis”, permite ao usuário extrair para uma planilha Excel (.xlsx) todos os lançamentos contábeis (débitos e créditos) de um período e de um conjunto de filiais escolhidos. É uma ferramenta de extração/exportação de dados: ela não altera nenhum lançamento já registrado, apenas gera um arquivo para download com as informações já existentes no sistema.
Vídeo Tutorial dos Lançamentos Contábeis
Pré-requisitos e Contexto de Acesso dos Lançamentos Contábeis
Para visualizar e abrir a janela “Lançamentos Contábeis”, o usuário precisa ter o perfil vinculado à permissão de visualizar e exportar lançamentos contábeis. Para efetivamente clicar em “Exportar Excel” e gerar o arquivo, é necessária a permissão de exportar lançamentos contábeis para Excel — as duas permissões estão registradas separadamente, então é possível (embora não usual) um usuário ter acesso à janela sem poder concluir a exportação.
Processo de Exportação — Passo a Passo
Esta rotina não cadastra registros novos — ela gera um arquivo a partir de dados já existentes. O fluxo de uso é:
Abrir a janela de exportação
O usuário acessa “Contabilidade > Geração Arquivos > Lançamentos Contábeis”. O sistema abre a janela “Exportar Lançamentos Contábeis”, com a filial do usuário logado já pré-selecionada no campo de filiais.
Informar o período e as filiais
O usuário informa a data inicial e a data final do período desejado e seleciona uma ou mais filiais.
Escolher a opção de código do plano de contas
O usuário escolhe se a planilha deve trazer o código estruturado normal do plano de contas ou o código de referencial contábil (usado em obrigações acessórias).
Solicitar a exportação
O usuário clica em “Exportar Excel”. O sistema valida os campos preenchidos e, se estiverem corretos, processa a exportação.
Baixar o arquivo gerado
Quando o processamento termina com sucesso, o sistema exibe o nome do arquivo em um botão de download na própria janela; o usuário clica nesse botão para abrir/baixar a planilha gerada.
Descrição de Cada Campo da Tela dos Lançamentos Contábeis
Filiais
Tipo: seleção múltipla
Obrigatoriedade: obrigatório
Descrição: uma ou mais filiais cujos lançamentos contábeis serão incluídos na exportação.
Comportamento: já vem pré-selecionado com a filial do usuário logado ao abrir a janela; o usuário pode adicionar outras filiais.
Impacto: somente lançamentos das filiais selecionadas entram no arquivo gerado.
Data Inicial
Tipo: data
Obrigatoriedade: obrigatório
Descrição: data inicial do intervalo de lançamentos contábeis a exportar.
Comportamento: validado pelo formulário antes do envio; se algum campo obrigatório não estiver preenchido corretamente, o sistema exibe o aviso “Preencha os campos corretamente!” e não envia a exportação.
Impacto: somente lançamentos com data de lançamento igual ou posterior a esta data entram no arquivo.
Data Final
Tipo: data
Obrigatoriedade: obrigatório
Descrição: data final do intervalo de lançamentos contábeis a exportar.
Comportamento: validado junto com a data inicial antes do envio.
Impacto: somente lançamentos com data de lançamento igual ou anterior a esta data entram no arquivo.
Opção de plano de contas
Tipo: seleção
Obrigatoriedade: obrigatório
Descrição: define se a planilha trará o código contábil estruturado “normal” das contas de débito/crédito ou o código de Plano de Contas Referencial (usado para obrigações acessórias, como o SPED Contábil).
Comportamento: quando a opção de código referencial é escolhida, o sistema verifica antes de gerar o arquivo se todas as contas usadas nos lançamentos do período possuem referencial cadastrado (ver Regra de Negócio 2).
Impacto: altera quais colunas da planilha são preenchidas (código reduzido/estruturado versus código de referencial) e pode bloquear a geração do arquivo se faltar referencial em alguma conta.
Botão “Exportar Excel”
Tipo: botão de ação
Obrigatoriedade: não se aplica
Descrição: dispara o processamento da exportação com os filtros informados.
Comportamento: exibe uma mensagem de “Exportando… Por favor, aguarde o fim do processo” enquanto o arquivo é gerado no servidor.
Impacto: ao concluir, atualiza o botão “Baixar arquivo gerado” com o caminho do arquivo, ou exibe uma mensagem de aviso/erro conforme o resultado.
Botão “Baixar arquivo gerado”
Tipo: botão de ação
Obrigatoriedade: não se aplica
Descrição: exibe o caminho do arquivo Excel gerado e, ao ser clicado, abre/baixa esse arquivo.
Comportamento: só fica com um caminho preenchido depois de uma exportação concluída com sucesso.
Impacto: é o único ponto de acesso ao arquivo gerado dentro da própria janela.
Utilização e Consulta de Registros dos Lançamentos Contábeis
Esta rotina não possui uma grid de consulta de registros próprios — ela apenas gera um arquivo a partir dos lançamentos contábeis já existentes, filtrados por período e filiais. Não há filtro adicional além de período, filiais e opção de código do plano de contas.
Processo de Edição dos Lançamentos Contábeis
Esta rotina não permite edição de nenhum registro. Ela apenas lê os lançamentos contábeis já existentes (gerados por outras rotinas de lançamento) e os exporta para uma planilha Excel; nenhuma informação é alterada no banco de dados durante o processo.
Estrutura Técnica e Comportamento do Sistema dos Lançamentos Contábeis
A exportação lê diretamente os lançamentos contábeis já lançados no sistema (débito e crédito, com suas respectivas contas do Plano de Contas e centros de custo) e grava o arquivo gerado em uma pasta de exportação do servidor de aplicação, disponibilizando-o para download via link. Não há nenhuma integração automática com estoque, documento fiscal ou outros módulos — a rotina apenas lê e formata dados contábeis já consolidados.
Regras de Negócio e Restrições dos Lançamentos Contábeis
Filtro de lançamentos considerados
Somente entram na exportação os lançamentos contábeis cuja data esteja dentro do período informado (Data inicial a Data final), cuja filial esteja entre as selecionadas, e que não sejam do tipo “extemporâneo”.
Bloqueio quando falta código de referencial em alguma conta
Se o usuário escolher a opção de “código de referencial” e existir alguma conta de débito ou crédito, entre os lançamentos filtrados, sem código de Plano de Contas Referencial cadastrado, o sistema não gera o arquivo e informa quais contas estão sem referencial (até 10 contas, indicando que há mais caso existam).
Bloqueio quando não há nenhum lançamento no filtro informado
Se, com o período e as filiais informados, não existir nenhum lançamento contábil, o sistema não gera o arquivo.
Substituição de arquivo anterior com o mesmo filtro
Antes de salvar o novo arquivo, o sistema tenta excluir, na pasta de exportação do servidor, qualquer arquivo anterior gerado com o mesmo nome-base (mesma combinação de filiais, período e opção de plano de contas). Essa exclusão é feita em modo “melhor esforço”: se falhar por qualquer motivo, o sistema segue adiante e grava o novo arquivo normalmente.
Falha ao salvar o arquivo no servidor
Se ocorrer um erro ao gravar o arquivo físico no servidor (ex: problema de permissão de disco), o sistema não informa o motivo técnico ao usuário; a tela exibe apenas o aviso genérico “Falha ao tentar exportar o arquivo.”
