Skip to main content

Charge Calculation Fields

Charge calculation fields represent fields that use other fields as inputs to generate a line item order upon order submission. Charge calculation fields may be either optional or required. Fields marked as optional may be submitted with 0 or undefined/null values and the results will be ignored/dropped if invalid resulting in no line item will be created for that field. Required fields will need to have a valid final value prior to submission. Forms will generate 1 line item in the order per valid charge calculation field result.

Valid input field types for Charge Calculation Fields include the following field types:

  • Number
  • Dropdown
  • Select

Dropdown and Select field options MUST be valid parse-able floating point values. Invalid values will result in an error message (See: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseFloat ). Dropdown/Select values MUST take the format of either a number OR "<select_value>@<value_floating_point_number>".

Ex: "gold@123.45"

Managers may test numerical values in the the "Test Results" section to observe field calculation results behavior. All available fields with valid types will be listed as inputs in the test results section. For additional information on the math engine used for handling the equation strings see https://mathjs.org/ 

Note that both an Internal and Commercial Cost Equation are required for proper functionality.

Screenshot 2026-01-26 at 10.07.24 AM.png

If a required charge calculation is missing an input or generates a negative/null result value the field will generate an error message and the form will be un-submittable with "(Invalid/Missing Fields)" as the button message.

image.png

Forms with Charge Calculations may be configured to automatically generate new orders on submission OR to require manual review after the form is submitted.

image.png

Form submissions with orders attached to them will have their input fields DISABLED from further editing. Processing status can still be adjusted but inputs will be disabled. Do not create an order for a form submission unless you are sure the inputs are correct.

Screenshot 2026-01-26 at 10.29.22 AM.png

image.png

image.png

Users submitting forms with charge lines will be required to select an associated charge account. Mangers may change the target field AFTER order creation through the normal approval process for orders.

Screenshot 2026-01-26 at 10.10.43 AM.png