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:

• workspace_dir/WebSphereCommerceWebServices.jar

Under the following path:

• META-INF/jaxrpc/WebSphereCommerce/WebSphereCommerce-OMS.wsdl

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
Enable WebSphere Commerce as a service provider

Related reference
Inbound web services provided