How To Use Description on Bill

Enter the verbiage to appear on the bill segment in the Description On Bill. Turn on Print if the verbiage should appear on the printed bill.

Note:

Suppressing calculation details on the printed bill. Only rate components used to calculate intermediate values are typically suppressed on a bill. For these types of rate components, we recommend using Description on Bill to show users how the line was calculated, but turn off the Print switch. This way, users will see the calculation details on the Bill Segment - Calc Lines window, but the taxpayer won't see it on the bill.

Many lines that appear on a bill do not contain static verbiage. Rather, the printed lines contain information from the calculation process. For example, the bill line for state tax would typically contain the tax percent.

You control exactly what is substituted in the bill line by entering one or more of the following substitution variables in the Description on Bill field:

Substitution Character

What It Does

%A

Replaces the substitution character with the amount of the bill line. Please be aware of the following:

  • If the rate component isn't designated as being "for calculation purposes only" (FCPO), all trailing zeroes up to the decimal position of the rate's currency will be removed. If the rate component is designated as being "for calculation purposes only" (FCPO), the number of decimal places as defined in the rate component's precision will be shown.

  • All leading zeroes will be removed unless the value is between 1 and -1 in which case a leading 0 will appear before the decimal place.

  • The Symbol on the Currency control table will prefix the value.

  • The position of the negative sign and currency symbol is dependent on the display profile of the user who generated the bill.

%D

Replaces the substitution character with message 10101 from message category 4. This message is maintained in the standard message table.

We recommend this message be set to "(prorated for %1 of %2 days)" where %1 will be substituted with the number of days of prorated consumption charged on the bill line and %2 will be the "normal" days associated with the rate's charges. This message will only be substituted when the rate component is prorated. Note, neither %1 nor %2 are required.

Either this character OR %F should be used when you desire to substitute the charge / percent into the bill line.

If the charge is proratable, %D should be using in conjunction with %R to print an appropriate message when the charges are prorated.

%F

Replaces the substitution character with message 10102 from message category 4. This message is maintained in the standard message table.

We recommend this message be set to "(prorated by %1)" where %1 will be substituted with the factor used to prorate the charge. This message will only be substituted when the rate component is prorated. Note, %1 is not required.

If the charge is proratable, %F should be used in conjunction with %I to print an appropriate message when the charges are prorated.

%I

Replaces the substitution character with the value specified in the rate component / rate factor.

If the value is a percent,

  • all leading and trailing zeroes will be suppressed,

  • and a "%" will be suffixed to the resultant value.

If the value is not a percent,

  • all trailing zeroes up to the decimal position of the rate's currency will be removed,

  • and all leading zeroes will be removed unless the value is between 1 and -1 in which case a leading 0 will appear before the decimal place,

  • and note that the position of the negative sign and currency symbol is dependent on the display profile of the user who generated the bill.

Either this character OR %R should be used when you desire to substitute the charge / percent into the bill line. Using %I will cause the value as specified in the rate component to be substituted regardless of whether the charges are prorated.

If the charge is proratable, %I should be used in conjunction with %F to print an appropriate message when the charges are prorated.

%Q

Replaces the substitution character with the rate quantity being billed. Leading zeroes are suppressed. The decimal places shown are specified in a field on the Unit Of Measure control table.

%R

Replaces the substitution character with the value specified in the rate component / rate factor. Either this character OR %I should be used when you desire to substitute the charge / percent into the bill line. Using %R causes the prorated charge / percent to be printed in the bill line (%I causes the charge / percent as specified in the rate to be printed during proration situations).

If the charge is proratable, %R should be used in conjunction with %D to print an appropriate message when the charges are prorated.

%S

Replaces the substitution character with the summed amount. All trailing zeroes up to the decimal position of the rate's currency will be removed. All leading zeroes will be removed unless the value is between 1 and -1 in which case a leading 0 will appear before the decimal place. The Symbol on the Currency control table will prefix the value. If the value is negative, a "-" will prefix the value.

This character should only be used with Minimum, Apply To, and Summary rate components.

%T

Replaces the substitution character with message 10103 from message category 4. This message is maintained in the standard message table.

We recommend this message be set to "(%1% exempt)" where %1 will be substituted with the tax exemption percent as specified in the obligation. This message will only be substituted when the rate component's rate factor is eligible for tax exemptions AND the taxpayer is exempt from the tax. Note, %1 is not required.

Lines that don't print

If the bill line is not printed (as defined by the Print switch), message 10104 from message category 4 will be appended to the bill line. This message is maintained in the standard message table.

We recommend this message be "NOT SEEN BY TAXPAYER!" This message appears in the bill line that appears in the billing windows but does not appear on the taxpayer's bill.

The following are examples of the content of common Description on Bills along with how the line would look on the taxpayer's bill:

Description on Bill On Rate Component

How It Looks On A Bill

County Tax at %R of %I: %A

County Tax at 1.0% of $70,160: $701.60

%O: %I %D

Homestead Exemption: $150.24 (prorated for 100 of 183 days)

First %Q of Income %R

First $45,000 of Income at 10%

State sales tax %R %T

State sales tax 6.25% (50% exempt)

Minimum charge of %I %F

Minimum charge of $10.00 (prorated by .3333)

Subtotal of %S

Subtotal of $1,123.23

The prorated references will only appear if the rate component's charges are prorated due to a short or long bill period.