Skip to content
Bitta Apps

Bitta Collections reference

License and seats

How Bitta Collections is licensed per Microsoft Entra tenant: the license page, seats, the 30-day trial, statuses, grace period and actions that need a seat.

updated: applies-to: 1.2.0.0

This page lists how the Bitta Collections license works: the license page, seats, the trial, the statuses and what needs a seat.

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

How licensing works

Bitta Collections is licensed per Microsoft Entra tenant, for a number of collections users. A collections user is a person with a seat: a collector, a credit manager or a cash clerk. One license covers every environment and company of the tenant, unless Bitta Apps issues it for one environment only. Seats are one list for all companies.

The license is a text that Bitta Apps signs. Bitta Collections checks the signature with a public key that ships with the app. The license holds no price. For prices, see Pricing.

The trial starts in the app with Start Free Trial, with no code. A paid license comes with an activation code from Bitta Apps.

The Bitta Collections License page

Search for Bitta Collections License, or choose Setup > Bitta Collections License on the Collections and Credit role center.

License

Field What it shows
Status Whether the license is active. See License statuses
Licensed To The customer that Bitta Apps issued the license to
Plan The plan of the license, such as a trial or a paid plan
Type Trial or Paid
Valid From The first day of the license
Valid Until The last day of the license. Renew it before this date

Seats

Field What it shows
Licensed Seats How many collections users the license allows
Seats Used How many users have a seat. Seats beyond the licensed number are not licensed

This Environment

Field What it shows
Microsoft Entra Tenant ID The tenant ID of this environment. Bitta Apps issues the license for this tenant
Environment The name of this environment
License ID The ID of the license. Give it to Bitta Apps support when you ask about your license

Actions

Action What it does
Get License Gets the current license of this tenant from Bitta Apps, for example after a renewal. The first time, it asks for the activation code. The code is kept, so a renewal is one click
Enter Activation Code Enter a new activation code from Bitta Apps and get the license that belongs to it
Paste License Paste a license text that you received from Bitta Apps, for an environment that can't reach the internet
Start Free Trial Starts the free trial: Bitta Collections gets the trial license of your Microsoft Entra tenant from Bitta Apps. Shown only while no license is active
Refresh Checks the license and the seats again

A license that was issued before the license already stored is refused, so an old license can't replace a newer one.

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

Collections Users

The Collections Users part on the license page lists the users with a seat: User Name, Full Name, Licensed, Assigned At and Assigned By.

Action What it does
Assign Seat Gives a user a seat, so the user can run the licensed actions. You can pick a person or a Microsoft Entra application that uses the collections API
Remove Seat Takes the seat from the selected user, for example when the user left. The seat is free at once for another user

Rules for seats:

  • A seat can be given only while the license is usable and a seat is free.
  • After a user's seat is removed, that user can't get a seat again for 30 days. The error offers Choose another user.
  • When there are more seats than the license allows, the first seats by Assigned At are licensed. The others show Licensed as off.

The assisted setup can also give you a seat: keep Give Me a License Seat on in the last step.

The trial

A trial lasts 30 days for 3 collections users. There is one trial per Microsoft Entra tenant.

You don't need to contact us or enter a code:

  1. Run the assisted setup. When there is no license yet, its License step starts the trial by itself and tells you that it started, or why it couldn't. You can also choose Start Free Trial on the license page.
  2. Give seats to the people who collect, in Collections Users.

Starting the trial again during the trial, for example in another environment of the same tenant, gives you the same trial. After the trial, buy a license and choose Enter Activation Code. If the trial can't start in a sandbox, turn on Allow HttpClient Requests (see below).

During the trial, a notification shows the number of users and the last day of the trial.

License statuses

Status What it means
Not Activated No license is stored yet. Choose Start Free Trial, or enter an activation code
Active The license is valid for this tenant and environment
Expired The Valid Until date has passed. The license stays usable for 14 more days
Not Yet Valid The Valid From date is still in the future
For Another Tenant The license was issued for another Microsoft Entra tenant. Choose Get License in this tenant
For Another Environment The license was issued for another environment. Choose Get License in this environment
Invalid The license text is not a valid Bitta Collections license, for example because it was not copied in full

Grace period

The license stays usable for 14 days after Valid Until. During that time, a notification says when the license ended and until when you can keep working. After the 14 days, the licensed actions stop until you renew. Everything else keeps working.

A notification also shows 14 days before the license expires. The notifications appear when you open the setup page, the worklist or the role center, with the action Open Bitta Collections License.

Licensed actions

Each of these actions needs a usable license and a seat for the user who runs it.

  • Refresh the collections worklist.
  • Send collections emails and statements.
  • Record promises to pay. This also covers activating a payment plan.
  • Open disputes.
  • Place credit holds by hand.
  • Suggest payment matches. This also covers Read Mailbox Now and Find Payment on remittances.
  • Use Copilot in Bitta Collections. The AI features must also be turned on.
  • Place accounts with a collection agency.
  • Approve or send physical mail.

The daily collections job needs a usable license, but no seat. The job queue often runs as a service account, so the job never takes a seat.

When a user without a seat tries a licensed action, the error says what is missing and how to fix it: get a license, renew it, or ask the license administrator for a seat.

What works without a license or seat

These never check the license:

  • credit hold enforcement on sales documents, and releasing holds;
  • checking promises against payments, as payments are posted;
  • resolving disputes and canceling promises;
  • accepting or rejecting match suggestions, so you can still apply cash;
  • logging activities, and snoozing and closing work items;
  • viewing every page and running every report;
  • the setup, license and assisted setup pages, and demo data;
  • all native Business Central posting;
  • payment plan checks, canceling plans and printing agreements;
  • payment links, the group view, agency withdrawals and recoveries;
  • tracking, canceling and simulating physical mail.

Customer ledgers, credit hold releases, cash application and reports keep working without a license.

Who needs a seat

Only people who run the licensed actions need a seat. Users who only read pages and reports, such as the order desk, salespeople and controllers, need no seat.

Every user still needs their own Business Central license from Microsoft. A Bitta Collections seat does not replace it. Seats are also separate from permission sets; see Permission sets.

Connection to Bitta Apps

Bitta Collections never calls Bitta Apps in the background. It connects only when an administrator chooses Get License, Enter Activation Code or Start Free Trial, or when the assisted setup starts the trial in an environment without a license. It sends only the Microsoft Entra tenant ID, the environment name, the app version and the activation code (no code for the trial).

In a sandbox environment, Business Central blocks outbound calls until you allow them. Search for Extension Management, choose Bitta Collections, choose Configure and turn on Allow HttpClient Requests. Production environments allow them by default. If you can't allow the calls, ask Bitta Apps for the license text and use Paste License.

Next step

Ready to try Bitta Collections?