UpdateOrder

There are two ways of updating an order after it has been created:

1. You can either send in a new ProcessOrder request with the same order number, or
2. You can use this function, UpdateOrder.

Generally speaking, you should use ProcessOrder. The main issue is that ProcessOrder can only update an order if the warehouse has not begun to pick it. So if you have a use-case where you know that you will need to update an order regardless of its picking status, then you should consider using UpdateOrder.

Tags: UpdateOrder, UpdateOrder, OrderUpdateIdentification, UpdateOrderStatus, UpdateOrderDeliveryDate, UpdateOrderGoodsOwnerOrderNumber, UpdateOrderWaybill, UpdateOrderTransporterOrderNumber, UpdateOrderPrintedTime, UpdateOrderPickFinishedTime, UpdateOrderShippedTime, UpdateOrderFreeDateTime1, UpdateOrderFreeDateTime2, UpdateOrderFreeText1, UpdateOrderFreeText2, UpdateOrderFreeText3, UpdatePickingPriority, UpdateOrderWarehouseInstruction, UpdateOrderReturnWaybill, UpdateOrderServicePointCode, UpdateOrderWayOfDeliveryType, UpdateOrderTransporter, UpdateOrderClasses, UpdateOrderDeliveryInstruction, UpdateOrderSalesCode, UpdateOrderCustomerAndNotification, UpdateOrderFreightPrice, UpdateOrderRemark, UpdateOrderClearPersonallyIdentifiableInformation, UpdateOrderCurrentShipment, TransporterContractClass, OrderClasses, Customer, OrderNotification, OrderClass, Coordinates, InvoiceAddress, CustomerGroup, UpdateOrderResponse, UpdateOrderResult

Request XML

POST /xxx/Service.asmx HTTP/1.1
Host: api.ongoingsystems.se
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://ongoingsystems.se/WSI/UpdateOrder"

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateOrder xmlns="http://ongoingsystems.se/WSI">
      <GoodsOwnerCode>string</GoodsOwnerCode>
      <UserName>string</UserName>
      <Password>string</Password>
      <updateOrder>
        <OrderUpdateIdentification>
          <OrderIdentificationType>GoodsOwnerOrderNumber or GoodsOwnerOrderId or SystemId</OrderIdentificationType>
          <GoodsOwnerOrderNumber>string</GoodsOwnerOrderNumber>
          <GoodsOwnerOrderId>string</GoodsOwnerOrderId>
          <OrderId>int</OrderId>
        </OrderUpdateIdentification>
        <UpdateOrderStatus>
          <OrderStatus>int</OrderStatus>
        </UpdateOrderStatus>
        <UpdateOrderDeliveryDate>
          <DeliveryDate>dateTime</DeliveryDate>
        </UpdateOrderDeliveryDate>
        <UpdateOrderGoodsOwnerOrderNumber>
          <GoodsOwnerOrderNumber>string</GoodsOwnerOrderNumber>
        </UpdateOrderGoodsOwnerOrderNumber>
        <UpdateOrderWaybill>
          <Waybill>string</Waybill>
        </UpdateOrderWaybill>
        <UpdateOrderTransporterOrderNumber>
          <TransporterOrderNumber>string</TransporterOrderNumber>
        </UpdateOrderTransporterOrderNumber>
        <UpdateOrderPrintedTime>
          <PrintedTime>dateTime</PrintedTime>
        </UpdateOrderPrintedTime>
        <UpdateOrderPickFinishedTime>
          <PickFinishedTime>dateTime</PickFinishedTime>
        </UpdateOrderPickFinishedTime>
        <UpdateOrderShippedTime>
          <ShippedTime>dateTime</ShippedTime>
        </UpdateOrderShippedTime>
        <UpdateOrderFreeDateTime1>
          <OrderFreeDateTime1>dateTime</OrderFreeDateTime1>
        </UpdateOrderFreeDateTime1>
        <UpdateOrderFreeDateTime2>
          <OrderFreeDateTime2>dateTime</OrderFreeDateTime2>
        </UpdateOrderFreeDateTime2>
        <UpdateOrderFreeText1>
          <OrderFreeText1>string</OrderFreeText1>
        </UpdateOrderFreeText1>
        <UpdateOrderFreeText2>
          <OrderFreeText2>string</OrderFreeText2>
        </UpdateOrderFreeText2>
        <UpdateOrderFreeText3>
          <OrderFreeText3>string</OrderFreeText3>
        </UpdateOrderFreeText3>
        <UpdatePickingPriority>
          <PickingPriority>int</PickingPriority>
        </UpdatePickingPriority>
        <UpdateOrderWarehouseInstruction>
          <WarehouseInstruction>string</WarehouseInstruction>
        </UpdateOrderWarehouseInstruction>
        <UpdateOrderReturnWaybill>
          <ReturnWaybill>string</ReturnWaybill>
        </UpdateOrderReturnWaybill>
        <UpdateOrderServicePointCode>
          <ServicePointCode>string</ServicePointCode>
        </UpdateOrderServicePointCode>
        <UpdateOrderWayOfDeliveryType>
          <Operation>Find or FindOrCreate</Operation>
          <Identification>WayOfDeliveryTypeCode</Identification>
          <WayOfDeliveryTypeCode>string</WayOfDeliveryTypeCode>
          <WayOfDeliveryTypeName>string</WayOfDeliveryTypeName>
        </UpdateOrderWayOfDeliveryType>
        <UpdateOrderTransporterContract>
          <TransporterContract>
            <TransporterContractIdentification>CodeAndServiceCodeAndCustomerNumber or CodeAndServiceCode or Code or ServiceCode or FiltersSpecified</TransporterContractIdentification>
            <TransporterContractOperation>Find or CreateOrUpdate</TransporterContractOperation>
            <TransportPayment>Collect or Prepaid or ThirdParty or UnKnown</TransportPayment>
            <TransporterCode>string</TransporterCode>
            <TransporterServiceCode>string</TransporterServiceCode>
            <CustomerNumber>string</CustomerNumber>
            <ConsigneePalletCustomerNumber>string</ConsigneePalletCustomerNumber>
            <EDICustomerCode>string</EDICustomerCode>
            <WaybillTemplate>string</WaybillTemplate>
          </TransporterContract>
        </UpdateOrderTransporterContract>
        <UpdateOrderSetOrderClasses>
          <OrderClasses>
            <Operation>FindOrCreate or Find</Operation>
            <Identification>Code</Identification>
            <Classes>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
                <IsPalletTypeSuggestion>boolean</IsPalletTypeSuggestion>
              </Class>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
                <IsPalletTypeSuggestion>boolean</IsPalletTypeSuggestion>
              </Class>
            </Classes>
          </OrderClasses>
        </UpdateOrderSetOrderClasses>
        <UpdateOrderAddOrderClasses>
          <OrderClasses>
            <Operation>FindOrCreate or Find</Operation>
            <Identification>Code</Identification>
            <Classes>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
                <IsPalletTypeSuggestion>boolean</IsPalletTypeSuggestion>
              </Class>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
                <IsPalletTypeSuggestion>boolean</IsPalletTypeSuggestion>
              </Class>
            </Classes>
          </OrderClasses>
        </UpdateOrderAddOrderClasses>
        <UpdateOrderDeliveryInstruction>
          <OrderDeliveryInstruction>string</OrderDeliveryInstruction>
        </UpdateOrderDeliveryInstruction>
        <UpdateOrderSalesCode>
          <OrderSalesCode>string</OrderSalesCode>
        </UpdateOrderSalesCode>
        <UpdateOrderCustomerAndNotification>
          <Customer>
            <CustomerOperation>Create or CreateOrUpdate or CreateNotUpdate or Find</CustomerOperation>
            <CustomerIdentification>ExternalCustomerCode or SystemId or CustomerNumber or FullNameAndAddress</CustomerIdentification>
            <ExternalCustomerCode>string</ExternalCustomerCode>
            <CustomerNumber>string</CustomerNumber>
            <CustomerId>int</CustomerId>
            <DeliveryAddressId>int</DeliveryAddressId>
            <InvoiceAddressId>int</InvoiceAddressId>
            <Coordinates>
              <Longitude>decimal</Longitude>
              <Latitude>decimal</Latitude>
            </Coordinates>
            <Name>string</Name>
            <Address>string</Address>
            <Address2>string</Address2>
            <Address3>string</Address3>
            <PostCode>string</PostCode>
            <City>string</City>
            <TelePhone>string</TelePhone>
            <Remark>string</Remark>
            <Email>string</Email>
            <MobilePhone>string</MobilePhone>
            <CountryCode>string</CountryCode>
            <CountryStateCode>string</CountryStateCode>
            <DeliveryInstruction>string</DeliveryInstruction>
            <IsVisible>boolean</IsVisible>
            <NotifyBySMS>boolean</NotifyBySMS>
            <NotifyByEmail>boolean</NotifyByEmail>
            <NotifyByTelephone>boolean</NotifyByTelephone>
            <InvoiceAddress>
              <Coordinates>
                <Longitude>decimal</Longitude>
                <Latitude>decimal</Latitude>
              </Coordinates>
              <Name>string</Name>
              <Address>string</Address>
              <Address2>string</Address2>
              <Address3>string</Address3>
              <PostCode>string</PostCode>
              <City>string</City>
              <TelePhone>string</TelePhone>
              <Remark>string</Remark>
              <Email>string</Email>
              <MobilePhone>string</MobilePhone>
              <CountryStateCode>string</CountryStateCode>
              <CountryCode>string</CountryCode>
              <DeliveryInstruction>string</DeliveryInstruction>
              <IsVisible>boolean</IsVisible>
              <NotifyBySMS>boolean</NotifyBySMS>
              <NotifyByEmail>boolean</NotifyByEmail>
              <NotifyByTelephone>boolean</NotifyByTelephone>
            </InvoiceAddress>
            <CustomerGroup>
              <CustomerGroupOperation>Find or CreateOrFind</CustomerGroupOperation>
              <CustomerGroupIdentification>CustomerGroupCode or CustomerGroupName</CustomerGroupIdentification>
              <CustomerGroupCode>string</CustomerGroupCode>
              <CustomerGroupName>string</CustomerGroupName>
            </CustomerGroup>
            <OrganisationNumber>string</OrganisationNumber>
            <VATNumber>string</VATNumber>
            <DoorCode>string</DoorCode>
            <AddressFreeText1>string</AddressFreeText1>
            <AddressFreeText2>string</AddressFreeText2>
          </Customer>
          <OrderNotification>
            <Telephone>string</Telephone>
            <MobilePhone>string</MobilePhone>
            <Email>string</Email>
            <NotifyByEmail>boolean</NotifyByEmail>
            <NotifyBySms>boolean</NotifyBySms>
            <NotifyByTelephone>boolean</NotifyByTelephone>
          </OrderNotification>
        </UpdateOrderCustomerAndNotification>
        <UpdateOrderFreightPrice>
          <FreightPrice>decimal</FreightPrice>
        </UpdateOrderFreightPrice>
        <UpdateOrderRemark>
          <OrderRemark>string</OrderRemark>
        </UpdateOrderRemark>
        <UpdateOrderClearPersonallyIdentifiableInformation>
          <Operation>Clear</Operation>
        </UpdateOrderClearPersonallyIdentifiableInformation>
        <UpdateOrderCurrentShipment>
          <ShipmentId>int</ShipmentId>
        </UpdateOrderCurrentShipment>
      </updateOrder>
    </UpdateOrder>
  </soap:Body>
</soap:Envelope>

Request specification

Response XML

<?xml version="1.0" encoding="utf-8" ?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <UpdateOrderResponse xmlns="http://ongoingsystems.se/WSI">
      <UpdateOrderResult>
        <Success>boolean</Success>
        <Message>string</Message>
        <OrderId>int</OrderId>
      </UpdateOrderResult>
    </UpdateOrderResponse>
  </soap:Body>
</soap:Envelope>

Response specification