UpdateShipment
This function allows you to update a shipment.
Note: The word "shipment" here refers to Ongoing WMS' own concept of a shipment, which is a way of organizing outbound and inbound deliveries. It has no relation to the "shipments" which a carrier (such as DHL or UPS) deals with. The vast majority of warehouses do not use Ongoing WMS' own shipment functionality, and therefore most integrations will not need to use this function.
Tags: UpdateShipment, UpdateShipment, ShipmentUpdateIdentification, UpdateShipmentComment, UpdateShipmentCustomsReferenceNumber, UnlockInboundArticleItemsOperation, UpdateShipmentStatus, UpdateShipmentWaybill, UpdateShipmentResponse, UpdateShipmentResult
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/UpdateShipment"
<?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>
<UpdateShipment xmlns="http://ongoingsystems.se/WSI">
<GoodsOwnerCode>string</GoodsOwnerCode>
<UserName>string</UserName>
<Password>string</Password>
<updateShipment>
<ShipmentUpdateIdentification>
<ShipmentIdentificationType>WayBill or ShipmentOrderNumber or ShipmentId</ShipmentIdentificationType>
<WayBill>long</WayBill>
<ShipmentOrderNumber>string</ShipmentOrderNumber>
<ShipmentId>int</ShipmentId>
</ShipmentUpdateIdentification>
<UpdateShipmentComment>
<ShipmentComment>string</ShipmentComment>
</UpdateShipmentComment>
<UpdateShipmentCustomsReferenceNumber>
<CustomsReferenceNumber>string</CustomsReferenceNumber>
</UpdateShipmentCustomsReferenceNumber>
<UnlockInboundArticleItemsOperation>
<Unlock>boolean</Unlock>
</UnlockInboundArticleItemsOperation>
<UpdateShipmentSetCustomsStatusApproved />
<UpdateShipmentSetCustomsStatusFetchedByCustomsSystem />
<UpdateShipmentSetCustomsStatusRejectedByCustomsSystem />
<UpdateShipmentStatus>
<ShipmentStatus>int</ShipmentStatus>
</UpdateShipmentStatus>
<UpdateShipmentWaybill>
<Waybill>long</Waybill>
</UpdateShipmentWaybill>
</updateShipment>
</UpdateShipment>
</soap:Body>
</soap:Envelope>
Request specification
UpdateShipment |
GoodsOwnerCode |
string(400) |
Req. |
The name/code of your client |
UserName |
string(50) |
Req. |
Your username |
Password |
string(50) |
Req. |
Your password |
updateShipment |
UpdateShipment |
Req. |
An element updateShipment. |
UpdateShipment |
ShipmentUpdateIdentification |
ShipmentUpdateIdentification |
|
Contains information about how to identify the shipment |
UpdateShipmentComment |
UpdateShipmentComment |
|
The new comment for the shipment. |
UpdateShipmentCustomsReferenceNumber |
UpdateShipmentCustomsReferenceNumber |
|
The new reference number for the shipment. |
UnlockInboundArticleItemsOperation |
UnlockInboundArticleItemsOperation |
|
If you want to unlock all article items on the shipment. |
UpdateShipmentSetCustomsStatusApproved |
UpdateShipmentSetCustomsStatusApproved |
|
If you send in this object, then the shipment status will be set to Approved. |
UpdateShipmentSetCustomsStatusFetchedByCustomsSystem |
UpdateShipmentSetCustomsStatusFetchedByCustomsSystem |
|
If you send in this object, then the shipment status will be set to Fetched by customs system. |
UpdateShipmentSetCustomsStatusRejectedByCustomsSystem |
UpdateShipmentSetCustomsStatusRejectedByCustomsSystem |
|
If you send in this object, then the shipment status will be set to Rejected by customs system. |
UpdateShipmentStatus |
UpdateShipmentStatus |
|
Used to update the status of the shipment. |
UpdateShipmentWaybill |
UpdateShipmentWaybill |
|
Used to update the waybill of the shipment |
ShipmentUpdateIdentification |
ShipmentIdentificationType |
enum |
|
Determines how you want the system to identify the shipment. Must be one of these values: |
WayBill |
long |
|
Waybill number. Required if ShipmentIdentificationType = WayBill. |
ShipmentOrderNumber |
string |
|
Shipment order number. Required if ShipmentIdentificationType = ShipmentOrderNumber. |
ShipmentId |
int |
|
Ongoing WMS internal id (SystemId) of the shipment. Required if ShipmentIdentificationType = ShipmentId . |
UpdateShipmentCustomsReferenceNumber |
CustomsReferenceNumber |
string |
|
The new reference number for the shipment. |
UnlockInboundArticleItemsOperation |
Unlock |
boolean |
|
True to unlock all items on the shipment. |
UpdateShipmentStatus |
ShipmentStatus |
int |
|
The id of the status the shipment should receive |
UpdateShipmentWaybill |
Waybill |
long |
|
The new waybill for the shipment. |
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>
<UpdateShipmentResponse xmlns="http://ongoingsystems.se/WSI">
<UpdateShipmentResult>
<Success>boolean</Success>
<Message>string</Message>
<ShipmentId>int</ShipmentId>
</UpdateShipmentResult>
</UpdateShipmentResponse>
</soap:Body>
</soap:Envelope>
Response specification
UpdateShipmentResponse |
UpdateShipmentResult |
UpdateShipmentResult |
|
UpdateShipmentResult |
Success |
boolean |
True if successful, false otherwise. |
Message |
string |
Error message, if the call was unsuccessful. |
ShipmentId |
int |
The internal Ongoing WMS shipment id of the shipment. |