# Update Order (Coming Soon)

#### Endpoint

**PUT**: `https://wms.eshopbox.com/api/v1/shipping/order/edit`

### Headers

| **Header Name**    | **Type** | **Description**                           |
| ------------------ | -------- | ----------------------------------------- |
| **Authentication** | string   | Bearer Token to authenticate the request. |

### Request Body Parameters

The following table outlines the parameters that can be included in the request body. Parameters marked as **mandatory** must be provided.

| **Name**                        | **Type**         | **Description**                                     | **Mandatory** |
| ------------------------------- | ---------------- | --------------------------------------------------- | ------------- |
| **vendorOrderNumber**           | string           | Unique order number assigned by the vendor          | Yes           |
| **billingAddress.contactphone** | string           | Phone number associated with the billing address    | Yes           |
| **externalChannelID**           | string           | Unique ID for the sales channel                     | No            |
| **externalWarehouseID**         | string           | Warehouse ID where the order will be fulfilled      | No            |
| **paymentType**                 | string           | Payment type: "prepaid" or "cod"                    | No            |
| **isCOD**                       | string           | "1" for COD, "0" for prepaid                        | No            |
| **items**                       | array of objects | Product items in the order                          | No            |
| **removedItems**                | array of objects | Items removed in the edit                           | No            |
| **addedItems**                  | array of objects | Items added in the edit                             | No            |
| **shippingAddress**             | object           | Full shipping address                               | No            |
| **billingAddress**              | object           | Billing address details (contactphone is mandatory) | Partially Yes |
| **customerOrderNumber**         | string           | Customer-facing order number                        | No            |
| **actor**                       | string           | Email ID of the user performing the edit            | No            |
| **shipChargeAmount**            | number           | Shipping charges                                    | No            |

### Example cURL Request

```bash
curl --location --request PUT 'https://wms.eshopbox.com/api/v1/shipping/order/edit' \
--header 'Authorization: Bearer YOUR_BEARER_TOKEN' \
--data-raw '{
    "orderType": "import",
    "externalChannelID": "CH8445",
    "externalWarehouseID": "Qastaging_CCTesting",
    "sameAddress": false,
    "paymentType": "prepaid",
    "isCOD": "0",
    "suggestedTrackingNumber": "",
    "invoiceNumber": "",
    "suggestedCourierLabel": "",
    "isSecureShipment": true,
    "items": [
        {
            "productImageUrl": "https://storage.googleapis.com/eshopbox_uploads_staging/product_create/Crop_Top_250402063637437-3851.jpg",
            "quantity": 3,
            "giftMessage": "Happy Birthday.",
            "discount": 0,
            "lineItemTotal": "2850",
            "isVirtualKit": "0",
            "customerPrice": 950,
            "productName": "Slim Fit Jogger",
            "itemID": "John@#",
            "lineItemSequenceNumber": 0,
            "isGift": "1",
            "taxAmount": 0,
            "taxCode": "ESBGST1",
            "sku": "HNXP83H674Q",
            "skuset": "HNXP83H674Q",
            "externalWarehouseID": "Qastaging_CCTesting",
            "unitPrice": 950,
            "sellerTotal": "2850",
            "sellerSkuOnChannel": "HNXP83H674Q",
            "isproduct": true,
            "productAdditionalInfo": {
                "productDetails": {
                    "hsnCode": "65457",
                    "dimensionHeight": 10,
                    "dimensionLength": 20,
                    "accountSlug": "qastaging",
                    "weight": 180,
                    "mrp": 999,
                    "dimensionWidth": 20,
                    "type": "BASE",
                    "sku": "John@#",
                    "esin": "HNXP83H674Q",
                    "status": "ACTIVE",
                    "weightUnit": "g"
                }
            },
            "giftWrapCharges": 0
        }
    ],
    "removedItems": [],
    "addedItems": [],
    "shippingAddress": {
        "city": "New Delhi",
        "countryCode": "",
        "postalCode": "110001",
        "addressLine1": "64 Sector 18 Hsidc Maruti Indl Area",
        "addressLine2": "",
        "countryName": "IN",
        "state": "Delhi",
        "contactPhone": "9999999999",
        "customerName": "John",
        "email": "rohitkumar@eshopbox.com",
        "gstin": ""
    },
    "billingAddress": {
        "city": "Delhi",
        "countryCode": "",
        "postalCode": "110001",
        "addressLine1": "64 Sector 18 Hsidc Maruti Indl Area",
        "addressLine2": "",
        "countryName": "IN",
        "state": "Delhi",
        "contactPhone": "9999999999",
        "customerName": "John doe",
        "email": "johndoe@test.com",
        "gstin": ""
    },
    "customerOrderNumber": "50_Custom_New_5-cp124",
    "vendorOrderNumber": "50_Custom_New_5-cp124",
    "autOrderID": false,
    "bkpCustomerOrderID": "",
    "giftMsg": "Happy Birthday.",
    "isGift": "1",
    "invoiceDate": "2025-04-28T09:49:57.619Z",
    "otherCharge": 0,
    "balanceDue": 0,
    "orderTotal": 3724,
    "subtotal": 3649,
    "actor": "rohitkumar@eshopbox.com",
    "shipMethod": "STD",
    "accountSlug": "qastaging",
    "thirdPartySh

```

### Success Response

```json
{
  "status": "success",
  "message": "Order updated successfully",
  "orderId": "ORD123456"
}
```

***

### Error Responses

**400 Bad Request**\
This indicates that one or more required fields were not provided or are invalid.

**401 Unauthorized**\
This indicates an authentication failure. The Bearer token may be expired or missing.

**404 Not Found**\
The order you are trying to update does not exist in the system.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eshop.gitbook.io/eshopbox-developers/order/orders/update-order-coming-soon.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.