Creating an On Invoice Sales Program

Owned by Tatum Hohl (Unlicensed)
Last updated: Jun 20, 2018 by Kati Huttunen (Unlicensed)
11 min read

Overview

On Invoice programs are very similar to Promotion Programs but are most commonly used to automate freight charges. Since freight charges are different by Carrier as well as an address’s proximity to the warehouse, they can be assigned based on these factors. They are also assigned by ‘Address Sets’ instead of selecting the individual addresses. Because On Invoice Programs show up on the customer invoice as a line item and all the accounting is based on the ‘Freight Item’ code, and item must exist to account for on invoice charges. 

Prerequisites

Required Prerequisites

  • Program Class Setup
    • To assign to the Sales Program for categorical purposes.
  • Item Setup
    • Specifically, an Item to code freight as that will display on the invoice for On Invoice charges/discounts.
  • Item Set Setup
    • To assign to the On Invoice program, making all items on this item set eligible for the program to be applied when sold on a Sales Order transaction that is being sold to a customer address at a site with a carrier all also assigned to the program.
  • Address Set Setup
    • To assign to the On Invoice program, making the addresses on the assigned Address Sets eligible for the program to be applied to any items sold to them from a site with a carrier that are all also assigned to the program.
  • UOM Setup
    • To assign the UOM for any freight rate set to a calculation of $/UOM.
  • Site Setup
    • To assign to the On Invoice program, making the sites eligible for the program to be applied to any items sold from them that are also assigned to the program with a carrier that is all also assigned to the program.
  • Carrier Setup
    • To assign to the On Invoice program, making the carriers eligible for the program to be applied to any items sold via them that are also assigned to the program from a site that is all also assigned to the program.

Optional Prerequisites

  • Integration setup
    • Setting the Host system integration for SO Invoice to immediate or timed.

Understanding the Data Flow

An On Invoice Sales Program will automatically be applied on any eligible Sales Order transaction, as determined by the program’s assigned Item Set(s), Address Set(s), Site(s), Carrier(s), and date range, and will calculate automatically based on the program’s calculation method and rate for the applicable item set(s). When the On Invoice Sales Program is applied to a Sales Order transaction, it will display as a line item on the invoice. The line item that displays is determined by the ‘Freight Item’ assigned to the applicable item set(s) on the program. Because the program’s calculations are reflected via the ‘Freight Item’, the accounting for this item will be determined by the item’s ‘Accounts’ setup for its ‘Sales’ account and will be posted along with the Invoice. 

Step 1: Creating the On Invoice Sales Program

To create an On Invoice Sales Program, navigate to the Sales Programs module in NorthScope, open the Programs page, click the New toolbar icon, and select On Invoice.

This will open the ‘Sales Programs: New On Invoice’ window with the On Invoice ID automatically assigned based on the Sales Programs preference for ‘Next Program ID’.

Completing the Header Fields

When creating a new On Invoice Sales Program, the following properties will display for data entry:

  • Description: Enter the description of the program. This will display in the Programs list view and will help differentiate the sales program from all other On Invoice programs. This field is displayed in the header section of the record. 
  • Class: Select the Program Class to assign to the On Invoice program. This is for categorical purposes and the lookup will only include those program classes assigned a program type of ‘On Invoice’. This field is required.
  • From: Enter the date as of which the On Invoice program is eligible. This field is required.
  • To: Enter the date as of which the On Invoice program is no longer eligible.  This field is required.
  • Settle To: This field defaults to ‘Invoice’ and is not editable for On Invoice programs.
  • Frequency: This field defaults to ‘Invoice’ and is not editable for On Invoice programs.
  • Inactive: This field inactives the program record. Incative sales programs are not assigned to Sales Order transactions. This field is displayed when the program record is saved with the base properties. 

Once completing the header fields, click Save.

Then, assign the Item Set(s) eligible for the On Invoice program.

Assigning Item Sets

To assign an item set, open the Item Sets tab within the Sales Program record and click the New grid toolbar icon.

This will open a single line item for data entry with the following fields:

  • Seq: This field defaults to the next number in the sequence and is not immediately editable. However, once the Item Sets tab is saved, each Item Set can be dragged and dropped into the correct order of hierarchy.
  • Item Set: Select the Item Set to assign to the On Invoice program. Duplicate Item Sets are not allowed to be assigned to the same sales program. This field will display a drop-down menu of all Item Sets assigned a ‘type’ of ‘Sales Programs’ or ‘All Modules’. This field is required.
    • To setup Item Sets, go to Inventory>Item Sets and click new. Enter the Item Set name and description and select the item set’s ‘Type’. By default, all new Item Sets include all items. To limit the items included in the item set, apply as many filters as necessary to include only the items meeting the filtered criteria. Filters can be placed on the following item values: Item Type, Item Class, Attribute Class, UOM Schedule and all Item Attribute Values. Items can be manually included and excluded if necessary. Saving the item set record updates the Items tab displaying the items assigned to the item set record. When a new item is added to NorthScope that fits the filtered criteria of an Item Set, that item is automatically added to the Item Set and therefore assigned to any sales program the Item Set is assigned to. 
  • Freight Item: Select the item that will display on the transaction for this On Invoice program and will therefore drive the accounting rules of the sales program. This field displays a drop-down menu of all non-Sales Inventory items. This field is required.
  • Calculation Method: Select the method by which the program will be calculated. This field displays a drop-down menu of calculation methods including the following:
    • $/UOM: Calculates the program based on the rate assigned to the item set for the program and the UOM assigned to the item set for the program. This calculation is the rate times the quantity (of the program UOM) that exists on the invoice for all items belonging to the item set. If this calculation method is selected, the UOM field is required.
    • % Gross $’s: Calculates the program based on the percentage rate assigned to the item set for the program and the total dollars of all items on the item set. This calculation is the percentage rate times the sum dollar amount of all items belonging to the item set on the invoice.
    • % Net $’s: Calculates the program based on the percentage rate assigned to the item set for program and the total dollars of all items on the item set. This calculation is the sum dollar amount of all items belonging to the item set on the invoice less the charges from all other sales programs times the percentage rate.
    • % off Total Invoice $’s: Calculates the program based on the percentage rate assigned to the item set for the program and the invoice’s total amount. This calculation is the percentage rate times the total invoice dollar amount, including items not belonging to the assigned item set(s).
  • Rate: Enter the rate by which to calculate the On Invoice program. If the Calculation Method is set to $/UOM, the rate being entered must be a dollar amount to be charged/discounted per 1 unit of the selected UOM. If the Calculation Method is set to anything other than $/UOM, the rate being entered is a percentage to be charged/discounted.
  • UOM: Select the unit of measure by which to calculate the program. If the Calculation Method is set to $/UOM, the UOM field is required and will determine the unit by which the rate is charged/discounted. If the Calculation Method is set to anything other than $/UOM, the UOM field is disabled and will display %.
  • # Items: This field is never editable by the user and will automatically update once the Item Set is saved to display the number of items on the item set, which are now assigned to the Sales Program.

Once entering all the Item Set fields, click the Save grid toolbar icon.

Multiple Item Sets can be assigned to a single Sales Program. To assign additional Item Sets, follow the steps above for each additional Item Set.

Assigning Addresses/Address Sets

Depending on the Sales Program property ‘Assign Address By’ the customer addresses are assigned to the program by the address sets or individual addresses.

Assigning Address Sets

Note: Applies to programs with ‘Assign Address By’ set to Address Set.

To assign an Address Set, open the Address Sets tab within the Sales Program record and click the New grid toolbar icon.

This will open a single line item for data entry will the following field(s):

  • Address Set: Select the Address Set to assign to the program. Duplicate Address Sets are not allowed to be assigned to the same sales program. This field will display a drop-down menu of all Address Sets. This field is required.
  • To setup Address Sets, go to Sales Order>Address Sets and click new. Enter the Address Set name and description. By default, all new Address Sets include all customer addresses. To limit the addresses included in the address set, apply as many filters as necessary to include only the addresses meeting the filtered criteria. Filters can be placed on the following address values: Customer, Customer Name, Address ID, City, State, and Zip. Once the desired filters have been applied to the Addresses list grid, click Save. When a new customer address is added to NorthScope that fits the filtered criteria of an Address Set, that address is automatically added to the Address Set and therefore assigned to any sales program the Address Set is assigned to.

After assigning the desired Address Set, click Save.

Multiple Address Sets can be assigned to a single Sales Program. To assign additional Address Sets, follow the steps above for each additional Address Set.

Assigning Addresses

Note: Applies to programs with ‘Assign Address By’ set to Address.

To assign a Customer Address, open the Customers tab within the Sales Program record.

The Customers tab will display all customer addresses with a check box, allowing the user to select the address(es) to assign to the program. Each column within the list is filterable, allowing the user to easily narrow down the addresses that display to select the appropriate addresses to assign. To assign addresses to a program, check the check box displayed before the Customer ID and click Mass Update.  This opens the mass update dialog, where addresses can be assigned. Set ‘Assign Addresses’ to ‘Yes’ and click Apply. Also the start date can be assigned on the mass update dialog, but this is not required. Multiple addresses can be assigned to the program simultaneously. To remove addresses from the program, check the check box and click Mass Update toolbar icon. Set ‘Remove Addresses’ to ‘No’ and click Apply. When an address is assigned to a program, the On Program column displays Yes. Addresses assigned to the program are displayed on top of the list view.

Assigning Sites

To assign a Site, open the Sites tab within the Sales Program record.

The Sites tab will display all Sales Order Sites set to be visible to sales with a check box, allowing the user to select the site(s) to assign to the program. Each column within the list is filterable, allowing the user to easily narrow down the sites that display to select the appropriate site(s) to assign.

Once finding a site to assign to the program, select the checkbox that corresponds to the site and click the save grid toolbar icon. This will sort the selected site(s) to the top of the list to easily identify the site(s) currently assigned to the program.

Assigning Carriers

To assign a Carrier, open the Carriers tab within the Sales Program record.

The Carriers tab will display all Sales Order Carriers, allowing the user to select the carrier(s) to assign to the program. Each column within the list is filterable, allowing the user to easily narrow down the carriers that display to select the appropriate carrier(s) to assign.

Once finding a carrier to assign to the program, select the checkbox that corresponds to the carrier and click the save grid toolbar icon. This will sort the selected carrier(s) to the top of the list to easily identify the carrier(s) currently assigned to the program.

Step 2: Entering a transaction with the On Invoice program

By default, when a Sales Order transaction is entered for a customer address that is assigned to an address set that is assigned to the program, with at least one item belonging to an item set assigned to the program, a site assigned to the program, a carrier assigned to the program, and a transaction date within the program’s date range, the On Invoice program will automatically be applied to the transaction and calculated accordingly. The sales program is displayed as a line item, which is for informational use only and cannot be edited. If the order has two or more items that are eligible for the same sales program, the total sales program amount is displayed as the price and the extended amount. If the sales order has items that are eligible for more than one on invoice sales programs, each sales program is displayed as a separate line item.

To adjust the sales program rate or to see more sales program details, click the transaction’s Program Details header toolbar icon and open the On-Invoice tab.

This tab will display all information regarding the effect(s) of the On Invoice program on the transaction, per item affected, with the following details:


  • Gross $: Displays the item’s total gross dollar amount.  
  • Item Set: Displays the name of the Item Set assigned to the program to which the corresponding transaction item belongs to.
  • Item: Description: Displays the item and item description of the transaction item affected by the program.
  • Method: Displays the calculation method of the program.
  • Net $: Displays the item’s total net dollar amount.  
  • Program Amt.: Displays the amount of the program as calculated for the corresponding line item.
  • Program Group: Displays the Sales Program type, ID and Description. Note: This column is not in the system view. .
  • Program ID: Displays the Program ID of the Sales Program. Note: This column is not in the system view. 
  • Program Name: Displays the name of the Sales Program. Note: This column is not in the system view. 
  • Program Type: Displays the type of the Sales Program. Note: This column is not in the system view. 
  • Promo Item ID: Displays the item ID that will display on the invoice for the program calculations.
  • Rate: This field displays the sales program rate as defined on the sales program record. This field is editable and the Program Amount is re-calculated after clicking Save. Note: Updating the rate on this window impacts only this transaction and it does not update the Sales Program record.
  • Unit UOM: Identifies the unit UOM of the item that is affected by the sales program.  
  • Units: Displays the total number of units ordered of the item that is affected by the sales program.
  • UOM: Displays the UOM upon which the program was calculated.
  • Weight: Displays total weight of the item that is affected by the sales program.
  • Wt. UOM: Identifies the weight UOM of the item that is affected by the sales program.  

Step 3: Posting the transaction with the On Invoice program

If an On Invoice program exists on a Sales Order transaction, no additional work is needed for the program to be posted with the transaction. Simply follow the steps to post the transaction and the program will be posted with it. Steps for posting Sales Order transactions can be found here.

However, the program rates cannot be adjusted once the transaction is in a status of Approved or greater.

Once the invoice is saved as Ready to Post, the freight item will visibly display on the invoice. Prior to saving the transaction as Ready to Post, the On Invoice program will only be visible via the Program Details page.

The program item will integrate to the host system the same as the other line items on the invoice, so long as the SO Invoice integration is set to immediate or timed.