Enhancing ESHOPMAN Shipping: Introducing Weight-Based Pricing for Smarter Logistics

For e-commerce merchants, accurately reflecting shipping costs is crucial for profitability and customer satisfaction. While order value is a common factor, businesses shipping physical goods—from board games to apparel—often find that carriers primarily charge by weight. This creates a significant challenge for platforms that don't natively support weight-based shipping rules.

At ESHOPMAN, our community frequently discusses ways to enhance the platform's capabilities. A recent, vital discussion highlighted the pressing need for more sophisticated shipping price rules, specifically the ability to factor in the total weight of a customer's cart. This feature is particularly important for ESHOPMAN merchants who manage their storefronts through HubSpot CMS and rely on precise logistics for their operations.

The Challenge: When Order Value Isn't Enough for Shipping

Many ESHOPMAN merchants find themselves limited when shipping options are based solely on item_total (order value). Consider a scenario where a lightweight, high-value item and a heavy, low-value item need shipping. Basing costs purely on order value can lead to:

• Inaccurate Pricing: Overcharging light, expensive orders or undercharging heavy, inexpensive ones, impacting profit margins.
• Operational Headaches: Merchants resort to fragile workarounds, manual price adjustments, or complex external services, adding unnecessary complexity to their ESHOPMAN-powered stores.
• Migration Pain Points: Businesses migrating to ESHOPMAN from platforms with robust weight-based shipping often face a complete redesign of their pricing strategy.

What ESHOPMAN merchants truly need is the flexibility to define shipping options with rules like "if cart weight is between X and Y, charge Z," mirroring how carriers structure their rate cards.

The ESHOPMAN Solution: Integrating Weight-Based Shipping

The ESHOPMAN team is actively addressing this by proposing to introduce weight as a first-class conditional dimension for flat-rate shipping options. This enhancement will empower merchants to create highly accurate and automated shipping price rules directly within their ESHOPMAN administration, accessible through their HubSpot environment.

The proposed solution involves several key technical integrations:

1. Cart Line Item Weight: ESHOPMAN will persist a unit_weight on each cart_line_item, inherited from the product variant's weight (or falling back to the product's weight).
2. Cart Weight Total: A new weight_total will be computed across line item totals and the entire cart. This total will be exposed on CartLineItemDTO and CartDTO for pricing calculations via the Store API.
3. Admin API Price Rule Attribute: The weight_total attribute will be whitelisted in ESHOPMAN's shipping option price-rule attribute enum. This allows the platform's checkout process to automatically select the correct shipping price based on the cart's total weight.
4. HubSpot Admin Dashboard Integration: ESHOPMAN's HubSpot-integrated admin dashboard will offer weight_total as an option in the shipping option conditional price form, including range-overlap validation for clear weight bands.

Example: Defining a Weight-Based Shipping Rule via ESHOPMAN Admin API

Here’s an illustrative example of how an ESHOPMAN shipping option could be configured to include weight-based pricing rules using the Admin API:

await sdk.admin.shippingOption.create({
  name: "Standard Shipping",
  service_zone_id: "serzo_123",
  shipping_profile_id: "sp_123",
  provider_id: "manual",
  price_type: "flat",
  type: { label: "Standard", description: "Standard shipping", code: "standard" },
  prices: [
    // default price
    { currency_code: "usd", amount: 10, rules: [] },
    // price if cart weight is 5000g or more
    {
      currency_code: "usd",
      amount: 15,
      rules: [{ attribute: "weight_total", operator: "gte", value: 5000 }],
    },
  ],
})

These weight_total rules combine with existing item_total rules, providing powerful and flexible pricing logic for your ESHOPMAN storefront deployed via HubSpot CMS.

Benefits for ESHOPMAN Merchants

This upcoming feature will significantly enhance the ESHOPMAN experience, offering:

• Accurate Pricing: Eliminate overcharging or undercharging, leading to better profit margins and customer trust.
• Simplified Operations: Reduce manual adjustments and complex workarounds, streamlining checkout and order fulfillment.
• Seamless Migrations: Ease the transition for stores moving to ESHOPMAN, allowing them to replicate existing weight-based shipping structures.
• Enhanced Flexibility: Leverage ESHOPMAN's headless architecture and Admin API for sophisticated pricing strategies.

The ESHOPMAN team is committed to continuously evolving the platform. This feature is currently in progress, demonstrating our dedication to providing robust, flexible, and merchant-centric solutions for your HubSpot-integrated storefronts.