| POST | /purchase/v2 | Create Order |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| orderId | body | string | Yes | Purchase order ID, total length-max with x-booster-App header: 99 |
| posCode | body | string | Yes | Global Pos Code for the intended Order e.g. ES100:102048 |
| brand | body | string | Yes | Brand Trigram of the intended Order, e.g. 'IWC', 'CAR', etc. |
| notes | body | string | No | Additional Notes regarding the Order |
| customerReference | body | string | No | Customer Reference |
| customerReferenceConsignment | body | string | No | Customer Reference for Consignment Order |
| orderDate | body | DateTime? | No | Purchase order date, e.g. '2020-12-31' |
| SplittedOrders | body | List<SplittedOrder> | No | Details of the end Customer |
| endCustomerBooster1Id | body | string | No | Booster1 ID of the end Customer |
| endCustomerDetails | body | EndCustomerDetails | No | Details of the end Customer |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| shipToId | form | string | Yes | Ship To Pos Code |
| finalShipToId | form | string | No | Final Ship To Pos Code |
| billToId | form | string | Yes | Bill To Pos Code |
| soldToId | form | string | Yes | Sold To Pos Code |
| salesRepresentativeId | form | string | No | Sales Representative Code |
| orderItems | form | List<CreateOrderItemRequestV2> | Yes | List of Articles to be created |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| lineNumber | form | int | Yes | Line Number |
| articleCode | form | string | Yes | Reference ID of the article/product, e.g. 'CRWB520003' |
| quantity | form | int | Yes | Desired quantity of the article |
| requestedDeliveryDate | form | DateTime? | No | Requested Delivery Date of the Item, e.g. '2020-12-30' |
| strap | form | StrapItem | No | Strap definition |
| orderType | form | string | No | Purchase order type, e.g. 'WCFS', null. Null for ordinary order |
| deliveryPlantId | form | string | No | DeliveryPlantId of item, e.g.: CHD6 |
| reasonCode | form | string | Yes | Reason Code |
| orderDeliveryPriority | form | int? | No | Order Delivery Priority, e.g.: 10, 20, 30, 40, 50 |
| buckleSummary | form | string | No | Buckle Summary, can be get from order simulation |
| materialSummary | form | string | No | Material Summary, can be get from order simulation |
| contentSummary | form | string | No | Content Summary, can be get from order simulation |
| strapSummary | form | string | No | Strap Summary, can be get from order simulation |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| speakingArticleCode | form | string | No | Article reference |
| buckleTypeDescription | form | string | No | Buckle type Description |
| buckleTypeCode | form | string | No | Buckle type |
| watch6Length | form | int? | No | watch 6 Length |
| watch12Length | form | int? | No | watch 12 Length |
| materialCode | form | string | No | Article Material Code |
| materialDescription | form | string | No | Article Material Description |
| colorCode | form | string | No | Article Color Code |
| colorDescription | form | string | No | Article Color Description |
| buckleWidth | form | string | No | Buckle Witdh |
| liningCode | form | string | No | Article Lining Code |
| liningDescription | form | string | No | Article Lining Description |
| stitchingCode | form | string | No | Article Stitching Code |
| stitchingDescription | form | string | No | Article Stitching Description |
| edgeCode | form | string | No | Article Edge Code |
| edgeDescription | form | string | No | Article Edge Description |
| paddingCode | form | string | No | Article Padding Code |
| paddingDescription | form | string | No | Article Padding Description |
| specialtyCode | form | string | No | Article Speciality Code |
| specialtyDescription | form | string | No | Article Speciality Description |
| nuancierCode | form | string | No | Nuancier Code |
| isStrapVipOrder | form | bool? | No | Strap Vip Order |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| title | form | string | No | Title of the end Customer, e.g. 'MR', 'MRS'. |
| firstName | form | string | Yes | First Name of the end Customer |
| lastName | form | string | Yes | Last Name of the end Customer |
| form | string | No | Email of the end Customer | |
| phone | form | string | No | Phone number of the end Customer, e.g. '0032477123456'. |
| country | form | string | Yes | Countr code in the shipping address, e.g. 'BE' (ISO Code) |
| city | form | string | Yes | City name in the shipping address |
| street | form | string | Yes | Street name in the shipping address |
| houseNumber | form | string | No | House number in the shipping address |
| building | form | string | No | Building number in the shipping address |
| postalCode | form | string | No | Postal code in the shipping address |
| region | form | string | No | Region code in the shipping address, e.g. 'VL' (ISO Code) |
| district | form | string | No | District name in the shipping address |
| additionalInfo | form | string | No | Additional Info number to the shipping address |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /purchase/v2 HTTP/1.1
Host: dev-api-booster.richemont.com
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<CreateOrderV2 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Richemont.Booster2.PublicApi.Purchase.ServiceModel">
<SplittedOrders>
<SplittedOrder>
<billToId>String</billToId>
<finalShipToId>String</finalShipToId>
<orderItems>
<CreateOrderItemRequestV2>
<articleCode>String</articleCode>
<buckleSummary>String</buckleSummary>
<contentSummary>String</contentSummary>
<deliveryPlantId>String</deliveryPlantId>
<lineNumber>0</lineNumber>
<materialSummary>String</materialSummary>
<orderDeliveryPriority>0</orderDeliveryPriority>
<orderType>String</orderType>
<quantity>0</quantity>
<reasonCode>String</reasonCode>
<requestedDeliveryDate>0001-01-01T00:00:00</requestedDeliveryDate>
<strap xmlns:d6p1="http://schemas.datacontract.org/2004/07/Richemont.Booster2.PublicApi.Purchase.ServiceModel.SharedModels">
<d6p1:buckleTypeCode>String</d6p1:buckleTypeCode>
<d6p1:buckleTypeDescription>String</d6p1:buckleTypeDescription>
<d6p1:buckleWidth>String</d6p1:buckleWidth>
<d6p1:colorCode>String</d6p1:colorCode>
<d6p1:colorDescription>String</d6p1:colorDescription>
<d6p1:edgeCode>String</d6p1:edgeCode>
<d6p1:edgeDescription>String</d6p1:edgeDescription>
<d6p1:isStrapVipOrder>false</d6p1:isStrapVipOrder>
<d6p1:liningCode>String</d6p1:liningCode>
<d6p1:liningDescription>String</d6p1:liningDescription>
<d6p1:materialCode>String</d6p1:materialCode>
<d6p1:materialDescription>String</d6p1:materialDescription>
<d6p1:nuancierCode>String</d6p1:nuancierCode>
<d6p1:paddingCode>String</d6p1:paddingCode>
<d6p1:paddingDescription>String</d6p1:paddingDescription>
<d6p1:speakingArticleCode>String</d6p1:speakingArticleCode>
<d6p1:specialtyCode>String</d6p1:specialtyCode>
<d6p1:specialtyDescription>String</d6p1:specialtyDescription>
<d6p1:stitchingCode>String</d6p1:stitchingCode>
<d6p1:stitchingDescription>String</d6p1:stitchingDescription>
<d6p1:watch12Length>0</d6p1:watch12Length>
<d6p1:watch6Length>0</d6p1:watch6Length>
</strap>
<strapSummary>String</strapSummary>
</CreateOrderItemRequestV2>
</orderItems>
<salesRepresentativeId>String</salesRepresentativeId>
<shipToId>String</shipToId>
<soldToId>String</soldToId>
</SplittedOrder>
</SplittedOrders>
<brand>String</brand>
<customerReference>String</customerReference>
<customerReferenceConsignment>String</customerReferenceConsignment>
<endCustomerBooster1Id>String</endCustomerBooster1Id>
<endCustomerDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/Richemont.Booster2.PublicApi.Purchase.ServiceModel.SharedModels">
<d2p1:additionalInfo>String</d2p1:additionalInfo>
<d2p1:building>String</d2p1:building>
<d2p1:city>String</d2p1:city>
<d2p1:country>String</d2p1:country>
<d2p1:district>String</d2p1:district>
<d2p1:email>String</d2p1:email>
<d2p1:firstName>String</d2p1:firstName>
<d2p1:houseNumber>String</d2p1:houseNumber>
<d2p1:lastName>String</d2p1:lastName>
<d2p1:phone>String</d2p1:phone>
<d2p1:postalCode>String</d2p1:postalCode>
<d2p1:region>String</d2p1:region>
<d2p1:street>String</d2p1:street>
<d2p1:title>String</d2p1:title>
</endCustomerDetails>
<notes>String</notes>
<orderDate>0001-01-01T00:00:00</orderDate>
<orderId>String</orderId>
<posCode>String</posCode>
</CreateOrderV2>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <z:anyType xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:z="http://schemas.microsoft.com/2003/10/Serialization/" />