Versions Compared

Key

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

...

Tip

On this page:

Table of Contents
maxLevel21

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.  

Process

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 The deal allows 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

XML usage:

Fixed values:
<GlobalPurchaseOrderTypeCode>: "Special Bid Order"
<GlobalDocumentReferenceTypeCode>: "Contract"
Variable values

<GlobalDocumentReference><ProprietaryDocumentIdentifier>: Contract number (i.e. OPG)

EDIFACT usage:

Include:
Segment group 1: RFF
Reference qualifier: CT
Example: RFF+CT:SpecBid 1234567'

...

The Special Bid Data can be retrieved in either XML or CSV format.

Syntax

The Special Bid Data complies with the below field definitions

...

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

ParentField NameDescriptionTypeCardinalityXML Element / AttributeXML Properties
Conclusion
Special Bid / header
DateCreation date of the Special BidDate1SpecialBid/dateStampSpecial Bid / header
DateTimeStamp([0-9]{8}Remove Field
Manufacturer GLNManufacturer GLN of the bidString
0..
1SpecialBid/partnerIdAttribute: GTINStringType
Mandatory, Use code conversions to GLN
Special Bid / headerBid IDID of the bid (provided by Manufacturer)String1SpecialBid/bidIDAttribute: string
Mandatory
Special Bid / headerBid VersionVersion of the bid (provided by Manufacturer)String0..1SpecialBid/bidVersionAttribute: string
Optional, Might be requested if vendor's connect directly
Special Bid / headerOrder Date FromValid FromDate0..SpecialBid/orderFromDate/dateStampDateTimeStamp([0-9]{8}
Optional
Special Bid / headerOrder Date ToValid ToDate1SpecialBid/orderToDate/dateStampDateTimeStamp([0-9]{8} 
Mandatory
Special Bid / header
Ship Date FromSpecial Bid / headerShip Date ToShipping to dateDate1SpecialBid/shipToDate/dateStampDateTimeStamp([0-9]{8}Remove FieldSpecial Bid / header
Shipping from dateDate1SpecialBid/shipFromDate/dateStampDateTimeStamp([0-9]{8}Remove Field
End CustomerDescription of End Customer (E.G. Acme Corp)String1SpecialBid/endCustomerAttribute: string
Mandatory, check EET, is this Special Deal?
Special Bid / headerResellerAvailable resellers on BIDGLN1..xSpecialBid/resellers/partnerIdAttribute: string
Mandatory, with Buyer GLN
Special Bid / headerDistributorsAvailable distributors on BIDGLN1..xSpecialBid/distributors/partnerIdAttribute: string
Mandatory, with distributor GLN as fixed value
Special Bid / header
Bid CurrencyCurrencyString1SpecialBid/currencyAttribute: stringRemove Field, use line levelSpecial Bid / header
TermsCodes for different term of validity.
(E.G only when everything on bid is ordered)
String0..1SpecialBid/termsAttribute: string
Optional
Special Bid / headerTextInfo free textString0..1SpecialBid/freeFormTextAttribute: string
Optional







Special Bid / productMin Order QTYMinimum Order QuantityNumeric0..1SpecialBid/product/minOrder/quantityAttribute: nonNegativeInteger
Optional
Special Bid / productMax Order QTYMaximum Order QuantityNumeric0..1SpecialBid/product/maxOrder/quanityAttribute: nonNegativeInteger
Optional
Special Bid / productRemaining Order QTYRemaining Order QuantityNumeric0..1SpecialBid/product/remainder/quantityAttribute: nonNegativeInteger
Optional, might be required if vendors are connected directly
Special Bid / productManufacturer Part NumberProduct ID from ManufacturerString
0..
1SpecialBid/product/productIdentifiers/productIdentifierAttribute: string
Mandatory
Special Bid / productSKUInternal Product ID from DistributorString0..1SpecialBid/product/productIdentifiers/productIdentifierAttribute: string
Optional, unless necessary
Special Bid / productLocalisation CodeCountry Specific CodeString0..1SpecialBid/product/productIdentifier/localisationCodeAttribute: string
Optional, Required if bid is country specific
Special Bid / productSpecial Bid PriceAmount for each item provided by ManufacturerAmount
0..
1SpecialBid/product/priceInfo/priceAttribute: decimal
Mandatory
Special Bid / productCurrencyCurrencyString
0..
1SpecialBid/product/priceInfo/currencyAttribute: string
Mandatory
Special Bid / productDescriptionProduct DescriptionString0..1SpecialBid/product/textualProductDescriptionAttribute: string
Optional