ShippingOption
A Shipping Option represents a way in which an Order or Return can be shipped. Shipping Options have an associated Fulfillment Provider that will be used when the fulfillment of an Order is initiated. Shipping Options themselves cannot be added to Carts, but serve as a template for Shipping Methods. This distinction makes it possible to customize individual Shipping Methods with additional information.
Properties
id
stringRequiredThe shipping option's ID
created_at
DateRequiredThe date with timezone at which the resource was created.
updated_at
DateRequiredThe date with timezone at which the resource was updated.
deleted_at
null | DateRequiredThe date with timezone at which the resource was deleted.
name
stringRequiredThe name given to the Shipping Option - this may be displayed to the Customer.
region_id
stringRequiredThe ID of the region this shipping option can be used in.
The details of the region this shipping option can be used in.
profile_id
stringRequiredThe ID of the Shipping Profile that the shipping option belongs to.
The details of the shipping profile that the shipping option belongs to.
provider_id
stringRequiredThe ID of the fulfillment provider that will be used to later to process the shipping method created from this shipping option and its fulfillments.
The details of the fulfillment provider that will be used to later to process the shipping method created from this shipping option and its fulfillments.
The type of pricing calculation that is used when creatin Shipping Methods from the Shipping Option. Can be flat\_rate
for fixed prices or calculated
if the Fulfillment Provider can provide price calulations.
flat\_rate
for fixed prices or calculated
if the Fulfillment Provider can provide price calulations.amount
null | numberRequiredThe amount to charge for shipping when the Shipping Option price type is
flat\_rate
.is_return
booleanRequiredFlag to indicate if the Shipping Option can be used for Return shipments.
Default: false
admin_only
booleanRequiredFlag to indicate if the Shipping Option usage is restricted to admin users.
Default: false
The details of the requirements that must be satisfied for the Shipping Option to be available for usage in a Cart.
data
Record<string, unknown>RequiredThe data needed for the Fulfillment Provider to identify the Shipping Option.
metadata
Record<string, unknown>RequiredAn optional key-value map with additional details
includes_tax
booleanRequiredWhether the shipping option price include tax
Default: false
Was this section helpful?