UpdateArticleItems

Each article (SKU) in Ongoing WMS has zero or more article items. The article items represent what is in stock at the warehouse (for more information about article items, see this article). UpdateArticleItems allows you to update the status of one or more article items.

Tags: UpdateArticleItems, UpdateArticleItemsOperation, UpdateArticleItemsIdentification, UpdateArticleItemStatus, UpdateArticleItemCategory, UpdateArticleItemLock, UpdateArticleItemPrice, UpdateArticleItemBatch, UpdateArticleItemWeight, UpdateArticleItemLength, UpdateArticleItemWidth, UpdateArticleItemHeight, UpdateArticleItemsResponse, UpdateArticleItemsResult, UpdateArticleItemsResultError, UpdatedArticleItem, Article_UpdatedArticleItem

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/UpdateArticleItems"

<?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>
    <UpdateArticleItems xmlns="http://ongoingsystems.se/WSI">
      <GoodsOwnerCode>string</GoodsOwnerCode>
      <UserName>string</UserName>
      <Password>string</Password>
      <Operation>
        <Identification>
          <ArticleNumber>string</ArticleNumber>
          <ArticleSystemId>int</ArticleSystemId>
          <OriginalArticleItemId>int</OriginalArticleItemId>
          <ArticleItemId>int</ArticleItemId>
          <ArticleItemStatusId>int</ArticleItemStatusId>
          <Batch>string</Batch>
          <Serial>string</Serial>
          <StockStatus>IsInStock or IsInStockOrIsAdvised or NoFilter</StockStatus>
        </Identification>
        <NumberOfItemsToUpdate>decimal</NumberOfItemsToUpdate>
        <UpdateArticleItemStatus>
          <ArticleItemStatusCode>string</ArticleItemStatusCode>
          <ArticleItemStatusId>int</ArticleItemStatusId>
        </UpdateArticleItemStatus>
        <UpdateArticleItemCategory>
          <ArticleItemCategoryCode>string</ArticleItemCategoryCode>
          <ArticleItemCategoryId>int</ArticleItemCategoryId>
        </UpdateArticleItemCategory>
        <UpdateArticleItemLock>
          <IsLockedByItemLock>boolean</IsLockedByItemLock>
        </UpdateArticleItemLock>
        <UpdateArticleItemPrice>
          <ArticleItemPrice>decimal</ArticleItemPrice>
        </UpdateArticleItemPrice>
        <UpdateArticleItemBatch>
          <Batch>string</Batch>
        </UpdateArticleItemBatch>
        <UpdateArticleItemWeight>
          <Weight>decimal</Weight>
        </UpdateArticleItemWeight>
        <UpdateArticleItemLength>
          <Length>decimal</Length>
        </UpdateArticleItemLength>
        <UpdateArticleItemWidth>
          <Width>decimal</Width>
        </UpdateArticleItemWidth>
        <UpdateArticleItemHeight>
          <Height>decimal</Height>
        </UpdateArticleItemHeight>
      </Operation>
    </UpdateArticleItems>
  </soap:Body>
</soap:Envelope>

Request specification

UpdateArticleItems
GoodsOwnerCode	string(400)	Req.	The name/code of your client
UserName	string(50)	Req.	Your username
Password	string(50)	Req.	Your password
Operation	UpdateArticleItemsOperation	Req.	The operation object

UpdateArticleItemsOperation
Identification	UpdateArticleItemsIdentification	Req.	This object tells the system which article items you want to update. For instance, you can update all article items which have the same batch. You have to specify at least one identifier. See Identification.
NumberOfItemsToUpdate	decimal		If specified, this is the maximum quantity which you want to change. If you don't specify this field, the system will change all article items which match your filter.
UpdateArticleItemStatus	UpdateArticleItemStatus		The new article item status of the items which match your filter. See UpdateArticleItemStatus.
UpdateArticleItemCategory	UpdateArticleItemCategory		The new article item category of the items which match your filter. See UpdateArticleItemCategory.
UpdateArticleItemLock	UpdateArticleItemLock		Allows you to lock or unlock the items which match your filter. See UpdateArticleItemLock. Note that this lock specifically refers to the _i_item lockbackslash_i. There are other ways of locking items (for instance, by placing them in a locked location) and those types of locks will not be affected by changing the item lock.
UpdateArticleItemPrice	UpdateArticleItemPrice		The new article item price of the items which match your filter. See UpdateArticleItemPrice.
UpdateArticleItemBatch	UpdateArticleItemBatch		The new batch of the items which match your filter. See UpdateArticleItemBatch.
UpdateArticleItemWeight	UpdateArticleItemWeight		The new weight of the items which match your filter. See UpdateArticleItemWeight.
UpdateArticleItemLength	UpdateArticleItemLength		The new length of the items which match your filter. See UpdateArticleItemLength.
UpdateArticleItemWidth	UpdateArticleItemWidth		The new width of the items which match your filter. See UpdateArticleItemWidth.
UpdateArticleItemHeight	UpdateArticleItemHeight		The new height of the items which match your filter. See UpdateArticleItemHeight.

UpdateArticleItemsIdentification
ArticleNumber	string(100)	The article number whose items you want to update.
ArticleSystemId	int	The article system id of the article whose items you want to update.
OriginalArticleItemId	int	Only update article items which have the specified OriginalArticleItemId.
ArticleItemId	int	Only update this particular ArticleItemId.
ArticleItemStatusId	int	Only update article items which have this status id.
Batch	string(50)	The batch number of the article items which you want to update.
Serial	string(128)	The serial number of the article items which you want to update.
StockStatus	enum	Must be one of these values: - IsInStock - IsInStockOrIsAdvised - NoFilter If IsInStock, then the system will only update article items which are in stock. If IsInStockOrIsAdvised, then the system will update article items which are either in stock or advised (this is the default behavior). If NoFilter, then the system will update all article items matching the provided Identification. This means that it is possible to update article items which have left the warehouse, so please use with caution.

UpdateArticleItemStatus
ArticleItemStatusCode	string(50)		The new article item status code for the items.
ArticleItemStatusId	int		The new article item status id for the items.

UpdateArticleItemCategory
ArticleItemCategoryCode	string(100)		The new article item category code for the items.
ArticleItemCategoryId	int		The new article item category id for the items.

UpdateArticleItemLock
IsLockedByItemLock	boolean		Whether or not the items are item locked.

UpdateArticleItemPrice
ArticleItemPrice	decimal		The new article item price for the items.

UpdateArticleItemBatch
Batch	string		The new batch for the items.

UpdateArticleItemWeight
Weight	decimal		The new weight for the items.

UpdateArticleItemLength
Length	decimal		The new length for the items.

UpdateArticleItemWidth
Width	decimal		The new width for the items.

UpdateArticleItemHeight
Height	decimal		The new height for the items.

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>
    <UpdateArticleItemsResponse xmlns="http://ongoingsystems.se/WSI">
      <UpdateArticleItemsResult>
        <Errors>
          <UpdateArticleItemsResultError>
            <Message>string</Message>
            <ErrorType>UnknownError or LogonError or NoArticleItemsFound or ArticleNotFound or ErrorUpdating or InvalidIdentification or ArticleItemStatusNotFound or NoUpdateOperationSpecified or ArticleItemDivideFailed or ArticleItemCategoryNotFound</ErrorType>
          </UpdateArticleItemsResultError>
          <UpdateArticleItemsResultError>
            <Message>string</Message>
            <ErrorType>UnknownError or LogonError or NoArticleItemsFound or ArticleNotFound or ErrorUpdating or InvalidIdentification or ArticleItemStatusNotFound or NoUpdateOperationSpecified or ArticleItemDivideFailed or ArticleItemCategoryNotFound</ErrorType>
          </UpdateArticleItemsResultError>
        </Errors>
        <UpdatedArticleItems>
          <UpdatedArticleItem>
            <Article>
              <ArticleSystemId>int</ArticleSystemId>
            </Article>
            <ArticleItemId>int</ArticleItemId>
            <OriginalArticleItemId>int</OriginalArticleItemId>
            <Serial>string</Serial>
            <Batch>string</Batch>
            <ArticleItemStatusId>int</ArticleItemStatusId>
            <NumberOfItems>decimal</NumberOfItems>
            <ArticleItemCategoryId>int</ArticleItemCategoryId>
            <IsLockedByItemLock>boolean</IsLockedByItemLock>
            <ArticleItemPrice>decimal</ArticleItemPrice>
            <ArticleItemWeight>decimal</ArticleItemWeight>
            <ArticleItemLength>decimal</ArticleItemLength>
            <ArticleItemWidth>decimal</ArticleItemWidth>
            <ArticleItemHeight>decimal</ArticleItemHeight>
          </UpdatedArticleItem>
          <UpdatedArticleItem>
            <Article>
              <ArticleSystemId>int</ArticleSystemId>
            </Article>
            <ArticleItemId>int</ArticleItemId>
            <OriginalArticleItemId>int</OriginalArticleItemId>
            <Serial>string</Serial>
            <Batch>string</Batch>
            <ArticleItemStatusId>int</ArticleItemStatusId>
            <NumberOfItems>decimal</NumberOfItems>
            <ArticleItemCategoryId>int</ArticleItemCategoryId>
            <IsLockedByItemLock>boolean</IsLockedByItemLock>
            <ArticleItemPrice>decimal</ArticleItemPrice>
            <ArticleItemWeight>decimal</ArticleItemWeight>
            <ArticleItemLength>decimal</ArticleItemLength>
            <ArticleItemWidth>decimal</ArticleItemWidth>
            <ArticleItemHeight>decimal</ArticleItemHeight>
          </UpdatedArticleItem>
        </UpdatedArticleItems>
        <Success>boolean</Success>
      </UpdateArticleItemsResult>
    </UpdateArticleItemsResponse>
  </soap:Body>
</soap:Envelope>

Response specification

UpdateArticleItemsResponse
UpdateArticleItemsResult	UpdateArticleItemsResult

UpdateArticleItemsResult
Errors	UpdateArticleItemsResultError[]	A list of UpdateArticleItemsResultError objects
UpdatedArticleItems	UpdatedArticleItem[]	An list of objects of type UpdatedArticleItem, telling you which article items were updated.
Success	boolean	True if successful, false otherwise.

UpdateArticleItemsResultError
Message	string	Message explaining the error.
ErrorType	enum	The type of error: - UnknownError - LogonError - NoArticleItemsFound - ArticleNotFound - ErrorUpdating - InvalidIdentification - ArticleItemStatusNotFound - NoUpdateOperationSpecified - ArticleItemDivideFailed - ArticleItemCategoryNotFound

UpdatedArticleItem
Article	Article_UpdatedArticleItem	Information about the article.
ArticleItemId	int	Article item id.
OriginalArticleItemId	int	Original article item id.
Serial	string(128)	Serial number.
Batch	string(50)	Batch number.
ArticleItemStatusId	int	Article item status id.
NumberOfItems	decimal	The quantity which this article item represents.
ArticleItemCategoryId	int	Article item category id.
IsLockedByItemLock	boolean	Whether or note the item is locked.
ArticleItemPrice	decimal	The article item price
ArticleItemWeight	decimal	The article item weight
ArticleItemLength	decimal	The article item length
ArticleItemWidth	decimal	The article item width
ArticleItemHeight	decimal	The article item height

Article_UpdatedArticleItem
ArticleSystemId	int