Promotional Products Data Interface Specification for Web services

 

 

 

Purchase Order

 

 

Version: 1.0.0

Date: 2018-07-01

Document Change Log

Version

Date

Reason for Change

Author

1.0.0

07/01/2018

v1.0.0 publish

See contributors section

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Contributors

The following have contributed to the creation of this specification:

Contributors:    Eric Shonebarger, CIO Hit Promotional Products, Inc

                             Jon Norris, VP of Operations Starline

                             Paul Fleischman, Technical Lead PCNA

                             Dustin Kessler, Enterprise Architect, Staples Promotional Products

                             Steve Luisser, VP of R&D, Essent

                            

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/

 


 

Service Details

 

Function: getSupportedOrderTypes()
This function returns the supported Order Types the vendor accepts.

 

Request: getSupportedOrderTypesRequest

Field

Description

WSDL Data Type

SQL Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced. Values are enumerated {1.0.0}

STRING

VARCHAR(64)

TRUE

id

The customerId or any other agreed upon Id.

STRING

VARCHAR(64)

TRUE

password

The password associated with the customerId.

STRING

VARCHAR(64)

FALSE

 

Response: getSupportedOrderTypesResponse

Field

Description

WSDL Data Type

SQL Data Type

Required?

SupportedOrderTypes[]

An array of supported order types for this supplier. Signifies which order types the supplier supports. Values are enumerated: “Blank”, “Sample”, “Simple” “Configured”

ARRAY

ARRAY

FALSE

ServiceMessageArray

An array of ServiceMessage objects.

OBJECT

OBJECT

FALSE

 

Function: sendPO()

This function will send a configured purchase order to a vendor. The purchase order is designed to work in conjunction with data from the Promostandards Product Pricing and Configuration web service. More information on Product Pricing and Configuration can be found at http://promostandards.org.

 

Request: sendPORequest

Field

Description

WSDL Data Type

SQL Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced. Values are enumerated {1.0.0}

STRING

VARCHAR(64)

TRUE

id

The customer Id or any other agreed upon Id.

STRING

VARCHAR(64)

TRUE

password

The password associated with the customer Id.

STRING

VARCHAR(64)

FALSE

PO

The object containing the Purchase Order

OBJECT

OBJECT

TRUE

 

PO

Field

Description

WSDL Data Type

SQL Data Type

Required?

orderType

The type of data transferred in the request; values are enumerated:

“Blank”—This is data is for blank goods.

“Sample”—This data is for a random sample order

“Simple”—The data in the purchase order is sent over without supplier configured data and will be processed manually.

“Configured”—The data is sent over in conjunction with the supplier’s Product Pricing and Configuration web service and designed for electronic processing of the purchase order.

ENUMERATED STRING

VARCHAR(64)

TRUE

orderNumber

Purchase order number

STRING

VARCHAR(64)

TRUE

orderDate

The date and time of the purchase order.

DATE

DATE

TRUE

lastModified

The date and time the purchase order was last modified

DATE

DATE

FALSE

totalAmount

The total dollar amount of the purchase order

DOUBLE

DECIMAL(12,4)

TRUE

paymentTerms

The terms of the purchase order.  i.e. NET15, NET30, etc.

STRING

STRING

FALSE

rush

Used to indicate a rush on the purchase order.

BOOLEAN

BOOLEAN

TRUE

currency

The currency the purchase order is transacted in ISO4217 format.

STRING

VARCHAR(3)

TRUE

DigitalProof

An object containing preproduction digital proof information

OBJECT

OBJECT

FALSE

OrderContactArray

An array of contact information

ARRAY

ARRAY

FALSE

ShipmentArray

Any array of purchase order shipments

OBJECT ARRAY

OBJECT ARRAY

TRUE

LineItemArray

An array of purchase order line items

ARRAY

ARRAY

TRUE

termsAndConditions

The terms and conditions for this purchase order.  Information that is order specific or information dealing with the configuration or shipment of the order should not be entered here.

STRING

VARCHAR(MAX)

TRUE

salesChannel

The sales channel

STRING

VARCHAR(64)

FALSE

promoCode

The promotion code

STRING

VARCHAR(64)

FALSE

TaxInformationArray

An array of TaxInformation objects related to calculating taxes

ARRAY

ARRAY

FALSE

 

DigitalProof

Field

Description

WSDL Data Type

SQL Data Type

Required?

required

A Boolean value set to TRUE indicates a proof is required for this purchase order; the value is FALSE otherwise.

BOOLEAN

BOOLEAN

TRUE

DigitalProofAddressesArray

An array containing DigitalProofAddress objects.

ARRAY

ARRAY

TRUE

 

DigitalProofAddress

Field

Description

WSDL Data Type

SQL Data Type

Required?

type

The type of address of the digital proof.  Values are enumerated: Email, Webservice

STRING

VARCHAR(64)

TRUE

email

The address that the digital proof should be sent to prior to production.

STRING

VARCHAR(128)

TRUE

lineItemGroupingId

What line item group does this proof address link to

INT

INT

TRUE

 

TaxInformation

Field

Description

WSDL Data Type

SQL Data Type

Required?

taxId

The purchasers tax identifier

STRING

VARCHAR(64)

TRUE

taxType

The type of tax the identifier applies to. Values are enumerated: “Hst-Gst”, “Pst”, “SalesTax”

ENUMERATED STRING

VARCHAR(64)

TRUE

taxExempt

Tax Except

BOOLEAN

BOOLEAN

TRUE

taxJurisdiction

Tax Jurisdictions

UNBOUNDED STRING ARRAY

VARCHAR(64)

TRUE

taxAmount

The amount of tax for this purchase order

DECIMAL

DECIMAL

FALSE

 

LineItem

Field

Description

WSDL Data Type

SQL Data Type

Required?

lineNumber

The line number of the line item

STRING

VARCHAR(64)

TRUE

description

The description of the line item.  For simple order type (not using a configuration), use this field to explain the details.

STRING

VARCHAR(MAX)

TRUE

lineType

The type of order; values are enumerated:

·  “New” –A new purchase order with no prior order reference

·  “Repeat” —An exact repeat of a previous purchase order with the vendor

·  “Reference” –An order that has the same artwork as a previous order.

ENUMERATED STRING

VARCHAR(64)

TRUE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

FALSE

fobId

Used to indicate the FOB point.  Use fobId from the supplier’s Product Pricing and Configuration Service to populate this information.

STRING

VARCHAR(64)

FALSE

ToleranceDetails

The object containing how tolerant this line is to overrun and underruns.

OBJECT

OBJECT

TRUE

allowPartialShipments

Allow partial shipments of this line item

BOOLEAN

BOOLEAN

TRUE

unitPrice

The unit price of the line item

DOUBLE

DECIMAL(12,4)

FALSE

lineItemTotal

The total for the line item

DOUBLE

DECIMAL(12,4)

TRUE

requestedShipDate

The date the line item is requested to ship from the FOB point.

DATE

DATE

FALSE

requestedInHands

The date the line item is requested to arrive at the shipping destination

DATE

DATE

FALSE

referenceSalesQuote

The sales quote number associated with this purchase order line (if applicable).

VARCHAR(64)

VARCHAR(64)

FALSE

Program

Program pricing information.

OBJECT

OBJECT

FALSE

endCustomerSalesOrder

The distributor’s order number provided to the end customer

VARCHAR(64)

VARCHAR(64)

FALSE

productId

The manufacturer’s product id associated with the configuration data.

STRING

VARCHAR(64)

FALSE

customerProductId

The distributor’s product id

STRING

VARCHAR(64)

FALSE

lineItemGroupingId

An identifier that allows configuration data to be spread out among multiple purchase order lines.  Keep lineItemGroupingID unique when referencing the same product on the purchase order.  Any change to the product, location, decoration, or artwork should produce a unique lineItemGroupingID to the purchase order.

INT

INT

FALSE

PartArray

An array of product part information.  This array should be populated with information from the supplier’s PromoStandards Product Pricing and Configuration service

ARRAY

ARRAY

FALSE

Configuration

An object containing line item configuration data

OBJECT

OBJECT

FALSE

           

 

ToleranceDetails

tolerance

An enumerator specifying the quantity tolerance allowed:  AllowOverRun, AllowUnderrun, AllowOverrunOrUnderrun, ExactOnly.  Specifying AllowOverRun, AllowUnderrun or AllowOverrunOrUnderrun without a value and uom will result in the supplier’s discretion. 

ENUMERATED STRING

VARCHAR(64)

TRUE

value

The overrun/underrun permitted.  This element is ignored if ExactOnly is specified for tolerance.

DECIMAL

DECIMAL(12,4)

FALSE

uom

The unit of measure for value element; enumerated values are: {Percent, Quantity}.  This element is ignored if ExactOnly is specified for tolerance.

 

ENUMERATED STRING

VARCHAR(10)

FALSE

 

Program

id

The program id associated with this purchase order line (if applicable).

VARCHAR(64)

VARCHAR(64)

FALSE

name

The program name associated with this purchase order line (if applicable).

VARCHAR(64)

VARCHAR(64)

FALSE

 

Quantity

value

The quantity value

DECIMAL

DECIMAL(12,4)

TRUE

uom

The unit of measure; values are enumerated.

Values are: {BX, CA, DZ, EA, KT, PR, PK, RL, ST, SL, TH}

BX - Box

CA - Case

DZ - Dozen

EA - Each

KT - Kit

PR - Pair

PK - Package

RL - Roll

ST - Set

SL - Sleeve

TH - Thousand

 

ENUMERATED STRING

VARCHAR(2)

TRUE

 

Configuration

Field

Description

WSDL Data Type

SQL Data Type

Required?

referenceNumber

The previous order number that this purchase order is referencing

STRING

VARCHAR(64)

FALSE

referenceNumberType

The type of the prior order reference; values are enumerated: “PurchaseOrder”,”SalesOrder”, “JobOrWorkOrder”

ENUMERATED STRING

VARCHAR(64)

FALSE

preProductionProof

Indicates that this line item is for a pre-production proof

BOOLEAN

BOOLEAN

TRUE

ChargeArray

An array of charge information.  This array should be populated with information from the supplier’s PromoStandards Product Pricing and Configuration service

ARRAY

ARRAY

FALSE

LocationArray

An array of Decoration Location Information.  This array should be populated with information from the supplier’s PromoStandards Product Pricing and Configuration service

ARRAY

ARRAY

FALSE

 

Part

Field

Description

WSDL Data Type

SQL Data Type

Required?

partGroup

An identifier that links common line item parts together

STRING

VARCHAR(64)

FALSE

partId

The part Id from the supplier’s PromoStandards Product Pricing and Configuration service

STRING

VARCHAR(64)

TRUE

customerPartId

How the part is being represented to the distributor’s customer

STRING

VARCHAR(64)

FALSE

customerSupplied

The part will be supplied by the customer or another entity other than the supplier

BOOLEAN

BOOLEAN

TRUE

description

The description from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(MAX)

FALSE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

TRUE

locationLinkId

An array of location link Ids.  This links the part to its configured locations.

ARRAY OF INTEGERS

INT[]

FALSE

unitPrice

The price of the part being referenced.

DECIMAL

DECIMAL(12,4)

FALSE

extendedPrice

The unitPrice multiplied by the Quantity value.

DECIMAL

DECIMAL(12,4)

FALSE

ShipmentLinkArray

Link this part and a specified quantity to one or many shipments.

OBJECT ARRAY

OBJECT ARRAY

FALSE

 

ShipmentLink   

Field

Description

WSDL Data Type

SQL Data Type

Required?

shipmentId

The shipment Id

INT

INT

TRUE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

TRUE

 


 

Charge

Field

Description

WSDL Data Type

SQL Data Type

Required?

chargeId

The chargeId from the supplier’s PromoStandards Product Pricing and Configuration service

STRING

VARCHAR(64)

TRUE

chargeName

The chargeName from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(128)

FALSE

description

The charge description from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(MAX)

FALSE

chargeType

The type of charge.  Values are enumerated {Freight, Order, Run, Setup}.

ENUMERATED STRING

VARCHAR(64)

TRUE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

TRUE

unitprice

The price of the charge being referenced.

DECIMAL

DECIMAL(12,4)

FALSE

extendedPrice

The unitPrice multiplied by the Quantity value

DECIMAL

DECIMAL(12,4)

FALSE

 

Location

Field

Description

WSDL Data Type

SQL Data Type

Required?

locationLinkId

An identifier to be used within the Part Array to link configured locations to a part.  Due to different colors and sizes, identical locations may need to be decorated differently.

INT

INT

TRUE

locationId

The locationId from the supplier’s PromoStandards Product Pricing and Configuration service

INT

INT

TRUE

locationName

The locationName from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(128)

FALSE

DecorationArray

An array of product decoration information

ARRAY

ARRAY

TRUE

 


 

Decoration

Field

Description

WSDL Data Type

SQL Data Type

Required?

decorationId

The decorationId from the supplier’s PromoStandards Product Pricing and Configuration service

INT

INT

TRUE

decorationName

The decorationName from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(128)

FALSE

Artwork

The object containing the details of the artwork

OBJECT

OBJECT

TRUE

 

Artwork

refArtworkId

A pre-shared artwork Id that can be used by the supplier to find and reference the artwork.

STRING

VARCHAR(64)

FALSE

description

A textual description of the artwork being provided.

STRING

VARCHAR(MAX)

FALSE

Dimensions

The dimensions of the artwork

OBJECT

OBJECT

FALSE

ArtworkFileArray

An array of artwork file data

ARRAY

ARRAY

FALSE

instructions

Any instructions regarding the processing or modification of artwork.  Adding instructions will cause delays in processing.

STRING

VARCHAR(MAX)

FALSE

Layers

An object that explains how the artwork layers or stops will be handled

OBJECT

OBJECT

FALSE

TypesetArray

An array of typeset data

ARRAY

ARRAY

FALSE

totalStitchCount

The total stitch count for the specified embroidery art

INT

INT

FALSE

 

ArtworkFile

fileName

The file name and extension only of the artwork

STRING

VARCHAR(256)

TRUE

fileLocation

The exact path/location to the artwork

STRING

VARCHAR(1024)

TRUE

transportMechanism

The mechanism that will be used to transport the artwork; values are enumerated: “Email”, “Url”, “Ftp”, “ArtworkToFollow”

ENUMERATED STRING

VARCHAR(64)

TRUE

artworkType

The purpose of the artwork file; values are enumerated: “ProductionReady”, “VirtualProof”, “SupplierArtTemplate”, “NonProductionReady”

ENUMERATED STRING

VARCHAR(64)

TRUE

 

Dimensions

Field

Description

WSDL Data Type

SQL Data Type

Required?

geometry

The geometry of the decoration.  Values are enumerated: {Circle, Rectangle, Other}.

ENUMERATED STRING

VARCHAR(64)

TRUE

useMaxLocationDimensions

Use the maximum allowed imprint dimensions for this location.  If this is set to true, all other dimension information is ignored except for geometry.  Note: Max dimensions be also found from the supplier’s PromoStandards Product Pricing and Configuration service.

BOOLEAN

BOOLEAN

TRUE

height

The height of the artwork; leave blank if the imprint is not rectangular

DECIMAL

DECIMAL (12,4)

FALSE

width

The width of artwork; leave blank if the imprint is not rectangular

DECIMAL

DECIMAL (12,4)

FALSE

diameter

The diameter of the artwork; leave blank if the imprint is not circular

DECIMAL

DECIMAL (12,4)

FALSE

uom

The unit of measure for the decoration area in ISO 20022

https://www.iso20022.org/standardsrepository/public/wqt/Description

/mx/dico/codesets/_Y4XF0tp-Ed-ak6NoX_4Aeg_385163498

ENUMERATED STRING

VARCHAR(64)

FALSE

 

Layers

Field

Description

WSDL Data Type

SQL Data Type

Required?

colorSystem

The color system to use: Cmyk, Other, Pms, Rgb, Thread

ENUMERATED STRING

ENUMERATED STRING

TRUE

LayerOrStopArray

An array of layers for the artwork

OBJECT ARRAY

OBJECT ARRAY

TRUE

 

LayerOrStop

Field

Description

WSDL Data Type

SQL Data Type

Required?

nameOrNumber

The name or number of the layer/stop

STRING

VARCHAR(64)

TRUE

description

A human readable description of the layer

STRING

VARCHAR(MAX)

TRUE

color

The color value that corresponds to the colorSystem defined

STRING

VARCHAR(64)

TRUE

 

Typeset

Field

Description

WSDL Data Type

SQL Data Type

Required?

sequenceNumber

The order of the typeset information

INT

INT

TRUE

value

The typeset to be used on the order

STRING

VARCHAR(1024)

TRUE

font

The font to use for the typeset

STRING

VARCHAR(64)

FALSE

fontSize

The font size to use for the typeset

DECIMAL

DECIMAL

FALSE

 

Shipment

Field

Description

WSDL Data Type

SQL Data Type

Required?

customerPickup

The shipment will be a pickup and will not be shipped.

BOOLEAN

BOOLEAN

TRUE

ShipTo

The object containing the ship to information

OBJECT

OBJECT

TRUE

ThirdPartyAccount

The object containing the third party information for the shipping account to use and the business entity that is paying for the shipping.  Otherwise known as ship using this account.

OBJECT

OBJECT

FALSE

shipReferences

Array of two strings max of identifiers used as the reference fields used during the shipping process.  A shipReference can be a purchase order number, customer number, company name, Bill of Lading number, or a phrase that identifies that shipment.

STRING ARRAY of 2

VARCHAR(64)

FALSE

packingListRequired

Packing list required

BOOLEAN

BOOLEAN

TRUE

blindShip

Require blind shipping

BOOLEAN

BOOLEAN

TRUE

allowConsolidation

Allow consolidation of shipments

BOOLEAN

BOOLEAN

TRUE

FreightDetails

The details on the freight: carrier and service

OBJECT

OBJECT

TRUE

comments

Comments regarding the shipment for further clarification.  Note: Use comments only when absolutely necessary, as it may cause delays in order processing.

STRING

VARCHAR(MAX)

FALSE

 

FreightDetails

Field

Description

WSDL Data Type

SQL Data Type

Required?

carrier

The carrier name of the shipping vendor being requested.  (i.e. “UPS”, “FEDEX”, etc.)

STRING

VARCHAR(64)

TRUE

service

The service code of the shipping vendor for the service being requested.  i.e. GROUND, 2DAY, NEXTDAY, etc.

STRING

VARCHAR(64)

TRUE

 

ShipTo

Field

Description

WSDL Data Type

SQL Data Type

Required?

shipmentId

The shipment id that can be referenced in the ShipmentLink object.

INT

INT

TRUE

ContactDetails

The object containing the third party contact details

OBJECT

OBJECT

TRUE

 

ThirdPartyAccount

Field

Description

WSDL Data Type

SQL Data Type

Required?

accountName

The name of the account that will be used for shipping.

STRING

VARCHAR(64)

TRUE

accountNumber

The number of the account that will be used for shipping.

STRING

VARCHAR(64)

TRUE

ContactDetails

The object containing the third party contact details

OBJECT

OBJECT

TRUE

 


 

Contact

contactType

The type of contact.  Values are enumerated: {“Art”, “Bill”, “Expeditor”, “Order”, “Sales”, “Ship”, “Sold”}

ENUMERATED STRING

VARCHAR(64)

TRUE

ContactDetails

The object that contains the details about the contact.

OBJECT

OBJECT

TRUE

accountName

The name of the account that will be invoiced for the purchase order.  This should be populated when the contactType is Bill.

STRING

VARCHAR(64)

FALSE

accountNumber

The number of the account that will be invoiced for the purchase order.  This should be populated when the contactType is Bill.

STRING

VARCHAR(64)

FALSE

 

ContactDetails

attentionTo

Attention To (first and last name of contact)

STRING

VARCHAR(35)

FALSE

companyName

Company Name

STRING

VARCHAR(35)

FALSE

address1

Address line 1

STRING

VARCHAR(35)

FALSE

address2

Address line 2

STRING

VARCHAR(35)

FALSE

address3

Address line 3

STRING

VARCHAR(35)

FALSE

city

The city

STRING

VARCHAR(30)

FALSE

region

The 2 character US state abbreviation or 2-3 character non-US region.

STRING

VARCHAR(3)

FALSE

postalCode

The postal code

STRING

VARCHAR(10)

FALSE

country

The country in ISO 3166-2 format

STRING

VARCHAR(2)

FALSE

email

The Email

STRING

VARCHAR(128)

FALSE

phone

The phone number

STRING

VARCHAR(32)

FALSE

comments

Comments regarding the contact for further clarification.  Note: Use comments only when absolutely necessary, as it may cause delays in order processing.

STRING

VARCHAR(MAX)

FALSE

 

Response: SendPOResponse

Field

Description

WSDL Data Type

SQL Data Type

Required?

transactionId

The transaction identifier in response indicating a successful transfer of a schematically valid PO payload.  It can also be used for IT departments to help with diagnostics and technical support.  This transaction identifier does not indicate that the PO was successfully entered and inventory was allocated.  The use of the Order Status service can provide the status of the order going forward.  If no transaction identifier is returned, a populated ErrorMessage object must be returned indicating the fault (Error severity is a failure).  A populated ErrorMessage object returned with a transaction identifier indicates the PO was successfully transferred but initial validation detected problems preventing it from being processed without human intervention (Error severity is a warning).  Based on the agreement with the supplier, either correct these issues and resubmit a revised PO or wait for contact from a supplier representative. 

INT

INT

FALSE

ServiceMessageArray

An array of ServiceMessage objects.

OBJECT

OBJECT

FALSE

 

Appendix A: Service Messages

ServiceMessage

Field

Description

WSDL Data Type

SQL Data Type

Required?

code

The numerical value of the code

INT

INT

TRUE

description

Response for any message requiring notification to requestor

STRING

VARCHAR(256)

TRUE

severity

The severity of the message.  Values are enumerated: {Error, Information, Warning}

ENUMERATED STRING

VARCHAR(64)

TRUE

 

Standardized Codes:  The range of 100-199 has been reserved for standardized error codes.  The number 999 has been reserved for an error codes that is a “General Error - Contact System Service Provider”

Code

Description

100

ID (customerID) not found

104

This account is unauthorized to use this service.  Please contact the service provider

105

Authentication Credentials failed

110

Authentication Credentials required

115

wsVersion not found

120

The following field(s) are required [Comma Delimited field names]

125

Not Supported: [details]

999

General Error – Contact the System Service Provider Details: [Details]

Service Specific Code: These error codes are only for this service.

Code

Description

200

Duplicated transaction detected.  PO was not submitted.

210

Data violation: {0} 

 

(Occurs when a supplier does a pre-check on the data and finds that there is a mismatch of data and/or there are incorrect calculations)

220

Field is not supported: {0}

230

Field is partially supported: {0}

 

(Use in situations where a supplier cannot accommodate different line level in-hands dates, fobs, etc.  The responder will explain in the message what the course of action will be.) 

240

The following is not supported by the Simple order type: {0}

250

The PO is received but there may be a delay in processing. 

 

Promotional Products Data Interface Specification for Web services

 

 

 

Inventory 2.0

 

 

Version:                2.0.0

Date:                                2017-17-03

Document Change Log

Version

Date

Reason for Change

Author

2.0.0RC1

11/03/2017

Initial Draft

Raj Mukherjee, Integration Team Lead, Hit Promotional Products Inc

 

Eric Shonebarger, CIO, Hit Promotional Products Inc

 

2.0.0RC2

11/17/2017

·         Renamed GetFilterValuesReply to GetFilterValuesReponse

·         Renamed InventoryRequest to GetInventoryLevelsRequest

·         Renamed InventoryReply to GetInventoryLevelsResponse

·         Changed id in GetInventoryLevelsRequest to be required

·         Changed password in GetInventoryLevelsRequest to be optional

·         All token types have been changed to strings.  We used tokens very early on and then switched to strings.

·         Added ErrorMessageArray to match PO spec.  Updated ErrorMessage object to include severity element.

·         Simplified filtering in both GetInventoryLevelsRequest and GetyFilterValuesResponse to use an object called "Filter".

·         futureAvailableInventoryQuantity and futureAvailableInventoryTimeStamp changed to required. The FutureAvailabilityArray is optional, so when specifying an element in the array, it must have this info.

·         Changed address1,address2,address3 and address4 to string array and renamed to addressLines to match the PO spec.

·         Updated default endpoint location to "[Endpoint URL]"

·         Renamed partSize to labelSize to match ProductData spec.

·         Renamed colorName to partColor to match ProductData spec.

·         Renamed filterSize to labelSizeEnum to match ProductData spec.

·         Renamed futureAvailableInventoryTimeStamp to arrivalDate

·         Changed quantityAvailable to use Quantity object

·         Changed onOrderQuantity to use Quantity object

·         Changed futureAvailableInventoryQuantity to use Quantity object

·         Changed warehouseName to be optional

·         Changed Address object to be optional

 

Paul Fleischman, Technical Lead, PCNA

2.0.0RC2

11/20/2017

·         Renamed Warehouse object to InventoryLocation

·         Renamed warehouseName to inventoryLocationName

·         Renamed warehouseQuantity to inventoryLocationQuantity

·         Renamed warehouseId to inventoryLocationId

Paul Fleischman, Technical Lead, PCNA

2.0.0RC3

12/7/2017

·         Renamed ErrorMessage to ServiceMessage

Paul Fleischman, Technical Lead, PCNA

2.0.0RC4

02/26/2018

Changes made based on February meeting:

·         Removed partId element from GetFilterValuesRequest

·         Created a partIdArray within the Filter object

·         Changed the FilterArray to not be an array within GetFilterValuesResponse. A single instance is all that is needed because of the new partIdArray within the Filter object.

Paul Fleischman, Technical Lead, PCNA

2.0.0RC4

05/10/2018

·         On the SharedObjectsInventory.xsd:

o   added mentioned partIdArray definition

o   Removed FilterValues definition

o   Replaced the partId with a partIdArray on the Filter definition.

 

Raj Mukherjee, Integration Team Lead, Hit Promotional Products Inc

 

Tim Dietrich, NetSuite Integrator / PromoStandards Implementer

2.0.0

07/24/2018

·         On the SharedObjectsInventory.xsd:

o   added replenishmentLeadTime

o   Removed SelectionArray definition from Filter object

 

Raj Mukherjee, Integration Team Lead, Hit Promotional Products Inc

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Contributors

The following have contributed to the creation of this specification:

Contributors:     Raj Mukherjee, Integration Team Lead Hit Promotional Products, Inc

                                Paul Fleischman, Technical Lead, PCNA

                                Eric Shonebarger, CIO Hit Promotional Products, Inc

                                Jon Norris, VP of Operations, 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 to build the interface. Additionally, this document will provide sample code 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 standard based on a secure form of communication.

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

 

 

 

 

 

 

 

Service Details

 

Function: getFilterValues ()

Gets the different variations on a product, broken out by size, colour, selection

Request: GetFilterValuesRequest

Field

Description

WSDL Data Type

SQL Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced. Values are enumerated {2.0.0}

STRING

VARCHAR(64)

TRUE

id

The customerId or any other agreed upon Id.

STRING

VARCHAR(64)

TRUE

password

The password associated with the customerId.

STRING

VARCHAR(64)

FALSE

productId

The Product Id

STRING

VARCHAR(64)

TRUE

 

 

 

Reply: GetFilterValuesRequestResponse

Field

Description

WSDL Data Type

SQL Data Type

Required?

FilterValues

An object containing the variations of a product by size, color, selection, etc

OBJECT

OBJECT

FALSE

ServiceMessageArray

Error message object Array

OBJECT ARRAY

OBJECT ARRAY

FALSE

 

 

 

 

FilterValues

Field

Description

WSDL Data Type

SQL Data Type

Required?

productId

The product id

VARCHAR(64)

VARCHAR(64)

TRUE

Filter

A Filter Object that contains the variations of a product by part, size, and/or color.

OBJECT

OBJECT

FALSE

 

Function: getInventoryLevels ()

Gets the different inventory levels for the product broken out by product and inventory location

It also gives you future stock on the product

Request: getInventoryLevelsRequest

Field

Description

WSDL Data Type

SQL Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced. Values are enumerated {2.0.0}

STRING

VARCHAR(64)

TRUE

id

The customer Id or any other agreed upon Id.

STRING

VARCHAR(64)

TRUE

password

The password associated with the Id.

STRING

VARCHAR(64)

FALSE

productId

The Product Id

STRING

VARCHAR(64)

TRUE

Filter

Filter the response of getInventoryLevels by using a portion of the filter information received in the response of GetFilterValuesRequest.

OBJECT

OBJECT

FALSE

 

 

 

 

Reply: getInventoryLevelsResponse

Field

Description

WSDL Data Type

SQL Data Type

Required?

Inventory

An object containing inventory by part and inventory location. Also shows future inventory by part and inventory location.

OBJECT

OBJECT

FALSE

ServiceMessage

Service message object

OBJECT

OBJECT

FALSE

 

Inventory

Field

Description

WSDL Data Type

SQL Data Type

Required?

productId

The product id

VARCHAR(64)

VARCHAR(64)

TRUE

PartInventoryArray

An array of ProductVariation objects

OBJECT ARRAY

OBJECT ARRAY

FALSE

 

PartInventory

Field

Description

WSDL Data Type

SQL Data Type

Required?

partId

The part id

VARCHAR(64)

VARCHAR(64)

TRUE

mainPart

A boolean value indicating if this is a main part of the product. In a tumbler with an optional lid configuration, the parts associated with the tumbler would be set to TRUE. The parts associated with the Lid would be set to false.

BOOLEAN

BOOLEAN

TRUE

partColor

Description of the color of the part

VARCHAR(64)

VARCHAR(64)

FALSE

labelSize

The apparel items tagged size.  Enumerated values:

{6XS,5XS,4XS,3XS,2XS,XS,S,M,L,XL,2XL,3XL,4XL,5XL,6XL,CUSTOM}

CUSTOM is used for any size that does not match one of the other sizes. For example 7XL and 8XL would return CUSTOM. To identify the actual size when CUSTOM is returned, reference the Product Data endpoint.

ENUMERATED STRING

VARCHAR(6)

FALSE

partDescription

Description of the part

VARCHAR(256)

VARCHAR(256)

FALSE

quantityAvailable

A quantity object containing the sum of inventory of all inventory locations of the part

QUANTITY OBJECT

QUANTITY OBJECT

FALSE

manufacturedItem

Indicates that the supplier produces this part according to demand. The supplier may keep a limited amount of inventory or inventory may be 0.

BOOLEAN

BOOLEAN

TRUE

buyToOrder

Indicates that the supplier purchases this product to order. The supplier may keep a limited amount of inventory, show available inventory to buy, or it might be 0.

BOOLEAN

BOOLEAN

TRUE

replenishmentLeadTime

 

Time to replenish buy to order or made to order

 

INT(3)

INT(3)

FALSE

attributeSelection

A string describing the attribute of the product other than size and color

VARCHAR(64)

VARCHAR(64)

FALSE

InventoryLocationArray

An array of InventoryLocation objects

ARRAY

ARRAY

FALSE

lastModified

A date timestamp in UTC specifying the last time inventory was modified.

DATETIME

DATETIME

FALSE

 

InventoryLocation

Field

Description

WSDL Data Type

SQL Data Type

Required?

inventoryLocationId

The inventory location id

VARCHAR(64)

VARCHAR(64)

TRUE

inventoryLocationName

The name of the inventory location

VARCHAR(64)

VARCHAR(64)

FALSE

postalCode

The postal code

STRING

VARCHAR(10)

TRUE

country

The country in ISO 3166-2 format

STRING

VARCHAR(2)

TRUE

inventoryLocationQuantity

An object which contains available to order quantity for this inventory location

QUANTITY OBJECT

QUANTITY OBJECT

FALSE

FutureAvailabilityArray

Array of FutureAvailability objects

OBJECT ARRAY

OBJECT ARRAY

FALSE

 

 

FutureAvailability

Field

Description

WSDL Data Type

SQL Data Type

Required?

Quantity

Future net available inventory quantity for the part/inventory location combination indicating goods on order or future quantity at manufactured goods. 

QUANTITY OBJECT

QUANTITY OBJECT

TRUE

availableOn

A date timestamp in UTC specifying the valid timestamp depicting when the inventory will be available for allocation to sales orders.

DATETIME

DATETIME

TRUE

 

Filter

Field

Description

WSDL Data Type

SQL Data Type

Required?

partIdArray

A list of part ids to be used when filtering

STRING ARRAY

VARHCAR(64)

FALSE

LabelSizeArray

An array of labelSize object

STRING ARRAY

VARCHAR(64)

FALSE

PartColorArray

A list of colors to be used when filtering

STRING ARRAY

VARCHAR(64)

FALSE

 

Quantity

value

The quantity value

DECIMAL

DECIMAL(12,4)

TRUE

uom

The unit of measure; values are enumerated.

Values are: {BX, CA, DZ, EA, KT, PR, PK, RL, ST, SL, TH}

BX - Box

CA - Case

DZ - Dozen

EA - Each

KT - Kit

PR - Pair

PK - Package

RL - Roll

ST - Set

SL - Sleeve

TH – Thousand

 

ENUMERATED STRING

VARCHAR(2)

TRUE

 

 

Appendix A: Error Messages

ServiceMessage

Field

Description

WSDL Data Type

SQL Data Type

Required?

code

The numerical value of the code

INT

INT

TRUE

description

Response for any message requiring notification to requestor

STRING

VARCHAR(256)

TRUE

severity

The severity of the message.  Values are enumerated: {Error, Information, Warning}

ENUMERATED STRING

VARCHAR(64)

TRUE

 

Standardized Codes:  The range of 100-199 has been reserved for standardized error codes.  The number 999 has been reserved for an error codes that is a “General Error - Contact System Service Provider”

Code

Description

100

ID (customerID) not found

104

This account is unauthorized to use this service.  Please contact the service provider

105

Authentication Credentials failed

110

Authentication Credentials required

115

wsVersion not found

120

The following field(s) are required [Comma Delimited field names]

125

Not Supported: [details]

999

General Error – Contact the System Service Provider Details: [Details]

 

 

Service Specific Code: These error codes are only for this service.

Code

Description

600

Product Id not found

610

Data violation: {0} 

 

(Occurs when a supplier does a pre-check on the data and finds that there is a mismatch of data and/or there are incorrect calculations)

620

Field is not supported: {0}

630

Part Id not found

 

Promotional Products Data Interface Specification for Web services

 

 

 

Purchase Order

****NOTE****

This is an old version, please use 1.0.0

*************

 

 

Version: 0.0.7

Date: 2017-08-22

Document Change Log

Version

Date

Reason for Change

Author

0.0.0

3/15/2017

Initial Draft

Eric Shonebarger, CIO, Hit Promotional Products Inc

0.0.1

3/27/2017

Revisions during WSDL creation

Paul Fleischman, Technical Lead, PCNA

0.0.3

5/31/2017

Revisions during alpha testing

Paul Fleischman, Technical Lead, PCNA

0.0.4

6/7/2017

Revisions during alpha testing

Paul Fleischman, Technical Lead, PCNA

0.0.5

6/27/2017

Revisions during alpha testing

Paul Fleischman, Technical Lead, PCNA

0.0.6

7/26/2017

Revisions during alpha testing

Paul Fleischman, Technical Lead, PCNA

0.0.7

8/21/2017

Revisions during beta testing

Paul Fleischman, Technical Lead, PCNA

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Contributors

The following have contributed to the creation of this specification:

Contributors:    Eric Shonebarger, CIO Hit Promotional Products, Inc

                            Jon Norris, VP of Operations Starline

                            Paul Fleischman, Technical Lead PCNA

                           

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/

 

 

 

 

 

 

 

Service Details

 

Function: getSupportedPODataTypes()

Request: getSupportedPODataTypesRequest

Field

Description

WSDL Data Type

SQL Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced. Values are enumerated {1.0.0}

STRING

VARCHAR(64)

TRUE

id

The customerId or any other agreed upon Id.

STRING

VARCHAR(64)

TRUE

password

The password associated with the customerId.

STRING

VARCHAR(64)

FALSE

 

Reply: getSupportedPODataTypesReply

Field

Description

WSDL Data Type

SQL Data Type

Required?

SupportedDataTypes

An array of supported purchase order data types for this supplier

ARRAY

ARRAY

TRUE

SupportedDataTypes[]

Field

Description

WSDL Data Type

SQL Data Type

Required?

supportedDataTypes

Signifies which purchase order datatypes the supplier supports. Values are enumerated: “Blank”, “Sample”, “Simple” “Configured”

ENUMERATED STRING

VARCHAR(32)

TRUE

 

 

 

 

Function: sendPO()

This function will send a configured purchase order to a vendor. The purchase order is designed to work in conjunction with data from the Promostandards Product Pricing and Configuration web service. More information on Product Pricing and Configuration can be found at  http://promostandards.org

 

Request: sendPORequest

Field

Description

WSDL Data Type

SQL Data Type

Required?

wsVersion

The Standard Version of the Web Service being referenced. Values are enumerated {1.0.0}

STRING

VARCHAR(64)

TRUE

id

The customer Id or any other agreed upon Id.

STRING

VARCHAR(64)

TRUE

password

The password associated with the customer Id.

STRING

VARCHAR(64)

FALSE

PO

The object containing the Purchase Order

OBJECT

OBJECT

TRUE

 

PO

Field

Description

WSDL Data Type

SQL Data Type

Required?

orderType

The type of data transferred in the request; values are enumerated:

“Blank”—This is data is for blank goods.

“Sample”—This data is for a random sample order

“Simple”—The data in the purchase order is sent over without supplier configured data and will be processed manually.

“Configured”—The data is sent over in conjunction with the supplier’s Product Pricing and Configuration web service and designed for electronic processing of the purchase order.

ENUMERATED STRING

VARCHAR(64)

TRUE

orderNumber

Purchase order number

STRING

VARCHAR(64)

TRUE

orderDate

The date and time of the purchase order.

DATE

DATE

TRUE

lastModified

The date and time the purchase order was last modified

DATE

DATE

FALSE

orderVersion

The version of the purchase order

STRING

VARCHAR(64)

TRUE

totalAmount

The total dollar amount of the purchase order

DOUBLE

DECIMAL(12,4)

TRUE

paymentTerms

The terms of the purchase order.  i.e. NET15, NET30, etc.

STRING

STRING

FALSE

rush

Used to indicate a rush on the purchase order.  Use the number of production days to signify the rush.  Example: 1-day rush, place a “1” in the field.

INT

INT

FALSE

currency

The currency the purchase order is transacted in ISO4217 format.

STRING

VARCHAR(64)

TRUE

DigitalProof

An object containing preproduction digital proof information

OBJECT

OBJECT

FALSE

OrderContactArray

An array of contact information in regards to this order.

ARRAY

ARRAY

FALSE

ShipmentArray

Any array of purchase order shipment objects

ARRAY

ARRAY

TRUE

LineItemArray

An array of line items of the purchase order

ARRAY

ARRAY

TRUE

termsAndConditions

The terms and conditions for this purchase order.  Information that is order specific or information dealing with the configuration or shipment of the order should not be entered here.

STRING

VARCHAR(MAX)

TRUE

salesChannel

The sales channel

STRING

VARCHAR(64)

FALSE

promoCode

The promotion code

STRING

VARCHAR(64)

FALSE

discountMethod

The discount method

STRING

VARCHAR(64)

FALSE

discountType

The discount type

STRING

VARCHAR(64)

FALSE

TaxInformationArray

An array of TaxInformation objects related to calculating taxes

ARRAY

ARRAY

FALSE

 

DigitalProof

Field

Description

WSDL Data Type

SQL Data Type

Required?

required

A Boolean value set to TRUE indicates a proof is required for this purchase order; the value is FALSE otherwise.

BOOLEAN

BOOLEAN

TRUE

DigitalProofAddressesArray

An array containing DigitalProofAddress objects.

ARRAY

ARRAY

TRUE

 

DigitalProofAddress

Field

Description

WSDL Data Type

SQL Data Type

Required?

type

The type of address of the digital proof.  Values are enumerated: Email, Webservice

STRING

VARCHAR(64)

TRUE

email

The address that the digital proof should be sent to prior to production.

STRING

VARCHAR(128)

TRUE

lineItemGroupingId

What line item group does this proof address link to

INT

INT

TRUE

 

TaxInformation

Field

Description

WSDL Data Type

SQL Data Type

Required?

taxId

The purchasers tax identifier

STRING

VARCHAR(64)

TRUE

taxType

The type of tax the identifier applies to. Values are enumerated: “Hst-Gst”, “Pst”, “SalesTax”

ENUMERATED STRING

VARCHAR(64)

TRUE

taxExempt

Tax Except

BOOLEAN

BOOLEAN

TRUE

taxJurisdiction

Tax Jurisdictions

UNBOUNDED STRING ARRAY

VARCHAR(64)

TRUE

 

LineItem

Field

Description

WSDL Data Type

SQL Data Type

Required?

lineNumber

The line number of the line item

STRING

VARCHAR(64)

TRUE

description

The description of the line item.  For simple order type (not using a configuration), use this field to explain the details.

STRING

VARCHAR(MAX)

TRUE

lineType

The type of order; values are enumerated:

·   “New” –A new purchase order with no prior order reference

·   “Repeat” —An exact repeat of a previous purchase order with the vendor

·   “Reference” –An order that has the same artwork as a previous order.

ENUMERATED STRING

VARCHAR(64)

TRUE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

TRUE

fobId

Used to indicate the FOB point.  Use fobId from the supplier’s Product Pricing and Configuration Service to populate this information.

STRING

VARCHAR(64)

FALSE

ToleranceDetails

The object containing how tolerant this line is to overrun and underruns.

OBJECT

OBJECT

TRUE

allowPartialShipments

Allow partial shipments of this line item

BOOLEAN

BOOLEAN

TRUE

unitPrice

The unit price of the line item

DOUBLE

DECIMAL(12,4)

TRUE

extendedPrice

The total price of the line item (unit price * quantity)

DOUBLE

DECIMAL(12,4)

TRUE

requestedShipDate

The date the line item is requested to ship from the FOB point.

DATE

DATE

FALSE

requestedInHands

The date the line item is requested to arrive at the shipping destination

DATE

DATE

FALSE

referenceSalesQuote

The sales quote number associated with this purchase order line (if applicable).

VARCHAR(64)

VARCHAR(64)

FALSE

Program

Program pricing information.

OBJECT

OBJECT

FALSE

endCustomerSalesOrder

The distributor’s order number provided to the end customer

VARCHAR(64)

VARCHAR(64)

FALSE

productId

The manufacturer’s product id associated with the configuration data.

STRING

VARCHAR(64)

FALSE

customerProductId

The distributor’s product id

STRING

VARCHAR(64)

FALSE

lineItemGroupingId

An identifier that allows configuration data to be spread out among multiple purchase order lines.  Keep lineItemGroupingID unique when referencing the same product on the purchase order.  Any change to the product, location, decoration, or artwork should produce a unique lineItemGroupingID to the purchase order.

STRING

VARCHAR(64)

FALSE

PartArray

An array of product part information.  This array should be populated with information from the supplier’s PromoStandards Product Pricing and Configuration service

ARRAY

ARRAY

FALSE

Configuration

An object containing line item configuration data

OBJECT

OBJECT

FALSE

           

 

ToleranceDetails

tolerance

An enumerator specifying the quantity tolerance allowed:  AllowOverRun, AllowUnderrun, ExactOnly.  Specifying AllowOverRun or AllowUnderrun without a value and uom will result in the supplier’s discretion. 

ENUMERATED STRING

VARCHAR(64)

TRUE

value

The overrun/underrun permitted.  This element is ignored if ExactOnly is specified for tolerance.

DECIMAL

DECIMAL(12,4)

FALSE

uom

The unit of measure for value element; enumerated values are: {Percent, Quantity}.  This element is ignored if ExactOnly is specified for tolerance.

 

ENUMERATED STRING

VARCHAR(10)

FALSE

 

Program

id

The program id associated with this purchase order line (if applicable).

VARCHAR(64)

VARCHAR(64)

FALSE

name

The program name associated with this purchase order line (if applicable).

VARCHAR(64)

VARCHAR(64)

FALSE

 

Quantity

value

The quantity value

DECIMAL

DECIMAL(12,4)

TRUE

uom

The unit of measure; values are enumerated.

Values are: {BX, CA, DZ, EA, KT, PR, PK, RL, ST, SL, TH}

BX - Box

CA - Case

DZ - Dozen

EA - Each

KT - Kit

PR - Pair

PK - Package

RL - Roll

ST - Set

SL - Sleeve

TH - Thousand

 

ENUMERATED STRING

VARCHAR(2)

TRUE

 

Configuration

Field

Description

WSDL Data Type

SQL Data Type

Required?

referenceNumber

The previous order number that this purchase order is referencing

STRING

VARCHAR(64)

FALSE

referenceNumberType

The type of the prior order reference; values are enumerated: “PurchaseOrder”,”SalesOrder”, “JobOrWorkOrder”

ENUMERATED STRING

VARCHAR(64)

FALSE

preProductionProof

Indicates that this line item is for a pre-production proof

BOOLEAN

BOOLEAN

TRUE

ChargeArray

An array of charge information.  This array should be populated with information from the supplier’s PromoStandards Product Pricing and Configuration service

ARRAY

ARRAY

FALSE

LocationArray

An array of Decoration Location Information.  This array should be populated with information from the supplier’s PromoStandards Product Pricing and Configuration service

ARRAY

ARRAY

TRUE

 

Part

Field

Description

WSDL Data Type

SQL Data Type

Required?

partGroup

 

STRING

VARCHAR(64)

TRUE

partId

The part Id from the supplier’s PromoStandards Product Pricing and Configuration service

STRING

VARCHAR(64)

TRUE

customerPartId

 

STRING

VARCHAR(64)

FALSE

description

The description from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(4000)

FALSE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

TRUE

locationLinkId

An array of location link Ids.  This links the part to its configured locations.

ARRAY OF INTEGERS

INT[]

FALSE

unitPrice

The price of the part being referenced.

DECIMAL

DECIMAL(12,4)

FALSE

extendedPrice

The unitPrice multiplied by the Quantity value.

DECIMAL

DECIMAL(12,4)

FALSE

ShipmentLinkArray

Link this part and a specified quantity to one or many shipments.

OBJECT

OBJECT

FALSE

 

ShipmentLink   

Field

Description

WSDL Data Type

SQL Data Type

Required?

shipmentId

The shipment Id

STRING

VARCHAR(64)

TRUE

Quantity

The quantity object that contains the value and unit of measure

OBJECT

OBJECT

TRUE

 

Charge

Field

Description

WSDL Data Type

SQL Data Type

Required?

chargeId

The chargeId from the supplier’s PromoStandards Product Pricing and Configuration service

STRING

VARCHAR(64)

TRUE

chargeName

The chargeName from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(128)

FALSE

description

The charge description from the supplier’s PromoStandards Product Pricing and Configuration service.

STRING

VARCHAR(4000)

FALSE

chargeType

The type of charge.  Values are enumerated {Order, Run, Setup}.

ENUMERATED STRING

VARCHAR(64)

TRUE

Quantity

The quantity object that contains the value and unit of measure