Skip to content
Bitta Apps

Bitta Collections reference

Setup reference

Every Bitta Collections setting and its default: the setup page by FastTab, setup actions, job queue entries, collectors, credit hold rules, customer, contact.

updated: applies-to: 1.2.0.0

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
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

Contact card

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

Next step

Ready to try Bitta Collections?