Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

 

 

 

Excerpt
hiddentrue

Learn to work with Normal billing

Panel
nameblue

On this page

Table of Contents
maxLevel2

Overview

Normal subscriptions can be billed in a group through Normal Billing of normal subscriptions is used to bill customers before (pre-bill) or after (post-bill) they start using services they have bought or are subscribed to. Through the billing run, bills to be sent to customers are created, while the customer's accounts receivable is either debited or credited accordingly.  Other than subscription services (termed and usage services), a normal billing run also bills physical goods, expenses and one time services, that are either added to a Subscription or a Job

Setting up Normal Billing Runs

Configuration required before executing normal billing runs is available at Billing Definition at Normal Billing Settings tab.  A bill is an itemized account of the cost of physical goods supplied, termed, usage and one-time services rendered and Subscription or Job expenses.  Bills consist of the invoices and credit notes created by the system for an account during the period the bill covers and are created by a billing run. Billing can take place before or after customers start using their subscription services. 

More specifically billing process is responsible for:

  • Billing the services
  • Renewing services
  • Setting services as candidates for deactivation

Available Billing Models 

According to the billing model of each subscription being billed the 

  • Pre-Billed - Pay before Bill: Services are pre-billed either anniversary or period based, and a bill is generated but only if the rated amount was already paid in advance.
  • Pre-Billed - Pay after Bill: Services are pre-billed either anniversary or period based, and a bill is generated which is expected to be paid afterwards
  • Post-Billed - Pay after Bill: Services are post-billed and a bill is generated which is expected to be paid afterwards

 

Setting Up Normal Billing Runs

Before executing normal billing runs, perform the necessary configurations in the Normal Bill Settings tab.

Info

Configuration > Billing Application > Billing > Set up Billing Definition > Normal Bill Settings


Using Normal Billing Runs

Info
Billing > Billing > Perform Normal Billing Runs

Normal billing run fields

This table contains an explanation of The table describes the sections of the the normal billing run Data  Data Entry page , a description of the usage of its fields and additional informationand explains how the fields on the page are used.

 Mandatory    CConfigurable values.

Main Information

Bill As Of as of Date:Defines the date from where normal billing run should start.   The first day of the period covered by the normal billing run.   Subscriptions with services whose having a 'Rated up to' date is equal or before up to and including the 'Bill as Of of Date' are taken into accountconsidered for billing.

Life Cycle State : The life cycle state of indicates which stage the billing run reflects the stage that the billing is at:

  • Draft : The billing run was (not yet executed yet)
  • Identification and Rating: The billing run was executed up to this stepInvoicing: The billing run was executed up to this step
  • Invoicing 
  • Assembling and Posting: The billing run was executed up to this step
  • Formatting: The billing run was executed up to this step
  • Completed: All billing run steps were executed successfully
  • Failed: The billing run was not executed and no bills were created
  • Completed with Errors: the billing run was executed with minor errors and bills were created

Scheduled Date: This is a Read-only field which is available once a run is scheduled. The date provided shows the latest date that the Run is scheduled to be executed on.

Criteria

You can manage who you are billing by providing specific criteria. Only subscriptions that meet the criteria defined are included in the billing. For example you can choose to bill your monthly subscribers in one billing run and your annual subscribers in a different billing run. You can defined specific values for 'Billing Term Schemes', 'Billing Frequencies', 'Accounts Receivable Classifications', 'Payment Preferences', 'Presentment Preferences'

Filters
As with criteria you can define filters that will be used during billing , to only bill specific specific entities. For example you can select to bill only entities that belong to a group, where that group can represent a geographical area. Filtering can be applied on, 'Accounts Receivable', 'Subscriptions', 'Jobs', 'Groups'
Scheduling Settings
Recurring: Determines whether the billing run takes place once or is recurring. In the case of a recurring, the recurrence is Read-only and is inherited from the billing definition settings. Once a billing run defined as recurring, is completed, the system schedules the next one as defined by the recurring settings
  •  
  • Formatting 
  • Completed (all steps executed successfully)
  • Failed (not executed, no bills created)
  • Completed with Errors (run executed with minor errors; a number of bills were created successfully).

Scheduled Date: A read-only field displaying the next date on which the run will be executed.

Criteria

Can be used to identify groups for billing (e.g., monthly or annual subscriptions).  Values can be defined for billing term schemes, billing frequencies, classifications, payment preferences, and presentment preferences.

Filters

Can be applied to bill selected entities (e.g., a group representing a specific geographical area). Filtering can be applied to accounts receivable, subscriptions, jobs, and groups.

Scheduling Settings

Recurring: Select repeating billing runs. 

Recurrence: A read-only value inherited from the billing definition settings, used by the system to schedule the next run once a recurring billing run is completed.

Financial Transaction Settings

Financial Transaction Posting Date: The date on which the Defines the posting date for invoices and credit notes created from by the billing is set as posted. The run. A default value is set by the Normal Billing Definitions inherited from the normal billing definition and can be modified by the user.

Invoice Due Date Proximity: Defines how How the bill's due date of the generated invoices should be set. The settings consist of the following:

  • A Sign: - or +
  • A Value: The actual value that will be added on the due date, which is

    calculated

    based on the 'active' accounts receivable definitions due date rules 

    . The

    defined sign and

    value must fall within the proximity range defined

    in

    by the due date rules of the

    'active' Accounts Receivable Definition. The Due Date of the Invoices, calculated based on the billing run Invoice due date, overwrites the due date defined on the credit period of the accounts receivable
    Results

    Results are available once billing is completed providing you with active /wiki/spaces/WIP/pages/10010232.

    The calculated due date overwrites credit period rules set on the accounts receivable.

    Results

    Provide information on the bills that were created .

    Number of Generated Bills: The total number of Bills generated by the Run.

    Start Date: The date on which the Billing Run starts.

    End Date: The date on which the Billing Run ends.

    by the run and are available once billing is completed.

    Results Per Step: A summary table listing all the steps of the specific Billing Runbilling run, the Financial Transactions financial transactions that were created and the included entities included.

    Exceptions

    If any Display accounts were excluded from billing die due to errors then the accounts are shown along with the error.

    Creating and executing a normal billing run

    ...

    Navigate to normal billing run and specify Under Billing > Perform Normal Billing Run, specify the criteria that match the billing run you are interested in, or click on use NEW from the Actions menu to create a new billing run. Provide the mandatory information as defined in the fields table above and save the billing run. 
    Once you create your billing run you must execute it. Normal billing runs can be performed up to a specific step and resume their execution from the step that was reached, giving you the capability to review results and make changes if required before you proceed creating the actual bills. The progress of each normal billing run is determined by its life cycle state.  

    1. Select Actions > Execute up to 'step you would like to go'
    2. In the Execute Normal Billing Run Modal:
      1. Execute Now: Check the box to execute the Billing Run directly.
      2. Scheduled Date: Click on the calendar to select a date and time to start the execution. Click DONE when completed.
      3. Click SAVE

    Identification and rating step

    Identification identifies all the unrated billable (chargeable or creditable) information which is ready to be billed and should be considered during the specific Billing Run. The following entities are taken into consideration for normal subscription billing

      • Subscription Usage Detail Records that should be billed or credited and have a posted life cycle state
      • Subscription Termed Services: Checks for pre-bill and post-bill services that should be billed or credited (based on their billing directive) are not yet fully rated and their billing effective date is before or equal to the bill as of date.
      • Subscription Expenses:Checks for expenses that should be billed or credited (based on their billing directive)

    ...

    • Usage Detail Records
    • Subscription Service
    • Subscription Expenses
    • Subscriptions
    • Jobs
    • Buy in Advance

    .Once completed, the billing run life cycle state will be updated to 'Identification and Rating

    Invoicing step

    Invoicing step is responsible for the generation of invoices or credit notes, based on the rated billing items generated by the rating step, or on existing items that are not yet processed. Normal billing run settings defined in the billing definition are observed and invoices will only be created if the rules are met. Rounding options are also taken into consideration and adjustment transactions are created if required. Finally the life cycle state of all rated service periods that were invoiced or credited will be updated to 'Billed.'

    Billing run life cycle state will be updated to 'Invoicing.'

    Assembling and posting step

    ...

    • The creation of the Bill consists of accumulating all Invoices and Credit Notes created by the Invoicing Step and calculating the Total Bill Amount.
    • Billing also takes into consideration
      • Partially Settled or Unsettled Bills
      • Debit transactions which were posted between the current Bill and the previous Bill (and not included in any bills)
      • Credit transactions which were posted between the current Bill and the previous Bill (and not included in any bills)
        The Total amount to be paid is calculated using the following formula
        Total billed amount + Total due amount from previous Bills + Total debit amount posted between Bills - Total credit amount posted between bills

    ...

    The life cycle state of the billing run will be updated to 'Assembling and Posting'.

    Formatting step is used to format the billing run results in an XML file, which includes all the information that was considered or generated by the Billing Run process. 

    The Billing Run Life Cycle State is updated to 'Formatted.'

     

    Downloading billing run results file

    ...

    • Rated service periods formatting settings defined on Billing Definitions

    • Subscription Service usage Detail Records (UDRs) are included based on the usage detail records formatting settings defined on Billing Definitions

    Additionally the file includes a summary of the following:

    ...

    To extract the xml file:

    1. From the Actions menu click on Actions > Download Billing Results File
    2. From the click on Download and save the file locally so you can access it later and send to the print-house

    Viewing generated bills

    Bills generated from each billing run are easily accessible through action available from the Actions menu, Actions > View Generated Bills. The action will transfer you to the bills Summary page where only bills created from the selected billing run are shown. You can then click on each of the bills to access their Data Entry page where more information is available for each oneand SAVE the run. 

    To execute the run

    1. Select Actions > SUBMIT
    2. Execute immediately or schedule the run.

    Once the Billing Run is executed and finished the bills will be available for extraction in an XML format

    Note

    All steps in a run can be executed in one go. A run can also be executed up to the formatting stage, which can then be performed manually.

    Use the normal billing settings of the billing definition to set up the run according to your needs.

     

    Understanding the billing process

    Drawio
    viewerToolbartrue
    bordertrue
    fitWindowfalse
    diagramNameNormal Billing Flow R14
    width
    simpleViewerfalse
    revision1

    Account identification

    The accounts to be billed are identified by the billing process.

    Ranking

    Subscriptions and subscription services are ranked to determine their processing order, as described in the table below

    Sorting of SubscriptionsSubscriptions are sorted based on:
    • Ranking level, as defined on the subscription type, in ascending mode  
    • First activation date, in ascending mode
    • Creation date, in ascending mode.
    Sorting of Subscription Services

    Services are sorted based on the following logic:

    • Mandatory services without prerequisites
    • Mandatory services with prerequisites
    • Optional services without prerequisites
    • Optional services with prerequisites.

    Services within each category are then sorted based on the following logic:

    • By tier level, in ascending mode, as defined on the subscription type
    • By first activation date, in ascending mode
    • By creation date, in ascending mode.
    Note

    Subscriptions inherit a ranking number from their subscription type, while services are ranked based on whether they are mandatory (higher ranking) or optional (lower ranking).  This is also defined in the subscription type.

     

    Billing based on billing model

    The billing process identifies the price and period that subscriptions and services should be billed for.  The services are then renewed and billed, or are placed in a queue for deactivation (when the respective process is executed), following the logic in the table below:

    Billing ModelChecks and Actions
    Pre-bill Pay Before Bill

    Subject to sufficient funds for an additional billing period, or if the funds are automatically retrieved through a payment gateway:

    • The services are renewed
    • A bill is generated and settled

    If the funds are insufficient to cover the cost for the period:

    • Subscription services are classified as candidates for deactivation and are placed in a deactivation queue
    • No bill is generated
    Pre-bill Pay After Bill

    If the credit limit of the accounts receivable will not be exceeded after billing the services for an additional period:

    • The services are renewed
    • A bill is generated
    Post-bill Pay After Bill

    If the accounts receivable hasn't reached its credit limit:

    • The termed services are renewed
    • A bill is generated

     

    Downloading billing run results file

    The XML document, including all the bills created by the run, includes the following information for each bill:

    • Total Amount Due
    • All financial transactions created 
    • Rated service periods (for termed services)
    • Usage Detail Records (UDRs) (for usage services)
      Rated service periods and UDRs are formatted as defined in the billing definition formatting settings.

    The file also includes:

    • Number of bills created
    • Total number of accounts receivable billed
    • Total number of services billed
    • Total number of invoices and credit notes
    • Total debited amount and total debited amount per service
    • Total credited amount and total credited amount per service

    The XML document can be sent to a print-house to print the bills.  The bills can then be forwarded to the customers. 

    To extract the XML file:

    1. Click on Actions menu > Download Billing Results File
    2. Click on Download and save the file.
      For a sample Bill XML file, click here.

    Viewing generated bills

    Bills generated by each billing run can be accessed from the bills Summary page (Actions > View Generated Bills).

    For more information, access the Data Entry page by clicking on a bill.

    Other normal billing flows

    Using prepayment

    ...

    Normal billing supports the model of prepayment where any billable events , where billable subscription actions can only be performed occur if account owners have enough funds in their accounts to cover the amount that will be billed. In such case, account owners must make a payment in advance in order for the billable event to be performed. Billing in case of prepayment to cover their expense.  Prepayment is not handled by the normal billing run but .  The account owner must pay for an event in advance and the system will validate and bill must validate that there are sufficient funds to bill the event at the time that the billable event is executed. The following are considered as billable events in the system.of execution. If the funds are not sufficient, the action (e.g., a subscription or service activation) is rejected. 

    The process of validating a billable action and applying this real-time billing will be is triggered when one of the following actions following subscription actions is performed on normal subscriptions: 

    • Become effective subscriber 
    • Amend billing terms but only (if the action changes the subscription's scheme into a to Normal one)
    • Activate subscription
    • Start subscription service
    • Swap service
    • End subscription resting
    • End short term deactivation
    • Add usage service
    • Short Term -term activation
    • Add Effective effective Services
    • Add Expenseexpense
    • Amend Bundle Servicesbundle services
    • Change Subscription DistributionAmend Services and Installed Itemssubscription distribution
    • Amend services and installed items.

     

    Additional fees applied to a bill

    ...

    Additional fees can be applied on bills during a normal billing run process, based on the presentment preferences of the subscriber. Additional fees are applied to each bill on a separate invoice financial transaction.

    NameDescription

    Bill Additional Fees

    Define if additional expenses will be applied on the bill of each account owner. Multiple additional fee rules might apply in each billing definition. Additional fee rules can be modified or deleted at any time.

    Start by specifying the expense service that the account owner will be charged for on each bill, as well as the conditions that should be met to apply this extra fee (such as, which account owners will be billed with the fee).

    During a normal bill perform run, the billing definition will be checked against the subscriber and the additional fees will be applied.

     

    Glossary  

    CRM.COM TermDefinition
    JobSmall A small project initiated by the operator for customers, involving the delivery and billing of services and , products, as well as and activities. Customer requests and orders, such as that for a new subscription, can be initiated and registered through a job.
    SubscriptionA collection selection of customer services which is provided to customers and billed on a recurring, usage or Oneone-Time time basis.
    Billable entityEntityEntities which that can be billed through the billing engine , i.e. (Jobs and Subscriptions).
    Rated Billing Items (RBIRBIs)Rated Billing Items is information Information on services, physical goods and the billing period, generated by the billing engine during the rating step of the normal billing run, before the financial transaction is createdtakes place
    They store information on the services, physical goods and additional billing period information and give you the chance to make amendments and corrections before the financial transaction which is a legal document is created,RBIs let the user make amendments or corrections before (a binding) financial transaction is created.
    Usage Detail Records (UDRUDRs)Usage Detail Record. UDRs are used to hold raw information Information describing the use of Usage Subscription Services. For more information view Usage Detail Recordsusage subscription services.
    Period billingBilling

    A

    method of

    mode that involves billing

    where

    customers

    are billed

    for a period

    of time which starts

    starting on a billing cycle day

    which is

    specified by the

    billing

    company.

     For example, if a customer

      If the billable entity is activated for the first time on

    the 20th

    a day of the month

    , but the Billing Cycle Date is set to the 1st of the month, then the billing will always cover the period starting from the 1st of the next month till the 1st of the following month, while the first Bill of the customer

    other than the billing cycle day, the first bill will also include the

    10

    days

    from the month of the activation

    up to the billing cycle day.

    Anniversary billingBilling

    A

    method of

    mode that involves billing

    where

    customers

    are billed

    for a

    period of time which starts

    one-month period starting on a

    billing

    cycle day

    they have chosen. For example, if a customer is activated for the first time on the 15th of the month, then their Billing Cycle Date can be set to "15" and the billing will always cover the period starting from the 15th of the month till the 15th of the next.

    of their choice (e.g., the day on which the customer signed up). 

     

     

    Note
    titleNotes
    • If you are using a previous release, view CRM.COM Release Changes.
    • Use the Normal billing WEB API to create and manage accounts receivable from an external system, such as a customer portal. View the accounts receivable WEB API for a complete list of actions available through the WEB API.

     

     

    Panel
    namegrey

    Related Links

    Filter by label (Content by label)
    showLabelsfalse
    spacesV4Manual
    showSpacefalse
    labelsglobal

     

    ...