Pyle

Orders ​

What This Is ​

Orders are the main records your team uses to review what a customer requested, what needs to ship, what was charged, and what happened after confirmation.

In Pyle, the same record also starts life as a cart before it is confirmed.

When You Would Use It ​

Use Orders when you need to:

  • review customer, address, and reference details
  • verify items, quantities, and prices
  • add a one-off custom item (for example handling or freight) when a catalog product is not the right fit
  • review shipping choices and shipping totals
  • check taxes, discounts, and payment status
  • confirm, cancel, duplicate, or otherwise act on an order
  • help a customer understand what has shipped and what is still pending

Before You Start ​

Before you review an order, make sure:

  • you know whether you are working in the admin order page or in shopper-facing order history
  • the order already exists
  • you understand whether the record is still a cart or already a confirmed order

In the shared package, the strongest packaged order workspace is the admin order page. Shoppers use My Account order history and order detail for the customer-facing side.

How To Use It In The Admin ​

  1. Go to Orders in the admin.
  2. Open the order you want to review.
  3. Use the page sections in this order:
    • Overview
    • Items
    • Shipping Details
    • Financial Details
    • Comments
  4. Check the main operational fields:
    • customer
    • shipping and billing addresses
    • reference number
    • project number
    • order status
    • fulfillment status
    • financial status
  5. Use the order actions when appropriate:
    • calculate
    • confirm
    • cancel
    • delete
  6. Review notifications before confirmation, especially critical ones that block checkout or confirmation.

In Items, operators can now use both entry points:

  • product search for catalog-backed lines
  • Custom item for productless manual lines with item code, title, SKU, product type, quantity, price, cost, taxable, and note

What It Changes In The Storefront ​

Orders affect the storefront and shopper experience through:

  • My Account order history
  • order-detail pages
  • shipped and unshipped item visibility
  • invoice availability
  • delivery status and fulfillment visibility

Common Tasks ​

Review a draft cart before confirmation ​

Check addresses, shipping selections, reference number, and critical notifications before the order is confirmed.

Review an open order after confirmation ​

Check items, shipping, financial details, fulfillments, and related recovery work such as returns or refunds.

Help a customer understand order status ​

Use order status, fulfillment status, shipping lines, and shipped-item visibility together instead of relying on only one status field.

Rules, Limits, And Things To Watch ​

  • A cart and an order are the same underlying record at different lifecycle stages.
  • Critical notifications can block confirmation or checkout.
  • Changing the customer can reset addresses and tax settings.
  • Returns, refunds, and shipped fulfillments are related to the order, but each has its own operational workflow.
  • Product-backed line identity stays locked in item edit, while productless custom lines can have title, SKU, quantity, and pricing adjusted.

Troubleshooting ​

The order cannot be confirmed ​

Check whether there are critical notifications, empty quantities, missing shipping selection, or payment-method issues.

Totals look wrong ​

Run the calculate flow and review shipping lines, discount lines, and taxes together.

The Custom item button is disabled ​

Custom items can only be added while the order is still updatable (typically draft/cart state).

The customer says the order page and storefront do not match ​

Check whether you are looking at the admin order view, the storefront order-detail view, or a cart that has not been confirmed yet.

  • Cart
  • Order Items
  • Returns
  • Order Tracking

Sources ​

  • packages/framework/src/Http/Controllers/Api/Admin/OrdersController.php
  • packages/storefront/src/Livewire/Storefront/MyAccount/Orders
  • packages/storefront/src/Livewire/Storefront/MyAccount/Order