billmax documentation   BillMax Billing Solutions
  877.245.5629
  sales@billmax.com
 

Chapter 3. Configuring BillMax Billing Parameters

Table of Contents

Configuring a Virtual Company
Company Info
Company Options
Configuring Taxes
Tax Overview
Configuring Tax Rates
Configuring Usage Based Billing
Usage Based Billing Overview
Configuring Usage Based Billing
Configuring a Service Definition
Service Definition Overview
Prepaid Billing Plan

Configuring a Virtual Company

A Virtual Company may be used to segregate Accounts. Reasons for segregating Accounts may include:

  • Accounts are managed by different business rules.

  • Accounts are managed as if they belong to different business entities.

[Tip] Tip

The values specified for each Virtual Company are available for use in the Email Template Files.

There are two web pages that are used to configure a Virtual Company. These are "Company Info" and "Company Options".

Company Info

Click on the Settings link on the Navigation Bar. Click on the "COMPANY INFO" button. The "Company Info" page will be displayed:

Figure 3.1. BillMax Company Info

BillMax Company Info


This page is used to specify contact information for the Virtual Company.

(1)

Clicking SEARCH with a value of "NEW COMPANY" in the dropdown brings up a web page with blank form fields. Otherwise it will bring up a web page with the values with an existing Virtual Company in the form fields.

(2)

Clicking SAVE with a value of "NEW COMPANY" in the dropdown will create a new Virtual Company. Clicking on SEARCH for an existing company, changing the dropdown to "NEW COMPANY" and clicking SAVE is a quick way to create a new Virtual Company using the values from the SEARCHed Virtual Company as defaults for the new Virtual Company.

(3)

The "Company Information" section is displayed on the header of the standard BillMax Statement.

Figure 3.2. BillMax Statement Header

BillMax Statement Header


(4)

Billing Contact email address. This email address is used as the "From:" address when BillMax sends emails to customers. This address receives daily processing emails. A value for this field is required.

(5)

Administrative Contact email address. This email address is used as the "To:" for daily processing emails. A value for this field is required.

Company Options

The Company Options page specifies business rules.

[Warning] Warning

Many of the following settings act as defaults for Accounts when creating a new Accounts. Changing theses values will affect new Accounts only, and not existing Accounts.

Click on the Settings link on the Navigation Bar. Click on the "COMPANY OPTIONS" button. The "Company Options" page will be displayed. This page is composed of the following:

Figure 3.3. BillMax Company Basic Options

BillMax Company Basic Options


(1)

If a partial service term is billed a prorated amount, the setting of billnextterm determines whether an additional complete service term is billed in addition to the partial term.

  • No - Additional complete service term not billed during Service creation.

  • Yes - Additional complete service term billed during Service creation.

  • Ask - Prompts Customer Service Representative when a new Service is added.

(2)

Defines tax status of postal and fax surcharges.

  • No - postal and fax surcharges are not taxable.

  • Yes - postal and fax surcharges are taxable.

(3)

Default domain used when creating an email address for a User or Account. If a User or Account does not have an email address, when a Service is created, the Service d01 field is combined with defdomain to create an email address for the User and/or Account. The Customer Service Representative is prompted whether to use the value to populate the Account and/or User data.

(4)

The default used for populating the Invday of a new Account

  • 0 - The day of month of the current date is used to populate the Invday of a new Account.

  • 1 through 28 - used to populate the Invday of a new Account.

(5)

Default monthly charge for sending an Account fax statements.

(6)

The default state of a new Service.

  • OPEN - Open State.

  • WAIT_FOR_PAYMENT - Wait_For_Payment State - This default is not used if the amount billed for the service does not cause the Account to have a positive balance or the value for account.ccnum is blank.

The state of a service will be changed from WAIT_FOR_PAYMENT to OPEN if either a payment is received or 30 days elapse.

(7)

Default postal cost for Accounts that receive postal statements.

(8)

24 hour clock time specifying the end of Prime Time used in Metered Billing.

(9)

24 hour clock time specifying the start of Prime Time used in Metered Billing.

(10)

Number of days that a service must be open before referral Store Credit will be issued to the referring Account.

Figure 3.4. BillMax Company Basic Options (continued)

BillMax Company Basic Options (continued)


(1)

Blank Statement(monthly)

Send a blank Statement monthly to Accounts even if there has been no financial activity.

Non-zero Balance

Send a Statement monthly to Accounts that have a non-zero balance.

Activity Monthly

Send a Statement to Accounts that have had financial activity in the past month regardless of money owed or not. A Statement is sent only if the customer has not already received a Statement detailing the financial activity.

Monthly(money owed)

Send a Statement to Accounts at least monthly that owe money.

Monthly(money owed greater than overduemin)

Send a Statement to Accounts at least monthly that owe an amount greater than config.overduemin.

Activity Daily

Send a Statement to Accounts any day there is financial activity. If this option is chosen, it is recommended that the -g be specified when running make_statements and send_statements.

Activity Daily(money owed)

Send a Statement to Accounts any day there is financial activity and money is owed at the end of processing. If this option is chosen, it is recommended that the -g be specified when running make_statements and send_statements.

(2)

Default payment terms for Accounts paying via the check or cash Payment Method.

(3)

Default payment terms for Accounts paying via the credit card Payment Method.

(4)

Default payment terms for Accounts paying via the ecash Payment Method.

(5)

Default payment terms for Accounts paying via the EFT Payment Method.

(6)

When a Service State is changed from Wait_For_Payment State to Open State, should BillMax automatically issue Store Credit for the time the Service State was Wait_For_Payment State?

Figure 3.5. BillMax Company Credit Card Processing Options

BillMax Company Credit Card Processing Options


(1)

Defines how long in days before an Account's credit card expiration date an email may be sent to the Account notifying the Account holder of the impending credit card expiration. See Email Template Files.

(2)

Defines the amount to bill an Account when the Account credit card is declined.

(3)

The number of days to wait between re-trying a declined credit card.

(4)

The maximum number of consecutive unsuccessful attempts to charge a credit card.

(5)

The Permissions needed to view the full credit card number.

(6)

The default maximum Account balance that will be charged to a credit card through nightly processing. If the Account balance is greater than this amount and this amount is non-zero, credit card processing will not occur for the Account.

(7)

The default minimum Account balance that will be charged to a credit card through nightly processing. If the Account balance is less than this amount and this amount is non-zero, credit card processing will not occur for the Account.

(8)

The default minimum Account balance (specified as a small negative value) that will be refunded to a credit card through nightly processing. Ignoring the negative sign, if the Account balance is refundable and the amount is less than this amount and this amount is non-zero, credit card processing will not occur for the Account

(9)

The default maximum Account balance (specified as a large negative value) that will be refunded to a credit card through nightly processing. Ignoring the negative sign, if the Account balance is refundable and the amount is greater than this amount and this amount is non-zero, credit card processing will not occur for the Account

Figure 3.6. BillMax Company Delinquency and Notification Options Options

BillMax Company Delinquency and Notification Options Options


(1)

Defines the number of days a Account, User or Service remains in a Suspended State before being changed to a Closed State.

(2)

Specifies how many days before the expiration of a Grace Date an email is sent. Once emails are started, an email is sent daily until Grace Date is reached. See Email Template Files.

(3)

A surcharge billed to an Account when the Account becomes overdue. If latepct is specified, the larger of the two is billed. These surcharges are billed monthly every invday without regards to p-rebilldays.

(4)

Determines whether or not Accounts in the Closed State are billed late fees.

  • No - late fees are not billed.

  • Yes - late fees are billed.

(5)

A percentage used to calculate the surcharge billed to an Account when the Account becomes overdue. The surcharge is the amount overdue multiplied by the percentage. If lateamt is specified, the larger of the two is billed. These surcharges are billed monthly every invday without regards to prebilldays.

(6)

Defines whether or not late fees are taxable charges.

  • No - late fees are not taxable.

  • Yes - late fees are taxable.

(7)

How often overdue notices are sent. Number of days between overdue notices is odinterval - 1.

Examples

  • 0 - No overdue notice sent.

  • 1 - Overdue notice sent every day.

  • 2 - Overdue notice sent every other day. 1 day in between overdue notices.

(8)

Maximum number of overdue notices sent to an overdue Account.

  • 0 - Overdue notices sent until the Account State is not Open State.

  • 1 or more - Maximum number.

(9)

Minimum amount owed by a Account that will trigger Overdue Processing.

(10)

Number of days an amount is overdue before overdue notices are sent to an Account. If 0, no notices are sent.

(11)

Number of days an amount is overdue before an Account gets suspended. If 0, Accounts are not suspended.

Figure 3.7. BillMax Statement Note Options

BillMax Statement Note Options


Figure 3.8. BillMax Company Advanced Options

BillMax Company Advanced Options


(1)

When the Service end date is specified using the Staff Interface, either by setting the end date or changing the Service State to Closed State, this option defines what to do for Sales that have Payhist Enddates in the future relative to the Service end date. The value supplied may be overridden on a Service by Service basis.

(2)

Default epaydays for an Account. When an invoice is created through automated processing, this value is added to the invoice date to set the invoice's epaydate. Epaydate is the first date an attempt will be made to collect payment for an unpaid invoice through automated payment processing.

(3)

A renewable service will be pre-billed this many days before it expires. Statements will be sent to customers this many days before their Invday also.

(4)

Specified whether to-date usage will be billed this config.prebilldays days before the next usage billing period as specified by usage billing options of a Service Definition.

(5)

Choose whether or not timing for collecting funds for usage data should take into account epaydays.

There are two aspects to usage data billing that are controlled by Virtual Company options. These are config.usageepaydays and config.usageprebilldays. The interaction with account.epaydays and config.prebilldays is best described with an example.

Example 3.1. Usage Billing Interaction with Epaydays and Prebilldays

Assume the following:

  1. account.epaydays is 10. "account" as each Account has its own epaydays. config.epaydays is just the default for new Accounts.

  2. config.prebilldays is 10.

  3. service.invdate is 2003-02-01.

  4. The Service Duration is one month.

  5. The Service Definition specifies that usage billing is to occur monthly on the day the Service is billed.

The billing for the subscription part of the Service occurs on 2003-01-22 and collection for the amount of the subscription part is scheduled for 2003-02-01.

How usage billing and collecting is determined in the following manner:

config.usageepaydays is NO and config.usageprebilldays is NO

The usage is billed on 2003-02-01 and collection for the usage amount is scheduled for 2003-02-01. This results in collecting for subscription and usage billings on the same day, but usage billing being done 10 days after subscription billing.

config.usageepaydays is YES and config.usageprebilldays is NO

The usage is billed on 2003-02-01 and collection for the usage amount is scheduled for 2003-02-11. The day funds for the subscription part are collected is the day that usage is billed. There is a 20 day gap between the day the subscription is billed and the funds for usage are collected.

config.usageepaydays is NO and config.usageprebilldays is YES

The usage is billed on 2003-01-22 and collection for the usage amount is scheduled for 2003-01-22. Funds for the subscription part are collected 10 days later. Although this combination is possible, it makes the least sense.

config.usageepaydays is YES and config.usageprebilldays is YES

The usage is billed on 2003-01-22 and collection for the usage amount is scheduled for 2003-02-01. The subscription billing and usage billing are done on the same day. The collections for the subscription and usage billings are done on the same day.



Document Revision A for BillMax 2.2.0   -   Copyright © 1997-2006 The iSpark Group, Inc.

All rights reserved. No part of this documentation may be reproduced or transmitted in any fashion without written permission by The iSpark Group, Inc. This documentation is for the sole use of licensees of the BillMax billing software created by The iSpark Group, Inc. Making the documentation available to a non-licensee of BillMax without written permission of The iSpark Group, Inc. is a violation of the use of this documentation.

While precautions have been taken in the preparation of this documentation, The iSpark Group, Inc. assumes neither liability nor responsibility for errors or omissions, or for damages resulting from the use of the information contained herein.

All terms mentioned that are known to be trademarks have been appropriately capitalized. Use of the a trademark does not affect the validity of any trademark or service mark.

Links to third-party Web sites are provided for convenience. The iSpark Group, Inc. is not responsible for any content contained in the third-party Web sites.

Comments about this documentation may be sent to doc@billmax.com