BeikeShop Multi-Origin Shipping

Overview

Multi-Origin Shipping is designed for stores that fulfill products from multiple warehouses, cities, or other fulfillment locations.

The plugin groups cart products by shipping origin, matches a shipping rule for each origin, calculates each fee separately, and combines the fees into one shipping method at checkout. Customers do not need to choose warehouses separately.

Features

• Configure multiple shipping origins
• Set a default shipping origin
• Assign a specific shipping origin to each product
• Automatically use the default origin for products without an assigned origin
• Configure rules by region group, destination country, and destination zone
• Support all-country and all-zone fallback rules
• Configure base shipping fee, per-item surcharge, and free-shipping threshold
• Split and calculate fees for orders containing products from multiple origins
• Show one Multi-Origin Shipping method at checkout
• Let customers view shipping fees by origin
• Save and display shipping details in order details
• Support Chinese and English

Configuration Flow

Complete the configuration in this order:

1. Maintain origins -> 2. Configure shipping rules -> 3. Assign origins to products

Step 1: Maintain Origins

Open:

Admin -> Plugin Management -> Multi-Origin Shipping -> Settings

Click Add origin and configure the following fields:

Origin codes support letters, numbers, hyphens, and underscores only:

guangzhou_01
CN-SC-CD

The code is not a customer address code or a product attribute. Without an external warehouse or data integration requirement, use a short and maintainable identifier.

At least one origin must be enabled, and one enabled origin must be selected as the default.

Step 2: Configure Shipping Rules

Each rule applies to one origin and a destination scope.

Fee calculation:

Shipping fee = Base shipping fee + Per-item surcharge x item quantity

When the origin subtotal reaches the free-shipping amount, the fee for that origin is 0.

Region Group Matching

Region groups are managed in BeikeShop under Admin -> Regions. A region group is made up of country and zone associations. A zone value of 0 means all zones within that country.

Region groups can be combined with the country and zone fields in a shipping rule. All selected conditions must match the customer's address.

The matching priority is based on how specific the rule is:

Origin + Region group + Country + Zone
Origin + Region group + Country
Origin + Region group
Origin + Country + Zone
Origin + Country
Origin + All destinations

For example, a rule for East China region group + China / Jiangsu only matches a Jiangsu address that belongs to the selected region group. It takes priority over a broader Guangzhou + All destinations rule.

Step 3: Assign an Origin to Products

When editing a product, select an origin in the Shipping Origin field.

• Select a specific origin when the product must be fulfilled from a fixed warehouse.
• Select Use default origin to use the configured default origin.
• Leaving the field unassigned also makes checkout use the default origin.

Checkout Behavior

One Origin

When all shippable products use the same origin, checkout shows one Multi-Origin Shipping method and calculates the fee using that origin's matching rule.

Multiple Origins

When cart products use multiple origins, the plugin:

1. Groups products by origin.
2. Matches the region group, destination country, and destination zone for each origin.
3. Calculates each origin's shipping fee.
4. Combines all origin fees into the order shipping total.

The shipping method name remains Multi-Origin Shipping. Warehouse names are not appended to the method name. Customers can open the shipping fee details to see each origin, item quantity, and fee.

Example:

Guangzhou Warehouse: Product A x 1, shipping fee 6
Chengdu Warehouse: Product B x 2, shipping fee 2
Total shipping fee: 8

If any origin has no matching enabled rule, the Multi-Origin Shipping method is not available. Check that every origin in the cart is enabled and has a rule matching the customer's region group, country, and zone.

FAQ

Why is Multi-Origin Shipping not available?

Check the following:

1. At least one origin is enabled.
2. An enabled default origin is selected.
3. The origin assigned to each product is enabled.
4. Every origin in the cart has an enabled shipping rule.
5. The region group, country, and zone in the rule match the customer's address.
6. The base fee and per-item surcharge are configured correctly.

Does a product without an origin break multi-origin checkout?

No. Products without an assigned origin automatically use the default origin. The default origin must have a matching enabled rule.

Why are no destination zones shown?

Select a destination country first. The plugin then loads only zones belonging to that country. City and county are not part of this plugin's rule configuration.

Is the origin code shown to customers?

No. The code is for internal identification and future integrations. Customers see the origin name and shipping fee details instead.

Can one origin have multiple rules?

Yes. You can create rules for region groups, countries, zones, and all destinations. More specific rules take priority.