Set up an Umpiring Charge Template

Security Note: You need the Allow the user to maintain contract charge templates security right in the Contracts domain security rights group for this activity.

Activity Steps

  1. Open the Contract Charge Templates.
  2. Right-click in the Contract Charges field group and select New » Umpiring Charge from the menu.
  3. Update the Name if required.
  4. Enter general details for the umpiring charge. See Enter General Details for a Charge.
  5. Enter conditions for the umpiring charge. See Limit the Applicability of a Charge.
  6. Configure the value type of the umpiring charge:
    1. Select the Value Type from:
      • Fixed (default)—The charge is defined by the Value.
      • Calculated—The charge is calculated with a formula created in the Expression Editor.
      • Tiered—The charge is determined by tier levels defined on the Tier Group tab.
      • Premium Matrix—The charge is determined from the selected premium matrix, and optionally from tier levels within the premium matrix. See Premium Matrixes.
    2. If the Value Type is Fixed, enter the Value.
    3. If the Value Type is Calculated, select a tested expression or create an expression for the Calc. Expression.
    4. If the Value Type is Tiered, enter tiers. See Enter Tiers for a Charge.
    5. If the Value Type is Premium Matrix:
      1. Select the Premium Matrix from the premium matrixes defined in the Premium Matrix Editor.
      2. If the premium matrix has a Tier Basis of Price, select whether to Use Premium Matrix Tier. If unchecked, the value from the Premium Matrix Rates table is used. If checked, the value is determined from the tiers configured for the premium matrix. The tier entry point is based on the price:
        • The payable analyte price for payable analyte charges
        • The main analyte price for contract term charges in contracts with analyte pricing
        • The product price for contract term charges in contracts with product pricing
  7. Configure the resulting value of the umpiring charge:
    1. Select the Value Basis to define what the calculated result affects on the invoice. Select from:
      • Umpire Lot (default)—Same as Won Umpire Lot.
      • Lost Umpire Lot—Calculated based on the number of lost and shared umpire lots.
      • Won Umpire Lot—Calculated based on the number of won and shared umpire lots.
    2. Complete the following fields on the Resulting Value tab as required.
      • Currency—Select from the currencies defined in the Currency/Exchange Editor.
      • Unit—Set to ea for each by default. Should be cleared if the Value Type is Calculated and based on either the =UmpiringCost() or =UmpiringCostPerAnalyte("AnalyteName") Expression Editor function.
      • Value Decimals—Number of decimal places to which to round the resulting value.
      • Minimum Output—Minimum value of the resulting value.
      • Maximum Output—Maximum value of the resulting value.
      • Apply To Base Unit Price—Whether the adjustment will roll up into the base unit price. If checked, other invoice line items that are calculated on the unit price will use the adjusted price. If unchecked, other invoice line items that are calculated on the unit price will use the base unit price.
      • Affect—What is affected by the resulting value. For contracts with analyte pricing, select from None and Invoice Value. For contracts with product pricing, select from:
        • None—The resulting value displays on the invoice, but does not affect the invoice value.
        • Invoice Value—The resulting value is included in the invoice as a separate line item.
        • Revenue Value—The resulting value is included in the calculation of the revenue line item.

        Example: A despatch order has a mass of 35,222.250 mt, a price of 50.50 USD/mt and a charge that results in 1.58 USD/mt. If the charge affects Revenue Value, the revenue line item is calculated:

        Price = (50.50 + 1.58 ) = 52.08
        Revenue Value = 52.08 * 35,222.50 = 1,834,374.78 USD
      • Excluded in FOB Value—Whether the resulting value is excluded in the FOB value. See Delivery Terms.
  8. Click Save.