Shipping methods
The shipping method object and the allowed CRUD operations on the related resource endpoint
Shipping methods are used to provide customers with different delivery options.
Shipping methods are defined by currency and can be restricted to an active market (in the latter case the currency is inherited by the market's price list).
- Set the
shipping_categoryrelationship if you want the shipping method to be available only if the items to be shipped belong to a specified shipping category. - Set the
shipping_zonerelationship if you want the shipping method to be available only if the shipping address belongs to a specified shipping zone. - Set the
stock_locationrelationship if you want the shipping method to be available only if the items are shipped from a specific stock location. - Specify a value for the
min_weightand/ormax_weightattributes (to do that also aunit_of_weightmust be defined) if you want the shipping method to be available only if the total weight of the items to be shipped falls within those values.
The total weight of the shipment is automatically calculated from the single weights of the items included (i.e. the
weight attribute of the SKUs to be shipped).Each shipping method can have a price and can be free over a specific order's total amount. Set the
use_subtotal attribute to true (default is false) if you want to compare the free over amount with the order's subtotal and exclude other discount calculations (if any).Set the proper value for the
scheme attribute (default is flat) to define how you want to manage the shipping method cost:flat— the shipping method has a fixed price (equal to the value of theprice_amount_centsattribute).weight_tiered— the shipping method price is tiered based on the total weight of the items included in the shipment (a maximum of 5 tiers for each shipping method is currently supported). See shipping weight tiers to learn more.external— the shipping method price is fetched from an external service which handles the custom calculation, overriding theprice_amount_centsset at creation time (remember to specify theexternal_prices_urlwhen creating or updating the shipping method).
If a
free_over_amount was specified, it applies regardless of the tier. If a min_weight and/or max_weight value for the shipping method's availability was specified, only the tiers between those values will be considered.Check the related ER diagram and explore the flowchart that illustrates how the shipping method resource relates to the other API entities.
Check the related guide to learn how to let a user choose one of the available shipping methods during the checkout. Learn how to manage the shipping methods cost via external services.
Last modified 3mo ago