ExchangeOrderRequest
Customer address and contact. Shared across both forward and reverse legs.
Forward order details — the new item being delivered to the customer.
Reverse order details — the old item being picked up from the customer.
CustomerDetails
nameCustomer full name.
contact^[0-9+]+$ · requiredCustomer phone number. 10-14 digits, may include + prefix.
addressCustomer address line 1.
cityCustomer city.
pincode^[1-9][0-9]{5}$ · required6-digit Indian pincode. Must start with 1-9.
address2Customer address line 2 (optional).
alternate_contactAlternate phone number.
latitudeLatitude coordinate.
longitudeLongitude coordinate.
location_accuracyLocation accuracy: L (low), H (high), G (GPS).
location_typeAddress type.
stateCustomer state.
FwdOrderDetails
Forward order-level details.
Pickup address for the forward leg.
Return address for the forward leg (where undelivered items go back).
SKUs being delivered. At least one required.
FwdOrderInfo
client_order_idYour unique order ID for the forward leg.
product_valueProduct value in INR. E-way bill required if >= 50,000.
payment_modecod_amountCOD amount. Must be 0 for prepaid.
awb_number^[a-zA-Z0-9]+$Your own AWB number (optional). Alphanumeric, max 25 chars.
actual_weightActual weight in kg.
volumetric_weightVolumetric weight in kg.
promised_delivery_dateFormat: yyyy-MM-dd hh:mm:ss.
total_amounteway_bill12-digit e-way bill. Required if product value >= ₹50,000.
order_serviceorder_identifierPickupAddress
pickup_type'warehouse' is normalized to 'origin' internally.
addresscitypincode^[1-9][0-9]{5}$ · requirednameRequired when pickup_type is 'seller'.
contact^[0-9+]+$Required when pickup_type is 'seller'.
latitudelongitudeReturnAddress
return_type'seller' = RTS, 'origin'/'warehouse' = RTO.
addresspincode^[1-9][0-9]{5}$ · requirednameRequired when return_type is 'seller'.
contact^[0-9+]+$Required when return_type is 'seller'.
cityemaillatitudelongitudeFwdSkuItem
sku_namesku_idpricecategoryhsn_codeinvoice_nobrandSeller information for GST compliance.
Tax breakdown.
Additional forward SKU metadata.
RevOrderDetails
Reverse order-level details.
SKUs being picked up. At least one required.
Return address for the forward leg (where undelivered items go back).
RevOrderInfo
client_order_idYour unique order ID for the reverse leg.
awb_number^[a-zA-Z0-9]+$Your own AWB number for the reverse leg (optional).
total_amountTotal amount for the reverse order.
priceProduct value for the reverse order. Internally mapped to product_value.
eway_bill12-digit e-way bill for the reverse leg.
RevSkuItem
sku_namepriceUnit price in INR.
sku_idYour SKU identifier.
categoryhsn_codeinvoice_nobrandreturn_reasonReason for the return/exchange.
qc_requiredWhether quality check is required on pickup. Default: true.
Seller information for GST compliance.
Tax breakdown.
Additional reverse SKU metadata.
Quality check questions for the rider.
SellerDetails
seller_nameseller_addressseller_stategstin_numberGSTIN. Required when product value >= ₹50,000.
TaxDetails
cgst_amountsgst_amountigst_amounttotal_tax_valueFwdAdditionalDetails
requires_extra_caretype_extra_careproduct_idproduct_weightRevAdditionalDetails
colorsizesku_imagesImage URLs. Auto-prefixed with https:// if missing.
quantity_valuequantity_unitimeiserial_norequires_extra_caretype_extra_careQcRule
questionQC question text.
is_mandatoryWhether the rider must answer this question.
valuePre-filled answer (optional).
ExchangeOrderSuccessResponse
messageDetails of both orders created.
errors