Copy page

Quick Commerce

Edit / Update Order

Update an existing order after creation. Supports pickup readiness, OTP relay, society gate events, and order/product detail updates.

Attribute	Value
Method / Path	POST /api/v3/clients/order_update/
Staging URL	https://dale.staging.shadowfax.in/api/v3/clients/order_update/
Headers	Same as Create Order

Update overrides existing order parameters. awb_number is mandatory; all other fields are optional and only the fields present in the request are updated.

Important: If product_details is supplied, the complete product list must be sent — it replaces the existing list. When product composition changes, weight / product_value / total_amount must be updated accordingly.

Restriction: Once the shipment has been picked up by the rider and is out for delivery, edit order is no longer permitted. Such requests are rejected with an HTTP 400 error.

Payload Variant A — Pickup Readiness

Code
{
    "awb_number": "<AWB_NUMBER>",
    "is_ready_for_pickup": true,
    "pickup_rack_details": [
        { "bag_id": "BAG-ID-001", "rack_id": "RACK-001" },
        { "bag_id": "BAG-ID-002", "rack_id": "RACK-002" }
    ]
}

Payload Variant B — OTP Details

Used to relay gate-entry, delivery, and return-verification OTPs collected on the client's side.

Code
{
    "awb_number": "<AWB_NUMBER>",
    "otp_detail": {
        "society_gate_entry": {
            "gate_vendor": "MyGate",
            "otp": 1234
        },
        "delivery_otp": {
            "otp": 123456
        },
        "return_verification_otp": {
            "otp": 1234
        }
    }
}

Payload Variant C — Society Gate Passed Event

Code
{
    "awb_number": "<AWB_NUMBER>",
    "event_type": "society_gate_entry_passed",
    "event_time_utc": "2026-07-09T08:55:30Z",
    "source": "mygate"
}

Payload Variant D — Order Details / Product Update

Code
{
    "awb_number": "<AWB_NUMBER>",
    "order_details": {
        "actual_weight": 100,
        "volumetric_weight": 100,
        "product_value": 515,
        "total_amount": 4500,
        "eta_details": {
            "pickup_ready_time": 1694568000,
            "assignment_time": 1694568000,
            "customer_promised_delivery_date": 1694569500,
            "transit_time_in_min": 30
        }
    },
    "product_details": [
        {
            "hsn_code": "HJUY890",
            "invoice_no": "INV-678",
            "sku_name": "Product Name",
            "sku_id": "SKU-789",
            "category": "grocery",
            "price": 4500,
            "seller_details": {
                "seller_name": "Example Seller Pvt Ltd",
                "seller_address": "Seller Address, City",
                "seller_state": "Karnataka",
                "gstin_number": "HDS798HG"
            },
            "taxes": { "cgst": 3, "sgst": 4, "igst": 5, "total_tax": 5.6 },
            "additional_details": {
                "requires_extra_care": "False",
                "type_extra_care": "Fragile",
                "quantity": 2
            }
        }
    ],
    "return_received_products": [
        {
            "hsn_code": "HJUY890",
            "invoice_no": "INV-678",
            "sku_name": "Product Name",
            "sku_id": "SKU-789",
            "category": "grocery",
            "price": 4500,
            "additional_details": {
                "requires_extra_care": "False",
                "type_extra_care": "Fragile",
                "quantity": 2
            }
        }
    ]
}

Field Reference

Field	Type	Required	Description
awb_number	string	Yes	Shadowfax-generated tracking number for the shipment
is_ready_for_pickup	boolean	No	Marks the order ready for rider pickup at store
pickup_rack_details	array	No	Bag/rack mapping for in-store staging; blocked once is_ready_for_pickup is true
otp_detail.society_gate_entry	object	No	Gate OTP for gated communities (MyGate/NoBroker style vendors)
otp_detail.delivery_otp	object	No	Customer delivery confirmation OTP
otp_detail.return_verification_otp	object	No	OTP to verify return-to-store item receipt
order_details.eta_details	object	No	Revised ETA/SLA timing; only editable pre-pickup
product_details	array	No	Full replacement list of order line items
return_received_products	array	No	Line items confirmed received back at store/warehouse

Field Update Eligibility Window

Field(s)	Allowed Order Status
eta_details, pickup_rack_details, is_ready_for_pickup	Only while order is in a pre-pickup state (New / Assigned)
society_gate_entry, delivery_otp	Only while order is in New / Assigned / Out-for-delivery state
return_verification_otp	Only while order is in a return-in-progress state (RTS / In-return-process)
product_details	Only while order is in a pre-pickup state
return_received_products	Only once, while order is in a return-in-progress state

Response

Code
{
    "message": "Success",
    "child_mps_awbs": []
}

API Reference

• Edit / Update Order