Activate a license

Bitta Commission needs a verified license before it calculates commission, produces settlement output or posts to the general ledger. This page shows how to activate a trial or subscription, how to read the license status, and what happens when a license is missing or has lapsed.

Bitta Commission Setup card showing the License group with a trial state

The License group shows the verified license state and limits.

Before you start

Request a 30-day production trial or your subscription activation code from Bitta Apps. Installing the extension alone does not activate a trial.
The person who activates must have the Bitta Commission Setup Administrator permission set (BAA Comm Setup Admin). Other users see the license status but cannot change it.
Keep the activation code private. Do not send it in ordinary support messages.

For plan prices, see Pricing.

Activate with an activation code

Open Bitta Commission Setup.
Go to the License group. Read 30-Day Trial and Activate Your Trial for a short summary.
Paste your code into Activation Code. The field is masked. The code is converted to a secret value immediately and is never stored.
Choose Activate License.
Read the message, then check the license fields:
- State should show Trial or Active.
- Valid Through shows when the verified license ends.
- Payee Limit shows the maximum number of active participants.
- Company Limit shows the maximum number of companies.
- Diagnostic shows a safe diagnostic code. It never shows license identifiers or the activation code.

The license must match your Business Central environment and company. If it does not, activation is refused and the diagnostic code explains why.

You can also reach the same actions from the setup wizard: Set Up Bitta Commission shows the license state, expiry date, days remaining and active payee limit on its first step. If the license needs attention, open Advanced and choose License and Recovery. A valid existing trial is reused, so you do not need to activate it again.

Activate with an offline license file

If Bitta Apps sends you a signed offline license file instead of a code:

Open Bitta Commission Setup.
Choose Import Offline License and select the JSON file.
Check State and Valid Through.

The raw file is not stored. The same verification rules apply as for direct activation.

Keep the license current

Action	When to use it
Refresh License	Updates a license that was already verified through direct activation. After a direct activation, the app also schedules a refresh job.
Deactivate License	Deactivates the current direct license and removes its refresh job, for example before you move to another environment.
Reconcile License Restore	Records an audited reconciliation when a verified license is pending review after an environment restore.
Recover Direct License History	Authenticates a retained license history row with its stored credential. Recovered history does not authorize operations.
Export History Recovery Request and Import History Attestation	Used with the Bitta Apps license administrator when the original credential is not available. An attestation cannot activate a license.

TIP

If refresh fails, the message states whether the license service timed out, rejected the request, reported a conflict or was temporarily unavailable, together with a reference code. Wait and try again, or send the reference code (not the activation code) to Bitta Apps.

License states

State	Meaning
Uninitialized	No verified license exists in this company yet.
Trial	A verified trial is in effect. A trial allows at most five active participants, even if the license shows a higher limit.
Active	A verified subscription is in effect, with the licensed payee limit.
Grace	The license is in its grace window. Calculation, settlement and posting continue, but you cannot activate additional participants.
Suspended, Expired, Revoked	The license no longer authorizes new commission output.

What a missing or lapsed license blocks

The app checks the license immediately before it creates new financial output. Without a verified license in the Trial, Active or Grace state:

Calculation of new positive commission is refused (BAA-LICENSE-PRODUCTION or BAA-LICENSE-AUTHORITY).
Settlement output, such as settlements, payroll-ready exports and AP exports, is refused (BAA-LICENSE-SETTLEMENT).
Accounting output, such as commission posting, is refused (BAA-LICENSE-ACCOUNTING).

Linked corrections that reduce an amount already produced are still allowed, so a return or clawback can be processed after a lapse.

Participant capacity is checked separately. Activating a participant, or creating new active participants in the setup wizard, is refused when the company would exceed the payee limit (BAA-LICENSE-CAPACITY). All active participants in the company count, not only the ones you are adding. Grace, Suspended, Expired and Revoked states do not allow new active participants.

These checks apply to producing new output. Existing commission records stay in the company.

What to check if it goes wrong

Symptom	What to do
The license fields and actions are not editable	Ask an administrator to assign BAA Comm Setup Admin to you in this company.
BAACOMM-PUB-LICENSE-BOOTSTRAP-001	The app could not build the environment identity for licensing. Contact Bitta Apps support with the code.
Activation conflict	Ask Bitta Apps to check the activation code and its company and environment association.
The wizard review blocks setup because of capacity	Select fewer new salespeople, review existing active participants, or ask Bitta Apps about a higher payee limit.