Before you start
Get started
Install Bitta Subscriptions, start the free trial or activate a license, run the assisted setup that checks Subscription Billing, and create demo data.
updated: applies-to: 1.3.5.0
Install the app, activate the license, and run the assisted setup. The assisted setup checks Microsoft's Subscription Billing prerequisites, sets the lifecycle defaults, schedules the daily tasks and, in a sandbox, can create demo data.
Use it once per company, right after you install the app. You can run it again later; it never overwrites data you entered.
Before you start
- Business Central online, version 29.0 or later.
- Microsoft's Subscription Billing app is installed (it is by default) and set up enough to bill: number series for contracts and subscriptions, a billing template, and contract accounts in the general posting setup. The assisted setup checks each of these and tells you what is missing.
- You have the Bitta Subscriptions - Admin permission set (see Permissions and seats).
Step 1: Activate the license
Bitta Subscriptions is licensed per Microsoft Entra tenant for a number of seats. A seat is a user who runs lifecycle actions (amend, hold, terminate, escalate prices, apply promotions, send renewal notices, use the plan picker, renew from the cockpit, create reseller statements). Microsoft's billing, posting and viewing never need a license or a seat.
- Choose the search icon, enter Bitta Subscriptions License, and then choose the related link.
- Choose one of the actions in the License group:
- Paste License: paste the license text that Bitta Apps sent you, and then choose OK.
- Enter Activation Code or Get License from Bitta Apps: the app fetches the license from bittaapps.com with the activation code that Bitta Apps sent you.
- Request Trial: starts your tenant's free 30-day trial for 3 users at once. Each Microsoft Entra tenant gets one trial. If the license service cannot be reached, Request Trial offers the Bitta Apps contact form instead.
- Choose Give Me a Seat to take a seat yourself, or choose Assign Seat in the Seats part to give one to another user.
The Status field shows Active when the license is valid. Details says what to do when it is not.
Step 2: Run the assisted setup
Choose the search icon, enter Set Up Bitta Subscriptions, and then choose the related link. It is also on the Assisted Setup page and in the Setup menu of the role center.
Welcome. Choose Next.
Microsoft Subscription Billing. The wizard lists Microsoft's prerequisites with a Check Status of Passed, Missing or Recommended. Use Fix to open the page that solves a line, then Refresh. Every Missing line must be fixed; recommendations are optional.
Features. The step asks Which features do you use? Plans and add-ons, amendments, holds, terminations, renewals, price increases, promotions, trials, bundles, one-time charges, usage commitments and tiered pricing, the recurring-revenue reports, the migration kit, webhooks and the APIs are always on. Turn on the modules you need as well:
- Devices: Sell Hardware with Serial Numbers, for example connected devices, meters or terminals that you ship with a service;
- Resellers, if partners resell your subscriptions or refer customers;
- Billing Plans, for installment plans, milestones and prepaid balances;
- Revenue Recognition, to allocate revenue by standalone selling price (set up its accounts afterwards in the setup);
- Approvals and Contract Lock, to send changes for approval and lock contracts.
A module you leave off is hidden everywhere, including search, and its background work does not run. You can change your answers at any time in Subscription Features.
Number Series. Choose series for Amendment Nos., Hold Nos., Termination Nos., Billing Operation Nos. (subscription moves, changes invoiced now and batch changes), Reseller Nos. and Reseller Statement Nos. (only with Resellers), or leave them blank and keep Create Number Series turned on. Finish then creates SUB-AMEND, SUB-HOLD, SUB-TERM, SUB-BILLOP, SUB-RES and SUB-RSTMT for the blank fields, and uses a series with that code if it already exists. If you turn Create Number Series off, the setup still works: billing operations create their series the first time you use them, you type reseller numbers yourself, and once you have a reseller the Health Check reminds you that reseller statements need a series.
Lifecycle Defaults. These defaults are proposed in every amendment, hold and termination, and users can change them each time:
- Upgrade Timing and Downgrade Timing: Immediately, Next Billing Date or End of Term.
- Adjustment Item No.: the item that credits use for subscriptions whose item is not a subscription item.
- Extend Term on Hold: moves the end of the term by the length of a hold.
- Termination Settlement: Credit Unused, No Credit or Bill Remaining Term.
- Fee Method (None, Fixed Amount, Percent of Remaining Value), Fee Value and Fee Item No. for early-termination fees.
Pricing and Renewals. Choose the Escalation Mode (Proposal or Automatic), the Escalation Horizon, the Renewal Horizon (default 90 days), the Notice Lead Time (default 30 days) and the Notice Recipient (Bill-to Contact or Customer).
Devices (only when you turned on Devices in the Features step). Choose how shipments register the devices, what a device return does and, in Main Identifier Type, the identifier that device lists show next to the serial number, for example an asset tag. Leave it blank to show the serial number only. To add a type such as ASSET-TAG, MAC or IMEI, choose the field, then New. See Device register.
Automation. Turn on Schedule Daily Tasks. Scheduled amendments, hold resumption, price increase proposals and renewal notices then run once a day in the job queue, and so do the tasks of release 1.2: prepaid balance expiry and alerts and finished installment plans (with Billing Plans), and, in companies that sell devices, the end of dealer prepaid device terms. If you set up Bitta Subscriptions before 1.2, run the assisted setup again, or the Health Check, to schedule the new tasks.
License. Shows the License Status. Choose Open License if it is not usable.
Demo Data. In a sandbox or an evaluation company, turn on Create Demo Data (see below). The field is disabled in production companies.
Selling and Change History. Choose the Default Contract Assignment of sales orders, the Trial Reminder Lead Time, the Trial Cancel Reason Code and Co-term New Order Lines (lines from new orders take the term of the contract), and keep Turn On Change History on to record who changed a contract or subscription and when.
Choose Finish. When you changed a feature, a message asks you to reload the browser page (F5), so that the menus, the role center and search show the change.
The setup also offers Turn On Change History, which records changes to contracts and subscriptions in Business Central's change log (Trials and bundles), and the device defaults (Devices). You can change every default later on the Bitta Subscriptions Setup page, and turn modules on or off in Subscription Features (the action is on the setup page and in the Setup menu of the role center).
Step 3 (optional): Explore with demo data
Demo data is created only in sandboxes and evaluation companies. It needs Microsoft's own Subscription Billing demo data (item SB1102 or SB1100), because the demo items copy its posting groups and packages.
| What | Created |
|---|---|
| Plans | Cloud Suite Basic (30.00) and Cloud Suite Pro (50.00), plan family CLOUD-SUITE |
| Add-ons | Standard Support (5.00) and Premium Support (15.00); Premium Support excludes Standard Support |
| Items for the setup | BAASUB-ADJUST (adjustment item) and BAASUB-FEE (early-termination fee) |
| One-time charge type | INSTALL (installation fee, 150.00), billed by the item BAASUB-INSTALL. Try it with Add One-Time Charge on a customer contract or a sales quote |
| Devices (only with Sell Hardware with Serial Numbers) | The serial-tracked hardware BAASUB-DEVICE (Connected device, 120.00) and its service plan BAASUB-DEVSVC (Device service, 10.00, plan family CONNECTED); identifier types ASSET-TAG, MAC and IMEI |
| Price index | CPI-DEMO with 24 monthly values |
| Escalation rules | CPI-YEARLY (index, 3-month lag, cap 5 %) and STEPPED-3Y (+5 %, +4 %, then index) |
| Promotion | 3MFREE, three months free, offered on both plans |
| Setup defaults | 10 % early-termination fee, 90-day renewal horizon, 30-day notice lead time (only where blank) |
| Resellers (only with Resellers) | REFERRAL-DEMO (10 % commission), set on the first two existing contracts without a reseller; RESALE-DEMO, set on the first customer without a contract |
No customers, contracts or subscriptions are created. Use Microsoft's demo contracts, or sell a demo plan with Choose Plan. Running the demo data again adds nothing and keeps your edits.
Find Bitta Subscriptions on your role center
The role centers, menus and cues below show the modules that are on in Subscription Features; for example, Resellers and Reseller Statements appear only with Resellers on.
Most small businesses work on the Business Manager role center. Bitta Subscriptions adds two things to it:
- The Subscription Lifecycle part, after Microsoft's activities. Its cues show what needs you, for example renewals and Cancellation Deadlines due, holds to resume, open adjustment lines, Notices Failed Today, My Renewals to Follow Up, Changes Pending Approval, Low Balances, Milestones Due, Awaiting Activation and Failed Background Runs. Choose a cue to open the records behind it. Users without a Bitta Subscriptions permission set see a short hint instead of the cues.
- A Subscriptions menu at the top, in the order of daily use:
- Customer Contracts, Subscriptions, Recurring Billing, Billing Operations and One-Time Charges;
- Amendments, Holds, Terminations and Subscription Approval Requests;
- Renewal Cockpit, Devices and Subscription Catalog;
- Resellers and Reseller Statements;
- Subscription Reports;
- Set Up Bitta Subscriptions, Bitta Subscriptions Setup and Bitta Subscriptions License.
On the Customer Contracts list, Open Contract (first on the Home tab) opens the selected contract, also when Business Central moves its own View and Edit under More options.
Microsoft's Subscription Billing role center gets the same cues and a Bitta Subscriptions menu: Amendments, Holds, Terminations, Subscription Approval Requests, Renewal Cockpit, Billing Operations, One-Time Charges, Devices, Subscription Catalog, Resellers, Reseller Statements, the setup and the license. Its Reports menu starts with Subscription Reports.
On the Item Card, the Subscription Catalog group (on the Item tab) opens the item's Catalog Entry, Catalog Rules, Price Tiers, Bundle Components and Standalone Selling Prices, and the Subscription Catalog FactBox shows whether the item is a plan, an add-on or a bundle, its plan family, tier pricing, trial period and whether it is blocked.
On the Customer List and the Customer Card, the Subscriptions FactBox shows the customer's active contracts, monthly recurring revenue, next cancellation deadline and term end, and the contracts on hold. See FactBoxes and search.
For a full workspace with every page and report, choose the Subscription Lifecycle Manager profile in My Settings.
What happens in Microsoft Subscription Billing
Nothing changes in Microsoft's data until you run a lifecycle action. The assisted setup only writes Bitta Subscriptions' own setup, number series, job queue entries and, if you ask for it, demo records.
Next steps
- Set up the catalog
- Give users permissions and seats
- Run the Health Check
- New in 1.2, each off until you set it up: revenue recognition, installment plans and milestones, prepaid balances, approvals and the contract lock