# Billing forms

You can create the forms used for billing here. Three standard forms are available in both text and HTML formats, which you can adopt and adjust as necessary.

You can use placeholders to determine the information to be provided on the bill.

The placeholders are listed and explained below. To obtain help on how to edit the billing forms, collapse the descriptive text by clicking the lightbulb icon or scroll down the page.

## Placeholder

Placeholders are available so you can position specific information on the billing form. You insert the information in the required place on the billing form. You can use placeholders in both TXT and HTML templates. By way of example you can take a look at the integrated default template in Edit mode.

Table 1. Available placeholders
Placeholder | Output
%GuestName% | Guest name
%RoomNumber% | Room number
%RoomName% | Room name
%DateOfArrival% | Arrival date
%DateOfDeparture% | Departure date
%BillingAddress% | Guest address
%Today% | Current date
%Time% | Current time
%StartList% | Start of the list with the individual call entries
%CallId% | Generates an ID for a call entry. The first call entry is assigned ID 1.
%CallDate% | Call date of a call entry
%CallTime% | Call time of a call entry
%CallDuration% | Call duration of a call entry
%CallDestinaion% | Call destination of a call entry
%CallCost% | Call charges of a call entry
%EndList% | End of the list with the individual call entries
%VAT% | Value Added Tax rate (output without percentage sign)
%TotalVAT% | VAT levied on the call charge total
%TotalRaw% | Call charge total excl. VAT
%TotalCost% | Call charge total with VAT
%Currency% | Currency
%AlternativeCurrencyTotalCost% | Call charge total with VAT in the alternative currency, in accordance with configured exchange ratio

## Formattable placeholders

The following placeholders are output differently depending on the format specification.

Table 2. %DateFormat=[format specification]%
Format specification | Output
dd | Day, two-digit
d | Day, one or two-digit
mm | Month, two-digit
m | Month, one or two-digit
yyyy | Year, four-digit
yy | Year, two-digit
Rules:
This format placeholder can be placed anywhere, except within a call entry list.
If the format placeholder occurs several times, only the last one on the template is interpreted.
Only lowercase letters are interpreted
Without this placeholder format, the dd.mm.yyyy date format is used.
Examples:
%DateFormat=d. m. yyyy% | 25. 1. 2012
%DateFormat=dd_mm_ yy% | 25_01_12
%DateFormat=yy/mm/dd% | 12/01/25

Table 3. %TimeFormat=[format specification]% and %DurationFormat=[format specification]%
Format specification | Output
hh | Hours (time/duration), two-digit
ii | Minutes (time/duration), two-digit
ss | Seconds (time/duration), two-digit
Rules:
This format placeholder can be placed anywhere, except within a call entry list.
Only lower-case letters are interpreted
With this placeholder format, the hh.ii time format is used for the time and hh.ii.ss for the duration.
Time is always indicated using the 24-hour format.
Examples:
%TimeFormat=hh:ii% | 08:12 (8 hours, 12 minutes am)
%TimeFormat=hh-ii-ss% | 08-12-56 (8 hours, 12 minutes, 56 seconds)
%TimeDuration=hh:ii:ss% | 00:08:23 (duration of 8 minutes and 23 seconds)

## Format placeholders for formatting TXT templates

Format placeholders are used to alter the formatting of bills in TXT format. It is best to insert the format placeholders at the beginning of the billing form. To format HTML bill forms use the standardised HTML syntax.

Table 4. Format placeholders that begin with %Size
Format placeholders | Explanation
Format placeholders that begin with %Size (size format placeholders) reserve the number of characters used to output a particular placeholder. If it is shorter than defined, spaces are added from the left. Use these format placeholders to right-justify the output of a placeholder in a TXT template. Note: Formatting made using size placeholders only has the desired effect when non-proportional fonts are used. So always check the Mitel 400 Print Spooler to see which font has been set.
%SizeDate=[format specification]% | Reserves the number of characters to output %CallDate%. Example: %SizeTime=12%
%SizeTime=[format specification]% | Reserves the number of characters to output %CallTime%. Example: %SizeTime=6%
%SizeDestination=[format specification]% | Reserves the number of characters to output %CallDestination%. Example: %SizeDestination=22%
%SizeDuration=[format specification]% | Reserves the number of characters to output %CallDuration%. Example: %SizeDuration=10%
%SizeCost=[format specification]% | Reserves the number of characters to output %CallId%. Example: %SizeCost=12%
%SizeId=[format specification]% | Reserves the number of characters to output %CallId%. Example: %SizeId=3%

Table 5. Other format placeholders
Format placeholders | Explanation
%PageLength=[format specification]% | Specifies the number of lines per page on a TXT template. A page break is inserted whenever that number is reached. Not applicable to HTML templates. Example: %PageLength=54% specifies the page length as 54 lines.

## Preparing forms

When you open the Billing forms view, you will see the updated HTML form (on top) and text form (below). To adapt the forms, proceed as follows:

1. Select one of the three standard forms for the HTML and text forms respectively.

2. Adjust the standard forms according to your needs and click the Apply button.

   The new forms are activated.

Note:

If you select a standard form, it is loaded into the editor and over writes the existing content. Therefore, we recommend that you process the form in an external editor and save it on your computer. Then copy the completed form to the integrated editor.

## Incorporating images (applies to HTML templates only)

You can also incorporate images into the HTML templates. The images must first be uploaded to the file system of the communication server.

1. Click the Browse button in the Upload image section.

   The file dialog box appears.

2. Select the image you want (which must be available in an HTML-compatible format) and click the Upload image button.

   The image is uploaded and listed in the list below.

3. Reference the image in the position you want it in the HTML template using the following addressees: <img src=”%PBXAdress%/Hospitality/Templates/img/mypic.jpg">

   The image is now visible in the preview and also appears on the printout.

Parent topic: Hospitality and hotel solution
↑