Creating Shipments

How to create shipments from orders, both individually and in bulk.

Create a Shipment from an Order

Go to: Admin Panel → Orders → (any order) → View

You will see a Create Shipment button. Clicking it:

1. Pulls the customer's name, phone, and delivery address from the order
2. Calls the active courier's API
3. Returns a tracking number / consignment ID
4. Creates a shipment record linked to that order

If you have multiple couriers active, select which courier to use from the dropdown before creating the shipment.

Duplicate protection: If a shipment already exists for the order, the system blocks a second creation and shows a warning.

Bulk Create Shipments

On the Orders list page, select multiple orders using the checkboxes and click Bulk Create Shipments. The system:

1. Queues a background job for each selected order
2. Each job calls the active courier API and saves the resulting shipment
3. You don't need to wait — processing happens asynchronously in the background

View and Track Shipments

Navigate to: Admin Panel → Courier → Shipments

This page lists every shipment with:

• Order number (clickable — links to the order detail page)
• Courier name and logo
• Tracking code / consignment ID
• Current status (colour-coded badge)
• Shipping cost (returned from the courier API)
• Created date

Filter options: Status (Pending / In Transit / Delivered / Cancelled / Failed) and Courier.

Previous: Admin Setup · Next: Cancel Shipment →