HandyCafe Docs
owner cashier

Despesas

A pagina de Despesas rastreia todos os custos do negocio que nao sao compras de produtos (aluguel, servicos publicos, reparos, assinaturas, salarios e quaisquer outros pagamentos). Ao registrar despesas de forma consistente, proprietarios obtem uma visao clara dos custos operacionais junto com a receita de sessoes e pedidos, permitindo calculo preciso de lucro.

Campos do Registro de Despesa

Cada entrada de despesa contem as seguintes informacoes:

Campo Descricao
title Uma descricao 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 padrao.
paid_at O carimbo de data/hora de quando a despesa foi efetivamente paga. Se este campo estiver preenchido, a despesa e considerada Paga. Se vazio, a despesa e Nao Paga.
due_date Uma data opcional ate quando o pagamento deve ser realizado. Util para rastrear obrigacoes futuras.
vendor O nome da parte que voce esta pagando (por exemplo, "Locador", "Companhia Eletrica", "Empresa de TI"). Opcional, mas recomendado para filtragem e relatorios.
note Um campo de texto livre para detalhes adicionais como numeros de nota fiscal, codigos de referencia ou contexto.

Status da Despesa

Despesas possuem dois status possiveis baseados no campo paid_at:

  • Paga: O campo paid_at contem um carimbo de data/hora, indicando que a despesa foi quitada. Despesas pagas exibem um badge "Pago" e a data de pagamento.
  • Nao Paga: O campo paid_at esta vazio. A despesa e uma obrigacao pendente. Se uma due_date estiver definida, o sistema pode destacar itens em atraso.

Predefinicoes de Filtro por Data

A pagina de Despesas oferece predefinicoes rapidas de filtro por data para restringir a lista a um periodo especifico:

Predefinicao Periodo
Hoje Apenas despesas criadas ou pagas hoje
Ontem Apenas despesas de ontem
Ultimos 7 Dias Despesas da ultima semana
Ultimos 30 Dias Despesas do ultimo mes
Esta Semana Despesas de segunda ate hoje (semana atual)
Semana Passada Despesas da semana completa anterior (segunda a domingo)
Este Mes Despesas do 1o dia do mes atual ate hoje
Mes Passado Despesas de todo o mes calendario anterior
Todo o Periodo Sem filtro de data. Mostra todas as despesas

Essas predefinicoes atualizam a lista imediatamente, tornando rapida a revisao de despesas para um periodo especifico.

Sugestoes de Autocomplete

Para agilizar a entrada de dados e manter a consistencia, a pagina de Despesas oferece sugestoes de autocomplete para dois campos:

  • Fornecedor: Conforme voce digita no campo de fornecedor, o sistema sugere nomes de fornecedores das suas entradas anteriores. Isso previne nomenclatura inconsistente (por exemplo, "Cia. Eletrica" vs. "Companhia de Eletricidade") e facilita a reutilizacao de nomes de fornecedores comuns.
  • Titulo: Da mesma forma, o campo de titulo sugere titulos de despesas usados anteriormente. Despesas recorrentes comuns como "Aluguel", "Internet" ou "Eletricidade" podem ser inseridas com uma unica selecao.

Busca

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

  • Titulo
  • Fornecedor
  • Nota
  • Valor

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

Criando uma Nova Despesa

Para registrar uma nova despesa:

  1. Navegue ate a pagina de Despesas pela barra lateral.
  2. Clique no botao Adicionar Despesa.
  3. Insira o titulo descrevendo a finalidade da despesa.
  4. Insira o valor (nas unidades menores da moeda do sistema).
  5. Opcionalmente defina o nome do fornecedor (sugestoes de autocomplete aparecem conforme voce 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 e criada com status Nao Paga por padrao.

Marcando uma Despesa como Paga

Para registrar que uma despesa foi quitada:

  1. Selecione a despesa da lista.
  2. Clique na acao 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 Nao Paga para Paga.

Voce tambem pode marcar uma despesa como paga no momento da criacao se o pagamento ja foi realizado.

Excluindo uma Despesa

Selecione uma despesa e use a acao de excluir para remove-la do sistema. Despesas excluidas sao permanentemente removidas. Esta acao requer permissoes apropriadas e deve ser usada com cuidado. Considere marcar despesas indesejadas como anuladas no campo de notas em vez de exclui-las para preservar o rastro de auditoria.

Requisitos de Permissao

O acesso ao gerenciamento de despesas e controlado pelas permissoes de funcao do operador. Dependendo da configuracao da funcao:

  • Algumas funcoes podem visualizar despesas, mas nao cria-las ou modifica-las.
  • A capacidade de marcar despesas como pagas pode ser restrita a funcoes de nivel proprietario.
  • Excluir despesas normalmente requer permissoes elevadas.

Consulte a pagina Funcoes de Operadores para detalhes sobre a configuracao dessas permissoes.