An international rateshop returns only some carriers (for example only DHL) because a Before Shipment Rates business rule that sets the Harmonized code and Terms of Sale never fires. The field the rule keys on (a UDF such as udf10) is sent only in the ship call, not in the rate call, so at rate time the rule does not fire and the carriers that need those values drop out.

Problem

On an integration or API international rateshop, some services error and drop out and you are left with only one carrier. USPS errors for a missing Harmonized code, FedEx errors for missing Terms of Sale, and UPS may drop out on its own when it does not serve the destination. The business rule that should set the Harmonized code and Terms of Sale (timing: Before Shipment Rates) does not seem to run during the rateshop.

Cause

A Before Shipment Rates rule has to run at rate time. This rule keys on a UDF field (for example udf10, mapped to a caption such as "Client" in Field Captions). Your integration sends that UDF only in the ship call, not in the rate call. At rate time the UDF is empty, so the rule does not fire, the Harmonized code and Terms of Sale are never set, and the carriers that need them error out. The ship call then offers only the carrier that did not need those values.

How to check: Compare the rate call and the ship call your integration sends for the same order. If the UDF the rule keys on is in the ship call but missing from the rate call, that is the cause.

Fix

  1. Confirm which UDF field the rule keys on (for example udf10) and its Field Captions mapping.
  2. Update your integration to send that UDF field in the rate call as well, not only the ship call. The host value must land in that exact Shipstore field.
  3. Re-run the rateshop and confirm the rule fires and the carriers that used to error now return rates.
  4. If you are not sure which field the rule needs or how it is mapped, email support@shipstore.com with an example order number and the rule name.

What you should see

The rate call now includes the UDF field, the Before Shipment Rates rule fires during the rateshop, and USPS and FedEx return rates instead of erroring. Only services that genuinely do not serve the destination are left out.

Related articles

  • A state-based rule does not fire on integration orders
  • Set the customs broker for international shipments