API Docs
YMS API
Order Controller
POST Update Order

POST Update Order

Introduction

Update an existing order by its order ID. This API allows you to modify order details such as customer, carrier, equipment information, item lines, and dynamic field values. Only the fields provided in the request body will be updated.

API Request

POST /order/{orderId}/update

Body

{
  "orderStatus": "string",
  "customerId": "string",
  "poNo": "string",
  "referenceNo": "string",
  "retailer": "string",
  "shipFrom": "string",
  "shipTo": "string",
  "totalPalletQty": 0,
  "totalCartonQty": 0,
  "itemInfos": [
    {
      "itemId": "string",
      "itemName": "string",
      "itemQty": "string",
      "palletQty": "string",
      "itemSpecDesc": "string",
      "itemSpecName": "string",
      "uomId": "string",
      "qty": "string"
    }
  ],
  "dynamicFieldValues": [
    {
      "entityId": "string",
      "entityType": "RECEIPT",
      "fieldCode": "string",
      "shortValue": "string",
      "longValue": "string",
      "value": "string"
    }
  ]
}

Request Parameters

NameLocationTypeRequiredDescription
orderIdpathstringYesOrder ID
X-Tenant-IDheaderstringNonone
X-Yard-IDheaderstringNonone
Item-Time-ZoneheaderstringNonone
AuthorizationheaderstringNonone
bodybodyOrderUpdateCmd (opens in a new tab)Nonone

Response Example

200 Response

{
  "code": 0,
  "msg": "",
  "success": false,
  "data": {
    "id": 0,
    "orderId": "",
    "orderStatus": "",
    "customerId": "",
    "poNo": "",
    "referenceNo": "",
    "retailer": "",
    "shipFrom": "",
    "shipTo": "",
    "totalPalletQty": 0,
    "totalCartonQty": 0,
    "itemInfos": [
      {
        "itemId": "",
        "itemName": "",
        "itemQty": "",
        "palletQty": "",
        "itemSpecDesc": "",
        "itemSpecName": "",
        "uomId": "",
        "qty": ""
      }
    ],
    "customerName": "",
    "carrierName": "",
    "shipToAddress": {
      "id": "",
      "name": "",
      "country": "",
      "state": "",
      "city": "",
      "zipCode": "",
      "fax": "",
      "address1": "",
      "address2": "",
      "contact": "",
      "phone": "",
      "extension": "",
      "email": "",
      "orgId": "",
      "orgName": "",
      "referenceNo": "",
      "batchCode": "",
      "storeNo": "",
      "shorthand": "",
      "toHome": false,
      "tags": [
        ""
      ],
      "latitude": "",
      "longitude": "",
      "crmAddressId": ""
    },
    "shipFromAddress": {
      "id": "",
      "name": "",
      "country": "",
      "state": "",
      "city": "",
      "zipCode": "",
      "fax": "",
      "address1": "",
      "address2": "",
      "contact": "",
      "phone": "",
      "extension": "",
      "email": "",
      "orgId": "",
      "orgName": "",
      "referenceNo": "",
      "batchCode": "",
      "storeNo": "",
      "shorthand": "",
      "toHome": false,
      "tags": [
        ""
      ],
      "latitude": "",
      "longitude": "",
      "crmAddressId": ""
    },
    "appointmentTime": "",
    "dynamicFieldValues": [
      {
        "entityId": "",
        "entityType": "",
        "fieldCode": "",
        "value": "",
        "fieldName": "",
        "longValue": "",
        "shortValue": ""
      }
    ],
    "proNos": [
      ""
    ],
    "invoicePros": [
      ""
    ],
    "doNos": [
      ""
    ],
    "tripNo": "",
    "shippedTime": ""
  }
}

Response

Status CodeDefinitionDescriptionData Model
200OK (opens in a new tab)noneROrderView (opens in a new tab)