🎆 rest-events

Festival Orders

Festival Orders plans ahead for high-demand occasions like Diwali or Christmas — you set up a festival with a target production quantity for each product, then collect individual customer advance orders against it (with an advance payment), track fulfillment status, and hand each order off to billing once it's ready to be sold.

📍 Menu path: Events & Banquet → Festival Orders

👤 Who uses it: All roles with the Billing feature enabled

Overview

This page is shared across BazaarPOS variants (the same component and API used by the bakery module) rather than being a restaurant-specific build — in pos-app-restaurant it appears as the "Festival Orders" item under Events & Banquet, giving restaurants the same advance-order planning tool bakeries use for festival production.

A Festival record has a Name, Event Date, an optional Order Cutoff Date (after which the UI flags the festival as "Order cutoff passed"), Notes, and a list of Products each with a Target Quantity and Price.

Selecting a festival from the left-hand list shows its Orders Panel with four summary tiles — Orders, Advance (collected), Total (order value) and Balance (pending) — plus a per-product "Production Needs" progress bar comparing quantity ordered against each product's target.

Each customer order records a Customer Name (required), Phone, an Advance Amount collected up front, Notes, and one or more line items with quantity — the Order Total is calculated automatically from quantities × each product's festival price.

Orders move through a fixed status flow: Received → Confirmed → Ready → Delivered, advanced one step at a time via a button; Cancelled is a separate status.

The "Bill via POS" action on an order not yet linked to a sale hands the order's items, customer and a note (including the advance already collected) straight into billing; once billed, the order shows a Print Invoice button instead, linking back to the completed sale.

Deleting a festival deletes all of its orders as well — a confirmation prompt names the festival before this happens.

Before You Start

You must have the Billing feature enabled on your plan.

Step-by-Step Guide

1 Create a new festival

Open Events & Banquet → Festival Orders and click "New Festival".
Enter the Festival Name (e.g. "Diwali 2026") and Event Date (both required), plus an optional Order Cutoff Date and Notes.
Under Products & Target Quantities, search for or type each product name, and enter its Target Qty and Price — use "+ Add" for more products.
Click "Create Festival" to save.

2 Collect a customer's advance order

Select the festival from the left-hand list, then click "Add Order" in its Orders Panel.
Enter the Customer Name (required), Phone, and enter a Qty for each product line the customer wants — the Order Total updates automatically.
Enter the Advance Collected amount and any Notes, then click "Add Order".

3 Advance an order and bill it

Click the status button on an order (e.g. "→ Confirmed") to move it forward one stage at a time through Received → Confirmed → Ready → Delivered.
Once the order is ready to hand over and hasn't already been billed, click the invoice icon ("Bill via POS") to send its items, customer and advance-payment note straight into billing.
After billing, the order shows a printer icon instead — click it to view/print the linked sale's invoice.

4 Track production needs

Open the festival and check the "Production Needs" panel — each product shows a progress bar of quantity ordered against its Target Qty.
Use this to decide whether to keep taking orders for a product or to close it off as production capacity is reached.

Every Field & Button, Explained

Field / Button	What it does
`Festival Name, Event Date`	Both required before a festival can be saved.
`Order Cutoff Date`	Optional; once this date has passed, the festival is flagged "Order cutoff passed" in the list, though orders can technically still be added after that point.
`Products & Target Quantities`	Each product line has a Target Qty (used as the denominator for the Production Needs progress bar) and a Price (used to calculate order totals) — products can be searched from your catalogue or typed as custom names.
`Customer Name / Phone (per order)`	Customer Name is required; Phone is optional but useful for follow-up.
`Advance Amount`	The amount collected up front from the customer, tracked separately from the Order Total and summed in the "Advance" summary tile.
`Order Total`	Calculated automatically as the sum of each line's Qty × the festival's Price for that product — not manually editable.
`Status`	Received → Confirmed → Ready → Delivered, advanced one stage at a time via a button; Cancelled is a separate status not part of the forward sequence.

Tips & Best Practices

Set realistic Target Qty figures per product when creating the festival — the Production Needs progress bars are only useful as an early-warning signal if the targets reflect what your kitchen can actually produce.
Collect at least a partial Advance Amount on every order — it is what the Balance summary tile and the note passed into billing are built around, and helps hold customers to their pre-order.
Bill an order only once it is truly ready to hand over — "Bill via POS" creates the actual sale, so billing too early can create a sale before the items are prepared.

Troubleshooting & FAQ

The Order Total looks wrong for a customer's order.

It is calculated purely from Qty × the festival's Price for that product at the time the order was placed — if the Price for a product was changed on the festival afterwards, existing orders keep their original total rather than recalculating.

I can't bill an order.

The "Bill via POS" icon only appears on orders that are not Cancelled and do not already have a linked sale — an order already billed shows a Print Invoice icon instead.

Deleting a festival removed orders I still needed.

Deleting a festival deletes all of its orders as well, with no separate recovery step — the confirmation prompt names the festival specifically to warn you before this happens.