Reading & fulfilling orders
How to read the vehicle, customer, and appointment details attached to a CBP order.
Reading & fulfilling orders
👤 Ops
Orders are managed in the Shopify admin as normal (Managing orders). What's unique to CBP is the extra booking information attached to each line item.
Line-item properties
When a customer buys a battery — and especially when they book installation — the order's line items carry properties: the vehicle, the customer's contact and address, the chosen appointment slot, and a shared Order ID. These appear under each line item in the order detail view in the Shopify admin.
The full list of properties and what each means is in the line-item property reference.
A booked installation order
A typical installation order has two line items:
| Line item | Key details it carries |
|---|---|
| Battery | The vehicle/rego, customer details, appointment slot, and the Order ID. |
| Installation service | The name of the battery to install, and the same Order ID. |
The shared Order ID is what confirms the two lines belong to the same job. If you ever see an installation-service line with no matching battery, or mismatched Order IDs, treat it as an exception and check with the office/developer.
The appointment is confirmed when the order is paid
The slot the customer picked is only provisionally reserved until payment. When the order is paid, the booking system automatically confirms it — the appointment becomes a permanent entry in the installer's calendar and confirmation emails go out. You don't need to confirm it manually.
If a customer paid but has no confirmed appointment (no confirmation email, slot not in the
calendar), the payment notification likely didn't reach the booking system. Unpaid-looking
reservations are auto-released after about an hour, so act quickly: check with a developer about the
order_paid webhook. See Common issues.
Properties whose name starts with an underscore (e.g. _Order ID, _Slot ID) are "hidden"
properties — they're for internal use and don't display to the customer at checkout, but you can
see them on the order in the admin.
Fulfilling the job
- Read the appointment slot and customer details from the order.
- The central office assigns an installer from the Google Calendar (see Appointments).
- Fulfil/close the order in Shopify once complete, as normal.
Refunds and cancellations
Refunds and cancellations are handled ad hoc through the standard Shopify admin — there is no custom CBP flow for them. Use Shopify's tools:
Refunding or cancelling in Shopify does not automatically free the reserved installation slot in the calendar. If a booked job is cancelled, also remove/clear the appointment in the central Google Calendar so the slot can be reused.