> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ofatoura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud Kitchen setup, items, and stock

> Initialize your Cloud Kitchen, build your item catalog, view on-hand quantities, record stock movements, and run physical stock counts — all from the web admin.

The Cloud Kitchen module gives you a centralized inventory hub that supplies your branches. Before you can receive goods, produce batches, or dispatch to branches, you need to name your Cloud Kitchen, link the branches that depend on it, and define the items you will track.

<Note>
  All Cloud Kitchen pages are in the web admin (browser dashboard) under **Cloud Kitchen Inventory**. There is no Cloud Kitchen section in the ePOS waiter app.
</Note>

## Permissions

| Action                                 | Permission required                                      |
| -------------------------------------- | -------------------------------------------------------- |
| All setup, items, stock, and movements | Staff with the **Manage Cloud Kitchen** permission       |
| Running stock counts                   | Also requires the **CK Perform Stock Count** permission  |
| Managing waste reasons                 | Also requires the **CK Manage Waste Reasons** permission |

***

## Initial setup

<Steps>
  <Step title="Open the Setup tab">
    In the web admin, go to **Cloud Kitchen Inventory** and open the **Settings** area, then select the **Setup** tab.
  </Step>

  <Step title="Name your Cloud Kitchen">
    Enter a name for your Cloud Kitchen (required, up to 255 characters). This name appears throughout the module and on dispatch records.
  </Step>

  <Step title="Link branches">
    From the branch list, tick every branch that will receive supplies from this Cloud Kitchen. You can link or unlink branches at any time. Only linked branches appear as destinations when you dispatch stock.
  </Step>

  <Step title="Save">
    Save your changes. Your Cloud Kitchen is now active and ready for items to be added.
  </Step>
</Steps>

***

## Building your item catalog

Cloud Kitchen items are the products you hold in central stock — ingredients, prepared goods, or packaging. Each item gets a name, an optional unit of measure, and an optional transfer price.

<Steps>
  <Step title="Go to Items">
    Under **Cloud Kitchen Inventory**, select **Items**.
  </Step>

  <Step title="Add a new item">
    Click **Add item** (or the equivalent button). Fill in the fields:

    | Field           | Notes                                                                                  |
    | --------------- | -------------------------------------------------------------------------------------- |
    | Name            | Required. Up to 255 characters.                                                        |
    | Unit of measure | Optional. Choose from your restaurant's unit list (e.g. kg, litre, box).               |
    | Transfer price  | Optional. The price used when this item is moved to a branch. Must be zero or greater. |
  </Step>

  <Step title="Save">
    Save the item. It now appears in stock views, movement forms, and dispatch screens.
  </Step>
</Steps>

<Tip>
  You can edit any item's name, unit, or transfer price at any time. Deleting an item is only possible if it is not currently used in any stock movement, recipe, or dispatch record.
</Tip>

Use the search bar on the Items page to find items quickly as your catalog grows.

***

## Viewing on-hand stock

The **Stocks** page gives you a live snapshot of what is currently available in your Cloud Kitchen.

Each row shows the item name, its unit symbol, the current on-hand quantity, and a status badge — **In stock** or **Out of stock**.

You can filter the list by status (all items / in stock only / out of stock only) and search by item name. From this page you can also open the form to receive new stock or record other movements directly.

***

## Recording stock movements

The **Movements** page is where you record every stock transaction manually — receiving goods from a supplier, writing off consumed stock, or logging waste.

### Adding a stock-in movement (receiving goods)

<Steps>
  <Step title="Open Movements and choose stock in">
    Go to **Cloud Kitchen Inventory → Movements** and click **Add movement**, then select **Stock in** as the movement type.
  </Step>

  <Step title="Fill in the details">
    | Field               | Notes                                                           |
    | ------------------- | --------------------------------------------------------------- |
    | Item                | Required. Choose from your item catalog.                        |
    | Quantity            | Required. Must be greater than zero.                            |
    | Supplier            | Optional. Select the supplier delivering the goods.             |
    | Unit purchase price | Optional. The price you paid per unit.                          |
    | Expiration date     | Optional. Record a best-before or use-by date for traceability. |
  </Step>

  <Step title="Save">
    Save the movement. The on-hand quantity for the item increases immediately.
  </Step>
</Steps>

<Note>
  You can edit or delete a stock-in movement after saving it. Deleting reverses the quantity change.
</Note>

### Adding a stock-out movement

Follow the same steps as stock-in but choose **Stock out** as the movement type. Provide the item and quantity. No supplier or pricing fields are required for outbound movements.

### Recording waste

<Steps>
  <Step title="Select Waste as the movement type">
    In the Add movement form, choose **Waste**.
  </Step>

  <Step title="Fill in the details">
    Provide the item, quantity, and a **waste reason** (required for waste movements). The waste reason list is configured separately — see [Waste reasons](#waste-reasons) below.
  </Step>

  <Step title="Save">
    The quantity is deducted from on-hand stock and the reason is recorded for reporting.
  </Step>
</Steps>

### Filtering movement history

On the Movements page you can filter by movement type (In, Out, Waste, Dispatch, Production) and by date range (today, this week, this month, this quarter). Use these filters to audit stock activity for a specific period or trace a particular item.

***

## Waste reasons

Before staff can log waste, the waste reason list must contain at least one active reason.

<Steps>
  <Step title="Go to Waste reasons">
    Under **Cloud Kitchen Inventory**, select **Waste reasons**.
  </Step>

  <Step title="Add a reason">
    Click **Add reason**, enter a name (e.g. "Expired", "Dropped", "Overproduction"), and save.
  </Step>

  <Step title="Activate or deactivate reasons">
    Toggle a reason's active status to control which reasons appear when staff log waste. Inactive reasons are hidden from the waste movement form but remain in historical records.
  </Step>
</Steps>

<Tip>
  Keep your waste reason list short and specific. A manageable list makes waste reports more meaningful.
</Tip>

***

## Stock counts

A stock count lets you physically count all items and compare the real-world quantities against what the system expects. This helps identify discrepancies caused by unrecorded waste, spillage, or data entry errors.

<Steps>
  <Step title="Open Stock counts">
    Under **Cloud Kitchen Inventory**, select **Stock counts**.
  </Step>

  <Step title="Create a new count draft">
    Click **New stock count**. The system creates a draft with one line per item, pre-filled with the system's current quantity at the moment of creation.
  </Step>

  <Step title="Enter counted quantities">
    Open the draft and work through each item line. Enter the quantity you physically counted in the **Counted** column. Add optional notes for the count session (e.g. "End of week count — freezer unit 2").
  </Step>

  <Step title="Review variance">
    For each item the system shows the **system quantity** (what the records say) and the **counted quantity** (what you found). The difference is the variance. Review these figures to identify items that need investigation.
  </Step>
</Steps>

<Warning>
  Stock count drafts capture the system quantity at the moment the draft is created. If stock movements are recorded after the draft is opened, the variance figures will reflect those changes. Create your draft and complete the physical count in the same session where possible.
</Warning>

***

## Related

* [Cloud Kitchen overview](/cloud-kitchen/index)
* [Cloud Kitchen procurement and production](/cloud-kitchen/procurement-production)
* [Dispatching to branches, mappings, reports, and alerts](/cloud-kitchen/dispatch-and-reports)
* [Inventory stock levels, movements, and waste](/inventory/stock-and-movements)