Introduction
The 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 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 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 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 Data can be retrieved in either XML or CSV format.
Syntax
The Special Bid Data complies with the below field definitionsWhen compiling a Special Bid Order, use the below field definitions to ensure all mandatory fields are filled and filled with the correct type.
Field Definitions
Parent | Field Name | Description | Type | Cardinality | XML Element / Attribute | XML Properties |
---|
Conclusion | Date | Creation date of the Special Bid | Date | 1Special Bid / header | SpecialBid/dateStamp | DateTimeStamp([0-9]{8} | Remove Field | Manufacturer GLN | Manufacturer GLN of the bid | String |
0..1 | SpecialBid/partnerId | Attribute: GTINStringType |
Mandatory, Use code conversions to GLN |
Special Bid / header | Bid ID | ID of the bid (provided by Manufacturer) | String | 1 | SpecialBid/bidID | Attribute: string |
Mandatory | Special Bid / header | Bid Version | Version of the bid (provided by Manufacturer) | String | 0..1 | SpecialBid/bidVersion | Attribute: string |
Optional, Might be requested if vendor's connect directly | Special Bid / header | Order Date From | Valid From | Date | 0..1 | SpecialBid/orderFromDate/dateStamp | DateTimeStamp([0-9]{8} |
Optional |
Special Bid / header | Order Date To | Valid To | Date | 1 | SpecialBid/orderToDate/dateStamp | DateTimeStamp([0-9]{8} |
MandatoryShip Date FromSpecial Bid / header | Ship Date To | Shipping to date | Date | 1 | SpecialBid/shipToDate/dateStamp | DateTimeStamp([0-9]{8} | Remove Field |
Special Bid / header | Shipping from date | Date | 1 | SpecialBid/shipFromDate/dateStamp | DateTimeStamp([0-9]{8} | Remove Field | End Customer | Description of End Customer (E.G. Acme Corp) | String | 1 | SpecialBid/endCustomer | Attribute: string |
Mandatory, check EET, is this Special Deal? |
Special Bid / header | Reseller | Available resellers on BID | GLN | 1..x | SpecialBid/resellers/partnerId | Attribute: string |
Mandatory, with Buyer GLN | Special Bid / header | Distributors | Available distributors on BID | GLN | 1..x | SpecialBid/distributors/partnerId |
Attribute: string | Mandatory, with distributor GLN as fixed value | Special Bid / header | Bid Currency | Currency | String | 1 | SpecialBid/currencyRemove Field, use line level |
Special Bid / header | Terms | Codes for different term of validity. (E.G only when everything on bid is ordered) | String | 0..1 | SpecialBid/terms | Attribute: string |
Optional |
Special Bid / header | Text | Info free text | String | 0..1 | SpecialBid/freeFormText | Attribute: string |
Optional |
|
|
|
|
|
|
|
Special Bid / product | Min Order QTY | Minimum Order Quantity | Numeric | 0..1 | SpecialBid/product/minOrder/quantity | Attribute: nonNegativeInteger |
Optional |
Special Bid / product | Max Order QTY | Maximum Order Quantity | Numeric | 0..1 | SpecialBid/product/maxOrder/quanity | Attribute: nonNegativeInteger |
Optional | Special Bid / product | Remaining Order QTY | Remaining Order Quantity | Numeric | 0..1 | SpecialBid/product/remainder/quantity | Attribute: nonNegativeInteger |
Optional, might be required if vendors are connected directly | Special Bid / product | Manufacturer Part Number | Product ID from Manufacturer | String |
0..1 | SpecialBid/product/productIdentifiers/productIdentifier | Attribute: string |
Mandatory |
Special Bid / product | SKU | Internal Product ID from Distributor | String | 0..1 | SpecialBid/product/productIdentifiers/productIdentifier | Attribute: string |
Optional, unless necessary |
Special Bid / product | Localisation Code | Country Specific Code | String | 0..1 | SpecialBid/product/productIdentifier/localisationCode | Attribute: string |
Optional, Required if bid is country specific | Special Bid / product | Special Bid Price | Amount for each item provided by Manufacturer | Amount |
0..1 | SpecialBid/product/priceInfo/price | Attribute: decimal |
Mandatory | Special Bid / product | Currency | Currency | String |
0..1 | SpecialBid/product/priceInfo/currency | Attribute: string |
Mandatory | Special Bid / product | Description | Product Description | String | 0..1 | SpecialBid/product/textualProductDescription | Attribute: string |
Optional