Pyle

Shipping Carriers ​

What This Is ​

Shipping Carriers are the companies or services that physically move your shipments — couriers, freight providers, pickup operators, or any other delivery partner your business works with.

In Pyle, a carrier record holds the carrier's identity and contact details. Each carrier can be linked to one or more broker services that let Pyle request rates and dispatch shipments through a connected shipping API.

When You Would Use It ​

You manage Shipping Carriers when you need to:

  • add a new delivery partner to your platform
  • update a carrier's contact information, account number, or call-window settings
  • link a carrier to a broker service so that fulfillment workflows can dispatch through a shipping API
  • remove a carrier service that is no longer active

Before You Start ​

Before creating a carrier:

  • Confirm the carrier's name and code are not already in use
  • If you plan to attach broker services, make sure the relevant shipping broker has been configured in the platform (brokers are set up by your technical team, not through the admin UI)
  • Know the shipping type the carrier handles — for example, parcel, freight, or will-call pickup

How To Use It In The Admin ​

Navigate to Settings → Shipping Carriers to see the full list of carriers. You can search by name or code.

Creating a carrier ​

  1. Click Create to open the create dialog.
  2. Fill in the required Name field. A code is generated automatically from the name; you can override it.
  3. Optionally fill in:
    • Shipping Type — the primary type of shipment this carrier handles
    • Account Number — your account reference with this carrier
    • Image URL — a logo for display purposes
    • Will Call — enable this if the carrier requires a phone call before pickup, then set the expected call window in hours and minutes
    • Phone, Contact Name, Contact Email — primary contact details
    • Notification Emails — additional email addresses that should receive carrier notifications
  4. Save the carrier.

Editing a carrier ​

  1. Find the carrier in the table and click the edit icon to open the edit dialog.
  2. Update any carrier fields as needed and save.

Managing carrier services ​

Carrier services connect a carrier to a specific broker and service code. They appear as a sub-table inside the edit dialog.

To add a new service:

  1. Open the edit dialog for a carrier.
  2. In the Services section, select a Shipping Broker from the dropdown.
  3. Choose a Service from the list populated by the selected broker.
  4. Select the Shipping Type for this service.
  5. Click Add Service.

To update or remove an existing service, use the edit and delete controls next to each service row.

What It Changes In The Storefront ​

Shipping Carriers are not directly visible to shoppers. They are internal configuration that broker integrations use when routing shipments to the correct carrier and service.

When a fulfillment request is processed through a broker integration, Pyle stores the selected carrier service on the request. This affects which carrier is dispatched and which service code is used when the shipping API is called.

Common Tasks ​

Add a new carrier ​

Navigate to Settings → Shipping Carriers, click Create, fill in the name and contact details, and save.

Update a carrier's contact information ​

Find the carrier in the table, open the edit dialog, update the contact fields, and save.

Open the edit dialog for the carrier, go to the Services section, and add a service by selecting the broker, service name, and shipping type.

Remove a carrier service that is no longer active ​

Open the edit dialog, find the service in the services table, and delete it.

Rules, Limits, And Things To Watch ​

  • Carrier name and code must each be unique across all carriers.
  • Carrier codes are auto-generated from the name if not provided. Once set, a code should not be changed arbitrarily because downstream integrations may reference it.
  • A carrier service is unique by the combination of carrier, broker, and service code. Attempting to add a duplicate is silently handled as an update.
  • Shipping Brokers are not managed through the admin UI. They are seeded and configured by your technical team. If the broker you need does not appear in the dropdown when adding a service, contact your implementation team.
  • Deleting a carrier service is immediate. If a fulfillment request already references that service, the stored reference is preserved on the request but the service itself becomes unavailable for new requests.

Troubleshooting ​

The broker I need is not in the service dropdown ​

Brokers are configured by your technical team through platform setup, not through the admin UI. Ask your implementation team to verify that the broker has been seeded and that its driver is registered in the platform configuration.

A carrier service I just added does not appear ​

Refresh the edit dialog. If the service still does not appear, confirm that the broker, service code, and shipping type combination is valid and does not duplicate an existing service.

I cannot find the Shipping Carriers page ​

Navigate to Settings in the admin sidebar. Shipping Carriers appears in the shipping section alongside Shipping Zones, Classes, and Services.

Sources ​

  • packages/admin/src/Livewire/Admin/Settings/ShippingCarriers/Page.php
  • packages/admin/src/Livewire/Admin/Settings/ShippingCarriers/DataTable.php
  • packages/admin/src/Livewire/Admin/Settings/ShippingCarriers/DataTable/CreateDialog.php
  • packages/admin/src/Livewire/Admin/Settings/ShippingCarriers/DataTable/EditDialog.php
  • packages/framework/src/Models/ShippingCarrier.php
  • packages/framework/src/Services/Shipping/ShippingCarrierService.php