Skip to content
Bitta Apps

Chapter 2 of 8Page 3 of 3

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

  1. Search for Bitta Collections Setup.
  2. Choose Navigate > Collections > Email Scenarios.
  3. 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

  1. On Bitta Collections Setup, open the Sequences and email FastTab.
  2. 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
Collections Email Templates list with the shipped templates, their tone and subject
The shipped email templates and their tone.

Change a template

  1. Search for Collections Email Templates.
  2. Open a template.
  3. 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.
  4. Edit the text in Body. Type placeholders in braces, such as {CustomerName}.
  5. 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

  1. On the worklist, the work item or the customer card, choose Send Email or Send Collection Email.
  2. On the Send Collection Email page, choose the Template and, if needed, a Send To Contact.
  3. Check Attach Invoice Copies and Attach Statement.
  4. In Invoices, use Remove from Email for invoices that the email should not mention. If an invoice is promised, the page tells you so.
  5. Choose Update Preview, then check To, CC, Subject, Attachments and Body. You can edit the body.
  6. 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.

Next step

Ready to try Bitta Collections?