Set up collections
Email and templates
Send collections email through the Business Central Email module: the Collections scenario, 11 templates, placeholders, invoice copies and a test mode.
updated: applies-to: 1.2.0.0
Set up the email account, the templates and the test mode for collections emails. Bitta Collections sends every email through the native Business Central Email module, from the account assigned to its own Collections email scenario. Emails that a collector writes open in the native email editor. Emails from automatic sequence steps are queued and sent in the background.
Applies to: Bitta Collections 1.2 on Business Central online, version 28 or later.
Before you start
- You need the BAA COLL SETUP permission set to change templates and email settings. Collectors with BAA COLL EDIT can send emails.
- You need an email account in Business Central. See Set up email on Microsoft Learn.
- The shipped templates are in English (US).
Assign the email account
- Search for Bitta Collections Setup.
- Choose Navigate > Collections > Email Scenarios.
- Assign the email account that sends collections emails to the Collections scenario.
If no account is assigned to the scenario, Business Central uses the default account. When there is no account at all, Bitta Collections stops with an error that offers Set Up Email Accounts.
Test safely with Redirect Emails To
- On Bitta Collections Setup, open the Sequences and email FastTab.
- Enter your own address in Redirect Emails To.
Every collections email, manual or automatic, now goes to that address instead of the customer. The Send Collection Email page shows the real recipients and Will be sent to (test redirect).
WARNING
Clear Redirect Emails To before you go live. While it is filled, no customer receives a collections email.
Email settings
The Sequences and email FastTab of Bitta Collections Setup holds these settings:
| Field | What it does | Default |
|---|---|---|
| Redirect Emails To | Sends every collections email to this address, for testing. | Blank |
| Payment Instructions | How customers can pay you, such as your remit-to address and bank details. Templates insert it with {PaymentInstructions}. | Blank |
| Max. Emails per Run | The most emails that one run of the collections job sends. | 200 |
| Max. Invoice Copies | The most invoice copies attached to one email. | 10 |
| Statement Period | The start of the period that statements cover, as a date formula from the work date. | -3M |
| Min. Days Between Contacts | The days after a contact before an automatic step contacts the customer again. | 3 |
Invoice copies are printed through Report Selections with the usage for posted sales invoices. Statements use the report selected for Customer Statement, so your own statement layout is used. Choose Prepare > Statement Options to store the options of that report.
The shipped templates
The assisted setup creates 11 templates. You can also choose Create Default Templates on the Collections Email Templates page. Existing templates are kept.
| Code | Description |
|---|---|
| COURTESY | Courtesy note before the due date |
| REMINDER1 | First reminder (friendly) |
| REMINDER2 | Second reminder (neutral) |
| FIRM | Firm reminder |
| FINAL | Final notice |
| STATEMENT | Statement cover note |
| PROMISE CONF | Promise to pay confirmation |
| DISPUTE ACK | Dispute acknowledgment |
| PLAN AGREEMENT | Payment plan agreement |
| AGENCY PLACE | Account placement to a collection agency |
| AGENCY WITHDRAW | Placement withdrawal to a collection agency |
Change a template
- Search for Collections Email Templates.
- Open a template.
- On the General FastTab, check the Description, Tone and Subject. Turn on Attach Invoice Copies or Attach Statement to attach them by default when a collector sends the template.
- Edit the text in Body. Type placeholders in braces, such as {CustomerName}.
- Choose Check Template. It lists any placeholder that the app doesn't know.
Reset to Default replaces the subject and body with the shipped text. Your changes to the template are lost.
Language Code lets you keep the same template code in several languages. The shipped templates have a blank language code, which is used when no template exists for the contact's or customer's language.
Placeholders
| Placeholder | Filled with |
|---|---|
| {CustomerName}, {CustomerNo} | The customer's name and number |
| {ContactName} | The name of the contact who receives the email |
| {OpenItemsTable} | A table of the invoices in the email, built from the customer ledger |
| {TotalDue}, {CurrencyCode} | The total of those invoices and its currency |
| {OldestDueDate} | The oldest due date among those invoices |
| {CollectorName}, {CollectorEmail}, {CollectorPhone}, {CollectorSignature} | From the customer's collector on the Collectors page |
| {CompanyName} | Your company name |
| {PaymentInstructions} | The Payment Instructions of the setup |
| {PromiseDate}, {PromiseAmount} | The customer's open promise to pay |
| {DisputeList} | The open disputes on the invoices in the email |
| {PaymentLinks} | Pay now links, when payment links are turned on. See Payment links. |
Send a collection email by hand
- On the worklist, the work item or the customer card, choose Send Email or Send Collection Email.
- On the Send Collection Email page, choose the Template and, if needed, a Send To Contact.
- Check Attach Invoice Copies and Attach Statement.
- In Invoices, use Remove from Email for invoices that the email should not mention. If an invoice is promised, the page tells you so.
- Choose Update Preview, then check To, CC, Subject, Attachments and Body. You can edit the body.
- Choose OK. The email opens in the email editor, where you send it.
Every collections email is logged as an activity with an Email Status: Queued, Sent or Failed. The email is also linked to the customer, so it shows in the customer's sent emails. The Collection Email Log report lists emails by template and status.
NOTE
After you remove or add invoices, choose Update Preview again. The status of an email is updated by the job queue user, who needs permission to change the collections activity log.
What's next
Start collecting: Work the worklist.