Despesas
Criado por Igor Ribeiro em 11 de setembro de 2026
Atualizado por Igor Ribeiro em 11 de setembro de 2026
Despesas
Módulo Financeiro: Lançamento de pagamento de despesas com saída de dinheiro direto de carteira Caixa ou Banco.
Visão Geral das Despesas
A rotina Despesas fica dentro do módulo Financeiro, na tela Caixa, e serve para registrar o pagamento de uma despesa, ou seja, uma saída de dinheiro que sai diretamente de uma Carteira do tipo Caixa ou Banco. Ao confirmar o lançamento, o sistema faz duas coisas ao mesmo tempo: registra a movimentação financeira (a saída do dinheiro daquela carteira) e gera automaticamente o lançamento contábil correspondente, sem que o usuário precise fazer nada além de preencher a tela e confirmar.
Essa rotina é pensada para lançamentos avulsos e pontuais de despesa: cada confirmação registra um único pagamento. Não existe, dentro desta tela, um recurso para lançar várias despesas de uma só vez.
Como a despesa lançada aqui já nasce paga (o dinheiro já sai da carteira no mesmo momento do lançamento), esta rotina não gera um título em aberto para ser quitado depois: o registro é imediato e definitivo.
Vídeo Tutorial das Despesas
▶ Tutorial em vídeo: ainda não disponível para esta rotina.
Pré-requisitos e Contexto de Acesso das Despesas
Acesso à Tela
Permissão de acesso à rotina “EditViewDeDespesas”, um recurso vinculado à tela Caixa dentro do módulo Financeiro.
Permissão de Salvar
Permissão específica de “Salvar” nesta rotina. Sem ela, o botão de confirmar o lançamento não realiza a gravação.
Permissão de Imprimir
Permissão específica de “Imprimir” para emitir o comprovante da despesa lançada.
Cadastros Pré-requisitos
- Carteira: Pelo menos uma do tipo Caixa ou Banco, pela qual o valor da despesa sairá.
- Fato Contábil de Despesa: Identificado como “BCODESP”, rotulado como “DESPESAS”, já configurado no sistema com as variações que aparecerão para o usuário escolher na tela.
- Histórico Padrão: Cadastrado para compor o texto que descreve o lançamento.
- Centro de Custo: Opcionalmente, caso a empresa utilize rateio de despesas por centro de custo.
Pré-preenchimento automático: Ao abrir a tela, o sistema já traz automaticamente um Centro de Custo padrão pré-preenchido (configurado nas preferências do financeiro) e, se a carteira padrão do usuário estiver configurada em moeda estrangeira, o sistema também já traz o símbolo da moeda e a cotação vigente para uso na tela.
Processo de Criação: Passo a Passo das Despesas
Acessar a Tela de Despesas
O usuário acessa o módulo Financeiro, entra na tela Caixa e abre a opção Despesas. O sistema carrega a tela já com o Centro de Custo padrão preenchido e, se aplicável, com as informações de moeda estrangeira (símbolo e cotação) da carteira padrão do usuário.
Selecionar a Carteira de Pagamento
O usuário escolhe, dentre as carteiras cadastradas do tipo Caixa ou Banco, de qual carteira o valor da despesa vai sair. Essa escolha é obrigatória: sem uma carteira válida selecionada, o sistema não permite concluir o lançamento.
Informar o Valor da Despesa
O usuário digita o valor a ser pago. Se a carteira selecionada operar em moeda estrangeira, o usuário também pode informar o valor correspondente nessa moeda.
Informar a Data de Emissão
O usuário informa a data de emissão do documento ou do lançamento da despesa.
Selecionar o Fato Contábil
O usuário abre a lista de consulta (lookup) de Fato Contábil e escolhe a combinação de Fato Contábil e Variação que representa o tipo daquela despesa (por exemplo, “35 – DESPESAS (BCODESP)” combinado com uma variação específica, como “200” ou “201”). Essa escolha define para qual conta contábil o lançamento será direcionado. A seleção é obrigatória.
Selecionar o Histórico Padrão
O usuário escolhe o Histórico Padrão que será usado para compor o texto/complemento do lançamento. Essa escolha é obrigatória.
Preencher Informações Complementares (Opcional)
O usuário pode, se desejar, informar o número do Documento relacionado à despesa, selecionar um Centro de Custo diferente do padrão já preenchido, e escrever uma Observação livre sobre o lançamento. Nenhum desses três campos é obrigatório.
Confirmar o Lançamento (Salvar)
O usuário clica em Salvar. O sistema verifica se todos os dados obrigatórios foram informados corretamente. Se a carteira informada não for localizada no cadastro geral, o sistema interrompe a operação e exibe uma mensagem de erro, sem gravar nada. Se tudo estiver correto, o sistema grava, em uma única operação, a movimentação financeira (a saída do valor da carteira selecionada) e o lançamento contábil correspondente. Se a carteira selecionada não for do tipo Caixa e pertencer a uma filial diferente da filial em que o usuário está logado, o sistema também gera automaticamente dois lançamentos adicionais de reconciliação entre as filiais envolvidas (ver Regra de Negócio 3, na seção 9).
Emitir o Comprovante (Opcional)
Após a confirmação do lançamento, o usuário pode optar por imprimir o comprovante da movimentação financeira gerada. Ao acionar essa opção, o sistema garante que a estrutura de arquivos necessária para gerar o comprovante já exista (criando a pasta de comprovantes do cliente e copiando o layout padrão, caso ainda não existam) e então gera o documento para impressão.
Descrição de Cada Campo da Tela das Despesas
Observação importante: A documentação técnica de origem descreve os campos a partir da estrutura de dados enviada ao sistema, e não a partir do texto exato exibido na tela. Os rótulos abaixo foram inferidos a partir dessa estrutura técnica; o texto literal exibido na interface pode variar ligeiramente e deve ser validado com a tela real do sistema.
Carteira
Tipo: Seleção (lista de carteiras cadastradas do tipo Caixa ou Banco)
Obrigatoriedade: Obrigatório
Descrição: Define de qual carteira (caixa físico ou conta bancária) o dinheiro da despesa vai sair.
Comportamento: O sistema busca a carteira escolhida no cadastro geral de carteiras; se a carteira não for localizada, o lançamento é bloqueado e o sistema exibe a mensagem “Não foi possível incluir Despesas. Carteira não encontrada. Favor informe uma carteira.” Se a carteira escolhida for do tipo Caixa, o sistema ajusta automaticamente a filial considerada para a carteira, igualando-a à filial em que o usuário está logado.
Impacto: Determina de qual conta financeira o saldo será debitado e, dependendo do tipo de carteira e da filial, pode disparar lançamentos adicionais de reconciliação entre filiais (ver Regra de Negócio 3).
Valor
Tipo: Número (valor monetário)
Obrigatoriedade: Obrigatório
Descrição: Valor da despesa a ser pago, na moeda corrente (moeda local).
Comportamento: Valor usado diretamente na movimentação financeira gravada e no lançamento contábil gerado.
Impacto: Aparece na movimentação financeira da carteira, no lançamento contábil e no comprovante de pagamento.
Valor (Moeda Estrangeira)
Tipo: Número (valor monetário)
Obrigatoriedade: Condicional; aplicável apenas quando a carteira selecionada opera em moeda estrangeira
Descrição: Valor correspondente da despesa expresso na moeda estrangeira da carteira selecionada.
Comportamento: Quando a carteira do usuário está configurada em moeda estrangeira, o sistema já traz previamente o símbolo da moeda e a cotação vigente para apoiar o preenchimento deste campo.
Impacto: Fica registrado junto com a movimentação financeira, permitindo consultas e comprovantes com o valor na moeda estrangeira, além do valor em moeda corrente.
Data de Emissão
Tipo: Data
Obrigatoriedade: [informação não disponível na documentação de origem, validar com analista responsável]
Descrição: Data de emissão do documento ou do lançamento da despesa.
Comportamento: Gravada junto com a movimentação financeira.
Impacto: Fica registrada na movimentação financeira e pode ser usada como referência de data em consultas futuras.
Fato Contábil
Tipo: Seleção (lookup que combina Fato Contábil e Variação)
Obrigatoriedade: Obrigatório
Descrição: Define o tipo de despesa que está sendo lançada, para fins de classificação contábil. Cada combinação de Fato Contábil e Variação (por exemplo, “35 – DESPESAS (BCODESP)” com a variação “200”) corresponde a uma conta contábil específica que vai receber o lançamento.
Comportamento: Ao escolher a combinação na lista, o sistema localiza, internamente, o registro de fato contábil de despesa correspondente à variação escolhida e usa essa informação para determinar a conta contábil do lançamento.
Impacto: Determina em qual conta contábil a despesa será classificada; aparece refletido no lançamento contábil gerado automaticamente pelo sistema.
Histórico Padrão
Tipo: Seleção (lista de históricos padrão cadastrados)
Obrigatoriedade: Obrigatório
Descrição: Texto padronizado que serve como descrição/complemento do lançamento financeiro e contábil.
Comportamento: O texto do histórico escolhido é usado para compor a descrição do lançamento gerado.
Impacto: Aparece na movimentação financeira, no lançamento contábil e no comprovante de pagamento, servindo como referência textual do que foi lançado.
Documento
Tipo: Texto
Obrigatoriedade: Opcional
Descrição: Número ou identificação do documento relacionado à despesa (por exemplo, o número de uma nota fiscal ou de um boleto).
Comportamento: Gravado junto com a movimentação financeira, sem validação de formato específica documentada.
Impacto: Fica disponível como referência do documento original nas consultas da movimentação financeira gerada.
Centro de Custo
Tipo: Seleção (lista de centros de custo cadastrados)
Obrigatoriedade: Opcional
Descrição: Identifica para qual centro de custo a despesa deve ser direcionada, permitindo o rateio de despesas por área ou departamento.
Comportamento: O sistema já traz um centro de custo padrão pré-preenchido ao abrir a tela (configurado nas preferências do financeiro), mas o usuário pode alterá-lo antes de confirmar o lançamento.
Impacto: Usado em relatórios e consultas que segmentam despesas por centro de custo.
Observação
Tipo: Texto livre
Obrigatoriedade: Opcional
Descrição: Campo livre para o usuário registrar qualquer informação adicional sobre a despesa lançada.
Comportamento: Gravado junto com a movimentação financeira, sem validação de conteúdo.
Impacto: Fica disponível como anotação complementar nas consultas da movimentação financeira gerada.
Utilização e Consulta de Registros das Despesas
A documentação técnica de origem desta rotina não descreve nenhuma tela ou ação de listagem/consulta de despesas já lançadas, nem filtros de busca associados a esta rotina especificamente. [informação não disponível na documentação de origem, validar com analista responsável]
O que a documentação de origem confirma é que, após a confirmação do lançamento (Passo 8 da seção 4), o sistema devolve os dados da movimentação financeira e do lançamento contábil gerados, permitindo ao usuário visualizar e imprimir o comprovante daquele lançamento específico (ver Passo 9, seção 4). Consultas mais amplas de despesas já lançadas anteriormente, caso existam, fazem parte de outra rotina do sistema, que não está documentada neste material.
Processo de Edição das Despesas
Edição não permitida
Esta rotina não permite editar uma despesa depois que ela foi confirmada.
A documentação técnica de origem desta rotina apresenta apenas duas ações: confirmar um novo lançamento de despesa (Salvar) e preparar a impressão do comprovante (Imprimir). Não há, na documentação de origem, nenhuma ação de edição ou atualização de uma despesa já lançada.
Isso é coerente com a natureza do lançamento: como explicado na Visão Geral, a despesa lançada por esta tela já nasce quitada, ou seja, o dinheiro já sai da carteira no exato momento da confirmação, dentro de uma única operação que grava ao mesmo tempo a movimentação financeira e o lançamento contábil (ver Regra de Negócio 6, na seção 9). Por isso, não existe um estado “em aberto” que possa ser posteriormente editado por esta mesma tela.
Caso o usuário precise corrigir um lançamento feito incorretamente, o caminho para isso (por exemplo, um estorno ou cancelamento) não está descrito na documentação de origem desta rotina: [informação não disponível na documentação de origem, validar com analista responsável]
Não há, na documentação de origem, menção a nenhum registro de histórico ou log de alterações para esta rotina, o que é esperado, já que não existe ação de edição.
Estrutura Técnica e Comportamento do Sistema das Despesas
Ao confirmar o lançamento de uma despesa, o sistema executa automaticamente, em segundo plano, uma sequência de ações para garantir que tudo fique consistente:
Geração Automática do Lançamento Contábil
Assim que a movimentação financeira é gravada, o sistema gera sozinho o lançamento contábil correspondente, usando a combinação de Fato Contábil e Variação escolhida pelo usuário na tela. O usuário não precisa fazer nenhum lançamento contábil manual: isso acontece automaticamente como consequência do lançamento da despesa.
Reconciliação entre Filiais (Mútuo)
Se a carteira selecionada não for do tipo Caixa e pertencer a uma filial diferente daquela em que o usuário está logado, o sistema entende que precisa equilibrar contabilmente as duas filiais envolvidas. Nesse caso, além do lançamento da despesa em si, o sistema gera automaticamente dois lançamentos adicionais (um de crédito e outro de débito) entre as carteiras de mútuo das duas filiais. Esse comportamento não ocorre quando a carteira selecionada é do tipo Caixa.
Operação Única e Seguro contra Falhas
A gravação da movimentação financeira e a geração do lançamento contábil (e, quando aplicável, dos lançamentos de mútuo) acontecem dentro de uma única operação. Isso significa que, se qualquer parte do processo falhar, nada é gravado: o sistema não deixa a despesa “meio lançada”.
Preparação do Comprovante para Impressão
Ao solicitar a impressão do comprovante, o sistema verifica se já existe, na estrutura de arquivos do cliente, o modelo de layout usado para gerar esse comprovante; se não existir, o sistema cria automaticamente a estrutura necessária e copia o layout padrão, para então gerar o documento de impressão.
Regras de Negócio e Restrições das Despesas
Lançamento Sempre Precisa de Dados Válidos
O sistema só confirma o lançamento de uma despesa se todos os dados enviados estiverem presentes e corretos. Se algo essencial estiver faltando, nenhum lançamento é feito e o sistema exibe a mensagem “Não foi possível Salvar. Os dados informados podem estar incorretos. Verifique se os dados informados estão corretos.”
Impacto para o usuário: É preciso revisar o preenchimento da tela e tentar novamente.
Carteira Precisa Existir no Cadastro
A carteira escolhida para pagar a despesa precisa estar corretamente cadastrada no sistema. Se o sistema não conseguir localizar essa carteira no cadastro geral, a operação é interrompida antes de qualquer gravação e o sistema exibe a mensagem “Não foi possível incluir Despesas. Carteira não encontrada. Favor informe uma carteira.”
Impacto para o usuário: É preciso selecionar uma carteira válida e cadastrada para conseguir concluir o lançamento.
Reconciliação entre Filiais (Mútuo) Depende do Tipo e da Filial da Carteira
Quando a carteira escolhida não é do tipo Caixa e pertence a uma filial diferente da filial em que o usuário está logado, o sistema entende que o lançamento está “atravessando” filiais e gera automaticamente dois lançamentos adicionais de reconciliação (mútuo) entre a filial do usuário e a filial da carteira. Quando a carteira escolhida é do tipo Caixa, o sistema sempre considera a filial da carteira igual à filial do usuário logado, e por isso, nesse caso, o mútuo nunca é gerado.
Impacto para o usuário: Ao lançar uma despesa em uma carteira bancária de outra filial, é normal e esperado que apareçam lançamentos contábeis adicionais de mútuo, além do lançamento da própria despesa.
Esta Tela Lança Sempre uma Despesa por Vez
Apesar de a estrutura interna do sistema permitir, em outras rotinas financeiras, o processamento de vários lançamentos de uma só vez, a tela de Despesas não oferece essa possibilidade ao usuário: cada confirmação de lançamento registra exatamente uma despesa. A única lista que o usuário efetivamente utiliza e enxerga nesta tela é a lista de consulta de Fato Contábil, usada para escolher a classificação contábil da despesa.
Impacto para o usuário: Para lançar várias despesas, é necessário repetir o processo de lançamento (seção 4) para cada uma delas.
A Escolha do Fato Contábil Define a Conta Contábil do Lançamento
O usuário escolhe, em uma lista de consulta, a combinação de Fato Contábil e Variação que representa o tipo daquela despesa. Essa escolha é o que determina, no lançamento contábil gerado automaticamente pelo sistema, qual conta contábil vai receber o valor.
Impacto para o usuário: Escolher a combinação correta de Fato Contábil e Variação é essencial para que a despesa seja classificada contabilmente de forma correta.
O Lançamento é Único e não Fica “pela Metade”
Toda a gravação da despesa (a movimentação financeira e o lançamento contábil, incluindo os lançamentos de mútuo quando aplicável) acontece como uma única operação. Se alguma etapa falhar por qualquer motivo, nenhuma parte do lançamento é gravada.
Impacto para o usuário: Não existe o risco de uma despesa ficar registrada apenas parcialmente (por exemplo, só no financeiro e não na contabilidade); ou o lançamento é concluído por completo, ou não é gravado nada.
A Integração Contábil Acontece Automaticamente
Depois que a movimentação financeira da despesa é gravada, o sistema gera sozinho o lançamento contábil correspondente, sem que o usuário precise realizar nenhuma ação adicional para isso.
Impacto para o usuário: Não é necessário lançar a despesa duas vezes (uma no financeiro e outra na contabilidade); um único lançamento na tela de Despesas já cobre as duas partes.
A Despesa Lançada por Esta Rotina Já Nasce Quitada
Diferente de um título a pagar que fica em aberto até ser baixado depois, a despesa lançada por esta tela já sai diretamente da carteira no momento da confirmação.
Impacto para o usuário: Esta rotina não deve ser usada para registrar uma despesa que será paga apenas no futuro; ela serve especificamente para despesas pagas no ato do lançamento.
