Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Tip

On this page:

Table of Contents
maxLevel1

Introduction

The Special Bid Order special bid is used when a Manufacturer provides a Special Bid (i.e. Special Bid Price for certain products under (Special Terms and Conditions) for Specific End-User(s). A Special Bid Order special bid is used in the IT Business vertical markets. Manufacturers/Vendors like i.e. HP have special agreements (contracts) with Specific End-Users (i.e. ‘Shell’). The Manufacturer/Vendor makes use of their Channel (i.e. Distributors and Resellers) for the delivery of the Special Bid products. This is because the Manufacturer/Vendor is using the regular stock products which are in stock at the Distributor.

Process

Special Bid Orders Bids allow Specific End-User to buy products at a different price instead of the regular price. The Distributor will support the lower price for all goods delivered for the Specific End-User by claiming the difference from the Manufacturer/Vendor. The delivery to the End-User is done by a Reseller. Subsequently, the Reseller needs to report in the Purchase Order to the Distributor that the order is for a Specific specific End-User. By adding End-User contract number information in the Purchase Order, the Distributor knows that they can give price support to the Reseller and they can claim the difference from the Manufacturer by validating the contract information.

Onetrail receives the Special Bid Data on a daily basis from the distributors in different formats. The Special Bid Data is normalized to a standard data format and delivered to the buyers via one of the supported communication protocols, like FTP, AS2 or HTTP.

Content

GLN's (Global Location Number's) are used to identify the Manufacturer/Vendor and Seller in this situation.

Format

The Special Bid Prices are used in OT format Order messages. The format of the standard Onetrail XML messages is XML version 1.0Data can be retrieved in either XML or CSV format.

Syntax

When compiling a The Special Bid Order, use Data complies with the below field definitions to ensure all mandatory fields are filled and filled with the correct type.

Field Definitions

ParentField NameDescriptionTypeCardinalityXML Element / AttributeXML Properties
Special Bid / headerManufacturer GLNManufacturer GLN of the bidString1SpecialBid/partnerIdAttribute: GTINStringType
Special Bid / headerBid IDID of the bid (provided by Manufacturer)String1SpecialBid/bidIDAttribute: string
Special Bid / headerBid VersionVersion of the bid (provided by Manufacturer)String0..1SpecialBid/bidVersionAttribute: string
Special Bid / headerOrder Date FromValid FromDate0..1 SpecialBid/orderFromDate/dateStampDateTimeStamp([0-9]{8}
Special Bid / headerOrder Date ToValid ToDate1SpecialBid/orderToDate/dateStampDateTimeStamp([0-9]{8} 
Special Bid / headerEnd CustomerDescription of End Customer (E.G. Acme Corp)String1SpecialBid/endCustomerAttribute: string
Special Bid / headerResellerAvailable resellers on BIDGLN1..xSpecialBid/resellers/partnerIdAttribute: string
Special Bid / headerDistributorsAvailable distributors on BIDGLN1..xSpecialBid/distributors/partnerIdAttribute: string
Special Bid / headerTermsCodes for different term of validity.
(E.G only when everything on bid is ordered)
String0..1SpecialBid/termsAttribute: string
Special Bid / headerTextInfo free textString0..1SpecialBid/freeFormTextAttribute: string







Special Bid / productMin Order QTYMinimum Order QuantityNumeric0..1SpecialBid/product/minOrder/quantityAttribute: nonNegativeInteger
Special Bid / productMax Order QTYMaximum Order QuantityNumeric0..1SpecialBid/product/maxOrder/quanityAttribute: nonNegativeInteger
Special Bid / productRemaining Order QTYRemaining Order QuantityNumeric0..1SpecialBid/product/remainder/quantityAttribute: nonNegativeInteger
Special Bid / productManufacturer Part NumberProduct ID from ManufacturerString1SpecialBid/product/productIdentifiers/productIdentifierAttribute: string
Special Bid / productSKUInternal Product ID from DistributorString0..1SpecialBid/product/productIdentifiers/productIdentifierAttribute: string
Special Bid / productLocalisation CodeCountry Specific CodeString0..1SpecialBid/product/productIdentifier/localisationCodeAttribute: string
Special Bid / productSpecial Bid PriceAmount for each item provided by ManufacturerAmount1SpecialBid/product/priceInfo/priceAttribute: decimal
Special Bid / productCurrencyCurrencyString1SpecialBid/product/priceInfo/currencyAttribute: string
Special Bid / productDescriptionProduct DescriptionString0..1SpecialBid/product/textualProductDescriptionAttribute: string