Fulfillment and shipments
Once a customer has paid, the order has to leave the building. Sales → Fulfillment is where that happens: a queue of paid orders with items still to ship, and a record of every shipment you create — carrier, tracking number, ship date, which items went in the box — with a one-click e-mail to the customer and a tracking link in their account. Fulfillment is built into TitanCart, in both Lite and Pro; there is nothing to switch on.
1. The Fulfillment screen
The screen has two views, switched with the tabs at the top:
- Needs Fulfillment — the default. Every order that is paid and still has physical items to ship, oldest first, with the order number, the customer, how many items are still To Ship, the total, the order status, and when it was placed. The tab carries a count badge whenever the queue is not empty. Click a row (or its Create Shipment → link) to ship that order.
- Shipments — every shipment you have recorded, newest first: its number, order, customer, carrier, tracking number, fulfillment status and date. Filter by fulfillment status with the chips, or search by tracking number or order number. The bin icon deletes a shipment.
+ Create Shipment at the top right starts a shipment for any Processing order, whether or not you came from the queue.
2. Which orders appear in Needs Fulfillment
The queue is worked out live from your orders — nothing is added or removed by hand. An order is listed when all three are true:
- Its status is Processing — paid, not on hold, not finished. Orders in Pending Payment or On Hold are not ready; Completed, Cancelled, Refunded and Failed are closed. A custom status does not qualify, so create shipments before moving an order to a custom stage. (Developers can widen the list with the
titancart_fulfillable_order_statusesfilter.) - It contains at least one item that requires shipping — a physical product, or a gift card the customer asked to have mailed. Digital products, downloads and e-mailed gift cards never need fulfilling, so an all-digital order never appears.
- Some of those items have not yet been shipped. As soon as your shipments cover every physical unit, the order drops out of the queue by itself.
Note: leaving the queue is all that happens when an order is fully shipped. Its status stays Processing until you change it — see section 8.
3. Creating a shipment
- Open Sales → Fulfillment and click an order in Needs Fulfillment, or click + Create Shipment and search for the order by order number, customer name or e-mail (the search offers the same orders the queue does — Processing, unless a developer has widened the list).
- The Select Order & Items card lists every physical line that still has units to ship, with Ordered, Remaining and a Ship Qty box pre-filled with the remaining quantity. Digital items and e-mailed gift cards are not offered. Lower a quantity, or set it to 0, for anything that is not going in this box.
- In the Tracking card choose the Carrier (USPS, UPS, FedEx, DHL or Other), type the Tracking Number, and set the Shipped Date if the parcel has already gone (leave it blank to fill in later).
- Leave E-mail the customer about this shipment ticked to send the Order Shipped e-mail when you save — it lists the items in this shipment and carries a Track Your Package button when the carrier has a tracking page. Untick it to record the shipment silently.
- Optionally pick a Fulfillment Status (section 6) and write a Note to the customer.
- Click Create Shipment.
The note reaches the customer. Whatever you type in Note to the customer is included in the shipment e-mail under Note from the store. Use it for “Left with the building concierge” or “Second parcel follows Thursday”, not for warehouse remarks — keep those on the order as a Staff Note (Managing orders section 5). Before TitanCart 0.2.69 this box was called Shipment Comments and was labelled as internal notes, but it was e-mailed all the same.
You cannot ship more of an item than remains: quantities above the remaining count are trimmed, and a shipment with nothing left to ship is refused.
4. Partial shipments and several parcels
A shipment is one parcel with one carrier and one tracking number. To ship an order in parts, create a shipment for what goes today with the other lines set to 0; the order stays in Needs Fulfillment showing only the units still outstanding, and the customer’s e-mail lists just the items in that parcel. Create the next shipment when the rest goes. Two tracking numbers means two shipments, even if they left on the same day.
5. Editing or deleting a shipment
Open a shipment from the Shipments view. You can change its carrier, tracking number, shipped date, fulfillment status and customer note; the order and the items are fixed once created. The e-mail checkbox is unticked when editing: tick it and change the tracking number to send the Tracking information updated e-mail. Any other edit never e-mails. The edit page also links back to the order and shows the customer’s contact details.
Delete a wrong shipment with the bin icon on the Shipments list. Its items count as unshipped again, so the order returns to Needs Fulfillment. Nothing else changes and no e-mail is sent.
6. Fulfillment statuses
Each shipment carries a fulfillment status, separate from the order’s status. TitanCart ships with Pending (the default for a new shipment), Picked Up, Packed and Shipped. They are labels for your team and your customer — they filter the Shipments list and appear as a badge on the customer’s order page — and have no other effect: moving a shipment to Shipped does not e-mail anyone and does not touch the order. Rename, recolour, reorder or add to them under Settings → Order Statuses → Fulfillment Statuses; see Order statuses.
7. What the customer sees
- The shipment e-mail — Order Shipped when you create a shipment with the box ticked, Tracking information updated when you change a tracking number with the box ticked. Each shows the carrier, tracking number, shipped date, your note to the customer, the items in the parcel, and a tracking button. Both templates, and the switch that enables them, are under Settings → Notifications as Shipment sent (with tracking); see E-mail notifications and templates section 5.
- My Account — the order page gains a Shipments & Tracking block as soon as the order has a shipment: one card per shipment with its status, shipped or created date, carrier, a clickable tracking number, and the items it contained. Shipment comments are not shown here, only in the e-mail.
- Tracking links are built from the carrier and number for USPS, UPS, FedEx and DHL. A carrier of Other shows the number as plain text with no link.
8. The order’s status after shipping
Shipping does not change the order’s status, and does not touch stock (stock was deducted when the payment was taken). When the last item has gone, the order simply leaves the Needs Fulfillment queue and stays in Processing. Mark it Completed from the order’s Update Status card when you consider it done — Completed e-mails the customer by default, starts the Verified purchase badge for reviews, and is what Returns look for. The returns window itself counts from the latest Shipped Date on the order’s shipments, so fill that date in.
9. Carriers, rates and labels
The carrier list on a shipment (USPS, UPS, FedEx, DHL, Other) exists to build tracking links; it does not need any account or credentials. Separately, TitanCart Pro can quote live USPS, UPS and FedEx rates at checkout when a shipping method is set up with the carrier’s API credentials — see Shipping zones & rate tables. TitanCart does not buy postage or print labels, and does not poll carriers for delivery scans: you create the label in the carrier’s own tools and paste the tracking number here. For a pick list to pack from, use the order’s Packing Slip button (Managing orders section 8); it lists the whole order, not a single shipment.
What fulfillment does — and don’t
Fulfillment records what you shipped and tells the customer. The queue is derived from paid orders with unshipped physical items and clears itself; a shipment stores carrier, tracking, date, status and items, and e-mails the customer when you ask. It does not change the order’s status (Completed is yours to set), does not adjust stock, does not buy labels or fetch delivery scans, and does not run any automation when a shipment reaches Shipped. One shipment is one parcel: several parcels are several shipments.
Troubleshooting
- A paid order is not in Needs Fulfillment. Check its status — only Processing qualifies. Offline-payment orders wait in On Hold until you confirm the money and move them to Processing; authorised-but-uncaptured card orders wait in On Hold until you capture. If the order contains only digital items or e-mailed gift cards there is nothing to ship.
- I cannot find the order in the Create Shipment search. The search offers the orders the queue would list — Processing by default. Move the order to Processing, or open it from the Needs Fulfillment queue.
- The customer saw my warehouse note. The shipment’s note is sent in the shipment e-mail (section 3). Edit the shipment to clear it before any tracking update, and keep internal remarks as a Staff Note on the order.
- The customer did not get the shipment e-mail. The box must be ticked when you save; on an edit it only sends when the tracking number changes. Then check Settings → Notifications: the Shipment sent (with tracking) event must be on and the template not Disabled, and the store needs a working outgoing mail setup.
- The tracking number has no link. The carrier is Other, which has no tracking page. Choose USPS, UPS, FedEx or DHL when the parcel went with one of them.
- I shipped everything but the order is still Processing. That is expected. Set it to Completed from the order page.
- I need to ship an order that is in my custom status. Move it back to Processing, create the shipment, then return it to your stage.
- The Shipments list shows a shipment for an order I deleted. Shipments are kept when an order is removed; delete the shipment from the list.
See also
- Managing orders (the Sales screen) — statuses, notes, the packing slip and invoice.
- Order statuses (built-in and custom) — what Processing and Completed trigger, and the Fulfillment Statuses tab.
- E-mail notifications and templates — the Order Shipped and Tracking information updated templates.
- Shipping zones & rate tables — shipping methods, live carrier rates (Pro) and the product fields shipping reads.
- Returns and RMA — the return window that counts from the shipped date.