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

# Order emails

> Set up mailboxes that turn purchase-order emails into structured order data.

An order mailbox turns inbound purchase orders — a forwarded Shopify notification, an Odoo confirmation, a customer's plain-text email — into structured line items matched against your [SKU catalog](/dashboard/sku-catalog). Set the mailbox **Template** to `ORDER` and **Delivery mode** to `REVIEW FIRST` so a person confirms each draft before it delivers.

## Sender recipes

Exact senders and `@domain` suffixes go in **Allowed senders** (one per line; empty allows everyone). Email from anyone else is marked `SKIPPED` — see [Senders and security](/configuration/senders-and-security).

| Source                       | Typical sender                                        | Allowlist entry                                          |
| ---------------------------- | ----------------------------------------------------- | -------------------------------------------------------- |
| Shopify store notifications  | `<your-store>@shopifyemail.com` or your custom sender | `@shopifyemail.com`, or the custom domain you configured |
| Odoo order confirmations     | the address your Odoo instance sends from             | `orders@yourcompany.com` or `@yourcompany.com`           |
| A customer's purchase orders | their ordering address                                | `purchasing@customer.com`                                |

<Warning>
  A `@domain` suffix trusts every sender on that domain. Prefer an exact address when the provider lets you pin one.
</Warning>

## What review resolves

Extraction reports issues instead of guessing. In the [inbox](/dashboard/inbox) detail view:

* **Low-confidence product match** — a catalog candidate the model picked but wouldn't commit to stays unresolved and shows as **suggested (N%)** in the SKU list; accept it per line or with **Accept all suggestions**.
* **Missing unit** — prefilled from the matched product's catalog unit, with a non-blocking note so the fill stays auditable. **Apply catalog units** does the same for every line at once.
* **Missing unit price** — derived as `total ÷ quantity` when both are present, flagged with a non-blocking note.
* **Ambiguous currency** — a bare symbol (`$`, `kr`, `¥`) or unknown code blocks delivery until you set the ISO 4217 code.
* **Possible duplicate** — a warning when the same order reference was already extracted from another email on the mailbox.
* **New product** — **+ Create catalog SKU** in the SKU list adds it without leaving the review.

## Delivery

Approve a draft to send the canonical order payload to the mailbox's [webhook](/configuration/webhooks) or [reply email](/configuration/reply-emails). Order deliveries include `customer_name`, `order_ref`, `order_date`, `currency`, `notes`, and `line_items` with `matched_sku`, `quantity`, `uom`, `unit_price`, and `total`.
