Relatórios

Exportação para Excel

Documentação Técnica 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. 01 — VISÃO GERAL Visão Geral da Rotina 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. Reaproveita o mesmo relatório e os mesmos filtros Internamente, esta rotina não tem lógica própria de apuração de dados: ao selecionar um Modelo, o sistema localiza o tipo do relatório original correspondente (o mesmo tipo usado para gerar o PDF) e executa exatamente a mesma consulta, com os mesmos parâmetros de filtro daquele relatório. A “Exportação para Excel” é, na prática, uma segunda forma de saída para relatórios que já existem, não um relatório novo. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Exportação para Excel ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Exportação para Excel O acesso é controlado pelo recurso “RelatorioGenericoContabilidade” (ID 50382), vinculado ao menu Contabilidade com o nome “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). Nem todo relatório está disponível como Modelo Apenas relatórios contábeis cuja classe de consulta segue o padrão reconhecido pela rotina (derivada de uma classe base comum de relatório, localizável pelo nome do modelo informado) aparecem como opção — não é qualquer relatório do sistema que pode ser exportado por aqui. 04 — PASSO A PASSO Processo de Exportação — Passo a Passo 1 Acessar a rotina O usuário acessa “Contabilidade > Exportação para Excel”. 2 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). 3 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. 4 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”). 5 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). 6 (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. 7 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. 05 — CAMPOS DA TELA 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 o tipo 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 por reflexão sobre a 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. 06 — CONSULTA DE REGISTROS 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. 07 — EDIÇÃO Processo de Edição da Exportação para Excel Não se aplica edição de dados contábeis —

Razão Auxiliar – Financeiro x Contábil

Documentação Técnica Razão Auxiliar – Financeiro x Contábil (Conciliação) Rotina do módulo Contabilidade que compara, em um período/data-base e para um conjunto de filiais, os saldos lançados no Financeiro com os saldos lançados na Contabilidade, para identificar divergências antes do fechamento contábil. 01 — VISÃO GERAL Visão Geral da Razão Auxiliar – Financeiro x Contábil A rotina “Razão Auxiliar – Financeiro x Contábil” (Conciliação) pertence ao módulo Contabilidade e serve para comparar, em um período/data-base e para um conjunto de filiais, os saldos lançados no módulo Financeiro (títulos a pagar e a receber, por cadastro/participante) com os saldos lançados na Contabilidade (razão auxiliar/movimentação contábil por conta patrimonial). O objetivo é identificar divergências entre os dois módulos antes do fechamento contábil. O que a tela oferece A tela apresenta um resumo agrupado por cadastro e por conta patrimonial, permite detalhar os lançamentos de origem (financeiro e contábil) de cada cadastro, isolar apenas os registros divergentes (“com erro”) e exportar o resultado para Excel. Esta rotina não cadastra, edita nem exclui registros próprios — é uma ferramenta de consulta e conferência. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Razão Auxiliar – Financeiro x Contábil ▶ 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 – Financeiro x Contábil O acesso a toda a rotina (consulta, detalhamentos e exportação) é controlado por uma única permissão: “EditViewDeConciliacaoFinanceiroContabil” (ID 1874), cadastrada no menu “Contabilidade > Conciliação > Razão Auxiliar – Financeiro x Contábil” (grupo de menu ID 1873). Apesar do prefixo “EditView” no nome da permissão (diferente do padrão “ListView” usado na maioria das demais rotinas do módulo), esta é a única permissão registrada para a tela e cobre tanto a visualização quanto a interação com o grid — não existem permissões granulares próprias para nenhuma ação desta rotina, inclusive a exportação para Excel. Pré-requisito de negócio Quando a opção “considera saldo anterior” está marcada e há filiais selecionadas, o período contábil do mês anterior à data-base consultada precisa estar fechado em todas as filiais informadas — do contrário a consulta é bloqueada (ver seção 9, Regra 1). 04 — PASSO A PASSO Processo de Utilização — Passo a Passo Esta rotina não possui processo de criação de registro — não existe uma ação de cadastro (“Novo”) nesta tela. A “criação” equivalente é a execução da consulta de conciliação. 1 Abrir a tela de Conciliação Financeiro x Contábil O sistema recupera automaticamente os últimos filtros usados pelo usuário logado (filiais, tipos de cadastro, cadastro inicial e data), gravados na sessão anterior. Se o usuário nunca usou a tela, o sistema pré-preenche apenas a filial logada e a data de movimentação corrente do usuário, deixando os demais filtros em branco. 2 Informar ou ajustar os filtros da consulta O usuário define a data-base, as filiais, os tipos de cadastro, um cadastro específico (opcional), se deve considerar o saldo anterior, o tipo de lançamento a considerar (somente corretos, somente incorretos ou todos) e, opcionalmente, uma conta contábil/patrimonial específica ou grupos econômicos. 3 Executar a consulta resumida O sistema retorna a listagem agrupada por cadastro e, dentro de cada cadastro, por conta patrimonial, mostrando o saldo financeiro, o saldo contábil e a diferença entre eles. Como efeito colateral, os filtros usados são gravados como preferência do usuário para a próxima abertura da tela (ver seção 9, Regra 2). 4 Detalhar um cadastro específico Ao selecionar um cadastro no grid resumido, o usuário pode consultar o detalhamento dos lançamentos financeiros que compõem aquele saldo, o detalhamento dos lançamentos contábeis correspondentes, ou apenas os lançamentos que não batem entre os dois módulos (“com erro”). 5 Exportar o resultado, se necessário O usuário pode gerar um arquivo Excel com o resumo da conciliação para análise fora do sistema. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da Razão Auxiliar – Financeiro x Contábil Filiais Tipo: seleção múltipla (lista de códigos de filial) Obrigatoriedade: opcional — se vazio, a consulta considera todas as filiais Descrição: filiais cujos saldos financeiro e contábil serão comparados. Comportamento: quando a opção “Considera Saldo Anterior” está marcada, cada filial informada é individualmente verificada quanto ao fechamento do período contábil anterior (ver seção 9, Regra 1). Impacto: restringe tanto o saldo financeiro (títulos) quanto o saldo contábil (razão) considerados na comparação. Tipos de Cadastro Tipo: seleção múltipla (lista de tipos de cadastro, ex: cliente, fornecedor) Obrigatoriedade: opcional Descrição: tipos de cadastro (participantes) a considerar na consulta. Comportamento: filtra quais cadastros aparecem no grid resumido. Impacto: usado também na exportação para Excel para restringir os cadastros exportados. Data Tipo: data Obrigatoriedade: obrigatório Descrição: data-base da conciliação — corresponde ao fim do período que está sendo analisado. Comportamento: define o corte temporal usado para calcular os saldos financeiro e contábil finais; junto com “Considera Saldo Anterior”, determina se o saldo do mês anterior é somado. Impacto: usada também para verificar se o período contábil anterior está fechado (ver seção 9, Regra 1). Cadastro Tipo: seleção (autocomplete de cadastro/participante, formato “código-nome”) Obrigatoriedade: opcional na consulta resumida; obrigatório nos detalhamentos por cadastro Descrição: cadastro (participante) específico a analisar. Comportamento: na consulta resumida, funciona como filtro adicional; nos detalhamentos (financeiro, contábil e divergências), é obrigatório informar o cadastro cujos lançamentos serão exibidos. Impacto: determina de qual participante virão os lançamentos exibidos no detalhamento. Considera Saldo Anterior Tipo: seleção (Sim/Não — padrão “Sim”) Obrigatoriedade: opcional (assume “Sim” quando não informado) Descrição: define se o saldo do período anterior à data-base deve ser somado ao saldo do período corrente, tanto no lado financeiro quanto no lado contábil. Comportamento: quando marcado como “Sim”, exige que o período contábil anterior esteja fechado nas filiais selecionadas (ver seção 9, Regra 1); também inclui uma linha de “Saldo Anterior” nos detalhamentos. Impacto: altera o valor de “Saldo Final” exibido em todas as consultas desta rotina. Tipo de Lançamento (opção) Tipo: seleção (Somente Corretos / Somente Incorretos / Todos — padrão “Somente Incorretos”) Obrigatoriedade: opcional Descrição: filtra o resultado da consulta resumida e da exportação

Conciliação

Documentação Técnica Conciliação Módulo Contabilidade — rotinas de conferência entre módulos e de exportação de dados contábeis já lançados, usadas para validar a consistência da informação antes do fechamento. VISÃO GERAL O que o sistema faz A área de Conciliação reúne, de um lado, a rotina que confronta os saldos do módulo Financeiro com os saldos já lançados na Contabilidade (para localizar divergências antes do fechamento) e, de outro, ferramentas de exportação: uma genérica, para tirar qualquer relatório contábil em Excel configurável, e uma central de relatórios oficiais/gerenciais em PDF. ROTINAS DESTA ÁREA Conferência e Exportação Razão Auxiliar – Financeiro x Contábil Compara, para um período/data-base e um conjunto de filiais, os saldos lançados no Financeiro (títulos a pagar e a receber, por participante) com os saldos lançados na Contabilidade (razão auxiliar por conta patrimonial), destacando as divergências entre os dois módulos antes do fechamento contábil. Exportação para Excel Ferramenta genérica que reaproveita qualquer um dos relatórios contábeis já existentes (Razão Contábil, Balanço, Balancete, DRE etc.) e entrega o mesmo resultado em planilha Excel, com colunas, ordenação e agrupamento escolhidos pelo usuário, em vez do layout fixo em PDF do relatório original. Relatórios Central dos relatórios oficiais e gerenciais em PDF gerados via Crystal Reports: Razão Contábil, Diário Contábil, Balanço Patrimonial, Balancete de Verificação, DRE (mensal, anual e trimestral), Conferência de Lote Contábil (detalhado e sintético) e Orçamento por Pacote de Gastos. PRÉ-REQUISITOS GERAIS Contexto de Acesso O acesso a cada rotina é controlado por uma permissão própria, vinculada ao menu do módulo Contabilidade. Todas trabalham em cima de dados já lançados em outras rotinas (lançamentos financeiros, lançamentos contábeis, saldos apurados) — nenhuma delas cadastra, edita ou exclui registros próprios.

Lançamentos Contábeis

Documentação Técnica 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. 01 — VISÃO GERAL Visão Geral da Rotina 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. 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 de Lançamentos Contábeis Para visualizar e abrir a janela “Lançamentos Contábeis”, o usuário precisa ter o perfil vinculado à permissão “EditViewDeExportacaoDeLanctosContabeis” (ID 1846). Para efetivamente clicar em “Exportar Excel” e gerar o arquivo, é necessária a permissão “MovimentacaoContabil/ExportarLancamentosContabeisParaExcel” (ID 1847) — 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. Sem cadastro prévio obrigatório Não há cadastro prévio obrigatório para usar esta rotina, além de já existirem lançamentos contábeis no período desejado. 04 — PASSO A PASSO 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 é: 1 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. 2 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. 3 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). 4 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. 5 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. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela de 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. 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros de 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. 07 — EDIÇÃO Processo de Edição de 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. 08 — ESTRUTURA TÉCNICA Estrutura Técnica e Comportamento do Sistema de 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. 09 — REGRAS DE NEGÓCIO Regras de Negócio e Restrições de Lançamentos Contábeis

Razão Auxiliar – Implantação de Saldo

Documentação Técnica Razão Auxiliar – Implantação de Saldo Módulo Contabilidade > Geração Arquivos — identifica títulos de contas a pagar/receber sem conta contábil patrimonial vinculada, corrige essa vinculação (automática ou manual) e exporta o saldo consolidado em CSV para implantação do razão auxiliar contábil. 01 — VISÃO GERAL Visão Geral do Razão Auxiliar – Implantação de Saldo A rotina “Razão Auxiliar – Implantação de Saldo”, disponível em Contabilidade > Geração Arquivos > Razão Auxiliar – Implantação de saldo, ajuda o usuário a identificar títulos de contas a pagar e a receber que ainda não têm uma conta contábil patrimonial vinculada e a corrigir essa vinculação — automaticamente, quando o sistema encontra uma correspondência confiável no histórico contábil, ou manualmente, quando o usuário precisa decidir qual conta aplicar. Consolidação e exportação Depois que os títulos estão com a conta patrimonial correta, o sistema consolida os saldos por conta e permite exportar esse resultado em um arquivo CSV, usado para implantar o saldo do razão auxiliar contábil. 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 do Razão Auxiliar – Implantação de Saldo Para acessar a tela, o usuário precisa ter a permissão “EditViewDeGeracaoDeRazaoAuxiliar” concedida ao seu perfil. Cada ação dentro da tela também exige uma permissão própria: exportar o CSV, listar o consolidado completo, listar por conta, listar os erros, corrigir automaticamente e corrigir manualmente são liberados individualmente — ou seja, um perfil pode, por exemplo, visualizar os erros sem poder corrigi-los. Sem cadastro prévio obrigatório Não há uma etapa de cadastro prévio obrigatória para usar a rotina: ela trabalha em cima de títulos de contas a pagar/receber e lançamentos financeiros já existentes no sistema. 04 — PASSO A PASSO Processo de Correção — Passo a Passo Esta rotina não cadastra um novo registro; ela processa e corrige a vinculação contábil de títulos já existentes. O fluxo de uso segue estes passos: 1 Informar os filtros de período e escopo O usuário informa a filial e a data-base a partir da qual o sistema deve considerar os lançamentos financeiros no cálculo do saldo retroativo. Opcionalmente, pode refinar por código do fato, tipo de movimento, tipo de cadastro, participante (cliente/fornecedor) ou código contábil. 2 Consultar os títulos pendentes de vinculação O usuário acessa a lista de erros (ação “Listar Erros”) para ver quais títulos ainda não possuem conta patrimonial confirmada. O sistema sinaliza, por indicadores, se existem títulos totalmente sem sugestão, com sugestão automática pendente de confirmação, ou já válidos. 3 Corrigir automaticamente Para os títulos em que o sistema já encontrou uma conta contábil sugerida (por bater valor e histórico de lançamento com o razão contábil já existente), o usuário executa a correção automática. O sistema grava a conta sugerida diretamente no título. 4 Corrigir manualmente os casos restantes Para os títulos sem nenhuma sugestão automática, o usuário localiza-os pelo filtro de busca, escolhe manualmente o código do plano de contas correto e aplica essa conta a todos os títulos filtrados de uma só vez. 5 Consultar o consolidado e exportar Com os títulos corrigidos, o usuário consulta o saldo consolidado por conta (ação “Listar por Conta”) e, quando estiver satisfeito, exporta o arquivo CSV com o saldo final para implantação do razão auxiliar. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela do Razão Auxiliar – Implantação de Saldo Filial Tipo: seleção Obrigatoriedade: obrigatório Descrição: código da filial (empresa) para a qual o saldo do razão auxiliar está sendo apurado. Comportamento: restringe todas as consultas e a exportação a essa filial. Impacto: usado como filtro em todas as consultas SQL de apuração de saldo e no nome do arquivo CSV gerado. Data-base Tipo: data Obrigatoriedade: obrigatório Descrição: data retroativa a partir da qual o sistema soma os lançamentos financeiros para calcular o saldo do título. Comportamento: todo lançamento financeiro posterior a essa data entra no cálculo do saldo retroativo do título. Impacto: afeta diretamente o valor de saldo mostrado nas listagens e exportado no CSV. Código do Fato / TMV / Tipo de Cadastro / Participante / Código Contábil Tipo: texto/autocomplete Obrigatoriedade: opcional Descrição: filtros opcionais — código do fato gerador de estoque, tipo de movimento de estoque relacionado, tipo de cadastro do participante (cliente/fornecedor), código do participante, ou código reduzido da conta contábil (busca por trecho). Comportamento: cada filtro, quando preenchido, restringe a consulta aos títulos que atendem ao critério correspondente. Impacto: reduzem o volume de registros nas listagens e na exportação. Busca (valor de consulta) Tipo: texto Obrigatoriedade: opcional Descrição: campo de busca livre usado nas listagens (completo, por conta e de erros) para localizar registros por data, código de participante ou início do nome/código de plano, participante ou tipo de cadastro. Comportamento: o sistema detecta automaticamente se o valor digitado é uma data, um número (código de participante) ou um texto, e aplica o filtro correspondente. Impacto: afeta apenas a listagem em tela — não altera o cálculo do saldo em si. Código do Plano de Contas (correção manual) Tipo: texto/autocomplete Obrigatoriedade: obrigatório (somente na correção manual) Descrição: código do plano de contas que o usuário decide aplicar aos títulos ainda sem vinculação automática. Comportamento: ao confirmar, o sistema grava esse código como a conta patrimonial de todos os títulos que atendem ao filtro de busca informado, em lotes internos de até 50 títulos por vez. Impacto: passa a valer como a conta contábil patrimonial do(s) título(s) corrigido(s), refletindo nas listagens e na exportação do CSV. 06 — CONSULTA DE REGISTROS Utilização e Consulta de Registros do Razão Auxiliar – Implantação de Saldo O usuário consulta os títulos de três formas: (1) “Listar Completo”, mostrando cada título individualmente já com conta vinculada; (2) “Listar por Conta”, mostrando o saldo somado por conta contábil e participante — o mesmo agrupamento que sai no CSV; e (3) “Listar Erros”, mostrando apenas os títulos ainda sem vinculação confirmada. Em todas, o campo de busca livre aceita data, código de participante ou início

Geração Arquivos

Documentação Técnica Geração Arquivos Módulo Contabilidade — rotinas de exportação e correção de dados que geram arquivos a partir de informações já existentes no sistema, sem alterar lançamentos contábeis. VISÃO GERAL O que o sistema faz A área de Geração Arquivos reúne rotinas que produzem arquivos (Excel ou CSV) a partir de dados já lançados no sistema, para uso em conferência externa ou em processos de implantação. Uma delas apenas extrai dados já corretos; a outra primeiro identifica e corrige vinculações contábeis pendentes antes de gerar o arquivo final. ROTINAS DESTA ÁREA Rotinas de Exportação Lançamentos Contábeis Extrai 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, com a opção de trazer o código estruturado normal do plano de contas ou o código de referencial contábil (usado em obrigações acessórias como o SPED Contábil). É uma ferramenta de extração pura: não altera nenhum lançamento já registrado. Razão Auxiliar – Implantação de Saldo Identifica títulos de contas a pagar e a receber que ainda não têm uma conta contábil patrimonial vinculada, sugere automaticamente a conta mais provável (com base no histórico contábil já lançado) ou permite corrigir manualmente, e depois exporta em CSV o saldo consolidado por conta — usado para implantar o saldo do razão auxiliar contábil. CARACTERÍSTICA COMUM Geração de Arquivo, Não Cadastro Nenhuma das duas rotinas possui uma tela de cadastro tradicional (Novo/Editar/Excluir de um registro próprio): ambas leem dados já lançados em outras rotinas do sistema (Movimentação Contábil, Contas a Pagar/Receber) e entregam o resultado como um arquivo para download — Excel ou CSV, conforme a rotina.

Geração Rateio off-line

Documentação Técnica 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. 01 — VISÃO GERAL 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. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Geração Rateio off-line ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS 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 RateioOffLine/AplicarModeloDeRateio Permite calcular e visualizar a proposta de rateio do DRE. RateioOffLine/SalvarDREComModeloDeRateio Permite gravar o rateio revisado como lançamentos no lote contábil. Observação Um usuário pode, em tese, ter acesso à tela e apenas visualizar a proposta de rateio (se tiver só a primeira permissão), sem poder efetivamente salvar os lançamentos (se não tiver a segunda). Pré-requisitos de cadastro Deve existir pelo menos um “Modelo de Rateio” já cadastrado no sistema (rotina de cadastro de Modelo de Rateio), definindo as contas de origem e destino, os centros de custo/controle envolvidos e o tipo de rateio de cada item (rateio por critério cadastrado ou rateio direto para uma conta destino única). O lote contábil de destino (identificado por série + número + filial) deve estar disponível: se ainda não existir, o próprio processo de salvamento cria o lote; se já existir, ele não pode conter lançamentos previamente cadastrados (ver seção 9, Regra 4). Opcionalmente, pode-se informar um “Histórico Padrão” já cadastrado, para ser aplicado aos lançamentos gerados. 04 — PASSO A PASSO Processo de Criação — Passo a Passo da Geração Rateio off-line 1 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. 2 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). 3 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). 4 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. 05 — CAMPOS Descrição de Cada Campo da Tela da Geração Rateio off-line Modelo de rateio Tipo: seleção (busca/autocomplete de modelo de rateio cadastrado) Obrigatoriedade: obrigatório Descrição: modelo de rateio previamente cadastrado que define as contas de origem/destino, centros de custo/controle e o tipo de distribuição a ser aplicado sobre o DRE. Comportamento: recebe o foco automaticamente ao abrir a tela; ao ser selecionado, define o conjunto de regras que será usado quando o usuário aplicar o rateio. Impacto: determina integralmente o resultado da proposta de rateio gerada na aba “DRE com modelo de rateio” e fica gravado no lote contábil resultante. Filial Tipo: seleção (busca de filial cadastrada) Obrigatoriedade: obrigatório Descrição: filial para a qual o DRE será apurado e rateado. Comportamento: filtra os saldos do DRE consultados apenas para a filial selecionada. Impacto: usada para localizar o DRE de origem e também para localizar/criar o lote contábil de destino. Período base Tipo: data Obrigatoriedade: obrigatório Descrição: mês/ano de referência do DRE cujos saldos serão rateados. Comportamento: o mês e o ano informados definem o intervalo de apuração do DRE consultado. Impacto: define a data do lote contábil criado e o período de apuração

Lista de Modelos Rateio off-line

Documentação Técnica Lista de Modelos Rateio off-line — Contabilidade Rotina que permite ao usuário cadastrar, consultar, editar e excluir “modelos de rateio”, usados posteriormente pela rotina de Rateio off-line para gerar lançamentos contábeis a partir dos saldos do DRE. 01 — VISÃO GERAL Visão Geral da Lista de Modelos Rateio off-line A rotina “Lista de Modelos Rateio off-line”, do módulo Contabilidade (menu “Contabilidade > Rateio > Lista de Modelos Rateio off-line”), permite ao usuário cadastrar, consultar, editar e excluir “modelos de rateio”. Um modelo de rateio é um conjunto de regras que informa, para cada conta contábil de origem, para qual conta e centro de custo de destino o valor deve ser distribuído — ou, alternativamente, para qual “Critério de Rateio” já cadastrado o sistema deve olhar para desdobrar esse valor em percentuais. Esses modelos não são usados isoladamente: eles servem de base para a rotina “Rateio off-line” (Contabilidade > Rateio > Geração Rateio off-line), que aplica o modelo sobre os saldos do DRE (Demonstrativo de Resultado do Exercício) de um período e gera automaticamente os lançamentos contábeis de rateio em um lote contábil. 02 — VÍDEO TUTORIAL Vídeo Tutorial da Lista de Modelos Rateio off-line ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso da Lista de Modelos Rateio off-line Permissão de Acesso à Tela Para visualizar a tela “Lista de Modelos Rateio off-line”, o usuário precisa ter o perfil vinculado à permissão “ListViewDeModeloRateio” (ID 683). Sem essa permissão, o item de menu “Contabilidade > Rateio > Lista de Modelos Rateio off-line” nem aparece para o usuário. Permissões por Ação Para executar ações específicas dentro da tela, são necessárias permissões adicionais e independentes: — Cadastrar um novo modelo: permissão “ModeloRateio/Novo” (ID 684). — Editar um modelo existente: permissão “ModeloRateio/Editar” (ID 685). — Excluir um modelo: permissão “ModeloRateio/Excluir” (ID 686). — Exportar a listagem de modelos: permissão “ModeloRateio/Exportar” (ID 544). Observação importante Não há dependência de cadastro prévio obrigatório para criar um modelo de rateio “vazio” (sem itens). No entanto, para que os itens do modelo façam sentido no negócio, o Plano de Contas e, quando aplicável, o Critério de Rateio (Contabilidade > Rateio > Critério rateio) referenciados nos itens precisam já existir. 04 — PROCESSO DE CRIAÇÃO Processo de Criação — Passo a Passo da Lista de Modelos Rateio off-line 1 Acessar a tela de listagem O usuário acessa “Contabilidade > Rateio > Lista de Modelos Rateio off-line” e aciona a opção de novo cadastro. O sistema solicita o preenchimento do código e do nome do modelo. 2 Informar o código e o nome do modelo O usuário informa um código numérico (campo “ID”) e uma descrição (campo “Nome”) para o modelo de rateio. 3 Adicionar as linhas (itens) do modelo Para cada linha, o usuário informa a conta contábil de origem (a que será rateada) e escolhe o tipo de rateio da linha: “com base no cadastro de rateio” (informando um Critério de Rateio já cadastrado e uma conta de envio) ou rateio direto para uma conta e centro de custo de destino específicos. 4 Confirmar o cadastro O usuário confirma a gravação. O sistema valida cada linha informada (ver seção 9, Regras de Negócio) e, se todas as validações passarem, grava o modelo com o texto de confirmação “Modelo de rateio inserido com sucesso”. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela da Lista de Modelos Rateio off-line ID (código do modelo de rateio) Tipo: número Obrigatoriedade: obrigatório Descrição: identificador numérico único do modelo de rateio, usado posteriormente para localizá-lo e aplicá-lo na rotina de Rateio off-line. Comportamento: informado manualmente pelo usuário ao criar o modelo; não é gerado automaticamente pelo sistema. Impacto: é a chave usada pela ação “Aplicar modelo de rateio” (Rateio off-line) para localizar o modelo correto. Nome (do modelo de rateio) Tipo: texto Obrigatoriedade: obrigatório Descrição: nome/descrição que identifica o propósito do modelo (ex: “Rateio DRE Administrativo”). Comportamento: texto livre digitado pelo usuário. Impacto: exibido nas listagens de modelos e no campo combinado “ID – Nome” usado em buscas/autocomplete de outras telas (ex: tela de Rateio off-line). Plano de contas a ratear (item do modelo) Tipo: seleção/autocomplete Obrigatoriedade: obrigatório para que a linha seja considerada válida Descrição: conta contábil de origem cujo saldo será distribuído para outra conta/centro de custo. Comportamento: o sistema valida, ao salvar, se a conta é analítica (ou analítica-e-sintética vinculada, dependendo do parâmetro contábil “TcExecutaCriterioDeRateiEmContasSinteticas”) — ver Regra 1 na seção 9. Impacto: usada pela rotina de Rateio off-line para localizar, no DRE do período, o saldo a ser distribuído. Centro de custo (de origem, item do modelo) Tipo: seleção/autocomplete Obrigatoriedade: opcional [informação não disponível na análise de código — validar com analista/vídeo do sistema quanto à obrigatoriedade exata na tela] Descrição: centro de custo associado à conta de origem da linha. Comportamento: informado junto com a conta de origem. Impacto: usado para localizar o saldo específico do centro de custo no DRE, quando aplicável. Tipo do rateio (item do modelo) Tipo: seleção Obrigatoriedade: obrigatório Descrição: define como o valor da conta de origem será distribuído — “C” (com base no cadastro de rateio, usando um Critério de Rateio para desdobrar percentualmente o valor) ou rateio direto para uma única conta/centro de custo de destino. Comportamento: quando o usuário seleciona “com base no cadastro de rateio”, o campo “Critério de rateio” e o campo “Conta de envio” passam a ser exigidos (ver Regra 4, seção 9). Impacto: determina se, na execução do Rateio off-line, a linha gera uma única sublinha de lançamento ou é desdobrada em várias, conforme o critério de rateio vinculado. Critério de rateio (item do modelo) Tipo: seleção/autocomplete Obrigatoriedade: obrigatório quando “Tipo do rateio” = “com base no cadastro de rateio” Descrição: referência a um Critério de Rateio já cadastrado (rotina “Contabilidade > Rateio > Critério rateio”) que define os percentuais de desdobramento do valor. Comportamento: campo de busca vinculado ao cadastro de Critério de Rateio. Impacto: usado pela rotina de Rateio off-line

Critério Rateio

Documentação Técnica Critério Rateio Rotina do módulo Contabilidade que permite cadastrar as regras usadas pelo sistema para distribuir (ratear) automaticamente o valor de um lançamento contábil entre várias contas do plano de contas e centros de custo, em percentuais definidos pelo próprio usuário. 01 — VISÃO GERAL Visão Geral do Critério Rateio A rotina “Critério rateio” permite cadastrar as regras que o sistema usa para distribuir (ratear) automaticamente o valor de um lançamento contábil entre várias contas do plano de contas e centros de custo, em percentuais definidos pelo próprio usuário. Cada critério de rateio é formado por um cabeçalho (código e nome do critério) e por uma lista de itens, cada um indicando uma conta contábil, um centro de custo e o percentual do valor total que será direcionado para aquela combinação. Observação importante Essa rotina é usada em conjunto com outras telas do módulo Contabilidade (lançamentos contábeis, lotes contábeis e geração de rateio off-line) que, ao referenciar um critério de rateio já cadastrado, aplicam automaticamente a distribuição percentual configurada aqui. 02 — VÍDEO TUTORIAL Vídeo Tutorial do Critério Rateio ▶ Tutorial em vídeo: ainda não disponível para esta rotina. 03 — PRÉ-REQUISITOS Pré-requisitos e Contexto de Acesso do Critério Rateio Para acessar a tela “Critério rateio”, o usuário precisa ter o perfil vinculado à permissão “ListViewDeCriterioRateio” (ID 259) — sem essa permissão, o item de menu “Contabilidade / Rateio / Critério rateio” não fica disponível. Para criar, editar, excluir ou exportar registros, são necessárias permissões adicionais e específicas para cada ação. Pré-requisito de negócio Antes de cadastrar um critério de rateio, é recomendável que o plano de contas e os centros de custo que serão usados nos itens do rateio já estejam cadastrados no sistema, pois o critério referencia diretamente esses cadastros. 04 — PASSO A PASSO Processo de Criação — Passo a Passo do Critério Rateio 1 Acessar a tela de Critério rateio O usuário acessa o menu “Contabilidade / Rateio / Critério rateio” e aciona a opção de novo registro. 2 Preencher os dados do cabeçalho do critério O usuário informa o código, o nome do critério e o tipo de execução do rateio. 3 Definir se o critério é segmentado por filial O usuário indica se o critério de rateio será aplicado de forma diferente por filial (com data de vigência) ou de forma única para toda a empresa. 4 Incluir os itens (linhas) do rateio Para cada linha, o usuário informa a conta contábil de destino, o centro de custo e o percentual do valor total que será direcionado para essa combinação. Se o critério for por filial, também informa a filial e a data de vigência de cada linha. 5 Salvar o critério Ao confirmar, o sistema valida se a soma dos percentuais de cada grupo (filial + data de vigência) fecha exatamente 100% e se as contas informadas atendem às regras de conta analítica/sintética. Se tudo estiver correto, o sistema grava o critério e exibe a mensagem “Critério de rateio inserida com sucesso.”. 05 — CAMPOS DA TELA Descrição de Cada Campo da Tela do Critério Rateio Código do critério de rateio Tipo: texto/número Obrigatoriedade: obrigatório Descrição: identificador numérico do critério de rateio, usado para referenciá-lo em outras rotinas (lançamentos, lotes contábeis, rateio off-line). Comportamento: aceita apenas valores numéricos; é convertido internamente para um número inteiro. Impacto: usado como referência em lançamentos contábeis, lotes contábeis e na geração de rateio off-line. Nome do critério de rateio Tipo: texto Obrigatoriedade: obrigatório Descrição: descrição/nome do critério, usado para localizá-lo nas telas de consulta. Comportamento: aceita busca por trecho do texto na tela de listagem. Impacto: exibido nas grades de listagem e consulta do critério de rateio. Tipo de execução do rateio Tipo: seleção Obrigatoriedade: obrigatório Descrição: define o tipo de execução do critério de rateio. Na importação por planilha, os valores aceitos são “S”, “C” ou “P” [informação não disponível na análise de código — validar com analista/vídeo do sistema o significado de negócio exato de cada sigla]. Comportamento: validado na importação por planilha; valor inválido impede a importação da linha. Impacto: influencia o comportamento de aplicação do rateio nas rotinas que o consomem. Critério de rateio por filial Tipo: seleção (Sim/Não) Obrigatoriedade: opcional (assume comportamento de critério único quando não é “Sim”) Descrição: indica se o critério terá itens diferentes por filial e data de vigência (valor 1) ou um único conjunto de itens válido para toda a empresa (valor 2). Comportamento: quando não é critério por filial, o sistema zera automaticamente os campos de filial e data de vigência de todos os itens ao salvar, mesmo que informados na tela. Impacto: determina se as rotinas que aplicam o rateio (lançamentos, lotes contábeis) filtram os itens por filial/data ou usam todos os itens do critério. Conta contábil do item Tipo: autocomplete/busca Obrigatoriedade: obrigatório por linha, quando a linha possuir dados de rateio Descrição: conta do plano de contas para a qual o percentual desta linha do rateio será direcionado. Comportamento: ao editar o critério, o sistema valida se a conta é analítica (ou, quando o parâmetro contábil correspondente estiver habilitado, se é sintética e analítica ao mesmo tempo); contas que não atendem à regra bloqueiam o salvamento. Impacto: usado para gerar os lançamentos contábeis rateados nas rotinas de lançamento e lote contábil. Centro de custo do item Tipo: autocomplete/busca Obrigatoriedade: obrigatório por linha, quando a linha possuir dados de rateio Descrição: centro de custo associado a esta linha do rateio. Comportamento: na importação por planilha, o sistema valida se o centro de custo existe e não está inativo. Impacto: usado para segmentar o lançamento contábil gerado por centro de custo. Percentual do rateio Tipo: número (percentual) Obrigatoriedade: obrigatório por linha, quando a linha possuir dados de rateio Descrição: percentual do valor total do lançamento que será atribuído a esta combinação de conta e centro de custo. Comportamento: a soma dos percentuais de todas as linhas de um mesmo grupo (filial + data de vigência) precisa fechar exatamente 100%; caso contrário, o sistema