M4 Charge Plans

From Kolmisoft Wiki
Jump to navigationJump to search






FUNCTIONALITY IS IN THE DEVELOPMENT STAGE

Description

Charge Plan is a set of options that determines HOW MUCH and HOW we will charge for some service. Charge Plan is a template for Subscriptions.

Usage

Go to ACCOUNTING –> Subscriptions –> Charge Plans:

Charge plans menu.png

Here you can see the list of Charge Plans and create a new Charge Plan.

Charge plans list.png

Charge Plan Settings

The Charge Plan can be a Periodic Charge or One-Time Charge.

Charge Plan Settings for Periodic Charge


Charge plans m4 new.png

General Settings

  • Name - name of the Charge Plan.
  • Name visible to end User - the name of the Charge Plan that will be visible to the end User. This name will also be included in Invoices.
  • Status - status of the Charge Plan.
  • Can be applied more than once - if set, Charge Plan can be applied more than once to the same User.
  • Description - description of the Charge Plan.


Period Settings

  • Period - subscription period (day(s), week(s), month(s), or year(s)). The number defines how long is the period. For example, if the period is set to a month and the number is set to 1, then a common monthly period will be used as the subscription period. The user will be charged for a single month and the charging repeats every month until the subscription is canceled. If the period is set to a month and the number is set to 6, then the user will be charged one time every 6 months (for example, if the subscription price is 10 EUR, then the subscription will be charged 10 EUR for those 6 months).
  • Align Period - if set, then the first and the last subscription periods will be aligned. This option is only relevant when a subscription starts in the middle of the period.

Examples of aligned and non-aligned periods:

If a monthly subscription starts on 2023-01-01 00:00:00, then there is no need to enable Align Period option since the subscription starts on the first day of the month (it is already aligned).

If a monthly subscription starts on 2023-01-10 00:00:00 and Align Period is not enabled, then subscription periods will always start at 10th day of the month:

2023-01-10 00:00:00 - 2023-02-09 23:59:59 (first period)
2023-02-10 00:00:00 - 2023-03-09 23:59:59 (second period)
2023-03-10 00:00:00 - 2023-04-09 23:59:59 (third period)

If a monthly subscription starts on 2023-01-10 00:00:00 and Align Period is enabled, then subscription periods will be adjusted to start on the first day of the month and end on the last day of the month:

2023-01-10 00:00:00 - 2023-01-31 23:59:59 (first period)
2023-02-01 00:00:00 - 2023-02-28 23:59:59 (second period)
2023-03-01 00:00:00 - 2023-03-31 23:59:59 (third period)

Here the first period is aligned as if it started on the first day of the month, therefore it ends on the last day of the month (2023-01-31). This way, all other periods (second, third) will start on the first day of the month.

Note that after Period adjustment, the first period is shorter (only 22 active days). In this case, additional options allow you to either charge the full price (for a whole month) or charge for active days only.

  • Full charge First Period (do not prorate) - charge the full amount on the first period. For example, if the Charge Plan price is 10 EUR, the period is monthly, and the subscription starts on the 10th of January, with this option enabled, January will be charged for the full 10 EUR. With the option disabled, January month will be charged for 22 active days: (10/30) * 22 = 7.33 EUR (here 10/30 is the price for a single day, 22 is active days).
  • Full charge Last Period (do not prorate) - same logic as above, but for Last Period.


Periodic Charge Settings

  • Try to renew in advance - hour(s) or days(s) in advance to try renewing (charging) subscription. For example, if this option is set to 1 hour, then the subscription will be charged 1 hour before the actual subscription period starts.
  • Try to renew for - hours(s) or days(s) for how long we will try to renew (charge) subscription.
  • Apply subscription Charges: - how to apply subscription Charges. Available Options:
    • At the end of the Period.
    • In advance.
      • Periods in advance - how many periods charge in advance. Default: 1.
    • Progressively (every day).
  • Charge Suspended Customers - at the time of applying subscription Charges, should we charge a Suspended Customer (User)? Default: No.
  • If balance insufficient:
    • Block User - yes or no.
    • Suspend Service - yes or no.
    • Charge Subscription - yes or no.

Note: Profit loss is possible if all three options are unchecked.

    • Send Email Notification to:
      • Admin
      • User


Activation Settings

  • Subscription is Activated - either on At the given start date or Upon the first usage.
  • If balance insufficient - either Allow activation or Deny activation.
  • Charge for Past – charge subscription for past dates. Example: subscription start period is set to 2022-01-01, but added on 2022-02-01 with the selected option, 2022-01-01 will also be charged


Cancellation Settings

  • Minimum Subscription Period - a period in months for which Customer will be charged if the subscription is canceled earlier.
    • Early Cancellation Penalty - either Fixed (enter manual value) or Remaining Subscription charges.


Credits

  • Issue credits for the days when: - issue money refund for days when the User was not able to use the subscription due to being blocked, suspended, or both.
    • The customer was blocked.
      • Invoice Line Name - name in Invoice for blocked days refund.
    • The service was suspended.
      • Invoice Line Name - name in Invoice for suspended service refund.
  • Skip credits, charge in full: - skip money refund for specific periods.
    • For the first billing period.
    • For the regular billing periods.
    • For the last billing period.


Billing Settings

  • Currency - one of the active currencies in the system.
  • Activation Fee - fee for a Charge Plan activation.
    • Invoice Line Name - name in Invoice for a Activation Fee.
  • Periodic Fee - Periodic Charge Plan Fee.
    • Invoice Line Name - name in Invoice for a Periodic Fee.
  • Rounding Precision - rounding precision in decimals.
  • Rounding method - available options:
    • Up - round to higher value. If the precision is 2 decimals 5.377xxxxxx will be rounded to 5.38.
    • Down - round to lover value. If precision is 2 decimals 5.377xxxxxx will be rounded to 5.37.
    • Round - round to nearest value using simple rounding logic. If precision is 2 decimals 5.355 will be rounded to 5.36, and 5.354 will be rounded to 5.35).


Charge Plan Settings for One-Time Charge



Charge plan one time new.png

General Settings

Same settings as in General Settings for Periodic Charge.

Activation Settings

  • If balance insufficient - either Allow activation or Deny activation.


Billing Settings

The same as Billing Settings for Periodic Charge, only Periodic Fee option is not available.



See also