Usage counters
15
Users through Purchase Returns
Subscription Limits & Usage
Settings · Subscription UsageImport access checks
2
Busy Import + Tally Import
Near-limit warning
85%
Card changes to warning/red state
Guide status
Implementation-backed
Current Dart screen
What Subscription Usage shows
A live organization-level view of plan capacity, current record counts, import access and the latest subscription details.
Subscription Usage reads the selected organization, resolves its current plan, loads the latest subscription record, counts the supported feature records, and compares each count with the numeric limit defined for that plan.
There are 15 numeric usage cards: Users, Employees, Accounts, Products, Manufacturing Orders, Sales, Purchase, Payment, Receipt, Journal, Contra, Quotation, Rental, Sales Return and Purchase Return. Busy Import and Tally Import are separate access cards rather than counters.
Important: the current usage queries do not apply a date range. These values are current total matching records, not monthly or financial-year-reset counters.
Screen behavior
• Pull-to-refresh / refresh action reloads all counters.
• Numeric limits show used / limit plus remaining count.
• No numeric limit returns an Unlimited badge.
• Upgrade opens the subscription upgrade sheet.
Plan limit matrix
These are the exact numeric limits returned by the current Subscription Usage screen logic.
| Feature counter | Lite | Elite | Prime | Other plan names |
|---|---|---|---|---|
| Users | 1 | 3 | Unlimited* | Unlimited* |
| Employees | 1 | 50 | 500 | Unlimited* |
| Accounts | 200 | 1,000 | Unlimited* | Unlimited* |
| Products | 50 | 250 | 1,000 | Unlimited* |
| Manufacturing Orders | 3 | 25 | Unlimited* | Unlimited* |
| Sales Vouchers | 25 | 100 | Unlimited* | Unlimited* |
| Purchase Vouchers | 25 | 100 | Unlimited* | Unlimited* |
| Payment Vouchers | 25 | Unlimited* | Unlimited* | Unlimited* |
| Receipt Vouchers | 25 | Unlimited* | Unlimited* | Unlimited* |
| Journal Vouchers | 25 | Unlimited* | Unlimited* | Unlimited* |
| Contra Vouchers | 25 | Unlimited* | Unlimited* | Unlimited* |
| Quotation Vouchers | 25 | 100 | Unlimited* | Unlimited* |
| Rental Agreements | 3 | 100 | Unlimited* | Unlimited* |
| Sales Return Vouchers | 10 | 100 | Unlimited* | Unlimited* |
| Purchase Return Vouchers | 10 | 100 | Unlimited* | Unlimited* |
* Unlimited: the app literally shows “Unlimited” when this screen has no numeric limit for that feature and plan key. This means no numeric cap is displayed by Subscription Usage for that counter; it should not be interpreted as a blanket promise that every VauPrime feature is unrestricted.
How usage is counted
The counter is based on matching saved records for the signed-in user and selected organization; Users is counted from organization membership.
| Counter | Current counting rule |
|---|---|
| Sales Vouchers | All matching Sales records for the signed-in user and selected organization. |
| Purchase Vouchers | All matching Purchase records for the signed-in user and selected organization. |
| Payment / Receipt / Journal / Contra | Transaction records filtered by voucher type for the signed-in user and selected organization. |
| Quotation / Rental / Returns | All matching records for the signed-in user and selected organization. |
| Accounts | Only non-system accounts are counted. Rows created by System or with account type System are excluded. |
| Products | All matching product records for the signed-in user and selected organization. |
| Manufacturing Orders | All matching manufacturing-order records for the signed-in user and selected organization. |
| Users | Organization member rows for the selected organization. |
| Employees | Employee records for the signed-in user and selected organization. |
No date filter
The screen does not limit these counts to the current month, subscription period or financial year. If old records remain in the organization, they can continue to appear in the displayed usage total.
Usage-card behavior
Each numeric card converts used and limit values into a progress bar, remaining count and near-limit warning state.
Used / limit
When a numeric limit exists, the card shows the current used count followed by the plan limit.
Remaining
Remaining is calculated from limit minus used and is never displayed below zero.
Near limit: 85%
At 85% usage or above, the card switches its progress/warning color to red.
Busy Import & Tally Import
Import access is evaluated separately from the 15 numeric counters.
Busy Import
The screen shows an access card instead of a used/limit counter.
Tally Import
Uses the same plan-access check as Busy Import.
Current source note: import eligibility is checked by a separate plan-access service. The current implementation explicitly ranks Lite, Elite and Premium for this check, while numeric Subscription Usage limits separately recognize Lite, Elite and Prime. Because these two checks are not identical, the import card should be treated as the app’s current displayed access result rather than inferred from the numeric matrix.
Subscription Details
The screen also displays information from the latest subscription record for the selected user and organization.
Plan
Resolved current plan name
Status
Latest subscription status; defaults to Active in the details UI when no value is available
Price
Plan price with subscription currency
Paid Amount
Amount recorded as paid
Start Date
Subscription start date
Expiry Date
Subscription expiration date
Validity
Plan validity value from the latest subscription record
Payment Method
Recorded subscription payment method
Upgrade flow
Use Upgrade when a numeric limit is close, reached, or when an import feature is not available on the current plan.
01
Open Upgrade
Select the Upgrade button from Subscription Usage.
02
Review Upgrade Options
The app opens Upgrade Options with messaging about increasing limits and unlocking imports.
03
Choose the required plan
Continue through the normal subscription upgrade/activation flow.
Troubleshooting
Messages and states that can appear from the current Subscription Usage flow.
| Screen message / condition | Why it happens | What to do |
|---|---|---|
| Please sign in to view subscription usage. | The usage screen requires an authenticated VauPrime user. | Sign in and reopen Subscription Usage. |
| Please select an organization first. | No valid organization context is available. | Select the intended organization, then refresh the screen. |
| A usage card is red | Usage has reached at least 85% of the numeric limit shown for that card. | Review the remaining count and use Upgrade if more capacity is needed. |
| A card says Unlimited | The screen did not return a numeric limit for that feature and current plan. | Treat this as no numeric cap on this Subscription Usage counter, not a promise that every unrelated product capability is unrestricted. |
| Busy or Tally Import shows locked | Import access is checked separately from the numeric usage counters. | Use Upgrade Options or verify that the current plan is recognized as eligible by the installed app version. |
| Usage looks higher than expected | The counters are not date-filtered in the current screen implementation. | Remember that the displayed number is the current total matching records, not a monthly or financial-year reset counter. |
Important implementation notes
Use these rules when interpreting the Subscription Usage page or writing support/marketing copy about limits.
Plan resolution: the screen prefers the latest subscription plan name when available, otherwise it falls back to organization state/company subscription information.
Accounts: system-created/system-type accounts are deliberately excluded from the account usage count.
Users: the Users counter is organization membership count, while most other counters are scoped to the signed-in user plus organization.
Unlimited: this is a UI result of a null numeric limit for that specific counter.
Refresh: the screen supports reload through its refresh control and pull-to-refresh behavior.