Shipping Rate Configuration Guide

General

  1. Status
    • Active: The shipping rate is enabled and available for customers.
    • Draft: The shipping rate is disabled and will not be displayed at checkout.
  2. Shipping Rate Name
    • This is the name displayed to customers during checkout.

    • Example: International

    • Tip: Use a clear and descriptive name that helps customers understand the rate.

  3. Phone Required
    • Yes: Customers must provide a phone number for this shipping rate.

    • No: Phone number is not required.

  4. Delivery Time Range (Optional)
    • Defines the estimated delivery time shown to customers at checkout.

    • Format: Minimum days – Maximum days.

    • Example:

      • Minimum: 1 days

      • Maximum: 3 days

    • If left empty, no estimated delivery time will be shown.

  5. Description
    • Allows you to provide additional details about this shipping rate.

    • Supports variables:

      • {delivery_range_from}: Automatically replaced with the minimum delivery time.

      • {delivery_range_to}: Automatically replaced with the maximum delivery time.

Example Description: Estimated delivery to your address between {delivery_range_from} and {delivery_range_to}.

If the delivery time range is set to 1 – 3 days, this will appear as:

    6. Shipping Tags
    • Tags help group and combine shipping rates with similar conditions.

    • Example: Cart.

    • Tip: Use the same tag for related shipping rates to avoid duplication. We will use shipping tags for combined rates.

    Best Practices

✔ Keep the Shipping Rate Name clear and relevant.

✔ Set a Delivery Time Range to improve transparency.

✔ Use Shipping Tags effectively to combine related rates.

Shipping Rates

1. Overview

Shipping rates can be manually configured using different calculation methods based on order conditions. There are two main methods to define shipping rates:

    • Use Range Values (Shipping cost is determined based on predefined ranges)
    • Base Value + Increment (Shipping cost starts from a base amount and increases incrementally)
2. Calculation Criteria
    • Determines how the shipping rate is calculated.
    • Available options (depending on app configuration):
      • Cart Total (Shipping cost is based on the total value of the cart)
      • Other custom criteria (if applicable)
2.1. Postcode Calculation Criteria

The application supports calculating shipping fees based on postal codes. You can import them or manually add them to the shipping rate.

3. Choosing Rate Input Method

You can select one of the following methods to calculate shipping rates:

A. Use Range Values

      • Defines shipping costs based on specific value ranges.
      • Example setup:

Minimum Value

Maximum Value

Price

0 VND

1,000,000 VND

20,000 VND

1,000,000 VND

5,000,000 VND

50,000 VND

5,000,000 VND

~

100,000 VND

How it Works

      • If the cart total is 700,000 VND, the shipping fee will be 20,000 VND.
      • If the cart total is 2,000,000 VND, the shipping fee will be 50,000 VND.
      • The maximum shipping rate, if specified, will set a cap on the shipping fee. Using “~” means there is no limit.

Maximum Shipping Rate

      • Defines the highest possible shipping fee that can be applied.
      • Example: If Maximum Shipping Rate is 80,000 VND, even if the calculated shipping exceeds this amount, it will be limited to 80,000 VND.

B. Base Value + Increment

Calculates shipping using a fixed base fee and additional increments based on order value.

UI fields:

      • Base Amount: Fixed starting fee for shipping.
      • Step Rate: Additional fee applied for every increment.
      • Skip Increment: Defines a threshold above which increments are skipped.
      • Increment Unit: Defines the unit for increments.

Example Setup

      • Base Amount = 30,000 VND
      • Step Rate = 10,000 VND
      • Increment Unit = 1,000,000 VND
      • Skip Increment = 5,000,000 VND

How it Works

      • For carts below 1,000,000 VND, the shipping fee is 30,000 VND.
      • For carts over 1,000,000 VND, every additional 1,000,000 VND in cart value adds 10,000 VND.
      • If the cart total exceeds 5,000,000 VND, additional increments do not apply.

Example Calculations

Cart Total

Shipping Cost

900,000 VND

30,000 VND

2,000,000 VND

40,000 VND

4,500,000 VND

60,000 VND

6,000,000 VND

80,000 VND (max limit applied)

4. Cost Type

Define how the shipping cost is applied

Available options include

      • Fixed Fee: a specific shipping amount is charged.
      • Percentage: shipping cost is calculated as a percentage of the cart total.

Best Practices

Choose the right method based on your store’s pricing strategy.

Set a reasonable maximum shipping rate to control high costs.

Use increments if your shipping cost scales with order value.

Test different configurations to see what works best for your business.

This guide explains how to configure carrier-based shipping rates using external shipping providers.

1. Carrier Service

Select the shipping carrier you want to use for calculating shipping rates.

Example: Australia POST – eParcel

The application currently supports the following carrier services.

      • Fedex
      • UPS
      • DHL Express MyDHL
      • USPS
      • Canada Post
      • Sendle
      • Australia POST Postage Assessment Calculator
      • Australia POST – eParcel
2. Maximum Shipping Rate (Optional)

Sets a cap on the shipping cost to prevent excessive charges.

If the calculated rate exceeds this amount, it will be limited to the specified value.

Example: If set to 100,000 VND, even if the carrier returns 120,000 VND, the customer will only be charged 100,000 VND.

3. Use Sandbox

Enable this option to test shipping rate calculations without affecting live orders.

Useful for debugging and setup before going live.

4. Carrier Account Authentication

If using a carrier that requires authentication, provide:

Username: Your login username for the carrier.

Secret Key: The API key or password provided by the carrier.

Account Number: Your registered account number with the carrier.

Click Validate Account to confirm that the credentials are correct.

5. Shipping Location

Defines the origin location for shipping calculations.

Options:

      • Use Shopify Location: Automatically pulls the location from Shopify settings.
      • Custom Location (if available): Allows entering a different warehouse or fulfillment center.
6. Services by Carrier

Determines how carrier shipping services are displayed to customers.

Options:

      • Show Service with Highest Rate: Displays the most expensive shipping option.
      • Show Service with Lowest Rate: Displays the cheapest available option.
      • Show all Services: Displays all rates returned by the carrier.
7. Exclude Services

Allows you to remove specific carrier services from checkout.

Example: Exclude Express Shipping if you only want to offer standard delivery.

8. Packaging Method

Determines how items are packed for shipping cost calculations.

There are three packaging methods available for determining how items are packed before calculating shipping costs:

    • Pack by Cart Attributes: Group products based on cart attributes.
    • Pack Each Product Separately: Each item is treated as an individual package.

    • AI based Packaging Algorithm: Uses AI to optimize package selection.

Each method impacts how shipping costs are calculated based on the dimensions and quantity of products.

8.1. Pack by Cart Attributes

Uses predefined cart attributes (e.g., weight, quantity) to determine package grouping.

Requires setting:

    • Package Splitting Rule:
      • Cart Quantity: Splits packages based on the number of items in the cart.
      • Cart Total: Splits packages based on the cart total.
      • Cart Weight: Splits packages based on the cart weight.
      • Cart Volume: Splits packages based on the cart volume.
      • Cart Volumetric Weight: Splits packages based on the cart volumetric weight.
    • Product Filter: You can filter which products this rule applies to using.
    • Box Configuration:
      • Define Box Max Limit (Maximum items per package).
      • Set Box Length, Width, and Height (for carrier rate calculations).
      • Optionally specify Empty Box Weight.

Example Setup

Box Max Limit

Box Length

Box Width

Box Height

Empty Box Weight

5 items

300 mm

200 mm

150 mm

0.5 kg

10 items

500 mm

400 mm

300 mm

1 kg

8.2. Pack Each Product Separately

Each product in the cart is assigned to its own package.

This method is useful when products vary in size or weight, and they cannot be grouped together for shipping.

8.3. AI-Based Packaging Algorithm

The AI-Based Packaging Algorithm automatically determines the most efficient way to pack products for shipping.

You can configure:

    • Packaging strategy (Largest package first, Smallest package first, etc.)
    • Stacking method (Lengthwise or Widthwise)
    • Predefined Package Options to improve packing accuracy.
    1. Packaging Method Settings
      • Select Algorithm
        • Largest Package First: Starts packing with the biggest available package.
        • Smallest Package First: Begins with the smallest package to minimize empty space.
      • Stacking Method
        • Stack items lengthwise: Arranges items side by side along their width.
        • Stack items widthwise: Arranges items side by side along their length.
      • Product Filter

Choose whether the packaging rules apply to all products or specific product categories.

 2. Adding Package Options

To define packaging options, click ”+ Add Package” and fill in the following details:

Package Name

        • Internal identifier (not shown to customers).
        • Helps distinguish between different package types.

Maximum Weight

        • The highest weight this package can accommodate (in grams).
        • Helps AI determine whether a package is suitable for an order.

Empty Weight (Optional)

        • The package’s weight before adding products.
        • This value is added to the total shipment weight when calculating shipping costs.

Outer Dimensions (Used for Carrier Rate Calculation)

        • Length / Width / Height (in mm).
        • These values are sent to the carrier to obtain live shipping rates.

Inner Dimensions (Used for Packing Efficiency)

        • Defines the actual space available inside the package.
        • Helps the AI algorithm determine how to fit items more effectively.

Example Package Setup

Package Name

Max Weight (g)

Empty Weight (g)

Outer Dimensions (L x W x H mm)

Inner Dimensions (L x W x H mm)

Small Box

5000 g

300 g

300 x 200 x 150

290 x 190 x 140

Medium Box

10000 g

500 g

500 x 400 x 300

480 x 380 x 280

9. Fallback Rate

Used when no carrier rates are available.

Enabling this option ensures a default shipping rate is applied when AI cannot determine a suitable package.

Shipment Adjustments

1. Overview

Shipment Adjustments allow store owners to modify shipping rates using discounts or additional service fees.

You can:

    • Apply a discount to reduce the shipping rate.
    • Set a discount threshold, meaning the discount is only applied when the shipping cost reaches a certain amount.
    • Add a service fee to increase the final shipping cost.
2. Discount Type
    • Percentage: Discount is applied as a percentage of the shipping rate.
    • Fixed Amount: A fixed-value discount is subtracted from the shipping rate.

Example:

    • If the shipping rate is 100,000 VND and a 10% discount is applied, the new shipping cost is 90,000 VND.
    • If a Fixed Discount of 20,000 VND is applied, the final shipping rate is 80,000 VND.
3. Discount

Enter the discount value based on the selected Discount Type.

Example:

    • If using Percentage, enter 10 to apply a 10% discount.
    • If using Fixed Fee, enter 20,000 VND to reduce the shipping rate by 20,000 VND.
4. Apply Discount Threshold

Defines the minimum shipping rate required before the discount is applied.

Example:

    • If set to 50,000 VND, the discount will only apply if the calculated shipping rate is 50,000 VND or higher.
    • If left blank, the discount applies to all shipping rates.
5. Service Fee

Adds an extra fee to the shipping rate.

Fee Type:

    • Fixed Fee: Adds a specific amount (e.g., 10,000 VND).
    • Percentage: Adds a percentage of the shipping cost (e.g., 5%).

Example:

    • If the shipping rate is 50,000 VND and a Fixed Service Fee of 10,000 VND is applied → The final shipping cost is 60,000 VND.
    • If a 5% Service Fee is applied, the total becomes 52,500 VND.

Best Practices

✔ Set a reasonable discount threshold to maintain profit margins.

✔ Use percentage-based discounts for scalable pricing.

✔ Apply service fees for premium shipping options.