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

# View, manage, and fulfill customer orders in Cartble

> Learn how to view incoming orders, advance fulfillment status, read financial and fulfillment codes, and manage subscription billing records.

In Cartble, customer orders are called **records**. The terminology adapts to your industry — what appears as "Order" in a retail context becomes "Ticket" or "Booking" in other blueprints — but the underlying data model is the same. You manage all records from **Admin → Records**.

The Records Manager focuses on **today's activity** by default, showing a real-time feed of incoming orders with an aging indicator that highlights how long each record has been waiting.

## Order lifecycle

Records move through a linear fulfillment workflow. Use the **Advance Status** button on any record to push it to the next stage.

<Steps>
  <Step title="Pending">
    A new order has arrived and is waiting to be acknowledged. The aging indicator turns amber after 15 minutes and red after 30 minutes to help you prioritize.
  </Step>

  <Step title="Processing">
    You have accepted the order and are preparing it (packing, cooking, or scheduling the appointment).
  </Step>

  <Step title="Shipped">
    The order has left your hands — dispatched for delivery, out for pickup, or en route to the customer.
  </Step>

  <Step title="Delivered / Cancelled">
    Terminal states. Delivered orders and cancelled orders appear together in the **History** tab.
  </Step>
</Steps>

## Financial and fulfillment statuses

Each record carries two independent status fields:

**Financial status** tracks payment:

| Status           | Meaning                                  |
| ---------------- | ---------------------------------------- |
| `pending`        | Payment has not been confirmed yet       |
| `paid`           | Payment was successfully captured        |
| `partially_paid` | A partial amount was collected           |
| `refunded`       | The full amount was returned             |
| `voided`         | The payment was cancelled before capture |

**Fulfillment status** tracks physical delivery:

| Status                | Meaning                                       |
| --------------------- | --------------------------------------------- |
| `unfulfilled`         | Nothing has been shipped yet                  |
| `partially_fulfilled` | Some items have been fulfilled                |
| `fulfilled`           | All items have been delivered                 |
| `restocked`           | Items were returned and put back in inventory |

<Note>
  The aging indicator and workflow tabs in the Records Manager are driven by the **fulfillment status**, while financial metrics (today's total sales, average ticket) are calculated from records with `financialStatus: paid`.
</Note>

## Order numbers

Each record has a human-readable `transactionNumber` (for example, `#1001`). Cartble generates this by incrementing the `lasttransactionNumber` counter stored on your platform document. The number is sequential and unique per store.

## Order details

Each record contains:

* **Customer name and shipping address** — shown in the record header and included in the thermal print view
* **Items** — list of purchased resources with name, quantity, and unit price; selected modifiers (for food/on-demand orders) and the chosen variant are also stored per item
* **Total price** — the final charged amount stored in cents along with the currency code
* **Delivery type** — `delivery`, `pickup`, or `table`, depending on your checkout configuration
* **Applied discount** — if a discount code or automatic promotion was used, the discount title, code, type, and exact amount saved are recorded on the order

## Printing orders

Click the **Print** icon on any record to open a thermal-print-ready receipt in a new window. The receipt includes the order number, item list with quantities and prices, total, and shipping address.

## Subscription records

If your store offers subscription products, the platform also stores **subscription records** separately from one-time orders. Each subscription record includes:

| Field               | Description                                                              |
| ------------------- | ------------------------------------------------------------------------ |
| `billingPeriod`     | Recurring interval: `monthly`, `quarterly`, `semi_annually`, or `yearly` |
| `status`            | `active`, `past_due`, `canceled`, or `trialing`                          |
| `nextBillingDate`   | Date of the next scheduled charge                                        |
| `gatewayUsed`       | Payment provider used for recurring charges (e.g., `stripe`)             |
| `cancelAtPeriodEnd` | Whether the subscription will cancel at the end of the current period    |
| `trialEndsAt`       | Date when the free trial period ends (if applicable)                     |

<Info>
  Subscription records are linked to a specific resource and customer. You can view a customer's active subscriptions from their profile in **Admin → Customers**.
</Info>

## Sound notifications

The Records Manager plays a cash-register sound whenever a new record arrives. Use the **sound toggle** in the top-right corner of the page to enable or disable this notification.