Contents
Letter format maintenance (ARE010)
The Letter format maintenance program allows you to create formats for all kinds of letters. These formats or templates make generating letters more convenient as it bypasses having to manually enter text, each time a letter is printed. This is done through the use of variables. A variable holds the data that is inserted into your letter in code form. When your letter generates, the system draws the relevant information into this field. For example, variable “BNO” = Billing Number, the system would draw the Customer’s Billing Number into that field when the letter is generated. Each letter is given a unique user defined code, in order to identify the type of standard letter that is to be sent to the debtor. These letters can be generated manually, in batch or automatically.
A standard letter may consist of text and instructions to retrieve and display various details in the body of the letter. Variable codes are used to instruct the system to retrieve information like customer name and address, dates, claim details and balance details. These variables are replaced with actual information, from the Customer masterfile, when the letter is generated.
Note that the variables used by the automatic letters are found in TMSAR/ LTR-VARO and therefore if the same format is required for manually generated and automatically generated letters, two formats will need to be established. The variables used in manually generated Letters are found in TMSAR/LTR-VAR.
When you want to generate a letter, select the customer the letter is for and the type of letter required. The system then automatically allocates the letter to that customer with all the necessary information included.
Access to the maintenance program is gained by selecting the letter code, which identifies the type of letter to be sent. Using the search function key, users are able to search letters stored in the system. A new letter can be added by selecting a letter code and using the Add function.
When this Letter format maintenance option is selected, the user can alter any existing information or, if in Add mode, create and add a new letter.
The letter’s description is entered on the first line, for example “Reminder Letter”. This description displays on inquiries and therefore the more meaningful it is the easier it is to interpret the inquiries. The Customer History Inquiry has a facility to read the text of letters sent.
Add a new letter format
- In the menu, expand Base Modules > Distribution > Debtors & Claims > Accounts Receivable > AR Reports > Manual Letter and then double-click Debtor Letter Format Maintenance. ARE010 Letter Format Maintenance selection panel appears.
- Enter a code for the letter, this Letter code identifies the type of standard letter. Various types of letters can be defined, each type identified by its own, unique, two character alphanumeric code.
- Click Add. ARE010 Letter Format Maintenance panel appears in Add mode.
| Function | Description |
| Insert text | Relevant text can be inserted by placing the cursor where the text needs to be inserted and then clicking Insert Text. The entry lines will disappear from the screen and an Insert Text field is available at the bottom of the screen. It will be inserted where you position the cursor. |
| Delete letter | The text of the letter is deleted via this function. Note the Letter Code is not deleted, only the text. |
| Delete line | Lines can be deleted by placing the cursor on the appropriate line and clicking this function key. |
| Insert line | Lines can be inserted by placing the cursor on the appropriate line and clicking this function key. |
- Enter the letter description on first line.
- Prompt to display a list of variables to choose from.
| Note |
A variable is data that is inserted into your letter in code form. When your letter generates, the system draws the relevant information into this field, for example, variable “BNO” = Billing Number, the system would draw the Customer’s Billing Number into that field when the letter is generated. List variables. Tell the system what information to drop into the letter, by inserting the relevant variables. To insert a variable Prompt to display a list for you to choose from. Select a variable using the Select option and the variable is entered into the letter at the spot that the cursor was on when Prompt was selected. To manually enter a variable key a “” first before you key the variable. To force the variable to start on a new line use a “@” in front of the “”. To use your own variable key “” followed by what you want the user to key, for example, “type your name here”. |
- Select required variables. The variable is entered into the letter at the spot that the cursor was on when prompt was selected.
- Enter letter text as required.
-
Click OK to save the new letter format.
Letter generation (ARE015)
This program enables the user to generate a standard letter for a selected customer by entering the customer number and the letter code. By using the Search function, users are able to search customers and letters stored in the system. The letter can be sent via email if required. On selection, the letter generation screen displays the standard letter with the appropriate variables automatically replaced by the customer number and the relevant information, retrieved from the Customer masterfile. The cursor highlights those variables still needing replacement information. These variables can be replaced simply by entering the appropriate values.
This program can also be called by Pending Review program (DSE025) if it’s specified in pending control file TMSDS/PEND-LTR.
A letter can be restarted, cancelling all manual replacements, by using the appropriate function.
- In the menu, expand Base Modules > Distribution > Debtors & Claims > Accounts Receivable > AR Reports > Manual Letter and then double-click Manual Letter Generation. ARE015 Letter Generation selection panel appears.
| Field | Description |
| Customer | Account number of the customer who is to receive the letter. |
| Letter code | Code identifying the letter. When a letter code is selected, the system retrieves the relevant standard letter and displays it in full. The information can then be altered to suit a particular account, before generating the letter print. For letter generation from Pending Review (DSE025), the Letter code is defaulted from the setting in TMSDS/PEND-LTR. |
| Description | An overriding description of the letter may be entered or press <ENTER> to default the description as per the Letter code selected. |
| Send via email | Flag ‘Y’ to send the generated letter by email. |
| Email from | If Send via email flag is set to ‘Y’ then a valid from email address must be entered here. |
| Email to | If Send via email flag is set to ‘Y’ then a valid to email address must be entered here. |
- Enter the above information, as necessary.
- Click OK. ARE015 Letter Generation main panel appears.
- Enter or maintain the letter text as required.
- Click Page down for additional text if required.
- Click OK to generate the letter. On successful generation of the letter you will see the system message ‘Letter has been successfully generated‘.
Note: If you have selected to send via email, system will write the letter to file XAEM* and will email the letter when the Submit E-mail sender (XAO410A) program is run via the menu option Cross Application > Data Queue > Submit E-mail sender.
Miscellaneous letter generation (ARR043)
This program provides the facility to generate miscellaneous letters in a batch print. Entry is required of the letter code and optional criteria include the debtor class, company, branch, region, customer, customer classification and type code. The account balance for aged month can also be specified.
- In the menu, expand Base Modules > Distribution > Debtors & Claims > Accounts Receivable > AR Reports > Manual Letter and then double-click Debtor Misc Letter Generation . ARR043 Miscellaneous Letter Generation for A/R panel appears.
| Field | Description |
| Account balance | Select the account balance range to include in the letter generation or leave blank to select all account balances. |
| For aged month | Indicate the aged month bucket ranges to be included in the letter generation or leave blank to select all. |
- Enter the above information, as required.
- Enter the selection fields and click OK.
Statement letter (ARR030)
This program will generate a statement letter based on user defined selection criteria.
- In the menu, expand Base Modules > Distribution > Debtors & Claims > Accounts Receivable > AR Reports > Manual Letter and then double-click Debtor Statement Letter. ARR030 A/R Statement Letter selection panel appears.
| Field | Description |
| Letter code | This field displays the letter code used to generate statement letter for the debtor. Debtor statement letter codes are established in TMSAR/LTR-CD. |
| Account balance | Extract the range of amount debtor balance. |
| For aged month | This range selection is used to determine the months that match the aged balance criteria, to include. |
| Statement period | Period from which the statement should range. |
| Statement due date | Range selection used to determine the due dates that match the criteria. |
| Invoice date | Date when invoice was raised |
| Print zero bal statements | Option to include or exclude zero balance statement letter |
- Enter the above selection criteria, as required.
- Click OK.
