HandyCafe Docs
owner cashier

Despesas

A página de Despesas rastreia todos os custos do negócio que não são compras de produtos (aluguel, serviços públicos, reparos, assinaturas, salários e quaisquer outros pagamentos). Ao registrar despesas de forma consistente, proprietários obtêm uma visão clara dos custos operacionais junto com a receita de sessões e pedidos, permitindo cálculo preciso de lucro.

Campos do Registro de Despesa

Cada entrada de despesa contém as seguintes informações:

Campo Descrição
title Uma descrição curta da despesa (por exemplo, "Aluguel - Abril 2026", "Conta de Luz", "Reparo do Roteador", "Assinatura de Internet").
amount O valor da despesa em unidades menores de moeda (por exemplo, centavos).
currency A moeda da despesa. Usa a moeda do sistema por padrão.
paid_at O carimbo de data/hora de quando a despesa foi efetivamente paga. Se este campo estiver preenchido, a despesa é considerada Paga. Se vazio, a despesa é Não Paga.
due_date Uma data opcional até quando o pagamento deve ser realizado. Útil para rastrear obrigações futuras.
vendor O nome da parte que você está pagando (por exemplo, "Locador", "Companhia Elétrica", "Empresa de TI"). Opcional, mas recomendado para filtragem e relatórios.
note Um campo de texto livre para detalhes adicionais como números de nota fiscal, códigos de referência ou contexto.

Status da Despesa

Despesas possuem dois status possíveis baseados no campo paid_at:

  • Paga: O campo paid_at contém um carimbo de data/hora, indicando que a despesa foi quitada. Despesas pagas exibem um badge "Pago" e a data de pagamento.
  • Não Paga: O campo paid_at está vazio. A despesa é uma obrigação pendente. Se uma due_date estiver definida, o sistema pode destacar itens em atraso.

Predefinições de Filtro por Data

A página de Despesas oferece predefinições rápidas de filtro por data para restringir a lista a um período específico:

Predefinição Período
Hoje Apenas despesas criadas ou pagas hoje
Ontem Apenas despesas de ontem
Últimos 7 Dias Despesas da última semana
Últimos 30 Dias Despesas do último mês
Esta Semana Despesas de segunda até hoje (semana atual)
Semana Passada Despesas da semana completa anterior (segunda a domingo)
Este Mês Despesas do 1o dia do mês atual até hoje
Mês Passado Despesas de todo o mês calendário anterior
Todo o Período Sem filtro de data. Mostra todas as despesas

Essas predefinições atualizam a lista imediatamente, tornando rápida a revisão de despesas para um período específico.

Sugestões de Autocomplete

Para agilizar a entrada de dados e manter a consistência, a página de Despesas oferece sugestões de autocomplete para dois campos:

  • Fornecedor: Conforme você digita no campo de fornecedor, o sistema sugere nomes de fornecedores das suas entradas anteriores. Isso previne nomenclatura inconsistente (por exemplo, "Cia. Elétrica" vs. "Companhia de Eletricidade") e facilita a reutilização de nomes de fornecedores comuns.
  • Título: Da mesma forma, o campo de título sugere títulos de despesas usados anteriormente. Despesas recorrentes comuns como "Aluguel", "Internet" ou "Eletricidade" podem ser inseridas com uma única seleção.

Busca

A barra de busca no topo da página de Despesas realiza busca em texto completo em todos os campos:

  • Título
  • Fornecedor
  • Nota
  • Valor

Digite qualquer palavra-chave para filtrar a lista instantaneamente. Por exemplo, buscar "internet" mostraria todas as despesas com "internet" no título, nome do fornecedor ou notas.

Criando uma Nova Despesa

Para registrar uma nova despesa:

  1. Navegue até a página de Despesas pela barra lateral.
  2. Clique no botão Adicionar Despesa.
  3. Insira o título descrevendo a finalidade da despesa.
  4. Insira o valor (nas unidades menores da moeda do sistema).
  5. Opcionalmente defina o nome do fornecedor (sugestões de autocomplete aparecem conforme você digita).
  6. Opcionalmente defina a data de vencimento se o pagamento tem um prazo.
  7. Adicione quaisquer notas para contexto adicional.
  8. Clique em Salvar.

A despesa é criada com status Não Paga por padrão.

Marcando uma Despesa como Paga

Para registrar que uma despesa foi quitada:

  1. Selecione a despesa da lista.
  2. Clique na ação Marcar como Paga (ou alterne o status de pagamento).
  3. O sistema registra o carimbo de data/hora atual como o valor de paid_at.
  4. O status da despesa muda de Não Paga para Paga.

Você também pode marcar uma despesa como paga no momento da criação se o pagamento já foi realizado.

Excluindo uma Despesa

Selecione uma despesa e use a ação de excluir para removê-la do sistema. Despesas excluídas são permanentemente removidas. Esta ação requer permissões apropriadas e deve ser usada com cuidado. Considere marcar despesas indesejadas como anuladas no campo de notas em vez de excluí-las para preservar o rastro de auditoria.

Requisitos de Permissão

O acesso ao gerenciamento de despesas é controlado pelas permissões de função do operador. Dependendo da configuração da função:

  • Algumas funções podem visualizar despesas, mas não criá-las ou modificá-las.
  • A capacidade de marcar despesas como pagas pode ser restrita a funções de nível proprietário.
  • Excluir despesas normalmente requer permissões elevadas.

Consulte a página Funções de Operadores para detalhes sobre a configuração dessas permissões.