On this page:
Introduction
The Special Bid Order 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 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 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.
Content
GLN's (Global Location Number's) are used to identify the Manufacturer/Vendor and Seller in this situation.
Format
Special Bid Prices are used in OT format Order messages. The format of the standard Onetrail XML messages is XML version 1.0.
Syntax
When 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 |
---|---|---|---|---|---|---|
Special Bid / header | Manufacturer GLN | Manufacturer GLN of the bid | String | 1 | SpecialBid/partnerId | Attribute: GTINStringType |
Special Bid / header | Bid ID | ID of the bid (provided by Manufacturer) | String | 1 | SpecialBid/bidID | Attribute: string |
Special Bid / header | Bid Version | Version of the bid (provided by Manufacturer) | String | 0..1 | SpecialBid/bidVersion | Attribute: string |
Special Bid / header | Order Date From | Valid From | Date | 0..1 | SpecialBid/orderFromDate/dateStamp | DateTimeStamp([0-9]{8} |
Special Bid / header | Order Date To | Valid To | Date | 1 | SpecialBid/orderToDate/dateStamp | DateTimeStamp([0-9]{8} |
Special Bid / header | End Customer | Description of End Customer (E.G. Acme Corp) | String | 1 | SpecialBid/endCustomer | Attribute: string |
Special Bid / header | Reseller | Available resellers on BID | GLN | 1..x | SpecialBid/resellers/partnerId | Attribute: string |
Special Bid / header | Distributors | Available distributors on BID | GLN | 1..x | SpecialBid/distributors/partnerId | Attribute: string |
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 |
Special Bid / header | Text | Info free text | String | 0..1 | SpecialBid/freeFormText | Attribute: string |
Special Bid / product | Min Order QTY | Minimum Order Quantity | Numeric | 0..1 | SpecialBid/product/minOrder/quantity | Attribute: nonNegativeInteger |
Special Bid / product | Max Order QTY | Maximum Order Quantity | Numeric | 0..1 | SpecialBid/product/maxOrder/quanity | Attribute: nonNegativeInteger |
Special Bid / product | Remaining Order QTY | Remaining Order Quantity | Numeric | 0..1 | SpecialBid/product/remainder/quantity | Attribute: nonNegativeInteger |
Special Bid / product | Manufacturer Part Number | Product ID from Manufacturer | String | 1 | SpecialBid/product/productIdentifiers/productIdentifier | Attribute: string |
Special Bid / product | SKU | Internal Product ID from Distributor | String | 0..1 | SpecialBid/product/productIdentifiers/productIdentifier | Attribute: string |
Special Bid / product | Localisation Code | Country Specific Code | String | 0..1 | SpecialBid/product/productIdentifier/localisationCode | Attribute: string |
Special Bid / product | Special Bid Price | Amount for each item provided by Manufacturer | Amount | 1 | SpecialBid/product/priceInfo/price | Attribute: decimal |
Special Bid / product | Currency | Currency | String | 1 | SpecialBid/product/priceInfo/currency | Attribute: string |
Special Bid / product | Description | Product Description | String | 0..1 | SpecialBid/product/textualProductDescription | Attribute: string |