Skip to end of banner
Go to start of banner

Setting up & Executing Bill Sending Runs

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

What does this section cover?

What are Bill Sending Runs?

Bill Sending Run Definitions are used to determine the business rules that will be used in order to identify bills that should be sent through Email, SMS or an external system. 

Bill Sending runs are used to log the execution of bill sending run definitions, that were performed in order to identify the bills that should be send, create a communication and a communication queue entry, and if an external system is not specified, then process those communications, by sending them through email or SMS.

Bill sending runs can be performed only within an effective bill sending run definition. When executing a Bill Sending Run Definition the bills that should be sent are identified based on the following criteria

  • The related accounts receivable is active
  • The related accounts receivable includes an active presentment preference having a type equal to the type specified in the presentment preferences conditions
  • The bill meets the definition criteria

A new bill sending run is created each time a recurring Bill Sending Run Definition is submitted. Whenever a run has been submitted, the bill sending run is added to the scheduler to be executed based on the specified run definition scheduling.

Creating, Editing & Deleting Validations & Restrictions

ActionValidationsRestrictionsAdditional Information
Edit
  • Not Applicable
  • Not Applicable
  • If there is at least one scheduled bill sending run using that definition, then a new bill sending run definition instance is created having the same values as the previous one, the same unified code, an increased version number, and all the modified information.
Save
  • Mandatory Fields are specified
  • You cannot add the same segment in Included and Excluded segments criteria
  • Not Applicable
  • Not Applicable
Delete
  • Not Applicable
  • You cannot delete a Bill Sending Run definition
  • Not Applicable

Bill Sending Run attributes 

Name

Description

Name*

The name of the definition
Alternative code*The alternative code of the definition
DescriptionA description of the definition
Life cycle stateThe life cycle state of the definition. The supported values are effective and not effective
Unified codeAn auto generated code which is used to group the various instances of each Bill Sending Run Definition
VersionAn auto generated number which is used to specify the version of each Bill Sending Run Definition. New Bill Sending Run Definition versions are created each time they are edited, if they are already been used by any bill sending runs
Scheduled DateThis is a read only field which is available once you schedule a Run. The date provided shows the latest date that the run is scheduled to be executed.
Input Settings: It defines the settings that will be used in order to create the communications that will be used to send the bills
Communication Media*

The media that will be used to communicate the bills. The following media is supported:

  • Email: Applicable only if the presentment preference type is set to Email or one of the customs
  • SMS: Applicable only if the presentment preference type is set to SMS or one of the customs
  • Device: Applicable only if the presentment preference type is not set to Email or SMS
Communication template*The communication template that will be used to create the communication for each bill. The available communication templates are effective and filtered based on the media specified above. The media are equal to one of the following:
  • Email
  • SMS
  • Device
Communication Queue External System*

Used to determine the external system that will actually send the communication.

Mandatory on Conditions: Mandatory if the communication template is set to device and optional for any other types of communication templates

Criteria
Billing Run Criteria: It defines the criteria that will be used to retrieve the bills that will be sent
Bills filter method*

It determines which bills will be retrieved, based on if they were already sent, rejected during sending or not processed at all. The following options are supported:

  • Process only failed and not sent: If selected then the process will retrieve only bills which were already processed but they were rejected (i.e. the communication queue is rejected) or not processed yet
  • Process only failed: If selected then the process will retrieve only bills which were already processed but they were rejected (i.e. the communication queue is rejected)
  • Process only not sent: If selected then the process will retrieve only bills which were not processed yet
Billing Run Filter Method*

It determines the method that will be used to filter the bills. The supported options are the following:

  • Bills included in the latest normal billing run
  • Bills includes in specific billing runs

Billing Run Selection*

 

A set of normal billing runs that will be considered in order to retrieve the bills that will be sent.

Mandatory on Conditions: Mandatory only if the "Bills included in specific billing runs" option is selected as a Billing Run Filter Method

Presentment Preference Criteria: It defines the settings that will be used in order to retrieve the accounts receivable that will be processed
Type*

The type of presentment preference that will be used to retrieve the accounts receivable. The supported types are

  • Post
  • Email
  • SMS
  • F2F
  • Other
  • All Custom
Segment Criteria: Determines the criteria that are used to identify the bills that will be sent. At least one segment will be specified, in one of the two options
Included in Segment

A list of segments which are used to filter the bills that will be sent.

Not Included in Segment

A list of segments which are used to exclude bills.

Configuring a Bill Sending Run tailored to your company's needs

  1. Navigate to BILLING APPLICATION > BILLING > PERFORM BILL SENDING RUNS
  2. Either search for an existing one or from the Top Menu click on NEW
    BILL SENDING RUN DEFINITION
  3. MAIN INFORMATION

    1. Provide the related information

      1. Name
      2. Alternative Code
      3. Description
  4. INPUT SETTINGS

    1. Define the required values
      1. Email: Select from the drop down list
      2. Communication Template: Quick Search or use modal search to find the communication template to be used
      3. Communication Queue External System: Quick Search  or use modal search  to find the communication template to be used
  5. CRITERIA

    1. Presentment Preferences:
      1. Click on ADD  and select the preferences you would like to include from the dropdown
    2. Bills:
      1. Bills Filter Method: Select from the drop down the option that will filter the bills you would like to send
      2. Billing Run Filter Method: Select from the drop down list the option that will filter from which Billing Runs the Bills will be retrieved
        1. Included Billing Runs: If you have selected a specific option then 
          1. Click on ADD and search for the desired billing Runs
            BILLS CRITERIA 
    3. Segments
      1. For both Included and excluded segments the process is the same
      2. Click on ADD
      3. Select from the drop down list the segments that will be used as conditions

        Only BILL related segments will be loaded in the drop down lists.

        BILL SENDING RUNS - SEGMENTS

  6. SCHEDULING SETTINGS

    1. Select from the available options according to what you would like to achieve
      1. RUN NOW: Will be executed once, now 
      2. RUN ON SPECIFIC DATE/TIME: Will be executed once, at the date defined
      3. RUN REPEATEDLY: Will be executed, starting and ending at a defined date/time and will be repeated every X UOT where UOT can be from seconds to Years
      4. ADVANCED SCHEDULING: Will be executed, starting and ending at a defined date with powerful repetition options from daily to yearly
    2. Run Now

      SCHEDULING SETTINGS - RUN NOW
       

    3. Run On Specific Date / Time

      1. Start Process
        1. Click on the calendar select the date and time the run should start being executed. 
          DATE AND TIME SELECTION
        2. Once selected click on "DONE"
          RUN ON SPECIFIC DATE TIME
    4. Run Repeatedly

      1. Start Process - On a Specific Date
        1. Click on the calendar select the date and time the run should start being executed. 
        2. Once selected click on "DONE"
      2. OR Start process - After a period of time
        1. Provide how long after current date/time the process should begin
          START PROCESS - AFTER A PERIOD OF TIME 
      3. Repeat Process
        1. EVERY: Type a number (INTEGER)
        2. UOT: Select between
          1. Seconds
          2. Minutes
          3. Hours
          4. Days
          5. Weeks
          6. Months
          7. Years
            REPEAT - UOT
      4. End Process
        1. Select between
          1. Never End
          2. On a specific date (define the date)
          3. After a period of time (define period of time)
            END PROCESS 
    5. Advance Scheduling

      1. Start Process
        1. Click on the calendar select the date and time the run should start being executed. 
        2. Once selected click on "DONE"
          ADVANCED SCHEDULING 
      2. Repeat Process
        1. Select between
          1. Daily : Define every how many days 
          2. Weekly: Select specific days of the week 
          3. Monthly:Define every how many months or on a specific day of the month
          4. Yearly: Define a specific date/month or a specific day of a month, such as the 1st Sunday of every January
            ADVANCED SCHEDULING - REPEAT PROCESS
      3. End Process
        1. Select between
          1. Never End
          2. On a specific date (define the date)
            ADVANCED - END PROCESS 
     

  7. From the Top Menu click on SAVE
  8. LOG INFORMATION

    Log information section keeps all the logging information related to the specific record

    • Basic set of information available in all entities
      • Created By User: The user that created the entity
      • Created By Unit: The unit of the user that created the entity
      • Updated By User: The user that last updated the entity
      • Updated by Unit: The unit of the user that last updated the entity
      • Date Created: The date the account was entity
      • Date Updated: The date the account was last entity
        LOG DETAILS

Executing a Bill Sending Run

  1. Navigate to the definition
  2. Search for the definition you would like to execute
  3. Click on the number of the definition to go to the data entry page
  4. Confirm that SCHEDULING SETTINGS are correctly configured
  5. From the Actions Menu click on ACTIONS > "SUBMIT"
    RUNS - SUBMIT
  6. The job will be submitted to the scheduler and will become available under PROCESS RUNS
    1. Once completed the Life Cycle State will be changed from Draft to Completed
    2. If the Run fails then the Life Cycle State will be updated to Failed
      PROCESS RUN
    3. Check Process Successfully and Processed with Errors for a closer look of individual results 

 

Modifying a Bill Sending Run

When you edit a definition that already has completed or scheduled runs then the system will automatically update the Version of the definition, by increasing its number by 1. Essentially, the system will create a new definition and will carry over all the information and configuration, apart from the Version number.

Accessing a definition with multiple versions, you will always see the latest version, while you have the option to View configuration and Runs of Previous versions by using th "VIEW PREVIOUS VERSIONS" link found in the Main Information tab

  1.  Click on the VIEW PREVIOUS VERSIONS link
    VERSIONING 
  2. Search from the modal for the version you would like to see
  3. Select the version
    1. The system will now show the configuration and the process runs of the version you have selected.
  4. To go back to the current version click on the CURRENT VERSION link under Main Information
    CURRENT VERSION 

 

Deleting a scheduled Bill Sending Run

If you have scheduled (submitted) a Run by mistake or you want to change the definition before execution, you have the option to delete the current job that was sent to the scheduler, given that it has not been executed yet. i.e., Life Cycle State is still Draft.

In order to delete the job follow the steps below:

  1. Navigate to the definition, for which you have scheduled a job
  2. Click on the number of the definition to move in the data entry page
  3. Go to Process Runs tab
  4. Find the job and check the left box next to the Run
  5. Click on "DELETE"


  6. A modal will open with the job information
  7. Click on "DELETE"
  8. Click "OK" on the confirmation message
  9. Close the modal
    The job will be removed from the Process Runs 

Changing the Life Cycle State of a Bill Sending Run Definition

Definitions Life Cycle State can be changed between Effective and Not Effective by following the steps below 

  1. Go to the data entry page of the definition'
  2. If the definition's Life Cycle State is set to "Effective"
    1. From the Actions Menu click ACTIONS > SET AS NOT EFFECTIVE
  3. If the definition's Life Cycle State is set to "Not Effective"
    1. From the Actions Menu click ACTIONS > SET AS EFFECTIVE
      RUN DEFINITIONS - LIFE CYCLE STATE ACTIONS 

 

Visit Understanding Bills for business examples related to Bill Sending Runs

Related Areas

Popular Labels

  • No labels