Pyle

Shipping Services ​

What This Is ​

Shipping Services are the actual priced delivery or pickup options Pyle evaluates for a shipment.

A shipping service combines:

  • a shipping method
  • an inventory location
  • pricing rules
  • delivery timing
  • geographic and product restrictions

When You Would Use It ​

Use Shipping Services when you need to:

  • change what shoppers can choose at checkout
  • change delivery or pickup pricing
  • restrict a service by geography, product type, customer, or weight
  • change which service should win when multiple services share the same method

Before You Start ​

Before you work with Shipping Services, make sure:

  • the shipping method already exists
  • the inventory location already exists
  • any needed shipping zones, shipping classes, and product types already exist
  • you know whether your team manages them through the shipping workbook or a project-specific internal screen

In the shared package, the main bulk-management path is the shipping Excel workflow. The packaged order and cart screens use the resulting eligible services later, but they are not the main place where services are defined.

How To Use It In The Admin ​

  1. Decide whether your project manages services through the shipping workbook or a project-specific internal screen.
  2. If you are using the shipping workbook, go to Tools > Excel and export the shipping report.
  3. Edit the shipping_services sheet:
    • method UUID
    • inventory-location UUID
    • price and currency
    • delivery-day range
    • geographic and product restrictions
    • free-shipping and priority flags
  4. Import the updated workbook if you are using the spreadsheet flow.
  5. Review an order shipment or storefront estimate to confirm the service behaves as expected.

What It Changes In The Storefront ​

Shipping Services directly affect:

  • which delivery-method cards shoppers see per shipment in cart
  • the shipping methods shown to shoppers
  • the price shown for each method
  • which pickup or delivery paths are available for a shipment
  • optional shipping add-ons
  • which dates are valid when calendar rules apply

In shopper-facing screens, Pyle usually collapses the raw service rules into a simpler delivery-method choice with price, transit days, and date fields.

Common Tasks ​

Change a delivery price ​

Update the service price and confirm the storefront estimate or order shipment reflects it.

Restrict a service ​

Use zones, postal-code, class, product-type, customer, or country and state restrictions when the service should not apply universally.

Prioritize one service over another ​

Use the priority flag when multiple services share one shipping method and you want one to win first.

Rules, Limits, And Things To Watch ​

  • A shipping service is not the same thing as a shipping method.
  • Free shipping can still be suppressed if the service does not allow zero-price results.
  • Priority changes which service wins inside a method group.
  • A service may exist in configuration and still be unavailable for a real shipment because another restriction filtered it out.
  • Product pages and cart availability can change with the shopper's selected location or session postal code even before a service is chosen.

Troubleshooting ​

The service exists, but shoppers cannot select it ​

Check the destination geography, shipment size, product types, and location used by the shipment.

The wrong service wins ​

Check whether another service for the same method is marked as priority.

The storefront price does not match the base service price ​

That can be normal. The final price may include shipping options, free-shipping rules, or shipping-price pipeline logic.

For the full operator recovery checklist, see How to troubleshoot why a shipping service is not available.

Sources ​

  • packages/framework/src/Http/Controllers/Api/Admin/ShippingServicesController.php
  • packages/framework/src/Actions/Exports/Shipping/Sheets/ShippingServicesSheet.php
  • packages/framework/src/Actions/Import/Shipping/Sheets/ShippingServicesImportSheet.php
  • packages/admin/src/Livewire/Admin/Order/Shipments/Block.php
  • packages/framework/src/Http/Controllers/Api/Storefront/ShippingController.php