HandyCafe Docs
owner

Pricing Schedule Settings

The Pricing Schedule lets you apply different pricing multipliers to different hours of the week. Use it to charge premium rates during peak hours and offer discounts during off-peak times.

Enable / Disable

A master toggle at the top of the page enables or disables the entire pricing schedule. When disabled, all sessions use the flat hourly rate defined in Pricing Settings regardless of time of day. When enabled, the active color slot's multiplier is applied to any session time that falls within its painted hours.

The Weekly Time Grid

The schedule is displayed as a color-coded grid:

  • Columns -- 7 days of the week (Sunday through Saturday, or Monday through Sunday depending on your General Settings day-of-week preference).
  • Rows -- 24 hours of each day (00:00 through 23:00).
  • Cells -- Each cell represents one hour of the week (168 total cells).

Painting Time Blocks

  1. Select a color slot from the slot list (see below).
  2. Click or click-and-drag on the grid to paint cells with that color.
  3. Painted cells adopt the multiplier of the selected color slot.
  4. To clear a cell, paint over it with a different color or deselect all colors and click the cell.

The grid provides a visual overview of your entire weekly pricing structure at a glance.

Color Slots

There are 8 color slots available, each represented by a distinct color:

Slot Color Default Use
1 Blue Standard rate
2 Orange Moderate premium
3 Red Peak / high demand
4 Green Discount / off-peak
5 Teal Special promotion
6 Gray Minimal rate
7 Cyan Custom
8 Emerald Custom

Slot Configuration

Each color slot has the following settings:

  • Enabled toggle -- Turn the slot on or off. Disabled slots cannot be painted onto the grid.
  • Name -- A descriptive label (e.g., "Peak Hours", "Night Owl Discount", "Weekend Special").
  • Multiplier -- A decimal multiplier applied to the base hourly rate. Examples:
    • 1.0 -- Standard rate (no change).
    • 0.5 -- Half price.
    • 0.7 -- 30% discount.
    • 1.5 -- 50% premium.
    • 2.0 -- Double rate.
  • Schedule data -- An internal representation indicating which of the 168 weekly hours are assigned to this slot. This value is managed automatically as you paint the grid. You do not need to edit it manually.

Color Selector

A color selector component is provided for choosing the currently active paint color. Click a color in the selector to make it the active brush, then paint cells in the grid.

Example Workflow

  1. Enable the pricing schedule with the master toggle.
  2. Click color slot 3 (Red) and configure it:
    • Name: "Peak Hours"
    • Multiplier: 1.5
  3. Paint the evening hours (18:00 through 23:00) for every day of the week with the red color.
  4. Click color slot 4 (Green) and configure it:
    • Name: "Off-Peak"
    • Multiplier: 0.7
  5. Paint the morning hours (06:00 through 12:00) on weekdays with the green color.
  6. Save the settings.

Now, a session running from 19:00 to 21:00 would be charged at 1.5 times the base rate, while a session from 08:00 to 10:00 on a weekday would be charged at 0.7 times the base rate.

How Schedule Changes Affect Active Sessions

When a session spans multiple pricing schedule slots, HandyCafe creates new pricing segments at each slot boundary. For example, if a session starts at 17:00 (standard rate) and continues into 18:00 (peak rate), the session's billing is split into two segments:

  • Segment 1: 17:00 to 18:00 at the standard multiplier.
  • Segment 2: 18:00 onward at the peak multiplier.

This ensures accurate billing without interrupting the customer's session.