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

# Reorder Suggestions

> View and act on automatically generated reorder recommendations for your ingredients

Reorder suggestions are automatically generated recommendations that tell you which ingredients need to be ordered, how much to order, and when.

Mathership calculates suggestions based on the reorder configurations you set on each ingredient — taking into account current stock, consumption history, lead time, safety stock, and review period.

<CardGroup cols={3}>
  <Card title="Know what to order" icon="lightbulb">
    See which ingredients need attention based on current stock and recent consumption.
  </Card>

  <Card title="Plan by vendor" icon="truck">
    Review suggestions grouped by vendor and storage unit.
  </Card>

  <Card title="Act directly" icon="check">
    Adjust quantities, make an order, snooze, dismiss, or reopen suggestions.
  </Card>
</CardGroup>

## Opening suggestions

Go to **Automation** → **Reorder Suggestions**.

The page shows automatically generated reorder suggestions for your ingredients.

## How suggestions are generated

Mathership generates a suggestion for an ingredient when the calculated stock coverage falls below the threshold defined in the ingredient's reorder configuration.

The calculation uses:

| Input               | What it means                                                  |
| ------------------- | -------------------------------------------------------------- |
| Current stock       | On-hand quantity in the configured storage unit                |
| Review period       | The window in days used to calculate average daily consumption |
| Lead time           | How many days it takes for an order to arrive                  |
| Safety stock        | How many days of buffer stock to keep on hand                  |
| Min. order quantity | The smallest quantity that should be included in an order      |

Suggestions are grouped by vendor and storage unit. Each suggestion can contain multiple ingredients from the same vendor.

## Suggestion list

Each row in the list shows:

| Column         | Description                                                             |
| -------------- | ----------------------------------------------------------------------- |
| Vendor         | The vendor the order would go to, or **My inventory** for manual orders |
| Storage        | The storage unit the suggestion is scoped to                            |
| Items          | Number of ingredients in the suggestion                                 |
| Total value    | Estimated order value                                                   |
| Urgency        | How urgently the order is needed                                        |
| Suggested date | The recommended order date                                              |
| Created        | When the suggestion was generated                                       |

### Urgency levels

| Urgency  | Meaning                                      |
| -------- | -------------------------------------------- |
| Critical | Stock is at or near zero — order immediately |
| Warning  | Stock is below the safety stock threshold    |
| Low      | Stock is getting low but not yet critical    |
| OK       | Stock is adequate                            |

The list sorts by urgency by default. Click the **Suggested date** or **Created** column headers to change the sort order.

## Filtering

Use the status filter to view suggestions by their current status.

| Status    | Meaning                                   |
| --------- | ----------------------------------------- |
| Pending   | Suggestions that need action              |
| Snoozed   | Suggestions postponed until a future date |
| Dismissed | Suggestions permanently removed           |
| Ordered   | Suggestions marked as ordered             |

Click **Add filter** to show additional filters. Use **Clear all** to reset everything.

## Suggestion detail

Click any row to open the suggestion detail panel.

The panel shows:

* Vendor
* Storage unit
* Urgency badge
* Full item table
* Action buttons

### Item table

| Column        | Description                                                                 |
| ------------- | --------------------------------------------------------------------------- |
| Product       | Vendor product name, article number, and linked ingredient                  |
| Current stock | On-hand quantity shown with packaging breakdown                             |
| Consumed      | Total consumption during the review period and the number of days it covers |
| Coverage      | How many days the current stock will last                                   |
| Suggested     | The system-calculated order quantity                                        |
| Quantity      | Adjustable quantity you can change before placing the order                 |

Click the ingredient chip on any item to go directly to that ingredient's detail page.

For pending suggestions, use the **+** and **−** buttons in the **Quantity** column to adjust the order quantity per item.

## Actions on pending suggestions

Pending suggestions are suggestions that still need action.

<CardGroup cols={3}>
  <Card title="Make order" icon="cart-shopping">
    Use the suggestion to create an order draft with the selected quantities.
  </Card>

  <Card title="Snooze" icon="clock">
    Postpone the suggestion until a future date.
  </Card>

  <Card title="Dismiss" icon="xmark">
    Remove the suggestion from the pending list.
  </Card>
</CardGroup>

### Making an order

<Steps>
  <Step title="Open a pending suggestion">
    Click a suggestion row to open the detail panel.
  </Step>

  <Step title="Review the suggested items">
    Check the products, current stock, consumed quantity, coverage, suggested quantity, and order quantity.
  </Step>

  <Step title="Adjust quantities if needed">
    Use the **+** and **−** buttons in the **Quantity** column.
  </Step>

  <Step title="Create the order">
    Use the order action in the detail panel to create an order draft.
  </Step>
</Steps>

### Snoozing a suggestion

Use snooze when you do not want to order now, but want to review the suggestion again later.

After snoozing, the suggestion moves to the **Snoozed** status.

### Dismissing a suggestion

Click **Dismiss** in the suggestion detail panel. The suggestion moves to the **Dismissed** status.

## Actions on snoozed and dismissed suggestions

Switch the status filter to **Snoozed** or **Dismissed** to view suggestions you have already acted on.

Click **Reopen** in the detail panel to move a snoozed or dismissed suggestion back to **Pending**.

## Reorder configurations

Reorder configurations define the rules Mathership uses to generate suggestions for each ingredient.

You manage them from the ingredient detail page.

### Configuration fields

| Field                | Description                                                                       |
| -------------------- | --------------------------------------------------------------------------------- |
| Storage unit         | The storage unit this rule applies to, or **All storage units** for a global rule |
| Lead time (days)     | Days it takes for an order to arrive after placing it                             |
| Safety stock (days)  | Days of buffer stock to keep on hand                                              |
| Review period (days) | Window used to calculate average daily consumption — must be at least 1           |
| Min. order qty       | Minimum quantity to include in a suggested order                                  |
| Notify on critical   | Send a notification when stock reaches the critical threshold                     |
| Notify on warning    | Send a notification when stock reaches the warning threshold                      |

### Storage unit scope

Each configuration is scoped to either a specific storage unit or all storage units.

| Scope                 | Meaning                                                      |
| --------------------- | ------------------------------------------------------------ |
| All storage units     | One global rule covering the ingredient across all locations |
| Specific storage unit | A rule scoped to one location only                           |

You can only have one **All storage units** configuration per ingredient.

## Adding a configuration

<Steps>
  <Step title="Open an ingredient">
    Go to the ingredient detail page for the ingredient you want to configure.
  </Step>

  <Step title="Find reorder configuration">
    Open the reorder configuration area.
  </Step>

  <Step title="Choose the storage scope">
    Select either **All storage units** or a specific storage unit.
  </Step>

  <Step title="Enter the reorder values">
    Add lead time, safety stock, review period, minimum order quantity, and notification settings.
  </Step>

  <Step title="Save the configuration">
    Save the rule so Mathership can use it when generating suggestions.
  </Step>
</Steps>

## Common problems

<AccordionGroup>
  <Accordion title="No suggestions are appearing">
    Check that:

    * The ingredient has at least one reorder configuration
    * The review period is set to a value greater than zero
    * There is consumption history for the ingredient
    * The status filter is set to **Pending**
  </Accordion>

  <Accordion title="A suggestion reappears after dismissing it">
    Dismissing removes it from the pending list but does not prevent a new suggestion from being generated if stock remains low.

    Delete the reorder configuration if you want to stop suggestions permanently for that ingredient.
  </Accordion>

  <Accordion title="Make order creates no draft">
    Check that:

    * At least one item has a quantity greater than zero
    * The vendor product linked to each item still exists
    * You have permission to create orders for this company
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="AI Assistant" icon="robot" href="/en/restaurants/automation/ai-assistant">
    Use the assistant to query inventory, orders, and reorder suggestions in plain language.
  </Card>

  <Card title="Ingredients" icon="carrot" href="/en/restaurants/inventory/ingredients">
    Manage the ingredient data used for stock levels and reorder calculations.
  </Card>

  <Card title="Order History" icon="clipboard-list" href="/en/restaurants/ordering/order-history">
    Review previous, draft, and scheduled orders.
  </Card>

  <Card title="Inventory Alerts" icon="bell" href="/en/restaurants/inventory/inventory-alerts">
    Monitor low-stock and inventory-related alerts.
  </Card>
</CardGroup>