Articles in this section

How to Apply Discounts to Customs Value via Automation Rules

By default, order discounts are not automatically applied to the customs value in ShipHero. To reflect a discounted price on your customs declarations, you must enable this feature using an automation rule. 

For more information about how the customs value of a product is identified, please visit our article on Customs Values and Kits.

Important Limitations and Requirements

  • Discount Amount Required: If the Discount Amount field is empty or set to $0, no discount will be applied to the customs value, even if the automation rule is turned on.
  • Editing Window: You can manually edit or enter the discount amount at any time before the label is generated. ShipHero uses the specific amount present in the system at the exact moment of shipping to calculate the final value.
  • 100% Discounts: Discounts cannot be applied if they cover 100% of the order value. In these cases, the system will use the full customs value.

Tax Liability Note: Even for free or heavily discounted shipments, items are still subject to duties and taxes. As the exporter, you are responsible for including customs-only value statements on your commercial invoices.

How to Enable This Feature

To apply discounts to your customs forms, create an automation rule with the Action: Apply Discount to Customs Value set to "On". When this rule is active, ShipHero enables a flag for the order. At the moment your shipping label is generated, the system calculates the discount percentage and applies it to each line item’s customs value.

How the Discount is Calculated

The system determines the discount percentage by comparing the total discount amount to the order subtotal.

Discount % = (Discount Amount / Order Subtotal) * 100

Discount Example:

  • Order Subtotal: $100.00
  • Discount Amount: $20.00
  • Result: A 20% discount will be subtracted from the customs value of every item in that shipment.
Was this article helpful?
2 out of 9 found this helpful

More Resources

  • ShipHero Public API

    Connect your tools and AI agents directly to ShipHero with the Public API. Build powerful integrations, automate workflows, and tap into real-time data using the AI tools you prefer, with the option for secure, read-only access for AI-driven insights without added risk.

  • ShipHero Academy

    Explore ShipHero Academy for certifications, deep-dive training, and expert-led courses on WMS and fulfillment. Build your expertise and help your team operate at a higher level.

  • Change Log

    Stay up to date with the latest improvements across ShipHero. The Change Log gives you a clear view of new features, enhancements, and fixes as they roll out—so you always know what’s new and what’s better.