Variable Handling Coding Details

The elements required to add variable handling charges to your shipment rate quote are provided in the ShipService WSDL. The following table contains variable handling elements:

Element Required Requirements
VariableHandlingChargeDetail/RateTypeBasisType/RateTypeBasis   The rate type. Valid values are:
  • ACCOUNT: Uses the customer’s account rate as the basis for the handling calculation.
  • LIST: Uses the FedEx List rate as the basis for the handling calculation.
VariableHandlingChargeDetail/RateElementBasisType/ RateElementBasis Required The charge upon which the variable handling amount is calculated. Valid values are:
  • BASE_CHARGE: This value is the base transportation charge.
  • NET_CHARGE_EXCLUDING_TAXES: This value is the net freight plus surcharges and taxes.
  • NET_CHARGE_EXCLUDING_TAXES: This value is the net freight plus surcharges.
  • NET_FREIGHT: This value is the base charge less discounts.
VariableHandlingChargeDetail Required Valid values are:
  • FIXED_AMOUNT: This value is used if you want to add a fixed handling charge to all shipments.
  • PERCENTAGE_OF_NET_CHARGE: This value is used if you want to have a variable handling charge calculated on the entire net charge of the shipment, including all surcharges.
  • PERCENTAGE_OF_NET_CHARGE_EXCLUDING_TAXES: This value is used if you are a Canada-origin shipper and want to exclude Canadian taxes from the variable handling charge net percentage.
  • PERCENTAGE_OF_NET_FREIGHT: This value is used if you want to have the variable handling charge calculated as a percentage of the net freight charge, excluding any other surcharges levied on the shipment.
VariableHandlingChargeDetail/FixedValue Conditional If you choose FIXED_AMOUNT as the ChargeType, this element allows you to enter the fixed value of the handling charge. The element allows entry of 7 characters before the decimal and 2 characters following the decimal. For example: if you want to enter a fixed handling amount of $5.00, enter 5.00 in the FixedValue element.
VariableHandlingChargeDetail/ PercentValue Conditional If you choose one of the percentage handling charges in the VariableHandlingChargeType element, this element allows you to enter the percent value of the handling charge to be calculated. The element allows entry of 7 characters before the decimal and 2 characters following the decimal. For example, if you want to enter a variable handling amount of 10%, enter 10.00 in the PercentValue element.
VariableHandlingCharges/ VariableHandlingCharge Optional The variable handling charge amount calculated based on the requested variable handling charge detail.
Note: Variable handling charges may be processed at shipment level or package level except for Express multiple piece shipments, which must be processed at the Shipment level.