Shadowfax HIH
Shadowfax HIH (Hand-in-Hand) is a simultaneous exchange service where a forward delivery and a reverse pickup are executed in a single trip to the customer's doorstep. The delivery partner hands over the new product to the customer and picks up the return item in one visit — minimizing logistics cost and improving customer experience.
Courier Partner ID:
Services Integrated
- Order Creation Order
- Cancellation
- Tracking via Webhook
- Quality Check (RVP)
- Label Generation
Understanding HIH Order Types
Before creating an HIH order on Clickpost, it is important to understand the components that make up an exchange order:
| Term | Description |
|---|---|
| Exchange Delivery | The forward leg — the new product being delivered to the customer. The delivery is completed only if the return item meets the defined quality standard at the time of pickup. |
| Exchange Pickup | The reverse leg — the item being picked up from the customer at the same time as the delivery. Can be a QC Pickup or a Non-QC Pickup. |
| QC Pickup | The delivery partner performs a quality check at the customer's doorstep. If the returned item meets the client's quality standard, it is picked up; otherwise it is rejected and not collected. |
| Non-QC Pickup | The delivery partner accepts any item handed over by the customer, without performing a quality check. |
| Exchange Order | A combined Exchange Delivery + Exchange Pickup executed in a single visit to the customer. |
Order Creation on Clickpost
Exchange orders for Shadowfax HIH are placed via the Clickpost Order Creation API. The request payload must contain information for both the forward and the reverse legs in a single call.
On a successful order creation:
- Both the forward AWB and reverse AWB are returned in the API response.
Serviceability
An HIH exchange order is serviceable only when both the First Mile (FM) and Last Mile (LM) are serviceable for the customer's pincode.
Note: Pincodes supported for Shadowfax HIH must be uploaded on the Clickpost dashboard under the carrier's Serviceability configuration.
Order Cancellation
- Cancellation is applicable only on the forward order, and only until delivery.
- When the forward order is cancelled, the reverse order is automatically cancelled as well.
- If the forward shipment is marked as lost, the reverse shipment is automatically cancelled.
Tracking & Scan Behavior
Clickpost receives and forwards tracking webhooks/callbacks for both forward and reverse AWBs. The scan sequence follows a defined state machine:
Scan Sequence
Reverse AWB The reverse AWB is kept in New status until the forward order goes Out for Delivery (OFD). No manual scanning happens on the reverse AWB — it is automatically added to the runsheet based on the forward order's progress.
The full Courier scan sequence is as follows:
1. Reverse (initial) New
2. Forward leg assigned_for_seller_pickup → ofp → (optional: seller_initiated_delay, seller_not_contactable, pickup_not_attempted, pickup_on_hold, on_hold) → picked → recd_at_rev_hub → recd_at_fwd_dc
3. Both legs (delivery) .assigned_for_delivery→ofd→delivered`
4. Reverse leg (return journey) return_initiated → in_transit_ret → recd_at_dc_ret → ret_d (Return Delivered) or ret_nd (Return Not Delivered)
Scan Behaviour — Special Cases
| Scenario | Behavior |
|---|---|
| QC Fail | Forward order moves to on_hold, followed immediately by RTS scans. Note: on_hold is not exclusive to QC Fail and can occur in other scenarios as well. |
| Forward order cancelled | Forward order scan moves to cancelled; reverse order scan also moves to cancelled. |
| Reverse order cancelled | After cancellation, the reverse AWB cannot be picked — no further scans will occur. |
| Forward order delivered | After delivered status, the forward order cannot be marked RTO. |
| Forward order lost | Reverse shipment is automatically cancelled. |
| Customer cancellation | cancelled_by_customer scan is shared — applicable for SF OTP Verified cancellation, SF Unverified cancellation, and API cancellation. For all cancellation types, an RTO scan is shared within 24 hours post IVR verification. |
Notes
- The reverse AWB will not show any tracking scans until the forward order is Out for Delivery (OFD). Only a single scan is shared at the time of order creation (
New). - Once the forward order reaches
delivered(terminal status), the reverse AWB continues its journey independently and its scans will be shared normally. - If both the forward and reverse orders are cancelled, the cancellation will be reflected in the Clickpost callback for both AWBs.
on_holdcan occur in scenarios beyond QC Fail; do not treat it as an exclusive QC Fail indicator in your downstream systems.
Updated 5 months ago
