PUT api/Order/Edit?id={id}

Edits details on an order, including order status. Please note that any null value submitted will be ignored. If you would like to remove a value, please enter an empty string "" and it will be converted to a null value.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The id is the int OrderId in the WMS system, and must be supplied both in this URI id paramater and in the OrderId Body parameter.	integer	Required

Body Parameters

Please note that any null value submitted will be ignored. If you would like to remove a value, please enter an empty string "" and it will be converted to a null value.

OrderEditData

Name	Description	Type	Additional information
OrderId	Unique identifier from the WMS system that is assigned at order creation, and it can be used as the id parameter.	integer	Required
ClientOrderId	Unique order identifier from your system.	string	String length: inclusive between 1 and 100
ClientOrderId2	Alternate order identifier from your system. For example, a PO number.	string	None.
WarehouseCode	Use "MEM" to send the order to the Memphis warehouse. Use "SLC" to send the order to the Salt Lake City warehouse. The default is "MEM".	string	None.
OrderStatus	Assigned by BGS to show the current status of the order.	string	None.
OrderDate		date	None.
CompanyOrName		string	String length: inclusive between 2 and 35
Attention		string	String length: inclusive between 2 and 35
AddressLine1		string	String length: inclusive between 2 and 35
AddressLine2		string	String length: inclusive between 2 and 35
AddressLine3		string	String length: inclusive between 2 and 35
City		string	String length: inclusive between 2 and 35
State	Can accept the 2 digit state code or the state's full name.	string	String length: inclusive between 2 and 35
PostalCode		string	String length: inclusive between 2 and 35
Country	Can accept the 2 digit ISO code, the 3 digit ISO code, or the country's full name.	string	String length: inclusive between 2 and 35
Phone		string	String length: inclusive between 0 and 35
Email		string	String length: inclusive between 0 and 100
ShippingMethod	If no ShippingMethod is submitted the default will be ISC_Economy (lowest cost option). The current acceptable values are: ISC_Economy, ISC_Freight, ISC_WillCall, FEDEX_Ground, FEDEX_Home, UPS_2ndDayAir, UPS_2ndDayAirAM, UPS_3DaySelect, UPS_Ground, UPS_GroundCommercial, UPS_GroundResidential, UPS_MailInnovations, UPS_NextDayAir, UPS_NextDayAirEarlyAM, UPS_NextDayAirSaver, UPS_StandardtoCanada, UPS_SurePost, UPS_WorldwideExpedited, UPS_WorldwideSaver, UPS_WorldwideExpress, USPS_FirstClassInternational, USPS_GroundAdvantage, USPS_PriorityMail, USPS_PriorityMailExpress, USPS_PriorityMailExpressInternational, and USPS_PriorityMailInternational	string	None.
NotesToCustomerPackingSlip	Text submitted here will appear on the packing slip to the end customer.	string	String length: inclusive between 0 and 500
NotesToWarehouse	Text submitted here will appear on screen when picking an order.	string	String length: inclusive between 0 and 255
OrderDetailEditData		Collection of OrderDetailEditData	None.
OrderMetaData		Collection of OrderMetaData	None.

Request Formats

application/json, text/json

Sample:

{
  "OrderId": 2,
  "ClientOrderId": "sample string 3",
  "ClientOrderId2": "sample string 4",
  "WarehouseCode": "sample string 5",
  "OrderStatus": "sample string 6",
  "OrderDate": "2026-02-03T08:45:33.5036573+00:00",
  "CompanyOrName": "sample string 7",
  "Attention": "sample string 8",
  "AddressLine1": "sample string 9",
  "AddressLine2": "sample string 10",
  "AddressLine3": "sample string 11",
  "City": "sample string 12",
  "State": "sample string 13",
  "PostalCode": "sample string 14",
  "Country": "sample string 15",
  "Phone": "sample string 16",
  "Email": "sample string 17",
  "ShippingMethod": "sample string 19",
  "NotesToCustomerPackingSlip": "sample string 20",
  "NotesToWarehouse": "sample string 21",
  "OrderDetailEditData": [
    {
      "ItemSKU": "sample string 2",
      "ItemQuantity": 3
    },
    {
      "ItemSKU": "sample string 2",
      "ItemQuantity": 3
    }
  ],
  "OrderMetaData": [
    {
      "Key": "sample string 3",
      "Name": "sample string 4",
      "Description": "sample string 5",
      "Value": "sample string 6"
    },
    {
      "Key": "sample string 3",
      "Name": "sample string 4",
      "Description": "sample string 5",
      "Value": "sample string 6"
    }
  ]
}

application/xml, text/xml

Sample:

<OrderEditData xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ISCAPI2.Models">
  <AddressLine1>sample string 9</AddressLine1>
  <AddressLine2>sample string 10</AddressLine2>
  <AddressLine3>sample string 11</AddressLine3>
  <Attention>sample string 8</Attention>
  <CarrierCode>sample string 18</CarrierCode>
  <City>sample string 12</City>
  <ClientOrderId>sample string 3</ClientOrderId>
  <ClientOrderId2>sample string 4</ClientOrderId2>
  <CompanyOrName>sample string 7</CompanyOrName>
  <Country>sample string 15</Country>
  <Email>sample string 17</Email>
  <NotesToCustomerPackingSlip>sample string 20</NotesToCustomerPackingSlip>
  <NotesToWarehouse>sample string 21</NotesToWarehouse>
  <OrderDate>2026-02-03T08:45:33.5036573+00:00</OrderDate>
  <OrderDetailEditData>
    <OrderDetailEditData>
      <ItemQuantity>3</ItemQuantity>
      <ItemSKU>sample string 2</ItemSKU>
      <OrderDetailEditDataId>1</OrderDetailEditDataId>
    </OrderDetailEditData>
    <OrderDetailEditData>
      <ItemQuantity>3</ItemQuantity>
      <ItemSKU>sample string 2</ItemSKU>
      <OrderDetailEditDataId>1</OrderDetailEditDataId>
    </OrderDetailEditData>
  </OrderDetailEditData>
  <OrderEditDataId>1</OrderEditDataId>
  <OrderId>2</OrderId>
  <OrderMetaData>
    <OrderMetaData>
      <Description>sample string 5</Description>
      <Key>sample string 3</Key>
      <ModuleId>2</ModuleId>
      <Name>sample string 4</Name>
      <OrderMetaDataId>1</OrderMetaDataId>
      <OrderTokenId>1</OrderTokenId>
      <Value>sample string 6</Value>
    </OrderMetaData>
    <OrderMetaData>
      <Description>sample string 5</Description>
      <Key>sample string 3</Key>
      <ModuleId>2</ModuleId>
      <Name>sample string 4</Name>
      <OrderMetaDataId>1</OrderMetaDataId>
      <OrderTokenId>1</OrderTokenId>
      <Value>sample string 6</Value>
    </OrderMetaData>
  </OrderMetaData>
  <OrderStatus>sample string 6</OrderStatus>
  <Phone>sample string 16</Phone>
  <PostalCode>sample string 14</PostalCode>
  <ShippingMethod>sample string 19</ShippingMethod>
  <State>sample string 13</State>
  <WarehouseCode>sample string 5</WarehouseCode>
</OrderEditData>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

Collection of ResultOrder

Name	Description	Type	Additional information
ClientOrderId	Unique order identifier submitted from your system.	string	None.
ResultDetail	If Success, then there will only by one record returned for the order. If Error, then there will be a record returned for each error caught.	Collection of ResultDetail	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "ClientOrderId": "sample string 3",
    "ResultDetail": [
      {
        "Status": "sample string 3",
        "Details": "sample string 4"
      },
      {
        "Status": "sample string 3",
        "Details": "sample string 4"
      }
    ]
  },
  {
    "ClientOrderId": "sample string 3",
    "ResultDetail": [
      {
        "Status": "sample string 3",
        "Details": "sample string 4"
      },
      {
        "Status": "sample string 3",
        "Details": "sample string 4"
      }
    ]
  }
]

application/xml, text/xml

Sample:

<ArrayOfResultOrder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/ISCAPI2.Models">
  <ResultOrder>
    <ClientOrderId>sample string 3</ClientOrderId>
    <OrderDataResultId>2</OrderDataResultId>
    <ResultDetail>
      <ResultDetail>
        <Details>sample string 4</Details>
        <ResultDetailId>1</ResultDetailId>
        <ResultOrderId>2</ResultOrderId>
        <Status>sample string 3</Status>
      </ResultDetail>
      <ResultDetail>
        <Details>sample string 4</Details>
        <ResultDetailId>1</ResultDetailId>
        <ResultOrderId>2</ResultOrderId>
        <Status>sample string 3</Status>
      </ResultDetail>
    </ResultDetail>
    <ResultOrderId>1</ResultOrderId>
  </ResultOrder>
  <ResultOrder>
    <ClientOrderId>sample string 3</ClientOrderId>
    <OrderDataResultId>2</OrderDataResultId>
    <ResultDetail>
      <ResultDetail>
        <Details>sample string 4</Details>
        <ResultDetailId>1</ResultDetailId>
        <ResultOrderId>2</ResultOrderId>
        <Status>sample string 3</Status>
      </ResultDetail>
      <ResultDetail>
        <Details>sample string 4</Details>
        <ResultDetailId>1</ResultDetailId>
        <ResultOrderId>2</ResultOrderId>
        <Status>sample string 3</Status>
      </ResultDetail>
    </ResultDetail>
    <ResultOrderId>1</ResultOrderId>
  </ResultOrder>
</ArrayOfResultOrder>