Hold Ticket Details
URI Summary
POST /stores/{storeId}/nodes/{nodeId}/holdTickets/{holdTicketId}
Request Parameters
|
Parameter Type |
Name |
Description |
Required |
Definition |
Example |
|---|---|---|---|---|---|
|
Path |
storeId |
The store identifier |
yes |
String |
TMSUS |
|
Path |
nodeId |
The node identifier |
yes |
String |
TMS_NA-Store001 |
|
Path |
holdTicketId |
The unique Hold Ticket identifier |
yes |
String |
ht1234 |
Request Payload Definition
|
Element |
Required |
Description |
|---|---|---|
|
StoreId |
yes |
The seller organization at which fulfillment order belongs. |
|
NodeId |
yes |
Fulfillment Order Ship Node |
|
holdTicketId |
yes |
The number for this hold ticket |
Request Payload Example
Responses
|
Http Status Code |
Description |
|---|---|
|
200 |
Hold Ticket Details Response |
Response Payload Definition
|
Element |
Required |
Description |
|---|---|---|
|
holdTickets[{ |
yes |
|
|
holdTicketId |
yes |
The hold ticket identifier |
|
fulfillmentOrder{ |
|
|
|
fulfillmentOrderId |
yes |
Fulfillment order ID |
|
storeId |
yes |
The seller organization to which this fulfillment order belongs. |
|
nodeId |
yes |
The node to which this order belongs |
|
webOrderId |
yes |
The web order ID associated with this fulfillment order |
|
omsOrderId |
yes |
The OMS order ID associated with this fulfillment order |
|
fulfillmentType |
yes |
Will always be same for ISPU |
|
currency |
yes |
The currency code in which this order is being processed, e.g. EUR or USD. |
|
carrier |
yes |
Fulfillment Order carrierService |
|
service |
yes |
Fulfillment Order Shipping SCAC |
|
fulfillmentOrderDate |
yes |
Release/Fulfillment Order create Date |
|
orderDate |
yes |
Fulfillment Order associated Sales Order creation date |
|
status |
yes |
Fulfillment Order Status Description |
|
totalVolume{ |
yes |
The total volume of the Fulfillment Order Shipment. |
|
unit |
yes |
The unit of measure for the units of volume |
|
value |
yes |
Number of units of measure |
|
totalWeight{ |
yes |
The total weight of the Fulfillment Order Shipment. |
|
unit |
yes |
The unit of measure for the weight |
|
value |
yes |
Number of units of weight |
|
pickTicketId |
no |
PickTicket number the Fulfillment Order is associated with |
|
holdLocation |
no |
Hold Location information for Customer Pick Queue |
|
storeName |
yes |
Physical store this order is being processed in |
|
pinNumber |
no |
PIN number to be used on pickup if this feature is enabled |
|
fulfillmentOrderItems [{ |
yes |
|
|
id |
yes |
Sequential number for this item (1-n) |
|
itemId |
yes |
The identifier for the item, including catalog |
|
itemDesc |
yes |
The description of the item. |
|
orderedQuantity |
yes |
The quantity of the line item that was ordered |
|
status |
yes |
Fulfillment Order Status Description for the item |
|
proxyPickupAddress |
no |
If using a proxy, this is a reference to the proxy details |
|
quantity |
yes |
For ISPU this is the same as holdQuantity |
|
holdQuantity |
yes |
The quantity held |
|
canceledQuantity |
yes |
The quantity canceled during pick |
|
itemTotal { |
yes |
Prices associated with the item |
|
unitPrice |
yes |
|
|
extendedPrice |
yes |
|
|
charges |
yes |
|
|
tax |
yes |
|
|
proxyPickupDetails{ |
no |
|
|
id |
yes |
proxyPickupAddress_1 |
|
personName{ |
yes |
Proxy pickup Name |
|
firstName |
yes |
|
|
lastName |
yes |
|
|
|
no |
Proxy pickup Email |
|
phone |
no |
Proxy pickup Phone Number |
|
address{ |
no |
|
|
line1 |
yes |
First line of address |
|
line2 |
no |
Second line of address |
|
city |
yes |
City |
|
mainDivisionCode |
yes |
State, Province, etc. |
|
postalCode |
yes |
Postal Code (zip code in the US) |
|
countryCode |
yes |
Country (e.g. DE, US) |
|
relationship |
no |
e.g. “Friend” |
|
destinations[{ |
yes |
Not useful for ISPU unless billing address is checked |
|
destinationId |
yes |
Cross referenced above |
|
destinationType |
yes |
MAILING_ADDRESS |
|
personName{ |
yes |
Customer name |
|
firstName |
yes |
First name |
|
middleName |
no |
Middle name |
|
lastName |
no |
Last name |
|
phone |
no |
Customer phone number |
|
address{ |
yes |
Customer address |
|
line1 |
yes |
First line of address |
|
line2 |
no |
Second line of address |
|
city |
yes |
City |
|
mainDivisionCode |
yes |
State, Province, etc. |
|
postalCode |
yes |
Postal Code (zip code in the US) |
|
countryCode |
yes |
Country (e.g. DE, US) |
|
billToAddress{ |
yes |
Cross reference to the destinationId above for the customer’s information and billing address |
|
destinationId |
yes |
|
|
shippingAddress{ |
yes |
Cross reference to the shipping address above. Not useful for ISPU |
|
destinationId |
yes |
|
|
orderTotal{ |
yes |
Prices associated with the whole order |
|
grandTotal |
yes |
|
|
grandTax |
yes |
|
|
grandCharges |
no |
|
Response Payload Example
{
"holdTickets": [
{
"holdTicketId": "123223",
"fulfillmentOrder": {
"fulfillmentOrderId": "10002343232001",
"storeId": "TMS_US",
"nodeId": "390-SFS-241",
"webOrderId": "25255225581",
"omsOrderId": "100051718744",
"fulfillmentType": "STORE_PICK_UP",
"currency": "USD",
"carrier": "USPS",
"service": "2DAY",
"fulfillmentOrderDate": "2014-11-04T15:00:00+00:00",
"orderDate": "2015-11-04T15:00:00+00:00",
"status": "Shipment Created",
"totalVolume": {
"unit": "CIN",
"value": 0.061
},
"totalWeight": {
"unit": "LBS",
"value": 2.061
},
"pickTicketId": "12321213",
"holdLocation": "Loc-001",
"storeName": "Store A Seller XYZ",
"pinNumber" : 7298,
"fulfillmentOrderItems": [
{
"id": "1",
"itemId": "21-885641458409",
"itemDesc": "10360 6 PREM RUST NBK-WP",
"orderedQuantity": 1,
"status": "Shipment Created",
"proxyPickupAddress": "proxyPickupAddress_1",
"quantity": 2,
"holdQuantity": 1,
"canceledQuantity": 1,
"itemTotal": {
"unitPrice": 10,
"extendedPrice": 60,
"charges": 10.1,
"tax": 1.01
},
"customAttributes": [
{
"key": "PIN_NUMBER",
"value": "M1EA0"
}
]
},
{
"id": "2",
"itemId": "21-885641458410",
"itemDesc": "10360 7 PREM RUST NBK-WP",
"orderedQuantity": 1,
"status": "Ready for backroom pick",
"proxyPickupAddress": "proxyPickupAddress_1",
"quantity": 2,
"holdQuantity": 1,
"canceledQuantity": 1,
"itemTotal": {
"unitPrice": 11,
"extendedPrice": 66,
"charges": 10.2,
"tax": 1.02
},
"customAttributes": [
{
"key": "PIN_NUMBER",
"value": "M1EA0"
}
]
}
],
"proxyPickupDetails": {
"id": "proxyPickupAddress_1",
"personName": {
"firstName": "Joe1",
"lastName": "Minimum1"
},
"email": "someone@someone@com",
"phone": "6100001000",
"address": {
"line1": "935 First Ave",
"city": "King Of Prussia",
"mainDivisionCode": "PA",
"postalCode": "19406",
"countryCode": "US"
},
"relationship": "Brother"
},
"destinations": [
{
"destinationId": "billing_1",
"destinationType": "MAILING_ADDRESS",
"personName": {
"firstName": "Joe1",
"lastName": "Minimum1"
},
"phone": "6105826426",
"address": {
"line1": "935 First Ave",
"city": "King Of Prussia",
"mainDivisionCode": "PA",
"postalCode": "19406",
"countryCode": "US"
}
},
{
"destinationId": "shipping_1",
"destinationType": "MAILING_ADDRESS",
"personName": {
"firstName": "Mary",
"lastName": "Receiver"
},
"phone": "6105826426",
"address": {
"line1": "935 First Ave",
"city": "King Of Prussia",
"mainDivisionCode": "PA",
"postalCode": "19406",
"countryCode": "US"
}
}
],
"billToAddress": {
"destinationId": "billing_1"
},
"shippingAddress": {
"destinationId": "shipping_1"
},
"orderTotal": {
"grandTotal": 100.12,
"grandTax": 1.01,
"grandCharges": 12.02,
}
}
}
]
}