Exportação para Excel
Criado por Igor Ribeiro em 14 de novembro de 2025
Atualizado por Igor Ribeiro em 03 de setembro de 2026
Exportação para Excel
Módulo Contabilidade — ferramenta genérica que exporta o resultado de um relatório contábil já existente (Razão Contábil, Balanço, Balancete, DRE etc.) diretamente para uma planilha Excel editável, com colunas, ordenação e agrupamento escolhidos pelo usuário — em vez do layout fixo em PDF do relatório original.
Visão Geral da Exportação para Excel
A rotina “Exportação para Excel” (Contabilidade > Exportação para Excel) permite ao usuário escolher um dos relatórios contábeis já existentes no sistema (por exemplo, WRCTD001 – Razão Contábil, WRCTD003 – Balanço Patrimonial, WRCTD004 – Balancete de Verificação ou WRCTD005 – DRE) e obter o mesmo conjunto de dados desse relatório em formato de planilha Excel, em vez do PDF gerado pelo Crystal Reports. O grande diferencial é a flexibilidade: o usuário escolhe quais colunas aparecem, em que ordem os registros são exibidos e por qual campo o resultado deve ser agrupado.
Vídeo Tutorial da Exportação para Excel
Pré-requisitos e Contexto de Acesso da Exportação para Excel
O acesso é gerenciado através do menu Contabilidade, disponível como “Exportação para Excel”. É necessário que já existam dados lançados no sistema compatíveis com o relatório escolhido como Modelo (por exemplo, lançamentos contábeis para o Razão Contábil, saldos apurados para o Balanço).
Processo de Exportação — Passo a Passo
Acessar a rotina
O usuário acessa “Contabilidade > Exportação para Excel”.
Selecionar o Modelo
O usuário escolhe, na lista “Modelo”, qual relatório contábil já existente servirá de base para a exportação (ex.: WRCTD001 – Livro razão contábil, WRCTD003 – Balanço patrimonial encerrado, WRCTD004 – Relatório de balancete de verificação, WRCTD005 – Demonstração de resultado do exercício).
Escolher as colunas
O sistema carrega automaticamente a lista de colunas disponíveis para o Modelo escolhido, já com um conjunto padrão pré-selecionado, e o usuário marca/desmarca quais colunas devem sair na planilha.
Definir ordenação e agrupamento (opcional)
O usuário pode informar por qual(is) coluna(s) o resultado deve ser ordenado (“Ordenar por”) e por qual coluna os registros devem ser agrupados em blocos na planilha (“Agrupar por”).
Preencher os parâmetros do relatório escolhido
A área “Configuração de parâmetro” exibe os mesmos filtros do relatório original selecionado como Modelo (filial, período, faixa de contas etc., conforme o relatório).
(Opcional) Salvar a configuração com um apelido
Para não precisar reconfigurar colunas, ordenação e agrupamento toda vez, o usuário pode digitar um “Apelido para configuração” (sem espaços em branco) e clicar em “Salvar configuração”, ficando disponível para reutilização nas próximas exportações desse mesmo Modelo.
Exportar e baixar
O usuário clica em “Exportar Excel”. O sistema consulta, ordena, agrupa e monta a planilha; se houver dados, disponibiliza o arquivo para download.
Descrição de Cada Campo da Tela da Exportação para Excel
Modelo
Tipo: lista de seleção
Obrigatoriedade: obrigatório
Descrição: relatório contábil já existente que será usado como base de dados e de filtros da exportação.
Comportamento: ao selecionar, o sistema identifica a classe do relatório correspondente pelo nome do modelo e recarrega a lista de colunas e de parâmetros disponíveis.
Impacto: define quais dados, colunas e filtros ficam disponíveis nos passos seguintes.
Colunas
Tipo: lista de seleção múltipla
Obrigatoriedade: obrigatório (ao menos uma)
Descrição: campos do relatório selecionado que serão incluídos como colunas na planilha exportada.
Comportamento: a lista é obtida automaticamente a partir da estrutura de dados do relatório escolhido; um subconjunto já vem marcado por padrão. Colunas cujo conteúdo estiver totalmente vazio em todos os registros retornados são removidas automaticamente da planilha final, mesmo que estejam marcadas.
Impacto: define as colunas (e a ordem delas) na planilha gerada.
Ordenar por
Tipo: seleção de coluna(s)
Obrigatoriedade: opcional
Descrição: coluna (ou colunas, em ordem de prioridade) usada para ordenar os registros antes de montar a planilha.
Comportamento: quando mais de uma coluna é informada, a ordenação é aplicada em cascata (a primeira manda, a segunda desempata, e assim por diante); o sistema tenta interpretar o valor como número ou data antes de tratar como texto.
Impacto: define a sequência das linhas na planilha.
Agrupar por
Tipo: seleção de coluna(s)
Obrigatoriedade: opcional
Descrição: coluna (ou colunas, em cascata) usada para agrupar os registros em blocos visuais na planilha.
Comportamento: cada valor distinto da coluna de agrupamento gera uma linha de cabeçalho destacada na planilha, com os registros daquele grupo logo abaixo; é possível agrupar por mais de uma coluna, criando subgrupos.
Impacto: organiza visualmente a planilha e, para colunas numéricas marcadas como totalizadoras, soma o valor ao final de cada grupo.
Utilização e Consulta de Registros da Exportação para Excel
Não há uma grid de consulta própria de “registros” — a rotina apenas consulta os dados do relatório escolhido como Modelo (usando os mesmos parâmetros de filtro daquele relatório) e os entrega em Excel. O que pode ser consultado e reaproveitado são as configurações salvas anteriormente: ao informar novamente o Apelido de uma configuração já salva, o sistema recarrega as colunas, a ordenação e o agrupamento gravados.
Processo de Edição da Exportação para Excel
Não se aplica edição de dados contábeis — a rotina apenas lê informações já lançadas em outras partes do sistema. A única coisa “editável” aqui são as configurações salvas de exportação (colunas, ordenação e agrupamento sob um apelido), que podem ser removidas pelo botão “Excluir configuração”.
Estrutura Técnica e Comportamento do Sistema da Exportação para Excel
Ao selecionar um Modelo, o sistema localiza dinamicamente (analisando o nome informado) a estrutura de dados do relatório original correspondente e chama exatamente o mesmo método de consulta de dados usado para gerar o PDF daquele relatório — reaproveitando também a mesma lista de parâmetros de filtro. Ou seja, os dados e os filtros exibidos aqui são sempre idênticos aos do relatório em PDF equivalente; só a forma de entrega muda (Excel configurável, em vez de PDF fixo).
A lista de colunas disponíveis também é obtida automaticamente: para o modelo WRCTD001 (Razão Contábil), usa uma estrutura de dados específica desse relatório; para os demais modelos suportados, usa uma estrutura genérica de saldo contábil compartilhada entre eles.
O arquivo Excel é montado usando tecnologia de geração de arquivo Excel: os registros são primeiro ordenados, depois agrupados recursivamente (permitindo múltiplos níveis de agrupamento), e então escritos em uma única planilha, com linhas de cabeçalho de grupo destacadas visualmente e uma linha de soma ao final de cada grupo para colunas numéricas marcadas como totalizadoras. Colunas sem nenhum valor preenchido em todo o resultado e linhas totalmente vazias são removidas antes de salvar o arquivo, gravado em uma pasta de arquivos gerados do servidor de aplicação.
Regras de Negócio e Restrições da Exportação para Excel
Os dados e filtros são sempre os do relatório original
A exportação não tem consulta própria: ela executa a mesma busca de dados e usa os mesmos parâmetros de filtro do relatório selecionado como Modelo. Qualquer regra de negócio de apuração daquele relatório (ex.: fechamento de período exigido, contas incluídas) continua valendo aqui.
Projeção de colunas depende do modelo
O conjunto de colunas disponíveis para seleção varia conforme o Modelo escolhido: o WRCTD001 (Razão Contábil) tem sua própria lista de campos; os demais modelos suportados compartilham uma lista de colunas genérica de saldo contábil.
Colunas vazias são removidas automaticamente
Mesmo que uma coluna esteja marcada para exportação, se todos os registros retornados tiverem esse campo vazio, a coluna não aparece na planilha final.
Agrupamento gera totais automáticos
Quando um agrupamento é aplicado, colunas numéricas marcadas internamente como “totalizadoras” recebem uma linha de soma ao final de cada grupo, em negrito e formatada como número.
Sem colunas com dado, o arquivo não é gerado
Se, depois de remover as colunas totalmente vazias, não sobrar nenhuma coluna válida (ou não houver dados no filtro informado), o sistema não grava o arquivo Excel.
Configurações salvas são por usuário e por rotina
O apelido de uma configuração salva (colunas, ordenação, agrupamento) fica vinculado ao usuário que a criou e ao Modelo/rotina usada — outro usuário, ou o mesmo usuário em outro Modelo, não enxerga essa configuração salva.
