Develop > Persistence layer > WebSphere Commerce Web services with JSP pages > Understand the WebSphere Commerce Web service framework > WebSphere Commerce as a service provider > Inbound Web services provided
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.
Map
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:
- WC_EAR /WebSphereCommerceWebServices.jar
Under the following path:
- META-INF/jaxrpc/WebSphereCommerce/WebSphereCommerce-OMS.wsdl
Related concepts
WebSphere Commerce Web services with JSP pages
Understand 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