Inventory update

The inventory update service is an inbound service for WebSphere Commerce configurations in which an external inventory management system (IMS) is used. This service is called by the external IMS to update the local inventory cache in WebSphere Commerce in such configurations.

Requests to this service are in the form of UpdateInventoryBalance business object documents (BODs). This service does not return a response BOD.

 

Mapping

This service is mapped to the InventoryBalanceUpdate command. The following table describes how the UpdateInventoryBalance BOD will be mapped to the input parameters of this command:

XPath Input Parameter Mandatory Description
DataArea/InventoryBalance[i]

this element describes the i-th local inventory cache entry to update
DataArea/InventoryBalance[i]/Item/ItemID/ID catEntryId_i n the WebSphere Commerce catalog entry ID of the entry
DataArea/InventoryBalance[i]/Item/SupplierItemID/ID partNumber_i n the part number (SKU) of the entry
DataArea/InventoryBalance[i]/GLEntityID storeId y the WebSphere Commerce store ID of the entry
DataArea/InventoryBalance[i]/Facility/IDs/ID fulfillmentCenterId_i y the WebSphere Commerce fulfillment center ID of the entry
DataArea/InventoryBalance[i]/AvailableQuantity inventoryQuantity_i y the quantity of the entry
DataArea/InventoryBalance[i]/AvailableQuantity/@unitCode UOM_i n the unit of measure (UOM) of the quantity above

 

Example

The following is a sample request: 

<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope 
    xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <soapenv:Header>
        <wsse:Security 
xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wsswssecurity-secext-1.0.xsd">
            <wsse:UsernameToken>
                <wsse:Username>wcsadmin</wsse:Username>
                <wsse:Password 
Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wssusername-token-profile-1.0#PasswordText">wcs1admin</wsse:Password>
            </wsse:UsernameToken>
        </wsse:Security>
    </soapenv:Header>
    <soapenv:Body>
        <oa:UpdateInventoryBalance releaseID="9.0"
versionID="9.1"
            xmlns:oa="http://www.openapplications.org/oagis/9"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  
xsi:schemaLocation="http://www.openapplications.org/oagis/9
../../../..
/BODs/Developer/UpdateInventoryBalance.xsd ">
            <oa:ApplicationArea>
               
<oa:CreationDateTime>2001-12-31T12:00:00</oa:CreationDateTime>
               
<oa:BODID>2001-12-31T12:00:00[wcsadmin]localhost</oa:BODID>
            </oa:ApplicationArea>
            <oa:DataArea>
                <oa:Update/>
                <oa:InventoryBalance>
                    <oa:Item>
                        <oa:ItemID>
                            <oa:ID>10001</oa:ID>
                        </oa:ItemID>
                    </oa:Item>
                   
<oa:GLEntityID>10001</oa:GLEntityID>
                    <oa:Facility>
                        <oa:IDs>
                            <oa:ID>10001</oa:ID>
                        </oa:IDs>
                    </oa:Facility>                  
<oa:AvailableQuantity>1000</oa:AvailableQuantity>
                </oa:InventoryBalance>
            </oa:DataArea>
        </oa:UpdateInventoryBalance>
    </soapenv:Body>
</soapenv:Envelope>

 

WSDL

The WSDL file of this service can be found in the following JAR file:

Under the following path:

Related concepts

WebSphere Commerce Web services with JSP pages

Understanding the WebSphere Commerce Web service framework

Security and the WebSphere Commerce Web service framework

Related tasks

Enabling WebSphere Commerce as a service provider

Related reference

Inbound Web services provided