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.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.
Order lifecycle
Records move through a linear fulfillment workflow. Use the Advance Status button on any record to push it to the next stage.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.
Processing
You have accepted the order and are preparing it (packing, cooking, or scheduling the appointment).
Shipped
The order has left your hands — dispatched for delivery, out for pickup, or en route to the customer.
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 |
| 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 |
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.Order numbers
Each record has a human-readabletransactionNumber (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, ortable, 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) |
Subscription records are linked to a specific resource and customer. You can view a customer’s active subscriptions from their profile in Admin → Customers.