Documentation

Quick Start Guide

Go from a new account to a first sale that deducts stock.

About 30 minutes 2 examples POS + Inventory

Before You Start

You work in two places:

  • Web admin: the back office you open in a browser. You set up the menu, products, stock and recipes here.
  • POS app: the app at the counter. You take orders and payment here. See Install the POS App.

You need the owner account you signed up with. It can do every step in this guide. The stock steps need the Inventory module on your account.

What a new trial account already contains
  • One branch, Main Branch, with its own warehouse, Main Branch - Storage.
  • Common units of measure, such as Kilogram, Gram, Liter, Piece and Pack.
  • Payment methods, menu categories and five sample dishes for your type of business.
  • No products, product categories, suppliers, stock or recipes. You add these in this guide.

The setup checklist on the Home page

The Web admin Home page shows the owner a card called Get your business ready. Its steps are: Add your business details, Make the menu yours, Add your staff, Take your first order, Add your products, Add a supplier and Record your opening stock. The last three appear only when your account has Inventory. Each step has a button that opens the right screen, and it is ticked once the data exists.

This guide follows the same order and adds the two things the checklist does not cover: the recipe, and the sale that deducts stock. If you hid the card, click Show setup checklist under the date on the Home page.

Choose Your Path

Start here
Example A: Fresh Orange Juice

About 20 minutes

The whole flow with one ingredient.

  • Add a menu item and take a first order
  • Add a product and its opening stock
  • Link them with a recipe and watch stock go down
Start Example A
Next
Example B: Classic Burger

About 15 minutes more

Buying from a supplier in packs.

  • Buy beef in 5 kg packs, use it in grams
  • Order with a purchase order, receive with a goods received note
  • A recipe with four ingredients
Go to Example B
Which one?

Do Example A first. Example B assumes the POS app is already set up and that you know how to take payment and complete an order.

Example A: Fresh Orange Juice

About 20 minutes · steps 1 to 4 get you selling, steps 5 to 9 add stock

1. Add your business details

Web admin. Open Branches and edit your branch. Enter the address under Location Details and the phone number under Contact Information, then click Save Changes.

2. Add the menu item

  1. Open the menu
    In the Web admin go to Point of Sale > Menu Items and click Add New Menu Item.
  2. Fill in the three required fields
    Name: Fresh Orange Juice. Category: pick one, or click New next to it to create one. Price: 1.250.
  3. Click Save
    Save & Add Another saves and gives you a blank form for the next dish.
The Create Menu Item form with Name, Category, Price, Preparation Time and Description, and the Save buttons
The Create Menu Item form. Name, Category and Price are required

The five sample dishes are ordinary menu items. Change them when you add your own menu. To add staff now, see Users and Roles; you can also do it later.

3. Set your PIN and set up the POS app

The POS app asks for a manager PIN the first time it is linked to a branch, so set yours first.

  1. Set your PIN (Web admin)
    Click your name at the top right and choose My PIN. Click Set Your PIN, enter your Account Password, a New PIN of 4 to 6 digits and the same PIN in Confirm PIN, then click Set PIN.
  2. Install the POS app and sign in
    Follow Install the POS App. Sign in with your Email Address and Password and tap Sign In.
  3. Choose the branch
    On Configure POS Terminal, pick your branch under Select Branch and tap Continue.
  4. Approve with your PIN
    Tap Authorize, pick your name under Select Manager, type your PIN and tap Authorize. Then tap Continue to Dashboard.
The Configure POS Terminal screen with the Select Branch list and the Continue button
Configure POS Terminal: choose the branch this device sells for

4. Take your first order

  1. Start the day
    In the POS app tap New Order. Because no day is open yet, Start of Day appears. Count the cash you are putting in the cash drawer and tap Start Day, or tap Skip to start with nothing in it. If your business takes no cash, the button reads Open Business Day. You are clocked in automatically.
  2. Add the dish
    The Menu screen opens, ready for a take-away order. Tap Fresh Orange Juice. It appears under Current Order. For later orders, tap New Order and choose Dine In, Take Away or Delivery.
  3. Take payment
    Tap Pay Now (on a phone, tap View Cart first). Tap Cash at the top, tap EXACT or type the amount received, then tap the Pay button. When PAYMENT APPROVED shows, tap Done.
  4. Complete the order
    Tap Orders, tap the order and tap Complete. If Complete is not there, the kitchen has not marked the order ready: tap the three-dot button and choose Completed, or open Kitchen and tap Start Cooking, then Ready, first.
The Start of Day screen with counts for each bill and coin, the opening cash balance and the Start Day and Skip buttons
Start of Day: count the opening cash by bill and coin, then tap Start Day
The Payment screen with the payment methods at the top, the total due, quick amount buttons, EXACT and the Pay button
Payment: choose the method at the top, tap EXACT or type the amount, then tap Pay
An open order on the Orders screen with the Complete button and the three-dot menu listing New, In Progress, Ready, Served and Completed
An order on the Orders screen: the Complete button, and Completed in the three-dot menu
Paying is not the last step

A paid order stays active until it is completed. Stock is deducted when a paid order is completed, not when it is paid, and you cannot close the day while orders are still active.

You can now sell. The next steps make each sale take its ingredients out of stock.

5. Add the product

A product is something you keep in stock. A menu item is something you sell. The recipe in step 8 connects the two.

  1. Open the form
    In the Web admin go to Inventory > Products and click Add New.
  2. Enter the name and category
    Name: Fresh Oranges. Next to Category click the + button, type Fresh Produce and click Create Category.
  3. Choose the base unit
    Base Unit of Measure: Kilogram. Stock is counted in this unit. Leave Product Code empty to have one generated, and leave Product Type and Procurement as they are.
  4. Click Save
    Name, Category and Base Unit of Measure are required.
The Create Product form in Simple mode with Product Code, Name, Category, Product Type, Procurement and Base Unit of Measure
The Create Product form in Simple mode
Leave the Opening Stock field alone

Switching the form to Advanced shows an Opening Stock field. Do not fill it in here. A product can have its opening stock declared only once per warehouse, and you do that in step 7.

6. Add a supplier

Go to Inventory > Suppliers and click Add New Supplier. Enter the Name (the only required field) and click Create supplier. Opening stock does not need a supplier, but every delivery you record later does.

7. Record your opening stock

Opening stock is what you already had on the shelf before you started. It adds stock without creating a bill from a supplier.

  1. Create the entry
    Go to Inventory > Opening Stock and click New Opening Stock Entry. Choose the Warehouse (Main Branch - Storage), the Effective Date and a Reason, for example Bought before using the system. Click Create and Add Products.
  2. Add the product
    Under Add Products, type Fresh Oranges and press Enter. Enter Quantity 20 and Unit Cost 0.600. Quantity is in the base unit, so this is 20 kg at 0.600 per kg.
  3. Save the line
    Click Save 1 line(s). The entry is still a Draft and stock has not changed.
  4. Post
    Click Post and confirm. The entry becomes Posted and the 20 kg is in stock. A posted entry cannot be edited, only reversed.

More detail: Opening Stock.

8. Add the recipe

The recipe says what one Fresh Orange Juice uses. Without an active recipe, selling the dish does not touch stock.

  1. Start a recipe
    Go to Point of Sale > Recipes and click New Recipe.
  2. Fill in the details
    Leave Type on Recipe - for a menu item you sell. Set Status to Active. Recipe Name: Fresh Orange Juice. In Menu Item, type the dish name and pick it. Yield: 1, Unit: Piece.
  3. Add the ingredient
    In the Ingredients search box type Fresh Oranges and pick it. Set Qty to 0.5, Unit to Kilogram and leave Waste% at 0.
  4. Click Save Recipe
    If you saved it as Draft, click Activate beside it in the recipe list. Only an active recipe deducts stock.
What Waste% does

Waste% is the share lost in preparation, such as peel. The quantity taken from stock is the recipe quantity divided by (1 minus the waste). With 0.5 kg and 20% waste, each juice takes 0.625 kg from stock.

9. Sell it and check the stock

  1. Sell two juices (POS app)
    Tap New Order, then Take Away. Tap Fresh Orange Juice twice, tap Pay Now and take payment as in step 4.
  2. Complete the order
    Tap Orders, open the order and tap Complete.
  3. Check the stock (Web admin)
    Go to Inventory > Reports > Stock Level. Fresh Oranges shows 19 under On Hand: 20 kg less 2 x 0.5 kg.
Example A done

You have a menu item, a product with stock, and a recipe that takes the stock out on every completed sale.


Example B: Classic Burger

About 15 minutes more · all setup is in the Web admin

You buy beef by the pack and use it by the gram. Each product keeps one base unit for stock and recipes, and can have extra units for buying.

Product Base unit Purchase unit Used in one burger
Ground Beef 80/20 Gram Pack = 5000 Gram 150 Gram
Brioche Burger Bun Piece Pack = 12 Piece 1 Piece
Cheddar Cheese Slices Piece Pack = 20 Piece 1 Piece
Iceberg Lettuce Gram Pack = 1000 Gram 30 Gram

1. Add the products with a purchase unit

Repeat these steps for each of the four products in the table.

  1. Create the product
    Go to Inventory > Products and click Add New. Enter the Name, a Category and the Base Unit of Measure from the table. Click Save and Continue Editing.
  2. Add the pack
    On the Edit Product page open the Units of Measure tab and click Add UOM. Choose Pack as the Unit of Measure. In Conversion Factor enter how many base units one pack holds, for example 5000 for the beef.
  3. Make it the buying unit
    Tick Purchase Default and click Add UOM. Purchase orders for this product now start in packs.
The Units of Measure tab of a product listing Box with factor 24 marked Purchase, Pack with factor 6 and Piece marked Base
The Units of Measure tab of a drinks product: Piece is the base unit, Box (24 pieces) is the purchase default

More detail: Packaging and Units of Measure.

2. Order from the supplier

  1. Start a purchase order
    Go to Inventory > Purchase Orders and click Create New Order. Choose the Supplier and the Receiving Warehouse. Both are required.
  2. Add the lines
    Under Order Items, type a product name and pick it. Each pick adds a line with quantity 1. Set the quantity, check the unit is Pack, and enter the price for one pack.
  3. Save, submit and approve
    Click Create Purchase Order. The order opens as a Draft. Click Submit, then Approve. Only an approved order can be received.
ProductQuantityUnit priceAdds to stock
Ground Beef 80/202 Pack12.50010,000 Gram
Brioche Burger Bun3 Pack0.96036 Piece
Cheddar Cheese Slices2 Pack1.00040 Piece
Iceberg Lettuce2 Pack0.8002,000 Gram
The New Purchase Order form with supplier, receiving warehouse and four order lines in packs: beef, buns, cheese slices and lettuce
A purchase order for the four burger ingredients, each ordered in packs

3. Receive the delivery

  1. Create the goods received note
    On the approved purchase order click Create GRN.
  2. Check the quantities
    For each line check RECEIVED against what arrived. Put anything you send back in REJECTED.
  3. Click Receive & Post
    Stock goes up in base units: 2 packs of beef become 10,000 grams. If your account requires approval of received goods, the button reads Save as Draft and the note is posted after approval.

More detail: Purchases and Goods Received Notes.

Bought without a purchase order?

For a market run or a cash purchase, go to Inventory > Direct Receipt and click Create Direct Receipt. You enter the supplier, the items and what you paid on one screen, then click Receive & Post. See Direct Receipts.

4. Add the burger and its recipe

If your sample dishes do not include a Classic Burger, add it as in step 2 of Example A. Then go to Point of Sale > Recipes, click New Recipe, set Status to Active, pick Classic Burger as the Menu Item and add these ingredients:

IngredientQtyUnitWaste%
Ground Beef 80/20150Gram0
Brioche Burger Bun1Piece0
Cheddar Cheese Slices1Piece0
Iceberg Lettuce30Gram0
Check the Unit on every line

A new ingredient line can start in the product's purchase unit. If Unit shows Pack, change it to Gram or Piece. A line of 150 Pack would take 150 packs of beef for every burger.

The saved Classic Burger recipe, Active, with four ingredients in grams and pieces, total cost, selling price and food cost percentage
The saved recipe: Active, linked to the Classic Burger menu item, with each ingredient in grams or pieces

More detail: Recipes.

5. Sell two burgers and check the stock

In the POS app, sell two Classic Burgers, take payment and complete the order. Then open Inventory > Reports > Stock Level in the Web admin.

ProductAfter receivingDeductedOn Hand
Ground Beef 80/2010,000300 (2 x 150)9,700
Brioche Burger Bun36234
Cheddar Cheese Slices40238
Iceberg Lettuce2,00060 (2 x 30)1,940

If the Stock Did Not Change

A sale deducts stock only when all of these are true. The order itself still goes through if one is missing, so check them in this order:

  • The order is paid and completed. In the POS app, Orders shows it as Paid, and it is no longer on the Active tab.
  • The menu item has an active recipe with ingredients. Check Point of Sale > Recipes: the Menu Item column shows the dish and Status is Active.
  • The product has stock in the warehouse of the branch that sold it. Stock is taken from the warehouse of the branch the POS app is linked to. The opening stock entry or goods received note must be Posted, and for that warehouse.
  • The recipe unit belongs to the product. Use the product's base unit, or a unit added on its Units of Measure tab. A line in a unit that cannot be converted to the base unit is skipped.

At the End of the Day

In the POS app open Cash Drawer and tap End of Day. Count the cash and tap Close Business Day. The day cannot be closed while any order is still active, so complete or void every order first. See Closing the Day.

What's Next