Shipments
A shipment lists the shipments created by a purchase.
Read Shipping Address For Shipment
Retrieve the shipment address associated with a shipment.
Workflow
- Start with shipment
GET
the link with rel: destination- Render the response
Response Fields
Type: addresses.address
Name | Description | Type |
---|---|---|
name | The customer name. | object |
given-name | The person’s given name. | string |
family-name | The person’s family name. | string |
address | The customer address. Address field names are based on the v.card specification. For more information on this specification, see v.card. | object |
street-address | The street address. | string |
extended-address | Extra field for address information. This field is optional. | string |
locality | The city name. | string |
region | Valid region codes for this field can be retrieved using the Geographies Resource. | string |
postal-code | Postal code or zip code. | string |
country-name | Valid country codes for this field can be retrieved using the Geographies Resource. | string |
phone-number | Phone number | string |
organization | The organization | string |
Read Shipment Line Items
Retrieve the shipment line items associated with a shipment.
Workflow
- Start with shipment
GET
the link with rel: lineitems- Render the response
Read Shipment Line Item
Read a shipment line item.
Workflow
- Start with shipment-line-items
GET
the link with rel: element- Render the response
Response Fields
Type: shipments.line-item
Name | Description | Type |
---|---|---|
name | The name. | string |
quantity | The quantity. | integer |
Read Shipment Line Item Options
Retrieve the options associated with a shipment line item.
Workflow
- Start with shipment-line-item
GET
the link with rel: options- Render the response
Read Shipment Line Item Option
Read a shipment line item option.
Workflow
- Start with shipment-line-item-options
GET
the link with rel: element- Render the response
Response Fields
Type: shipments.option
Name | Description | Type |
---|---|---|
name | The name. | string |
display-name | The display name. | string |
Read Shipment Line Item Option Value
Retrieve the option value associated with a shipment line item.
Workflow
- Start with shipment-line-item-option
GET
the link with rel: value- Render the response
Response Fields
Type: shipments.value
Name | Description | Type |
---|---|---|
name | The name. | string |
display-name | The display name. | string |
Read Shipping Option For Shipment
Retrieve the shipment options associated with a shipment.
Workflow
- Start with shipment
GET
the link with rel: shippingoption- Render the response
Response Fields
Type: shipmentdetails.shipping-option
Name | Description | Type |
---|---|---|
name | Name of the shipping option. | string |
display-name | The localized name of the carrier, intended for display in the client application. | string |
carrier | 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 |
Read Shipments For Purchase
Retrieve the shipments associated with a purchase.
Workflow
- Start with purchase
GET
the link with rel: shipmentsGET
the link with rel: element- Render the response
Response Fields
Type: shipments.shipment
Name | Description | Type |
---|---|---|
status | Indicates the status of the shipment. | object |
code | The status code. | string |