This page lists every setting that Bitta Collections adds, where to find it, what it does and its default.
Applies to: Bitta Collections 1.2 on Business Central online, version 28 or later.
Open Bitta Collections Setup by searching for it, or choose Setup > Bitta Collections Setup on the Collections and Credit role center. The setup record is created when the app is installed. When you close the page, it checks the score weights, the remittance mailbox, the mail API keys and the agency journal batch, and lists every problem at once.
A blank default means none: a switch is off, and a code or text field is empty.
Bitta Collections Setup
General
| Field |
What it does |
Default |
| Default Collector Code |
The collector for customers that have no collector of their own, and for escalations of collectors without an escalation collector |
Empty. The assisted setup can set it |
| Default Sequence Code |
The dunning sequence for customers that have no sequence of their own |
Empty. The assisted setup sets STANDARD |
| Min. Overdue Amount |
The overdue amount, in local currency, below which an overdue balance alone does not put a customer on the worklist |
1 |
Job status
These fields are read-only.
| Field |
What it does |
| Last Worklist Refresh |
When the worklist was last refreshed |
| Last Job Run |
When the collections job last finished |
| Last Job Failure Count |
How many customers, promises or disputes failed in the last run. The job still processes the rest. Shown in red when it is more than 0. Drill down to open Dunning History filtered to the failed dunning steps |
| Last Job Failures |
The first 10 failures of the last run, each with its phase and error |
Worklist score
The four weights must add up to 100. Each is between 0 and 100.
| Field |
What it does |
Default |
| Amount Weight |
Score points that depend on the overdue amount |
40 |
| Days Weight |
Points for the days that the oldest entry is overdue |
30 |
| Risk Weight |
Points for the customer's risk rating and broken promises |
20 |
| Follow-up Weight |
Points for customers that have a follow-up due |
10 |
| Full Score Amount (LCY) |
The overdue amount that earns all the amount points |
25000 |
| Full Score Days |
The days overdue that earn all the days points |
90 |
Promises
| Field |
What it does |
Default |
| Promise Nos. |
Number series for promises to pay |
COLL-PTP |
| Promise Grace Days |
Days after the promised date before an unpaid promise becomes broken |
2 |
| Max. Promise Days |
The latest promise date a collector can accept, in days after the work date |
60 |
| Exclude Promised Entries |
Native reminders and finance charge memos skip entries that have an open promise |
On |
Disputes
| Field |
What it does |
Default |
| Dispute Nos. |
Number series for disputes |
COLL-DSP |
| Dispute Days to Resolve |
Days after the work date that a new dispute is due to be resolved |
14 |
| Exclude Disputed Entries |
Native reminders and finance charge memos skip entries that have a dispute status |
On |
Sequences and email
| Field |
What it does |
Default |
| Min. Days Between Contacts |
Days after an outbound contact before an automatic step contacts the customer again |
3 |
| Max. Emails per Run |
The most emails that one run of the collections job sends |
200 |
| Redirect Emails To |
Sends every collections email to this address instead of the customer, for testing. Leave it empty to send to customers |
Empty |
| Statement Period |
The start of the period that statements cover, as a date formula added to the work date |
-3M |
| Max. Invoice Copies |
The most invoice copies attached to one email |
10 |
| Payment Instructions |
How customers can pay you, such as a remit-to address or bank details. Templates insert it through the payment instructions placeholder |
Empty |
Credit control
| Field |
What it does |
Default |
| Credit Control Enabled |
Credit rules place customers on hold, and holds stop the release and shipping of sales documents |
Off |
| Default Release Days |
How many days a released hold stays released. Sets the default Released Until date |
7 |
| Credit Source |
Where risk ratings and credit limits come from. Manual means users keep them on the customer |
Manual |
Cash application
| Field |
What it does |
Default |
| Match Date Window (Days) |
How many days before a payment an open entry can be posted and still be suggested as a match |
180 |
| Max. Invoices per Match |
The most invoices that one match suggestion combines |
5 |
| Max. Candidates per Payment |
The most open entries considered for one payment |
25 |
Copilot
Each switch asks for confirmation when you turn it on. The confirmation names the data sent to Azure OpenAI and says that Microsoft bills each use in Copilot credits. The capability must also be active on the Copilot & agent capabilities page. See AI features (preview).
| Field |
What it does |
Default |
| AI Collector Assist Enabled |
Collectors can use Copilot to draft emails and summarize accounts. A person reviews the result |
Off |
| AI Match Assist Enabled |
Copilot ranks match candidates when the rules find no clear match. A person confirms |
Off |
| AI Reply Triage Enabled |
Customer replies read from the remittance mailbox are kept and classified by Copilot. A person confirms each proposed action. Needs the remittance inbox |
Off |
| Max. Replies per Run |
The most customer replies one run of the collections job classifies. 0 uses 25 |
25 |
| Reply Follow-up Days |
Days after the work date when the follow-up of a confirmed Already Paid reply is due |
3 |
| Reply Triage Enabled At |
Read-only. When AI reply triage was turned on. Only emails received after that are kept as replies |
|
Insight
| Field |
What it does |
Default |
| DSO Period Days |
The days that the DSO figures cover. Also the default period of the period reports |
90 |
| Forecast History Months |
How many months of paid invoices the predicted pay dates learn from |
24 |
| Forecast Min. Paid Invoices |
How many paid invoices a customer needs before its own history is used. With fewer, the company's history is used |
5 |
| Forecast Max. Paid Invoices |
How many of a customer's most recently paid invoices are read at most |
50 |
| Forecast Half-Life (Days) |
After how many days a paid invoice counts half as much as one paid today |
180 |
Payment Plans
| Field |
What it does |
Default |
| Payment Plan Nos. |
Number series for payment plans |
COLL-PLN |
| Default No. of Installments |
Installments in a new plan, not counting a down payment |
3 |
| Default Installment Frequency |
Time between installments, as a date formula |
1M |
| Max. Plan Months |
The latest installment due date, in months after the work date |
12 |
| Plan Agreement Template Code |
The email template that sends the plan agreement |
PLAN AGREEMENT |
| Plan Agreement Terms |
The terms printed above the signature lines. Have your counsel review them |
A standard text about paying by the due dates |
Payment Links
| Field |
What it does |
Default |
| Payment Links Enabled |
Emails, the statement and the collection letter include Pay now links |
Off |
| Links Only for Unpaid Invoices |
Only invoices without a partial payment get a link |
On |
| Max. Payment Links per Email |
The most links in one email. 0 means no limit |
10 |
| Payment Link Provider |
Business Central Payment Services or Stripe. Choosing Stripe asks for consent and starts in test mode |
Business Central Payment Services |
| Payment Link Test Mode |
Links are created with the test key; no money moves |
On |
| Payment Link Test Key, Payment Link Live Key |
Masked. Paste the Stripe secret key; it is stored encrypted and the field is cleared |
|
| Payment Link Test Key Stored, Payment Link Live Key Stored |
Read-only. Whether a key is stored |
|
| Payment Link Grouping |
One per Invoice or One per Customer and Currency |
One per Invoice |
| Accept Card Payments |
Customers can pay by card |
On |
| Accept US Bank Payments |
Customers can pay in US dollars from a US bank account (ACH), when your Stripe account offers it |
On |
| Payment Success URL |
The page customers see after they paid. Blank shows the provider's confirmation |
|
| Online Payment Journal Template, Online Payment Journal Batch |
The cash receipt journal batch for the lines of online payments |
|
| Payment Fee G/L Account |
The account for the provider's fee, on its own journal line. Blank books no fee lines |
|
| Last Online Payment Check |
Read-only. When the job last asked the provider for completed payments |
|
Remittances
| Field |
What it does |
Default |
| Remittance Inbox Enabled |
The collections job reads the unread emails of the remittance mailbox and keeps the ones that look like remittance advice. Needs a chosen mailbox |
Off |
| Remittance Mailbox |
Read-only. Set it with Choose Remittance Mailbox. The job queue user must be able to read it, so use a shared mailbox |
Empty |
| Remittance Folder Name |
Read-only. The folder that is read. Empty means the inbox |
Empty |
| Mark Remittances as Read |
Marks emails as read after they are stored. Emails are never deleted or moved |
On |
| Remittance Category |
The Outlook category put on stored emails |
Empty |
| Max. Remittances per Run |
The most emails read per run |
50 |
| Remittance Match Window (Days) |
Days before or after arrival that a payment can be dated and still match the remittance |
14 |
| Last Remittance Read |
Read-only. When the mailbox was last read |
None |
Group View
| Field |
What it does |
Default |
| Group View Company Filter |
A filter on company names for the group view, for example CRONUS*. Leave it empty for every company you may open |
Empty |
Collection Agencies
| Field |
What it does |
Default |
| Agency Placement Nos. |
Number series for agency placements |
COLL-AGY |
| Default Agency Code |
The agency that a Send to Agency step uses when the step names none |
Empty |
| Agency On Hold Code |
The On Hold code put on placed entries, so native reminders, finance charges and payment suggestions skip them |
AGY |
| Send Agency Packets Automatically |
An automatic Send to Agency step also emails the packet and places the account. When off, the step proposes the placement for review |
Off |
| Agency Journal Template Name |
The general journal template for recoveries and commission |
Empty |
| Agency Journal Batch Name |
The general journal batch for recoveries and commission. You post the lines yourself |
Empty |
| Agency Commission G/L Account |
The G/L account for agency commission |
Empty |
Physical Mail
| Field |
What it does |
Default |
| Mail Enabled |
Collectors can send letters and statements by post. Turning it on asks you to agree to the Lob privacy notice |
Off |
| Mail Provider |
The print and mail service, under your own account |
Lob |
| Mail Test Mode |
Letters use the test key: Lob renders a proof but prints, mails and charges nothing. Turning it off asks for confirmation and needs a live key |
On |
| Test API Key |
Write-only. A Lob key that starts with test_. Stored encrypted and never shown again |
None |
| Test API Key Stored |
Read-only. Shows that a test key is stored |
Off |
| Live API Key |
Write-only. A Lob key that starts with live_. Live letters are printed, mailed and charged to your Lob account |
None |
| Live API Key Stored |
Read-only. Shows that a live key is stored |
Off |
| Mail Class |
First Class or Standard. Certified mail needs First Class |
First Class |
| Mail Color |
Print in color, which costs more |
Off |
| Mail Double-Sided |
Print on both sides |
On |
| Min. Overdue to Mail |
The overdue balance, in local currency, below which no letter is mailed. A letter that falls below it before it is sent is canceled |
100 |
| Mail Sender Name |
The name in the return address. The address comes from Company Information and must be in the United States |
The company name |
| Mail Review Required |
Every letter waits for a person to approve it. A sequence step can skip review with Mail Without Review |
On |
| Mail Preferred-Channel Customers |
Customers whose collections contact prefers mail get a letter where a step sends an email or a statement |
On |
| Letter Address Placement |
Where the address is printed on letters: Top of First Page or Insert Blank Page |
Top of First Page |
| Statement Address Placement |
The same for statements. Choosing Top of First Page asks for confirmation |
Insert Blank Page |
| Mail Tracking Days |
Days after sending that the job keeps asking Lob about a letter |
45 |
| Price per Letter (USD) |
Your Lob plan's price for a one-page black-and-white First Class letter, used for cost estimates |
1.066 |
| Price per Extra Page (USD) |
The price per extra page |
0.101 |
| Color Surcharge (USD) |
The color surcharge |
0.16 |
| Certified Mail Fee (USD) |
The certified mail fee |
6.95 |
The price defaults are the Lob Developer plan prices effective November 1, 2026. Change them to match your own Lob plan. See Letters by post.
Setup page actions
| Group |
Action |
What it does |
| Prepare |
Schedule Jobs |
Creates or updates the job queue entries. Asks whether to add the hourly worklist refresh |
| Prepare |
Statement Options |
Opens and stores the request page options of the report chosen for the Customer Statement usage in Report Selections. The standard statement needs no options |
| Prepare |
Assisted Setup |
Opens the Set up Bitta Collections guide |
| More ways to collect |
Choose Remittance Mailbox |
Picks the email account whose mailbox receives remittance advice |
| More ways to collect |
Choose Folder |
Picks a folder of that mailbox |
| More ways to collect |
Test Mailbox |
Reads up to five unread emails without storing them |
| More ways to collect |
Remittance Inbox, Customer Replies, Payment Plans, Online Payments, Issued Payment Links, Collection Agencies, Mail Queue, Group Overview |
Open those pages |
| More ways to collect |
Delete Payment Link Test Key, Delete Payment Link Live Key |
Delete a stored Stripe key. Deleting the live key turns test mode on |
| More ways to collect |
Payment Services |
Opens the native Payment Services page |
| More ways to collect |
Delete Test API Key, Delete Live API Key |
Delete a stored Lob key. Deleting the live key turns test mode on |
| Navigate |
Collectors, Collections Sequences, Collections Email Templates, Credit Hold Rules, Bitta Collections License |
Open those pages |
| Navigate |
Email Scenarios |
Opens the native email scenario setup, where you assign an account to the Collections scenario |
| Navigate |
Job Queue Entries, Failed Dunning Steps |
Open the collections job queue entries, and Dunning History filtered to the steps that failed in the last run |
Job queue entries
Installing the app schedules nothing. Schedule Jobs on the setup page, or Schedule the Collections Job in the assisted setup, creates these entries. Running it again updates them instead of adding new ones.
| Description |
Parameter |
When it runs |
| Bitta Collections: daily collections job |
ALL |
Monday to Friday at 06:00 |
| Bitta Collections: hourly worklist refresh (optional) |
WORKLIST |
Monday to Friday, every 60 minutes from 07:00 to 19:00 |
Both entries use the job queue category BAACOLL, so they never run at the same time. Each tries up to 3 times, 300 seconds apart. The daily job runs these phases in order:
| Phase |
What it does |
| INBOX |
Reads the remittance mailbox and processes remittances, when the remittance inbox is on. With AI reply triage on, also classifies customer replies |
| PAYMENTS |
Reads completed Stripe payments and creates their journal lines, when Stripe links are on |
| LEDGER |
Checks promises, resolves disputes on closed entries, checks payment plans and agency placements |
| HOLDS |
Applies the credit hold rules |
| SEQUENCES |
Runs the dunning steps |
| MAIL |
Sends approved letters and tracks sent ones, when physical mail is on |
| WORKLIST |
Refreshes the work items |
The job needs a usable license, but no seat. The parameter can also be a comma-separated list of phases. A failure for one customer does not stop the job; it shows in Last Job Failures.
Collectors
Search for Collectors, or choose it from the setup page. One collector is one Business Central user who works customers.
| Field |
What it does |
Default |
| Code |
The collector code. Required |
None |
| Name |
The name as it appears in emails |
None |
| User ID |
The Business Central user who works as this collector. A user can be only one collector |
None |
| Email |
The collector's email, used in emails and escalation notices |
None |
| Escalation Collector Code |
The collector who takes over customers that a sequence escalates |
Empty |
| Can Release Credit Holds |
The collector may release customers from credit hold |
Off. The assisted setup turns it on for you |
| Phone No. |
Shown in emails |
None |
| Job Title |
Shown in the signature |
None |
| Signature |
Ends the collector's emails. Hidden by default |
None |
| Blocked |
No new customers can be assigned to the collector |
Off |
| Customers |
The number of customers assigned to the collector |
Calculated |
| Open Work Items |
The number of work items that are not closed |
Calculated |
Credit Hold Rules
Search for Credit Hold Rules. There is one rule per risk rating. The rule with the blank rating, Not Rated, applies to every customer without a rating. Create Default Rules adds a rule for each rating that has none, plus the reason codes used to release holds.
| Field |
What it does |
| Risk Rating |
Not Rated, Low, Medium or High |
| Overdue Days |
Days overdue that put a customer on hold |
| Min. Overdue Amount |
The overdue amount, in local currency, that must also be reached |
| Hold When Over Limit |
Holds a customer whose balance is over the credit limit |
| Hold On Broken Promise |
Holds a customer who broke a promise recently |
| Broken Promise Days |
How recent the broken promise must be, in days |
| Enabled |
The rule is used |
The default rules from the assisted setup:
| Risk Rating |
Overdue Days |
Min. Overdue Amount |
Broken promise hold |
| Not Rated |
60 |
1,000 |
No |
| Low |
90 |
2,500 |
No |
| Medium |
45 |
500 |
Within 30 days |
| High |
30 |
0 |
Within 60 days |
All default rules are enabled and hold customers over their credit limit. The release reason codes are CR-PAID, CR-PROMISE, CR-MGR and CR-PREPAID.
Customer card
Bitta Collections adds On Credit Hold and Credit Hold Reason after Blocked on the General FastTab, and a Collections FastTab after Payments.
| Field |
What it does |
Default |
| Collector Code |
The collector who works this customer. Empty means the default collector |
Empty |
| Dunning Sequence Code |
The sequence for this customer. Empty means the default sequence |
Empty |
| Collections Risk Rating |
Not Rated, Low, Medium or High. Used by the worklist score and the credit hold rules |
Not Rated |
| On Credit Hold |
Read-only. Sales documents can't be released or shipped |
Off |
| Credit Hold Reason |
Read-only. Manual, Overdue, Over Credit Limit, Broken Promise or Dunning Step |
Empty |
| Credit Hold Since |
Read-only. The date the hold was placed |
None |
| Hold Released Until |
Read-only. Until this date the rules don't put the customer on hold again |
None |
| Group Customer Key |
The same key in every company, so the group view can match the customer. Empty means match on VAT registration number |
Empty |
| Mail Returned |
Read-only. A letter mailed to the customer came back. Changing the address clears it |
Off |
| Mail Returned Date |
Read-only. The date Lob reported the returned letter |
None |
Bitta Collections adds two fields after E-Mail on the Contact Card. The Contact List shows Collections Email Role.
| Field |
What it does |
Default |
| Collections Email Role |
Whether the contact gets collections emails: To, CC or Do Not Email |
Empty |
| Collections Preferred Channel |
How the contact prefers to be reached: Email, Phone or Mail |
Email |
Number series
Installing the app creates these number series and puts them on the setup page when the fields are empty.
| Code |
Used for |
Numbers |
| COLL-PTP |
Promises to pay |
PTP000001 and up |
| COLL-DSP |
Disputes |
DSP000001 and up |
| COLL-PLN |
Payment plans |
PLN000001 and up |
| COLL-AGY |
Agency placements |
AGY000001 and up |
Other setup lists