Pyle

Fulfillment Requests ​

What This Is ​

Fulfillment Requests are the planning records Pyle uses before items are actually fulfilled.

They bring together:

  • the order
  • the inventory location
  • request items
  • delivery or pickup dates
  • transfer locations
  • confirmation state
  • quote and document workflows

When You Would Use It ​

Use Fulfillment Requests when you need to:

  • plan how items from one location will be delivered or picked up
  • confirm what the supplier can actually fulfill
  • manage delivery timing and transfer stops
  • send scheduling, quote, or pickup details
  • create the final fulfillment once the request is ready

Before You Start ​

Before you work with a Fulfillment Request, make sure:

  • the order already exists
  • the order has a shipping address
  • the correct inventory location is known
  • the items are ready for planning or confirmation

In the shared package, the fulfillment-request workflow is well defined, but the exact operator workspace can vary by project. Some teams expose a dedicated operations screen, while others surface the same workflow through custom internal tools.

How To Use It In The Admin ​

  1. Open your project’s fulfillment-request workspace or the internal operations screen that surfaces fulfillment requests.
  2. Review the key operational fields:
    • location
    • shipping carrier and type
    • pickup date
    • estimated delivery date
    • internal note
    • transfer locations
    • waiting-for-details flags
  3. Confirm items only after the dates and confirmation number are ready.
  4. Fulfill items only after confirmed quantities are correct and tracking details are available.
  5. Use the available actions when needed to:
    • calculate the request
    • mark delivery booked
    • send vendor quote or fulfillment-request emails
    • send pickup details
    • download PDFs or estimated invoices

What It Changes In The Storefront ​

Fulfillment Requests are usually not a direct storefront concept.

They change the customer experience indirectly by driving:

  • schedule-related emails
  • pickup details
  • delivery booking communication
  • the final fulfillment records customers later see in order history
  • order-tracking and shipped-item updates after the request turns into a real fulfillment

Common Tasks ​

Plan a request for one location ​

Set the correct location, dates, and notes before you start confirmation.

Confirm request items ​

Use this when the supplier has confirmed quantities and timing.

Turn a request into a fulfillment ​

Fulfill the confirmed items only after tracking information is ready.

Rules, Limits, And Things To Watch ​

  • A request is not the same thing as a fulfillment.
  • You cannot confirm a request without the required dates.
  • Transfer locations need their own pickup and estimated-delivery dates before the request can be confirmed.
  • Fulfilling items has downstream effects on order status, invoices, and inventory.

Troubleshooting ​

I cannot confirm the request ​

Check whether pickup date, estimated delivery date, transfer dates, and confirmation number are all set.

I cannot fulfill the items ​

Check confirmed quantities, tracking details, and any hold-until-payment constraints on the order items.

The request changed after I updated an item ​

That can be normal. Fulfillment requests recalculate when the request or its items change.

  • Fulfillment
  • Shipping Services
  • Calendar Rules
  • Inventory Locations

Sources ​

  • packages/framework/src/Http/Controllers/Api/Admin/FulfillmentRequestsController.php
  • packages/framework/src/Actions/FulfillmentRequest/UpdateFulfillmentRequest.php
  • packages/framework/src/Actions/FulfillmentRequest/ConfirmFulfillmentRequestItems.php
  • packages/framework/src/Actions/FulfillmentRequest/FulfillFulfillmentRequestItems.php