Shipmentdetails
The shipmentdetails resource defines how and where the physical goods you’re purchasing are shipped. The where you’re shipping is the shipping address, while the how are the shipping options, such as Canada Post or FedEx, available for your store.
Read Order Destination Info
Retrieves the order’s destinationinfo, which contains links to:
- A selector for choosing the order’s shipping address: Select Shipping Address
- The shipping address currently selected for the order: Read Order Shipping Address
- The delivery the destinationinfo belongs to: Read Order Delivery
Workflow
- Start with delivery
GETthe link with rel: destinationinfo- Refer to shipping addresses
Read Order Shipping Option Info
Retrieves the order’s shippingoptioninfo, which contains links to:
- A selector for choosing the order’s shipping option: Select Shipping Choice
- The shipping option selected for the order: Read Order Shipping Option
- The delivery the shipping option belongs to: Read Order Delivery
Workflow
- Start with delivery
GETthe link with rel: shippingoptioninfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |
Read Order Shipping Option
Retrieves the shipping option that is currently selected for the order. The shipping option is how the order is shipped, such as FedEx or Canada Post. If a shipping option has not been selected for the order, the shipping option link does not appear on the shippingoptioninfo. For more information about how to select the shippingoption,
see Select Shipping Choice
Workflow
- Start with shipping-option-info
GETthe link with rel: shippingoption- Render the response
Response Fields
Type: shipmentdetails.shipping-option
| Name | Description | Type |
|---|---|---|
name | The name of the shipping option. | string |
display-name | The localized name of the carrier, intended for display in the client application. | string |
carrier | The name of the carrier. | string |
cost | The shipping costs for shipping the item(s) to the selected shipping address. | array |
currency | The currency the cost is in. | string |
amount | The decimal value of the cost. | decimal |
display | Formatted currency string that can be displayed on the client application. | string |
Select Shipping Option
Use a Selector to choose the shipping option for the order. The shipping option is how the order is shipped, such asFedEx or Canada Post. The shipping options available for your shipment depend on which shipping regions and shipping options are configured for your store. Check with your store’s administrator for more information on these options.
Workflow
- Start with shipping option info
GETthe link with rel: selectorGETthe link with rel: choiceGETthe link with rel: chosenGETthe link with rel: descriptionPOSTthe choice using the link with rel: selectaction
Read Destination Needinfo From Order
Read the needinfo link for the shipping address. If this link appears on the order, it means the shipping address
has not been selected or created for the order. Needinfo links can appear on the order, the purchase form, and the delivery.
Workflow
- Start with order
GETthe link with rel: needinfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |
Read Destination Needinfo From Delivery
Read the needinfo link for the shipping address from the delivery. Needinfo links can appear on the order, the purchase form, and the delivery.
Workflow
- Start with delivery
GETthe link with rel: needinfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |
Read Destination Needinfo From Purchaseform
Read the needinfo link for the shipping address from the purchase form. Needinfo links can appear on the order, the purchase form, and the delivery.
Workflow
- Start with create purchase form
GETthe link with rel: needinfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |
Read Shippingoption Needinfo From Order
Read the needinfo for the shipping option from the order. This needinfo appears when a shipping option has not been selected for the order. Needinfo links can appear on the order, the purchase form, and the delivery.
Workflow
- Start with order
GETthe link with rel: needinfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |
Read Shippingoption Needinfo From Delivery
Read the needinfo for the shipping option from the order. This needinfo appears when a shipping option has not been selected for the order. Needinfo links can appear on the order, the purchase form, and the delivery.
Workflow
- Start with delivery
GETthe link with rel: needinfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |
Read Shippingoption Needinfo From Purchaseform
Read the needinfo for the shipping option from the purchaseform. This needinfo appears when a shipping option has not been selected for the order. Needinfo links can appear on the order, the purchase form, and the delivery.
Workflow
- Start with create purchase form
GETthe link with rel: needinfo- Render the response
Response Fields
Type: controls.info
| Name | Description | Type |
|---|---|---|
name | The info object’s name. | string |