...
The BTO order definition is published as draft on this page. You can contribute to the BTO order definition by adding comments to the field definitions .
| Info |
|---|
Background |
at the bottom of the page.
A customer panel is currently active in developing the BTO (build to order) order process and as a first deliverable we’ve work on the BTO ordering. Other modules like material creation and order validation are currently worked on.
...
Parent | Field name | Description | Type | Cardinality | XML element / attribute | XML properties |
Order | Order Line | Element | 1..n | ProductLineItem | Element | |
Order / Order line | Bid ID | ID of the BID provided by the manufacturer | String | 1 | ProductLineItem/DocumentLineReference/ProprietaryDocumentIdentifier | Attribute: string |
Order / Order line | Qualfier | Fixed: Contract | ProductLineItem/DocumentLineReference/GlobalDocumentReferenceTypeCode | Enumeration | ||
Order / Order line | Requested Delivery Date | Requested delivery date (goods receipt) by the end user | Date | 1 | requestedEvent/TransportationEvent/DateStamp | DateTimeStamp ([0-9]{8}T[0-9]{6}) |
Order / Order line | Qualfier | Ship or Delivery | requestedEvent/TransportationEvent/GlobalTransportEventCode | Enumeration(Ship,Delivery) | ||
Order / Order line | Quantity | The number / quantity of bundles/configurations ordered | Numeric | 1 | OrderQuantity/requestedQuantity/ProductQuantity | Attribute: xsd:nonNegativeInteger |
Order / Order line | Bundle ID | Id for the bundle provided by the manufacturer | String | 1 | PartnerProductIdentification/ProprietaryProductIdentifier | Attribute: string |
Order / Order line | Qualfier | Fixed: Manufacturer | PartnerProductIdentification/GlobalPartnerClassificationCode | Enumeration | ||
Order / Order line | Bundle Price | Amount for each bundle provided by the manufacturer | Amount | 1 | requestedUnitPrice/FinancialAmount/MonetaryAmount | Attribute: decimal |
Order / Order line | Currency | Currency | String | 1 | requestedUnitPrice/FinancialAmount/GlobalCurrencyCode | Attribute: string |
Order / Order line | BTO Line | BTOLine | Element | |||
Order / Order line / BTO Line | Bid Version | Version of the BID provided by the manufacturer | String | 0..1 | BTOLine/BidVersion | Attribute: string |
Order / Order line / BTO Line | Validate Bid | Instruction whether this bid needs to be validated and bounced by Onetrail | Boolean | 1 | BTOLine/ValidateBid | Enumeration (Yes,No) |
Order / Order line / BTO Line | Manufacturer GLN | Manufacturer of the configuration | String | 0..1 | BTOLine/SuppliedBy/PartnerDescription/BusinessDescription/GlobalBusinessIdentifier | |
Order / Order line / BTO Line | Qualfier | Fixed: Manufacturer | BTOLine/SuppliedBy/PartnerDescription/BusinessDescription/GlobalPartnerRoleClassificationCode | Enumeration | ||
Order / Order line / BTO Line | Bundle | Element | 0..n | BundleLineItem | Element | |
Order / Order line / BTO Line / Bundle | Sequence Number | Sequence number, the sequence of the bundle items is important to some manufacturers | Numeric | 1 | BundleLineItem/SequenceNumber | Attribute: xsd:nonNegativeInteger |
Order / Order line / BTO Line / Bundle | SKU | Internal product ID from distributor | String | 1 | BundleLineItem/PartnerProductIdentification/ProprietaryProductIdentifier | Attribute: string |
Order / Order line / BTO Line / Bundle | Qualfier | Fixed: Seller | String | 1 | BundleLineItem/PartnerProductIdentification/GlobalPartnerClassificationCode | Enumeration |
Order / Order line / BTO Line / Bundle | manufacturer Part Number | Internal product ID from manufacturer | String | 1 | BundleLineItem/PartnerProductIdentification/ProprietaryProductIdentifier | Attribute: string |
Order / Order line / BTO Line / Bundle | Qualfier | Fixed: Manufacturer | String | 1 | BundleLineItem/PartnerProductIdentification/GlobalPartnerClassificationCode | Enumeration |
Order / Order line / BTO Line / Bundle | Localisation Code | Required if the bid is not country specific | String | 0..1 | BundleLineItem/PartnerProductIdentification/revisionIdentifier | Attribute: string |
Order / Order line / BTO Line / Bundle | Quantity | Number of items in one config | Numeric | 1 | BundleLineItem/OrderQuantity/requestedQuantity/ProductQuantity | Attribute: xsd:nonNegativeInteger |
Order / Order line / BTO Line / Bundle | Unit Price | Amount for each bundle provided by the manufacturer | Amount | 1 | BundleLineItem/requestedUnitPrice/FinancialAmount/MonetaryAmount | Attribute: decimal |
Order / Order line / BTO Line / Bundle | Currency | Currency | String | 1 | BundleLineItem/requestedUnitPrice/FinancialAmount/GlobalCurrencyCode | Attribute: string |
...
Sample XML
Sample XML
| Code Block | ||
|---|---|---|
| ||
<?xml version="1.0" encoding="UTF-8"?>
<!-- Sample for an BTO/CTO order-->
<tns:Pip3A4PurchaseOrderRequest xmlns:ns="http://www.onetrail.net" xmlns:ns3="http://pip3a4po.ws.service.onetrail.com/" xmlns:tns="http://www.onetrail.net" xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<tns:fromRole>
<tns:PartnerRoleDescription>
<tns:ContactInformation>
<tns:contactName>
<tns:FreeFormText lang="EE">Purchase Department</tns:FreeFormText>
</tns:contactName>
<tns:EmailAddress>Purchase@onetrail.com</tns:EmailAddress>
<tns:facsimileNumber>
<tns:CommunicationsNumber>+31 30 697 3289</tns:CommunicationsNumber>
</tns:facsimileNumber>
<tns:telephoneNumber>
<tns:CommunicationsNumber>+31 30 697 3288</tns:CommunicationsNumber>
</tns:telephoneNumber>
</tns:ContactInformation>
<tns:GlobalPartnerRoleClassificationCode>Reseller</tns:GlobalPartnerRoleClassificationCode>
<tns:PartnerDescription>
<tns:BusinessDescription>
<tns:GlobalBusinessIdentifier>8714253023366</tns:GlobalBusinessIdentifier>
<tns:GlobalSupplyChainCode>Information Technology</tns:GlobalSupplyChainCode>
<tns:businessName>
<tns:FreeFormText lang="EN">Onetrail B.V. - Test Buyer</tns:FreeFormText>
</tns:businessName>
</tns:BusinessDescription>
<tns:GlobalPartnerClassificationCode>Buyer</tns:GlobalPartnerClassificationCode>
</tns:PartnerDescription>
</tns:PartnerRoleDescription>
</tns:fromRole>
<tns:GlobalDocumentFunctionCode>Request</tns:GlobalDocumentFunctionCode>
<tns:PurchaseOrder>
<tns:AccountDescription>
<tns:accountName>
<tns:FreeFormText lang="EE">Onetrail B.V. - Test Buyer</tns:FreeFormText>
</tns:accountName>
<tns:AccountNumber>8714253023366</tns:AccountNumber>
<tns:billTo>
<tns:PartnerRoleDescription>
<tns:ContactInformation>
<tns:contactName>
<tns:FreeFormText lang="EN">Finance Department</tns:FreeFormText>
</tns:contactName>
<tns:EmailAddress>Finance@onetrail.com</tns:EmailAddress>
<tns:facsimileNumber>
<tns:CommunicationsNumber>+31 30 697 3289</tns:CommunicationsNumber>
</tns:facsimileNumber>
<tns:telephoneNumber>
<tns:CommunicationsNumber>+31 30 697 3288</tns:CommunicationsNumber>
</tns:telephoneNumber>
</tns:ContactInformation>
<tns:GlobalPartnerRoleClassificationCode>Reseller</tns:GlobalPartnerRoleClassificationCode>
<tns:PartnerDescription>
<tns:BusinessDescription>
<tns:GlobalBusinessIdentifier>8714253023397</tns:GlobalBusinessIdentifier>
<tns:businessName>
<tns:FreeFormText lang="EE">Onetrail B.V. - Test Buyer</tns:FreeFormText>
</tns:businessName>
</tns:BusinessDescription>
<tns:GlobalPartnerClassificationCode>Buyer</tns:GlobalPartnerClassificationCode>
</tns:PartnerDescription>
</tns:PartnerRoleDescription>
</tns:billTo>
</tns:AccountDescription>
<tns:remarks>
<tns:remark context="Buyer Remark">Header Text</tns:remark>
</tns:remarks>
<!--This is the end user reference-->
<tns:DocumentReference>
<tns:DateTimeStamp>20150214T171451</tns:DateTimeStamp>
<tns:GlobalDocumentReferenceTypeCode>Work Order</tns:GlobalDocumentReferenceTypeCode>
<tns:ProprietaryDocumentIdentifier>End user ref 285481</tns:ProprietaryDocumentIdentifier>
</tns:DocumentReference>
<!--Special order type for BTO-->
<tns:GlobalPurchaseOrderTypeCode>BTO Order</tns:GlobalPurchaseOrderTypeCode>
<tns:OrderShippingInformation>
<tns:GlobalShippingServiceLevelCode>AB - Pre Noon</tns:GlobalShippingServiceLevelCode>
<tns:GlobalSpecialFulfillmentRequestCode>Partial</tns:GlobalSpecialFulfillmentRequestCode>
</tns:OrderShippingInformation>
<tns:ProductLineItem>
<tns:remarks>
<tns:remark lang="NL">Lijn Tekst</tns:remark>
</tns:remarks>
<!--This is the special bid Id on line level-->
<tns:DocumentLineReference>
<tns:DateTimeStamp>20150214T171451</tns:DateTimeStamp>
<tns:GlobalDocumentReferenceTypeCode>Contract</tns:GlobalDocumentReferenceTypeCode>
<tns:ProprietaryDocumentIdentifier>BID:1231231</tns:ProprietaryDocumentIdentifier>
</tns:DocumentLineReference>
<tns:GlobalProductUnitOfMeasureCode>EACH</tns:GlobalProductUnitOfMeasureCode>
<tns:isDropShip>
<tns:AffirmationIndicator>Yes</tns:AffirmationIndicator>
</tns:isDropShip>
<tns:LineNumber>1</tns:LineNumber>
<!--The quantity of bundles to order-->
<tns:OrderQuantity>
<tns:requestedQuantity>
<tns:ProductQuantity>3</tns:ProductQuantity>
</tns:requestedQuantity>
</tns:OrderQuantity>
<!--Put the bundle ID in the Manufacturer, other ClassifcationCode (i.e Seller, EAN, etc. are not supported for BTO lines) -->
<tns:ProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Manufacturer</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>12312312</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
</tns:ProductIdentification>
<tns:requestedEvent>
<tns:TransportationEvent>
<tns:DateStamp>20150214T120000</tns:DateStamp>
<tns:GlobalTransportEventCode>Ship</tns:GlobalTransportEventCode>
</tns:TransportationEvent>
</tns:requestedEvent>
<!-- The price for 1 bundle / config-->
<tns:requestedUnitPrice>
<tns:FinancialAmount>
<tns:GlobalCurrencyCode>EUR</tns:GlobalCurrencyCode>
<tns:MonetaryAmount>995.56</tns:MonetaryAmount>
</tns:FinancialAmount>
</tns:requestedUnitPrice>
<tns:totalLineItemAmount>
<tns:FinancialAmount>
<tns:GlobalCurrencyCode>EUR</tns:GlobalCurrencyCode>
<tns:MonetaryAmount>2986.68</tns:MonetaryAmount>
</tns:FinancialAmount>
</tns:totalLineItemAmount>
<!--Additional fields for BTO on line level (bundle)-->
<tns:BTOLine>
<tns:BidVersion>001</tns:BidVersion>
<tns:ValidateBid>Yes</tns:ValidateBid>
<tns:SuppliedBy>
<tns:PartnerRoleDescription>
<tns:GlobalPartnerRoleClassificationCode>Manufacturer</tns:GlobalPartnerRoleClassificationCode>
<tns:PartnerDescription>
<tns:BusinessDescription>
<tns:GlobalBusinessIdentifier>8714253023236</tns:GlobalBusinessIdentifier>
<tns:GlobalSupplyChainCode>Information Technology</tns:GlobalSupplyChainCode>
<tns:businessName>
<tns:FreeFormText lang="EN">Hewlett Packard</tns:FreeFormText>
</tns:businessName>
</tns:BusinessDescription>
</tns:PartnerDescription>
</tns:PartnerRoleDescription>
</tns:SuppliedBy>
<!--The bundle line items (the indiviual products making the bundle)-->
<tns:BundleLineItem>
<tns:SequenceNumber>1</tns:SequenceNumber>
<!--The number of items in 1 bundle / config -->
<tns:OrderQuantity>
<tns:requestedQuantity>
<tns:ProductQuantity>3</tns:ProductQuantity>
</tns:requestedQuantity>
</tns:OrderQuantity>
<!--Product ID's-->
<tns:ProductIdentification>
<tns:GlobalProductIdentifier>MCC2HUK</tns:GlobalProductIdentifier>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Manufacturer</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>MCC2HUK</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Seller</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>SellerPN1</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Buyer</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>BuyerPN1</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>EAN</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>8712345678921</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<!--Localisation code of bundle-items-->
<tns:revisionIdentifier>ABD</tns:revisionIdentifier>
</tns:ProductIdentification>
<!-- Price for an individual item-->
<tns:requestedUnitPrice>
<tns:FinancialAmount>
<tns:GlobalCurrencyCode>EUR</tns:GlobalCurrencyCode>
<tns:MonetaryAmount>295.56</tns:MonetaryAmount>
</tns:FinancialAmount>
</tns:requestedUnitPrice>
</tns:BundleLineItem>
<tns:BundleLineItem>
<tns:SequenceNumber>2</tns:SequenceNumber>
<tns:OrderQuantity>
<tns:requestedQuantity>
<tns:ProductQuantity>1</tns:ProductQuantity>
</tns:requestedQuantity>
</tns:OrderQuantity>
<tns:ProductIdentification>
<tns:GlobalProductIdentifier>MCC2HUJ</tns:GlobalProductIdentifier>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Manufacturer</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>MCC2HUJ</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Seller</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>SellerPN2</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>Buyer</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>BuyerPN2</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:PartnerProductIdentification>
<tns:GlobalPartnerClassificationCode>EAN</tns:GlobalPartnerClassificationCode>
<tns:ProprietaryProductIdentifier>8712345678922</tns:ProprietaryProductIdentifier>
</tns:PartnerProductIdentification>
<tns:revisionIdentifier>ABD</tns:revisionIdentifier>
</tns:ProductIdentification>
<tns:requestedUnitPrice>
<tns:FinancialAmount>
<tns:GlobalCurrencyCode>EUR</tns:GlobalCurrencyCode>
<tns:MonetaryAmount>108.88</tns:MonetaryAmount>
</tns:FinancialAmount>
</tns:requestedUnitPrice>
</tns:BundleLineItem>
</tns:BTOLine>
</tns:ProductLineItem>
<tns:purchaseOrderIdentifier>
<tns:ProprietaryDocumentIdentifier>BTO Order 1</tns:ProprietaryDocumentIdentifier>
</tns:purchaseOrderIdentifier>
<tns:requestedEvent>
<tns:TransportationEvent>
<tns:DateStamp>20150214T120000</tns:DateStamp>
<tns:GlobalTransportEventCode>Ship</tns:GlobalTransportEventCode>
</tns:TransportationEvent>
</tns:requestedEvent>
<!-- ShipTo address for the BTO-->
<tns:shipTo>
<tns:PartnerDescription>
<tns:BusinessDescription>
<tns:businessName>
<tns:FreeFormText lang="EE">Onetrail Test Buyer</tns:FreeFormText>
</tns:businessName>
</tns:BusinessDescription>
<tns:GlobalPartnerClassificationCode>Buyer</tns:GlobalPartnerClassificationCode>
<tns:ContactInformation>
<tns:contactName>
<tns:FreeFormText lang="EE">Purchase Department</tns:FreeFormText>
</tns:contactName>
<tns:EmailAddress>support@onetrail.com</tns:EmailAddress>
<tns:facsimileNumber>
<tns:CommunicationsNumber>+31 30 697 3289</tns:CommunicationsNumber>
</tns:facsimileNumber>
<tns:telephoneNumber>
<tns:CommunicationsNumber>+31 30 697 3288</tns:CommunicationsNumber>
</tns:telephoneNumber>
</tns:ContactInformation>
</tns:PartnerDescription>
<tns:PhysicalAddress>
<tns:addressLine1>
<tns:FreeFormText lang="EE">Huis ter Heideweg 46</tns:FreeFormText>
</tns:addressLine1>
<tns:addressLine2>
<tns:FreeFormText lang="EE">First Floor</tns:FreeFormText>
</tns:addressLine2>
<tns:cityName>
<tns:FreeFormText lang="EE">Zeist</tns:FreeFormText>
</tns:cityName>
<tns:GlobalCountryCode>NL</tns:GlobalCountryCode>
<tns:NationalPostalCode>3705 LZ</tns:NationalPostalCode>
</tns:PhysicalAddress>
</tns:shipTo>
<tns:totalAmount>
<tns:FinancialAmount>
<tns:GlobalCurrencyCode>EUR</tns:GlobalCurrencyCode>
<tns:MonetaryAmount>2986.68</tns:MonetaryAmount>
</tns:FinancialAmount>
</tns:totalAmount>
<!-- the BTO header fields-->
<tns:BTOOrder>
<!--The EndUser details-->
<tns:EndUser>
<tns:PartnerDescription>
<tns:BusinessDescription>
<tns:businessName>
<tns:FreeFormText>End User B.V.</tns:FreeFormText>
</tns:businessName>
</tns:BusinessDescription>
<tns:GlobalPartnerClassificationCode>EndUser</tns:GlobalPartnerClassificationCode>
<tns:ContactInformation>
<tns:contactName>
<tns:FreeFormText>John Doe</tns:FreeFormText>
</tns:contactName>
<tns:EmailAddress>john.doe@enduser.com</tns:EmailAddress>
<tns:telephoneNumber>
<tns:CommunicationsNumber>012-3456789</tns:CommunicationsNumber>
</tns:telephoneNumber>
</tns:ContactInformation>
</tns:PartnerDescription>
<tns:PhysicalAddress>
<tns:addressLine1>
<tns:FreeFormText>EndUser street 22</tns:FreeFormText>
</tns:addressLine1>
<tns:cityName>
<tns:FreeFormText>SampleCity</tns:FreeFormText>
</tns:cityName>
<tns:GlobalCountryCode>NL</tns:GlobalCountryCode>
<tns:NationalPostalCode>1234 AB</tns:NationalPostalCode>
</tns:PhysicalAddress>
</tns:EndUser>
<!-- who is going to fullfill the order to the end user-->
<tns:shipBy>
<tns:GlobalPartnerRoleClassificationCode>Reseller</tns:GlobalPartnerRoleClassificationCode>
</tns:shipBy>
</tns:BTOOrder>
</tns:PurchaseOrder>
<tns:thisDocumentGenerationDateTime>
<tns:DateTimeStamp>20150214T171451</tns:DateTimeStamp>
</tns:thisDocumentGenerationDateTime>
<tns:thisDocumentIdentifier>
<tns:ProprietaryDocumentIdentifier>25658937T874q376</tns:ProprietaryDocumentIdentifier>
</tns:thisDocumentIdentifier>
<tns:toRole>
<tns:PartnerRoleDescription>
<tns:ContactInformation>
<tns:contactName>
<tns:FreeFormText lang="EN">Sales Department </tns:FreeFormText>
</tns:contactName>
<tns:EmailAddress>sales@onetrail.com</tns:EmailAddress>
<tns:facsimileNumber>
<tns:CommunicationsNumber>+31 30 697 3289</tns:CommunicationsNumber>
</tns:facsimileNumber>
<tns:telephoneNumber>
<tns:CommunicationsNumber>+31 30 697 3288</tns:CommunicationsNumber>
</tns:telephoneNumber>
</tns:ContactInformation>
<tns:GlobalPartnerRoleClassificationCode>Distributor</tns:GlobalPartnerRoleClassificationCode>
<tns:PartnerDescription>
<tns:BusinessDescription>
<tns:GlobalBusinessIdentifier>8714253023236</tns:GlobalBusinessIdentifier>
<tns:GlobalSupplyChainCode>Information Technology</tns:GlobalSupplyChainCode>
<tns:businessName>
<tns:FreeFormText lang="EN">Onetrail B.V. - Test Seller</tns:FreeFormText>
</tns:businessName>
</tns:BusinessDescription>
<tns:GlobalPartnerClassificationCode>Seller</tns:GlobalPartnerClassificationCode>
</tns:PartnerDescription>
</tns:PartnerRoleDescription>
</tns:toRole>
</tns:Pip3A4PurchaseOrderRequest> |
