Start here instead: most new integrations should begin with the Editor API, which covers designing, ordering and fulfilling an order end to end. Even if you have your own product UI, the editors can run headlessly for many products; reach out and we will help you scope that path. Use the Order Submit API directly when your orders are composed entirely outside WHCC. The exception is webhooks: registration for every integration, including the Editor API, is documented in this section.
Create an order request JSON object and POST the request JSON to this endpoint to start a new order.
Your order will not be processed until you submit the order after importing using /api/OrderImport/Submit.
/api/OrderImport1
2
3
4
curl https://apps.whcc.com/api/OrderImport \
-H "Authorization: Bearer 726670514499" \
-H "Content-Type: application/json" \
-d '{"EntryId":"12345","Orders":[{"SequenceNumber":1,"Instructions":null,"Reference":"OrderID 12345","SendNotificationEmailAddress":null,"SendNotificationEmailToAccount":true,"ShipToAddress":{"Name":"Chris Hanline","Attn":null,"Addr1":"2840 Lone Oak Parkway","Addr2":null,"City":"Eagan","State":"MN","Zip":"55121","Country":"US","Phone":"6516468263"},"ShipFromAddress":{"Name":"Returns Department","Addr1":"3432 Denmark Ave","Addr2":"Suite 390","City":"Eagan","State":"MN","Zip":"55123","Country":"US","Phone":"8002525234"},"OrderAttributes":[{"AttributeUID":548},{"AttributeUID":553}],"OrderItems":[{"ProductUID":2,"Quantity":1,"ItemAssets":[{"ProductNodeID":10000,"AssetPath":"https://whcc-api-testing.s3.amazonaws.com/sample-images/sample-image-1.jpg","ImageHash":"a9825bb0836325e07ccfed16751b1d07","PrintedFileName":"sample-image-1.jpg","AutoRotate":true}],"ItemAttributes":[{"AttributeUID":1},{"AttributeUID":5}]}]}]}'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
{
"EntryId": "12345",
"Orders": [
{
"SequenceNumber": 1,
"Instructions": null,
"Reference": "OrderID 12345",
"SendNotificationEmailAddress": null,
"SendNotificationEmailToAccount": true,
"ShipToAddress": {
"Name": "Chris Hanline",
"Attn": null,
"Addr1": "2840 Lone Oak Parkway",
"Addr2": null,
"City": "Eagan",
"State": "MN",
"Zip": "55121",
"Country": "US",
"Phone": "6516468263"
},
"ShipFromAddress": {
"Name": "Returns Department",
"Addr1": "3432 Denmark Ave",
"Addr2": "Suite 390",
"City": "Eagan",
"State": "MN",
"Zip": "55123",
"Country": "US",
"Phone": "8002525234"
},
"OrderAttributes": [
{
"AttributeUID": 548
},
{
"AttributeUID": 553
}
],
"OrderItems": [
{
"ProductUID": 2,
"Quantity": 1,
"ItemAssets": [
{
"ProductNodeID": 10000,
"AssetPath": "https://whcc-api-testing.s3.amazonaws.com/sample-images/sample-image-1.jpg",
"ImageHash": "a9825bb0836325e07ccfed16751b1d07",
"PrintedFileName": "sample-image-1.jpg",
"AutoRotate": true,
"AssetEnhancement": null
}
],
"ItemAttributes": [
{
"AttributeUID": 1
},
{
"AttributeUID": 5
}
]
}
]
}
]
}
Prices below are illustrative only. Your actual product and shipping charges depend on your account's pricing and the OrderAttributes you submit.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
"Account": "10072",
"ConfirmationID": "d4bcb9a7-caf0-4d2b-aa18-674a5d2c527e",
"EntryID": "",
"Key": "B431BE78D2E9FFFE3709",
"NumberOfOrders": 1,
"Orders": [{
"LineItems": [],
"Note": "",
"Products": [{
"Price": "0.65",
"ProductDescription": "Print Fulfillment 5x7",
"Quantity": 1
}, {
"Price": "7.95",
"ProductDescription": "USA - Drop Ship, Lowest Cost",
"Quantity": 1
}],
"SequenceNumber": "1",
"SubTotal": "8.60",
"Tax": "0.60",
"Total": "9.20"
}],
"Received": "8/19/2018 4:34:01 PM Central Time"
}
ConfirmationID
String
The ID for the order. This value is needed for the /api/OrderImport/Submit call to actually submit the order to be produced.
Account
Integer
The WHCC account number this order will be produced under.
NumberOfOrders
Integer
The number of orders included in this import.
Received
String
The time the order was submitted.
Orders
Array
Additional data about the potential orders in this import.
LineItems
Array
An array of LineItems this order contains.
SequenceNumber
String
Value submitted for SequenceNumber with order import request.
SubTotal
String
Cost of order before sales tax.
Tax
String
Sales tax amount for this order.
Total
String
Cost of order including sales tax.
Products
Array
An array of product billing items for this order.
ProductDescription
String
Description of the product billing item.
Quantity
Integer
Number of copies of this item.
Price
String
Price per item for the product billing item.
Submit the ConfirmationId to confirm your order