Inventory   WebService   SOAP  

Promotional Products Data Interface Specification for Web services



 

Inventory Interface Standards












 

Version: 1.0.0

Date:28-Apr-2014

Document Change Log

Version

Date

Reason for Change

Author

.1

2014-2-10

Initial Draft

Eric Shonebarger, CIO

Hit Promotional Products

.2

2014-02-19

Review by BIC Graphic personnel:  

Removed authentication standard in lieu of all parties using following their standards.

Added ProductIDType to Request:

Added companion inventory  to Reply:

Added multiple array detail fields

Tim Nale, Director IT

BIC Graphic

.3

2014-03-03

Modified Custom Attributes to ARRAY

Added reference to Data Mining / Abuse

Tim Nale, Director IT

BIC Graphic

1.0

2014-03-27

Modified Quantity Available data type; added version control

Tim Nale, Director IT

BIC Graphic

1.0.0

2014-04-28

Updated casing on field names and Array Naming convention

Jon Norris, System Operations Manager

Starline

 

Abstract and Recommended Audience

This document describes the technologies for integration of suppliers and distributors in the Promotional Products Industry. This document will discuss in detail the technology required in order to build the interface. Additionally, this document will provide sample code in order to use the interface.

This document will assume that the reader is fluent in web based technologies, and has knowledge of the language they plan to consume the web service in.

Background Information

All specifications will be built using the Simple Object Access Protocol (SOAP) over HTTPS as the foundation for the web services protocol stack in order to provide a standards based secure form of communication.

More information on SOAP can be found at http://www.w3.org/TR/soap12-part1/

Inventory

Function: getInventoryLevels()

Request:

Field

Description

Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced

64 STRING

TRUE

id

The customerID or any other agreed upon ID.

64 STRING

TRUE

password

The password associated with the customerID.

64 STRING

FALSE

productID

Item’s ID

64 STRING

TRUE

productIDtype

productID type (Distributor, Supplier)

64 STRING

TRUE

 

Reply:

Field

Description

Data Type

Required?

productID

The associated product.

64 STRING

TRUE

productVariationInventoryArray1

An array of inventory levels grouped by variation.

ARRAY

FALSE

productCompanionInventoryArray2

Array of companion items’ inventory levels.

ARRAY

FALSE

errorMessage

Response for any error requiring notification to requestor

256 STRING

FALSE

CustomMessageArray3

An array of custom data that the supplier/distributor is free to implement in any way they see fit.

ARRAY

FALSE

 

1ProductVariationInventory

Field

Description

Data Type

Required?

partID

The associated part

64 STRING

TRUE

partDescription

Part’s description

256 STRING

FALSE

partBrand

Part’s brand

64 STRING

FALSE

priceVariance

Variance from requested part’s price

64 STRING

FALSE

quantityAvailable

The quantity available

64 STRING

TRUE

attributeColor

Description of the color of the part

64 STRING

FALSE

attributeSize

Description of the size of the part

64 STRING

FALSE

AttributeFlexArray4

Array of the part’s attributes

ARRAY

FALSE

customProductMessage5

Message from the supplier regarding the stock

256 STRING

FALSE

entryType

Record type (exact, alternate)

64 STRING

FALSE

validTimestamp

Datetime inventory is available

ISO 8601

FALSE




 

2ProductCompanionInventory

Field

Description

Data Type

Required?

partID

The companion part

64 STRING

TRUE

partDescription

Part’s description

256 STRING

FALSE

partBrand

Part’s brand

64 STRING

FALSE

price

Companion item price

64 STRING

FALSE

quantityAvailable

The quantity available

64 STRING

TRUE

attributeColor

Description of the color of the part

64 STRING

FALSE

attributeSize

Description of the size of the part

64 STRING

FALSE

AttributeFlexArray4

Array of the part’s attributes

ARRAY

FALSE

customProductMessage5

Message from the supplier regarding the stock

256 STRING

FALSE

validTimestamp

Datetime inventory is available

ISO 8601

FALSE

 

3 CustomMessage

Suppliers and distributors are free to use the custom array however they wish.

4 AttributeFlex

Field

Description

Data Type

Required?

ID

Attribute ID

64 STRING

FALSE

Name

Attribute Name

64 STRING

FALSE

Value

Attribute Value

256 STRING

FALSE

The Supplier can use this ARRAY to define additional unique attributes about the product.  An example could be for an item which has choices about thickness which can be made.  

In this ID = “1”; Name = “Thickness”; Value = “0.10 inches”

5 CustomProductMessage

Suppliers and distributors are free to use this custom message String however they wish.

Code Samples

To be published under separate specification: “Inventory Interface Supplier/Distributor Developer Guide”

DATA MINING / ABUSE GUIDELINE

The use of services detailed within this specification are to be conducted within the current guidelines of the “Interface Data Use Guidelines Standards”

Validation of Services

Before you publish your endpoint, please ensure that it adheres to the promostandards.org spec by using the web service validation tool. 

http://services.promostandards.org/webserviceValidator/home

Select the service, version, method and input your endpoint.  If the endpoint is correct you should receive a message of:

 

"The XML response is valid."