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, 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>
      </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.
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.

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>
          </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>
          </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
Article_UpdatedArticleItem
ArticleSystemId int