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, 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</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>
          </TransporterContract>
        </UpdateOrderTransporterContract>
        <UpdateOrderSetOrderClasses>
          <OrderClasses>
            <Operation>FindOrCreate or Find</Operation>
            <Identification>Code</Identification>
            <Classes>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
              </Class>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
              </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>
              </Class>
              <Class>
                <Name>string</Name>
                <Code>string</Code>
                <Comment>string</Comment>
              </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</CustomerGroupOperation>
              <CustomerGroupIdentification>CustomerGroupCode or CustomerGroupName</CustomerGroupIdentification>
              <CustomerGroupCode>string</CustomerGroupCode>
              <CustomerGroupName>string</CustomerGroupName>
            </CustomerGroup>
            <OrganisationNumber>string</OrganisationNumber>
            <VATNumber>string</VATNumber>
            <DoorCode>string</DoorCode>
          </Customer>
          <OrderNotification>
            <Telephone>string</Telephone>
            <MobilePhone>string</MobilePhone>
            <Email>string</Email>
            <NotifyByEmail>boolean</NotifyByEmail>
            <NotifyBySms>boolean</NotifyBySms>
            <NotifyByTelephone>boolean</NotifyByTelephone>
          </OrderNotification>
        </UpdateOrderCustomerAndNotification>
      </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