Overview

Invoice Sets are located under Admin → Invoice Sets.

Invoices are bulk-generated and organized as “Invoice Sets”Sets.” Invoice sets are based on configuration of Fee Categories and contain related invoices for the each fee category. Upon creation of a new Periodic Invoice Fee Categorylookup record, an invoice sets set and associated invoice amounts are automatically generated and made available for review (as “Prelists”). Invoices may be generated, with creation or related receivables from the Invoice Set.

Invoice Sets

To access Invoice Sets:

• Access the Admin menu and select Invoice Sets

  • The Invoice Sets page is opened listing all invoice sets with their associated fee category, fiscal year, effective period, number of records, last data refresh, and status.

Image Removed

in an Invoice Prelist. Financial staff can then Invoice one or more items in a prelist. When a set of prelist items are invoiced, invoice documents are generated and the financial charges are created.

What Items Are Included in an Invoice Set?

There are two major components to an invoice set:

1. The creation of the invoice set “container” “containers” for a given Fiscal Year and Effective Period, and

2. The determination of items to include in an invoice set based on the Effective Period and the charge amounts for each item.

Invoice Set Creation, Effective Periods, and Items Included

nVIRO will create a placeholder invoice set for each Fee Category and Periodic Invoice Fee/Year. The Fiscal Year and Effective Period for the Invoice Set are based on the invoice set’s Fee Category. The Invoice Set’s Effective Period is based on the Fiscal Year End Date month and day, and Invoice Frequency defined in the Fee Category. For example, if the Fiscal Year End Date is 7/1/XXXX and an Invoice Frequency of “Annual”, an invoice set will be created for Effective Period 7/1/20XX - 6/30/20XX each year.

Determination of Items and Amounts to

Include in an Invoice Set

Permits and Compliance Actions are included in an invoice set.

Permits are added based on the assignment of a Fee Category and/or Fee Type to a permit. A permit will be included in the invoice set if there is an active permit version at any time within the Invoice Set’s on the final day of the invoice set’s effective period. The fee amount is based on the default amount assigned to the Fee Type, or an override amount on a specific permit, if configured to allow this.

Compliance Actions are added based on the presence of an Expense with an Expense Date within the Invoice Set’s effective period.

Invoice Set

Invoice sets have the following statuses:

Status

Description

Prelist

Image Removed

This is a “dry run” of an invoice set. A background procedure and creates the potential number of records for invoicing based upon the Fee Category. When in a prelist status, no invoices have yet been generated.

The purpose of the prelist status is to confirm that all the information is correct prior to generation of the invoice.

Invoiced

Image Removed

The invoice is issued and an invoice letter is generated.

Refresh Error

Image Removed

This error is returned if the data in the invoice set is different from the information in the permit.

Creating a New Invoice Set for a Specific Fee and Year

To create a new invoice set a for given year:

• Click Lookups on the Admin menu.

• Click Periodic Invoice Fees:

Image Removed

• The list of existing invoice fee categories, fee types, invoice years, and amounts is displayed.

To create a new invoice fee/year:

• Click Add New Invoice Fee:

Image Removed

Image Removed

Enter the Fiscal Year, Fee Category, Fee Type, andDefault Amount for the new invoice set and click Save.

Adding Periodic Invoicing to a Permit

If a permit is eligible for periodic invoicing, the permit’s periodic invoicing information must be specified on the permit.

Image Removed

• The user is prompted to input information similar to that entered when creating an invoice set:

Image Removed

Fee Cycles

When adding periodic invoicing information to a permit, a fee cycle may be available for selection, based on the selected fee category. In order for this to be available, fee cycles must exist in the database for that specific fee category. Fee cycles can be used in situations where invoicing is performed over several cycles throughout a given period (e.g., quarterly, monthly, etc.).

Invoicing a Newly Issued Permit

When invoicing information is added to a new permit or modified on an existing permit, the invoice set(s) related to the permit will automatically be refreshed as soon as the permit transitions from a pending to active status. It may take up to five minutes for the permit to appear in the invoice sets to which it belongs. After the relevant invoice set(s) refresh, the permit will appear as a new ungrouped item in invoice set(s).

Working with Invoice Sets

To view the invoice set,

• click Open on the right-hand side of the page.

  • This opens the invoice set details screen where all the invoice records are listed.

Image Removed

The resulting page displays details including the site name, permit number, fee type, fee amount, and billing contact for each billing item:

Image Removed

Grouped vs Ungrouped Invoice Set Items

An invoice set can contain a list of both invoiced and uninvoiced items. If one more items in the invoice set has been invoiced, a group will appear on the left side of the screen with a name for the invoice group. If one or more items are uninvoiced, these items will be available in the Ungrouped entry on the left side of the screen.

Grouped/Ungrouped Items List

The following columns appear on this page:

Site Name: Contains the name and address of the site being billed.

Permit Number: Lists the permit to which the fee applies. When clicked, it redirects to the Permit Details page for that permit.

Fee Type: This is set under the permit. This determines the type of fee the site will receive.

Fee Amount: The amount owed by the site.

Billing Contact: This lists the name, address, and contact information of the party billing the site. This is configured on the Edit Fee Category page (Admin > Lookups > Fee Categories > Edit Fee Category) for a given fee category.

Refreshing an Invoice Set

If any details regarding an ungrouped invoice change (such as the billing contact or fee category/type), click Refresh Pre-List Data at the top of the page and it will update any changes made to the permit.

Image Removed

Creating an Invoice Group

Invoice groups allow for partitioning an invoice set into smaller groups for invoicing at different time intervals or for other purposes.

Select the prelisted invoices you wish to manage. Click Add x items to group at the bottom of the page.

Image Removed

• After clicking Add x items to group, choose whether to add the items to a new group or an existing group.

  • When creating a new group, a name will need to be provided. Then click Add Items.

  • If adding the items to an existing group, choose from the group dropdown and then click Add Items:

Image Removed

• After the items are added, the left side of the page displays the names of the invoice group, the status of the group, and the number of items. The number of ungrouped items in the invoice set are listed below the invoice groups:

Image Removed

• To return to the invoice set list, click Invoice Sets at the top of the page:

Image Removed

• This links to the Invoice Sets main page, where invoice groups and ungrouped invoices can be viewed below each invoice set:

Image Removed

Generating an Invoice

Generating an Invoice for a Grouped Item

When satisfied with an invoice group, open up the invoice group and select all the items to be invoiced.

To select all items

• check the box to the left of the Site Name column header,

• or select individual sites using the checkboxes next to the site names.

Image Removed

Once the items are selected, three options appear:

• invoice the selected items,

• move the selected items, or

• ungroup the items.

To invoice the items:

• Click Invoice Items:

Image Removed

• The status of the invoice group is set to Invoiced, and invoices are sent to the recipients.

• Open any of the invoiced permits to verify that a fee has been created in conjunction with the invoice set.

Image Removed

Generating an Invoice for an Ungrouped Item

To send invoices for ungrouped items:

• Click Ungrouped in the left-hand column.

To send all invoices:

• Check the box to the left of the Site Name column header, or select individual invoices using the checkboxes next to the site names:

Image Removed

When the items are selected, two options appear:

• invoice the selected items, or

• move the selected items to an invoice group:

Image Removed

Image Removed

• After naming the invoice group, click Generate:

Image Removed

• A new invoice group appears on the left-hand side of the page, the invoice group status is automatically set to Invoiced, and the selected invoices are sent to the recipients:

Image Removed

Viewing Invoice Details

To view details for an invoice:

• Click the Open button for an invoice within an invoice group

• The invoice set is displayed:

Image Removed

Alternatively, details for a given invoice set can be found…

… on the Periodic Invoicing tab of the permit’s Permit Details page

Image Removed

… or via the Financials option on the Site menu for a given site

Image Removed

Relation to Document Sets

Upon invoice generation within a given invoice group, a document set is created that generates and finalizes PDFs of each individual invoice. These sets can be viewed by selecting the Documents Sets option on the Admin menu. See the Document Sets topic for more information.

Image Removed

Paperless Invoicing

Site Level Paperless Invoicing

An External User can make invoices paperless by navigating to the Site Details Page and opening the Preferences tab. Two checkboxes will appear, check “Paperless Invoice Preferred”.

Image Removed

Paperless Invoicing can however be overridden on Fee Category Level. To override Site Preference of Paperless Invoicing, navigate to Admin → Lookups → Fee Category. Upon selecting the Fee Category where a paper invoice is required, there is a section on the Fee Category Page titled “Periodic Invoicing”. Within this section, there is a checkbox titled “Always mail paper invoice”. Selecting this will override the Site Preferences and for that particular fee, a paper invoice will be generated and mailed.

Image Removed

Document Sets

As mentioned above, a Document Set is created upon invoice generation for a particular invoice group.

When paperless invoicing is not checked on Site Preferences, selecting Open on a Document Set to show the Document Set Details Page…

Image Removed

…there is the option to download or print the Generated Invoice Document for the Site where Paperless Invoice is not selected.

Image Removed

Image Removed

Types

nVIRO will create a placeholder invoice set for each Fee Category and Periodic Invoice Fee/Year. The Fiscal Year and Effective Period for the Invoice Set are based on the invoice set’s Fee Category. The Invoice Set’s Effective Period is based on the Fiscal Year End Date month, and day and Invoice Frequency defined in the Fee Category.

Permits and Compliance Actions are included in an invoice set.

Permits are added based on the assignment of a Fee Type to a permit. A permit will be included in the invoice set if there is an active permit version on the final day of the invoice set’s effective period. The fee amount is based on the default amount assigned to the Fee Type or an override amount on a specific permit, if configured to allow this.

Compliance Actions are added based on the presence of an Expense with an Expense Date within the Invoice Set’s effective period.

Permit Invoice Sets

Permit Invoice Sets are set up for Annual Invoicing only. Invoice Set Effective Periods are set for the year prior to the invoice set’s Fiscal Year. If the Fiscal Year End Date is 6/30, an invoice set for fiscal year 2024 be created for Effective Period 7/1/2022 - 6/30/2023.

Permit line items are included in the invoice set if:

• The permit has a linked Periodic Invoicing component with a Fee Type that is contained in the invoice set’s Fee Category, and

• They are effective on the last day of the effective period. In the example above, permits effective on 6/30/2023 will be included in the invoice set (even if they have been subsequently terminated).

Permit Fee Type

1. Custom fee calculation stored procedure specified at the Fee Type level.

2. Custom fee calculation stored procedure specified at the Fee Category level.

3. Flat Fee entered into the permit’s Periodic Invoicing Component.

4. Flat Fee specified in the Periodic Invoice Year record.

Compliance Action Invoice Sets

Compliance Action Invoice Sets include Expense line items specified on Compliance Actions. Invoice can be created at the following frequencies:

• Annual

• Biannual

• Quarterly

• Monthly

Invoice sets are created within a Fiscal Year based on the Fee Category’s Fiscal Year End Date. For example, if a Fee Category has a frequency set to Quarterly with a Fiscal Year End Date of 6/30, the following invoice sets will be created for fiscal year 2024:

• Quarter 1: 7/1/2023 - 9/30/2023

• Quarter 2: 10/1/2023 - 12/31/2023

• Quarter 3: 1/1/2024 - 3/31/2024

• Quarter 4: 4/1/2024 - 6/30/2024

Compliance Action line items are included in an invoice set if:

1. The Compliance Action Type/Program is configured to allow Expense Tracking.

2. The Compliance Action Type/Program’s default Fee Category matches that of the Invoice Set.

3. The Compliance Action has an Expense record that falls within the Invoice Set’s effective period.

Compliance Action Fee Type

The fee amount for a line item is determined by the specified Expense Type’s calculation method. The calculation methods are:

• Quantity/Rate (e.g. work hours multiplied by an hourly rate) - quantity is specified on the Expense item at the Compliance Action and is multiplied by a rate specified on the linked Periodic Invoice Year rate amount.

• Flat Fee - flat fee amount is specified on the Expense item.

Configuration

Fee Category

Administration for Permit Fee Types are managed in Admin>Lookups>Fee Category.

From the Fee Category List page, either click the Add New Fee Category button or Open an existing fee category. This opens the New Fee Category or Edit Fee Category page. The configuration options fall under the following categories, and here is how to configure:

Basic Configuration

The basics for Invoicing configuration

Image Added

Period Invoicing

Period Invoicing Configurations:

Image Added

Fee type

Administration for Permit Fee Types are managed in Admin>Lookups>Fee Types.

Fee Types are used to generate periodic fees for permits/compliance actions, and here is how to configure:

• Fee types get linked to permits/compliance actions by internal processors when crafting new or revised permits.

• Fee types determine the fee sent out to the responsible party when periodic fees are generated, configured via Annual Invoice Fees (used to change annual fees from period to period), or based on a custom fee calculation stored procedure.

• Fee Calc Type Selection determines if it is a set Flat Fee or Quantity and Rate.

  • Periodic Invoice Fees uses this Fee Type for calculations.

    • Flat Fee will have a user entered dollar value on an Expense.

    • Quantity and Rate will have a fixed dollar amount that is used to calculate Expense by user entered quantity.

Periodic Invoice Fees

Administration for Periodic Invoice Fees is managed in Admin>Lookups>Periodic Invoice Fees.

Image Added