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

1. Start with delivery
2. GET the link with rel: destinationinfo
3. 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

1. Start with delivery
2. GET the link with rel: shippingoptioninfo
3. 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

1. Start with shipping-option-info
2. GET the link with rel: shippingoption
3. 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

1. Start with shipping option info
2. GET the link with rel: selector
3. GET the link with rel: choice
4. GET the link with rel: chosen
5. GET the link with rel: description
6. POST the 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

1. Start with order
2. GET the link with rel: needinfo
3. 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

1. Start with delivery
2. GET the link with rel: needinfo
3. 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

1. Start with create purchase form
2. GET the link with rel: needinfo
3. 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

1. Start with order
2. GET the link with rel: needinfo
3. 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

1. Start with delivery
2. GET the link with rel: needinfo
3. 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

1. Start with create purchase form
2. GET the link with rel: needinfo
3. Render the response

Response Fields

Type: controls.info

Name	Description	Type
name	The info object’s name.	string