Discounts and Uplifts > Rating Discounts and Uplifts > Creating System Values for Freight Discounts and Uplifts
  
Creating System Values for Freight Discounts and Uplifts
Use the hierarchy/precedence system values in Freight Discount/Uplift Configuration for configuration. You can configure the discount or uplift for a specific Service and Packing Location, specific Carrier and Packing Location, or more generic configuration across all Packing Locations or across all Services.

Freight Discount/Uplift Configuration
 
Category
Key
Value
SPS
FRT UPLIFT: xxxx – yyy
Discount/uplift for a chosen service and Packing Location.
• xxxx is the service in option RT.
• yyy is the Packing Location. The shipper may use the same set of rates for multiple Packing Locations, but choose to have different discounts, or uplifts, per Packing Location.
Example:
FRT UPLIFT: RTTEST1 – ABC
The system value key for a freight uplift/discount for service RTTEST1 and Packing Location ABC.
[Uplift Detail-1]|[Uplift Detail-2]|
Each [Uplift Detail] entry can contain:
CTRY:Country Code(s);STATE:State Code(s);POSTAL:Postal Code(s);CARRIERDISC:Carrier Percent;CARRIERFIXED:Carrier Fixed Value;CARRIERMIN:Carrier Minimum; CARRIERCOSTTYPE: Carrier Cost Type(s); CARRIERCOSTCODE:Carrier Cost Code(s); CUSTOMERDISC:Customer Percent;CUSTOMERFIXED:Customer Fixed Value;CUSTOMERMIN:Customer Minimum; CUSTOMERCOSTTYPE:Customer Cost Type(s);CUSTOMERCOSTCODE:Customer Cost Code(s); CUSTOMERUSESCARRIERVALUE:[yes/no]
SPS
FRT UPLIFT: CARR: xxxx - yyy
Discount/uplift for a chosen carrier and Packing Location.
• xxxx is the global carrier.
• yyy is the Packing Location. The shipper may use the same set of rates for multiple Packing Locations, but choose to have different discounts, or uplifts, per Packing Location.
Example:
FRT UPLIFT: CARR: UPS – ABC
The system value key for a generic freight uplift/discount for carrier UPS and Packing Location ABC.
[Uplift Detail-1]|[Uplift Detail-2]|
Each [Uplift Detail] entry can contain:
CTRY:Country Code(s);STATE:State Code(s);POSTAL:Postal Code(s);CARRIERDISC:Carrier Percent;CARRIERFIXED:Carrier Fixed Value;CARRIERMIN:Carrier Minimum; CARRIERCOSTTYPE: Carrier Cost Type(s); CARRIERCOSTCODE:Carrier Cost Code(s); CUSTOMERDISC:Customer Percent;CUSTOMERFIXED:Customer Fixed Value;CUSTOMERMIN:Customer Minimum; CUSTOMERCOSTTYPE:Customer Cost Type(s);CUSTOMERCOSTCODE:Customer Cost Code(s); CUSTOMERUSESCARRIERVALUE:[yes/no]
SPS
FRT UPLIFT: xxxx
Discount/uplift for a chosen Service across all Packing Locations.
• xxxx is the service in option RT.
Example:
FRT UPLIFT: RTTEST2
The system value key for a generic freight uplift/discount for service RTTEST2.
[Uplift Detail-1]|[Uplift Detail-2]|
Each [Uplift Detail] entry can contain:
CTRY:Country Code(s);STATE:State Code(s);POSTAL:Postal Code(s);CARRIERDISC:Carrier Percent;CARRIERFIXED:Carrier Fixed Value;CARRIERMIN:Carrier Minimum; CARRIERCOSTTYPE: Carrier Cost Type(s); CARRIERCOSTCODE:Carrier Cost Code(s); CUSTOMERDISC:Customer Percent;CUSTOMERFIXED:Customer Fixed Value;CUSTOMERMIN:Customer Minimum; CUSTOMERCOSTTYPE:Customer Cost Type(s);CUSTOMERCOSTCODE:Customer Cost Code(s); CUSTOMERUSESCARRIERVALUE:[yes/no]
SPS
FRT UPLIFT: CARR: xxxx
Discount/uplift for a chosen carrier across all packing locations.
• xxxx is the global carrier.
 
Example:
FRT UPLIFT: CARR: FEDEX
The system value key for a generic freight uplift/discount for carrier FEDEX.
[Uplift Detail-1]|[Uplift Detail-2]|
Each [Uplift Detail] entry can contain:
CTRY:Country Code(s);STATE:State Code(s);POSTAL:Postal Code(s);CARRIERDISC:Carrier Percent;CARRIERFIXED:Carrier Fixed Value;CARRIERMIN:Carrier Minimum; CARRIERCOSTTYPE: Carrier Cost Type(s); CARRIERCOSTCODE:Carrier Cost Code(s); CUSTOMERDISC:Customer Percent;CUSTOMERFIXED:Customer Fixed Value;CUSTOMERMIN:Customer Minimum; CUSTOMERCOSTTYPE:Customer Cost Type(s);CUSTOMERCOSTCODE:Customer Cost Code(s); CUSTOMERUSESCARRIERVALUE:[yes/no]
SPS
FRT UPLIFT: ALL – yyy
Discount/uplift for all services.
• yyy is the Packing Location. The shipper may use the same set of rates for multiple Packing Locations, but choose to have different discounts, or uplifts, per Packing Location.
Example:
FRT UPLIFT: ALL – ABC
The system value key for a freight uplift/discount for all services for Packing Location ABC.
[Uplift Detail-1]|[Uplift Detail-2]|
Each [Uplift Detail] entry can contain:
CTRY:Country Code(s);STATE:State Code(s);POSTAL:Postal Code(s);CARRIERDISC:Carrier Percent;CARRIERFIXED:Carrier Fixed Value;CARRIERMIN:Carrier Minimum; CARRIERCOSTTYPE: Carrier Cost Type(s); CARRIERCOSTCODE:Carrier Cost Code(s); CUSTOMERDISC:Customer Percent;CUSTOMERFIXED:Customer Fixed Value;CUSTOMERMIN:Customer Minimum; CUSTOMERCOSTTYPE:Customer Cost Type(s);CUSTOMERCOSTCODE:Customer Cost Code(s); CUSTOMERUSESCARRIERVALUE:[yes/no]
SPS
FRT UPLIFT: ALL
Discount/uplift for all Packing Locations.
This is the system value key for a freight uplift/discount for all services.
[Uplift Detail-1]|[Uplift Detail-2]|
Each [Uplift Detail] entry can contain:
CTRY:Country Code(s);STATE:State Code(s);POSTAL:Postal Code(s);CARRIERDISC:Carrier Percent;CARRIERFIXED:Carrier Fixed Value;CARRIERMIN:Carrier Minimum; CARRIERCOSTTYPE: Carrier Cost Type(s); CARRIERCOSTCODE:Carrier Cost Code(s); CUSTOMERDISC:Customer Percent;CUSTOMERFIXED:Customer Fixed Value;CUSTOMERMIN:Customer Minimum; CUSTOMERCOSTTYPE:Customer Cost Type(s);CUSTOMERCOSTCODE:Customer Cost Code(s); CUSTOMERUSESCARRIERVALUE:[yes/no]
Note: A shipper configures freight uplift system values per Packing Location, and also a system value with no Packing Location for the same Service. In this case, the system value with the Packing Location takes precedence when that is the Packing Location on the shipment being rated.
The freight uplift/discount might apply at different levels for a particular service. Levels include:
• Country
• State
• Postal Code range
• General/All
Each [Uplift Detail] section is made up of subsections that determine the rules that apply to the freight uplift/discount percentage. These subsections are not mandatory, so an [Uplift Detail] section can contain some or all subsections, as in Examples of Configuration for Freight Discount/Uplifts. Each of these subsections is separated by a semicolon. The subsections are:
• CTRY:Country Code(s) identifies a set of countries for which the rule applies. Enter a comma-separated list of ISO country codes.
• STATE:State Code(s) identifies a set of state codes within the countries identified in the previous subsection rule. Enter a comma-separated list.
• POSTAL:Postal Code(s) identifies a set of postal codes, or postal code ranges, within the countries identified in a previous subsection rule. Enter a postal code or postal code range in a comma-separated list. Each range is divided by a minus character (-).
• CARRIERDISC:Carrier % identifies the uplift/discount percentage to apply to the base freight rate, based on the discount/uplift that the carrier applies to the base rate. For discounts, the value must be negative.
• CARRIERFIXED:Carrier Fixed identifies the fixed value uplift to apply to the base freight rate, based on the fixed value uplift/discount that the carrier applies to the base rate. For discounts, the value must be negative. Fixed value is applied after the percentage, if any.
• CARRIERMIN:Carrier Min identifies the minimum charge value to be applied to the calculated freight rate—after applying both or either of Carrier % and Carrier Fixed—when the calculated value falls below a minimum specified by the carrier.
• CARRIERCOSTTYPE:Carrier Cost Type(s) identifies the cost types to which the discount/uplift is applied for the carrier charges. These cost types can be specified from a list of prescribed values for different cost types contained in Black Box Guide - 901 - Message Field Lookups.xls. If no cost types are specified, the default is to uplift/discount FREIGHT and FUEL cost types.
• CARRIERCOSTCODE:Carrier Cost Codes(s) identifies the cost codes to which the discount or uplift is applied for the carrier charges. When a specific set of cost codes specified in option CH must be uplifted/discounted, this value is used.
• CUSTOMERDISC:Customer % identifies the discount/uplift percentage to apply to the base freight rate based on the discount/uplift that the shipper applies to the base rate when charging the customer. For discounts, the value must be negative.
• CUSTOMERFIXED:Customer Fixed identifies the fixed value uplift to apply to the base freight rate, based on the fixed value discount/uplift that the shipper applies to the base rate when charging the customer. For discounts, the value must be negative. Fixed value is applied after the percentage, if any.
• CUSTOMERMIN:Customer Min identifies the minimum charge value to apply to the calculated freight rate—after applying both or either of Customer % and Customer Fixed—when the calculated value falls below a minimum that the carrier specified.
• CUSTOMERCOSTTYPE:Customer Cost Type(s) identifies the cost types to which the discount/uplift is applied for the customer charges. These cost types can be specified from a list of prescribed values for different cost types contained in Black Box Guide - 901 - Message Field Lookups.xls. If no cost types are specified, the default is to uplift/discount FREIGHT and FUEL cost types.
• CUSTOMERCOSTCODE:Customer Cost Codes(s) identifies the cost codes to which the discount/uplift is applied for the customer charges. When a specific set of cost codes specified in option CH must be uplifted/discounted, this value is used.
• CUSTOMERUSESCARRIERVALUE:[yes/no] determines whether the customer charge is to be calculated as an uplift/discount applied to the already calculated carrier charge value; for example, CUSTOMERUSESCARRIERVALUE:YES.
Note: To make the rules more readable, split the [Uplift Detail] sections across lines using a carriage-return.
Examples of Configuration for Freight Discount/Uplifts
 
Category
Key
Value
Rules
SPS
FRT UPLIFT: RTTEST1 – ABC
CTRY:US;
STATE:CA,KS,CO;
CARRIERDISC:-25|
CTRY:US;
POSTAL:90210-90299,90400;
CARRIERDISC:-15;
CARRIERFIXED:-1|
CTRY:US;
CARRIERDISC:-10|
CARRIERDISC:-8;
CARRIERMIN:49
For the RTTEST1 service and Packing Location ABC:
• 25% carrier discount for states CA, KS and CO for country US
• 15% carrier discount and a subsequent $1 discount, for postal codes 90210 - 90299 and for postal code 90400 for country US.
• 10% carrier discount for country US for other states or postal codes.
• 8% carrier discount otherwise.
• $49 minimum charge to apply when discounted/uplifted charge is less than $49.
• If an [Uplift Detail] entry in a general unconditioned rule contains an element in the rules subsections not found in an earlier conditioned rule, this element is also applied to the conditioned rule. In this example, the minimum charge of $49 from the general rule is applied to all more specific rules because no specific rule includes a CARRIERMIN element.
SPS
FRT UPLIFT: RTTEST2
CUSTOMERDISC:10;
CUSTOMERCOSTTYPE:FREIGHT,EXTENDEDAREA
For the RTTEST2 service and all Packing Locations, unless there is a system value with higher precedence specified:
• 10% uplift to the charge applied by the shipper to the customer. This uplift is only applied to cost types of type FREIGHT and EXTENDEDAREA.
SPS
FRT UPLIFT: RTTEST3
CUSTOMERDISC:8;
CUSTOMERCOSTCODE:QFRT,QMULTI
 
For the RTTEST3 service and all Packing Locations, unless there is a system value with higher precedence specified:
• 8% uplift to the charge applied by the shipper to the customer. This uplift is only be applied to costs of code QFRT and QMULTI.
SPS
FRT UPLIFT: RTTEST2
10
The system value represents a discount/uplift to a customer.