Skip to content
Bitta Apps

Chapter 1 of 8Page 3 of 3

Before you start

Getting started

Install Bitta Collections, activate the license, run Set up Bitta Collections, schedule the daily job and assign the Read, Collector and Administrator sets.

updated: applies-to: 1.2.0.0

Set up Bitta Collections in five steps: install the app, activate the license, run the assisted setup, check the daily job and give people the right permission sets. The assisted setup is listed in Business Central as a 15-minute task. In a demo company it can also add sample promises, disputes and activities, so the worklist has something to show.

Applies to: Bitta Collections 1.2 on Business Central online, version 28 or later.

Before you start

  • You need Business Central online, version 28 or later.
  • You need the SUPER permission set, or BAA COLL SETUP together with the permissions to manage users, email accounts and job queue entries.
  • To send collections emails, set up an email account in Business Central first. The assisted setup tells you which account the Collections email scenario uses.
  • In a sandbox environment, allow outbound calls for the app before you activate it: search for Extension Management, choose Bitta Collections, choose Configure and turn on Allow HttpClient Requests. Production environments allow them by default.

Install the app

  1. Install Bitta Collections in your environment. You don't need a code for the trial.
  2. When the installation is done, search for Extension Management. It lists Bitta Collections by Bitta Apps, LLC.

Installing the app changes nothing in your ledgers. It adds the Bitta Collections Setup page, the number series COLL-PTP, COLL-DSP, COLL-PLN and COLL-AGY for promises, disputes, payment plans and agency placements, and the job queue category BAACOLL. No job is scheduled until you choose to schedule it.

Activate the license

Bitta Collections is licensed per Microsoft Entra tenant, for a number of collections users. Start with the free trial: 30 days for 3 collections users, once per tenant, with no code and nobody to contact.

  1. Search for Bitta Collections License.
  2. Choose Start Free Trial. Bitta Collections gets the trial license of your tenant from Bitta Apps. The assisted setup also starts the trial in its License step when there is no license yet.
  3. Check that Status shows Active.
  4. In the Collections Users part, choose Assign Seat for each person who collects.

When you buy a subscription, Bitta Apps sends an activation code. Choose Enter Activation Code on the same page and enter it. The app keeps the code, so a renewal is one click on Get License. For an environment that cannot reach the internet, Bitta Apps can send the license text, and you choose Paste License instead. See License and seats for what needs a seat and what works without one.

Bitta Collections License page with status Active, the licensed company, the plan and the seats used
The License page after activation.

Run the assisted setup

Open the guide in one of three ways: search for Assisted Setup and choose Set up Bitta Collections, choose Assisted Setup on the Bitta Collections Setup page, or choose Setup > Assisted Setup on the Collections and Credit role center. Nothing is saved until you choose Finish, and you can run the guide again at any time.

  1. Welcome to Bitta Collections. Choose Next.
  2. License. Shows the license status. Without a license, this step starts the free trial and tells you that it started, or why it couldn't. If you bought a license, choose Enter activation code here.
  3. Collectors. Keep Make Me a Collector on to work customers yourself. Choose Add other users as collectors to add more people. Keep I Can Release Credit Holds on if you may release holds.
  4. Assign customers. Choose the collector in Assign Customers To. With Only Unassigned Customers on, customers that already have a collector keep theirs. Only customers with a balance are assigned.
  5. Dunning. Keep Create Recommended Sequences, Create the Email Templates and Create the Dispute Reasons on. STANDARD fits most customers; GENTLE suits key accounts. Existing sequences, templates and reasons are kept.
  6. Email. Check which email account sends collections emails. If none is set up, choose Choose the email account. Enter your Payment Instructions. To test safely, enter your own address in Redirect Emails To.
  7. Credit control. Turn on Turn On Credit Control when you want holds to block sales documents. Create the Default Credit Rules adds one rule per risk rating.
  8. Automation. Keep Schedule the Collections Job on. Turn on Refresh the Worklist Every Hour if collectors want the list refreshed during the day.
  9. AI help (optional). Leave both switches off for now. See AI features (preview) before you turn them on.
  10. More ways to collect (optional). Pay now links, letters by post, the remittance mailbox and collection agencies. All stay off until you set them up.
  11. Sample data. Shown only in a demo company. Create Sample Data adds 3 promises, 2 disputes and 6 activities to existing open invoices. Nothing is posted.
  12. That's it. Keep Give Me a License Seat and Refresh the Worklist Now on, then choose Finish.

NOTE

Turn on Redirect Emails To while you test. Every collections email then goes to that address instead of the customer. Clear the field before you go live.

Set up Bitta Collections guide on the Collectors step with My Collector Code and I Can Release Credit Holds
The setup guide makes you a collector in one step.
Set up Bitta Collections guide on the Dunning step with the recommended sequences, email templates and dispute reasons
The Dunning step creates the recommended sequences, templates and dispute reasons.

Schedule the collections job

If you turned off Schedule the Collections Job in the guide, schedule it later: open Bitta Collections Setup and choose Schedule Jobs. The collections job runs every weekday at 06:00. It checks promises and disputes, evaluates credit holds, runs the dunning sequences and refreshes the worklist. One customer's error never stops the others.

Check the result the next morning on the Job status FastTab of Bitta Collections Setup: Last Job Run, Last Job Failure Count and Last Job Failures. The jobs are listed on Job Queue Entries in the category BAACOLL.

Bitta Collections Setup Job status FastTab with the last worklist refresh, the last job run and its failures
Job status shows when the job last ran, how many steps failed and why.

Permission sets

Bitta Collections adds three permission sets. Assign them on the Users or Permission Sets page, in addition to the Business Central sets a person needs for customers and ledger entries.

Permission set Caption For whom What it allows
BAA COLL READ Bitta Collections - Read Anyone who looks up collections data View work items, activities, promises, disputes, holds and setup, and run every report
BAA COLL EDIT Bitta Collections - Collector Collectors, credit managers and cash clerks Everything in Read, plus work the worklist, log activities, record promises and disputes, send emails, place holds, apply cash, payment plans, remittances, agencies and mail
BAA COLL SETUP Bitta Collections - Administrator Administrators Everything in Collector, plus setup, collectors, sequences, templates, credit rules, agencies, email accounts and license seats

Users with D365 READ get Read automatically. Users with D365 ACC. RECEIVABLE or D365 BUS FULL ACCESS get Collector automatically. No standard set grants Administrator; assign it yourself. See Permission sets for the details.

To give collectors their own home page, ask them to choose the Collections and Credit role in My Settings.

What's next

Decide who works which customers: Collectors and customers.

Next step

Ready to try Bitta Collections?