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>
         </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) Req.* The new waybill of the order.
UpdateOrderTransporterOrderNumber object
> UpdateOrderTransporterOrderNumber str(150) Req.* The new transporter order number of the order.
UpdateOrderTransporterFreightWeight object
> TransporterFreightWeight dec Req.* The new freight weight of the order.
UpdateOrderTransporterFreightPrice object
> TransporterFreightPrice dec Req.* The new freight price of the order.
UpdateOrderInvoiceUrl object
> InvoiceUrl str(200) Req.* The new invoice URL of the order.
UpdateOrderComment object
> Comment str(500) Req.* The new order comment.
UpdateOrderStatus object
> OrderStatus int Req.* 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) Req.* Transporter code. See GetTransporterContracts for available codes. Required if TransporterContractIdentification = CodeAndServiceCodeAndCustomerNumber, CodeAndServiceCode or Code
> TransporterServiceCode str(50) Req.* 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

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.