Ongoing Warehouse logo

Ongoing Warehouse Developer

UpdateOrder (automation API)

This function allows you to update certain fields on orders.

Note that the goods owner SOAP API contains a function with the exact same name. So we have:

  1. UpdateOrder in the goods owner SOAP API.
  2. UpdateOrder in the automation API (the function described on this page).
These two functions are very similar. However, the UpdateOrders function in the automation API (the function described in this page) allows you to update any order regardless of which goods owner the order belongs to.

Tags: UpdateOrder, UpdateOrderResult

Request XML

POST /xxx/automation.asmx HTTP/1.1
Host: api.ongoingsystems.se
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://ongoingsystems.se/Automation/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/Automation">
         <UserName>string</UserName>
         <Password>string</Password>
         <Order>
            <OrderId>int</OrderId>
            <UpdateOrderWaybill>
               <Waybill>string</Waybill>
            </UpdateOrderWaybill>
            <UpdateOrderTransporterOrderNumber>
               <TransporterOrderNumber>string</TransporterOrderNumber>
            </UpdateOrderTransporterOrderNumber>
            <UpdateOrderTransporterFreightWeight>
               <TransporterFreightWeight>decimal</TransporterFreightWeight>
            </UpdateOrderTransporterFreightWeight>
            <UpdateOrderFreightPrice>
               <FreightPrice>decimal</FreightPrice>
            </UpdateOrderFreightPrice>
            <UpdateOrderInvoiceUrl>
               <InvoiceUrl>string</InvoiceUrl>
            </UpdateOrderInvoiceUrl>
            <UpdateOrderComment>
               <Comment>string</Comment>
            </UpdateOrderComment>
            <UpdateOrderStatus>
               <OrderStatus>int</OrderStatus>
            </UpdateOrderStatus>
            <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>
            <UpdateOrderWarehouseInstruction>
               <WarehouseInstruction>string</WarehouseInstruction>
            </UpdateOrderWarehouseInstruction>
         </Order>
      </UpdateOrder>
   </soap:Body>
</soap:Envelope>
+

Request specification

UpdateOrder
UserName str(50) Req. Your username.
Password str(50) Req. Your password.
OrderId int Req. The order id of the order which you want to update
UpdateOrderWaybill object
Waybill str(50) The new waybill of the order.
UpdateOrderTransporterOrderNumber object
UpdateOrderTransporterOrderNumber str(150) The new transporter order number of the order.
UpdateOrderTransporterFreightWeight object
TransporterFreightWeight dec The new freight weight of the order.
UpdateOrderTransporterFreightPrice object
TransporterFreightPrice dec The new freight price of the order.
UpdateOrderInvoiceUrl object
InvoiceUrl str(200) The new invoice URL of the order.
UpdateOrderComment object
Comment str(500) The new order comment.
UpdateOrderStatus object
OrderStatus int The new order status.
UpdateOrderTransporterContract object
> TransporterContractIdentification enum Req. Defines what you want to identify the transporter contract by:
 - CodeAndServiceCodeAndCustomerNumber
 - CodeAndServiceCode
 - Code
 - ServiceCode
Most integrations will use CodeAndServiceCode
> TransporterContractOperation enum Req. Defines the operation:
 - Find
 - CreateOrUpdate
Most integrations will use Find
> TransportPayment enum Req. Defines who will pay for the transport:
 - Collect
 - Prepaid
 - ThirdParty
 - UnKnown
Most integrations will use Prepaid
> TransporterCode str(50) Transporter code. See GetTransporterContracts for available codes. Required if TransporterContractIdentification = CodeAndServiceCodeAndCustomerNumber, CodeAndServiceCode or Code
> TransporterServiceCode str(50) Transporter service code. See GetTransporterContracts for available codes. Required if TransporterContractIdentification = CodeAndServiceCodeAndCustomerNumber, CodeAndServiceCode or ServiceCode
> CustomerNumber str(50) Customer number at the transporter. Usually not needed if TransportPayment = PrePaid
> ConsigneePalletCustomerNumber str(50) Pallet reg number
UpdateOrderWarehouseInstruction object
> WarehouseInstruction str(500) The new warehouse instruction for the order.

Response XML

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?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/Automation">
         <UpdateOrderResult>
            <Success>boolean</Success>
            <Message>string</Message>
            <OrderId>int</OrderId>
         </UpdateOrderResult>
      </UpdateOrderResponse>
   </soap:Body>
</soap:Envelope>
+

Response specification

UpdateOrderResult
Success bool True if successful, false otherwise.
Message str(*) Error message, if the call was unsuccessful.
OrderId int The internal Ongoing order id of the order.