Agency Fees Setup

Purpose of this document

The Agency Fees functionality provides food banks with the ability to create and maintain special Item unit fees charged to agencies for designated items. For example, other Food Banks could be charged a reduced fee for the same Item, without specific manual discounting on the Agency Order. Agency Fees can be set up to apply to all Agencies, Agency Groups, individual Agencies or a Campaign.

Ceres will check all applicable unit fees for the combination of Agency and Item and select the lowest unit fee the Agency qualifies for. Standard Unit fees are established on the Item Card which will be used only if no other applicable Agency Fees are found in the Agency Fee table. Agency Fees can have start and end dates and if populated are only active for agency orders within the specified date range.

If established and synchronized, then Agencies will see the specific fees on Agency Express as in Ceres.

Ceres Object release 6.00.00 is required for the functionality described in this document.

TABLE OF CONTENTS

• Accessing the Agency Fees Setup Page 
  • Agency Fees from an Agency
  • Agency Fees from an Item
• Agency Fees Setup
• Calculation of Agency Fees
• Agency Fees with Agency Express

Accessing the Agency Fees Setup Page 

The Agency Fees Setup page may be accessed from either the Agency List or the Item List. Access from the Agency List will filter the records to only those agency fees applicable to the selected Agency. Likewise, access from the Item List will filter the records to only those agency fees applicable to the selected item.

Agency Fees from an Agency

1. Agencies can be accessed by selecting “Search” from the Dynamics 365 Business Central Banner and entering “Agencies” in “Tell me what you want to do” then selecting “Agencies” from the results in the Go to Pages and Tasks section OR by selecting the “Agencies” menu action (if present) from your Role Center home page.

2. Select the Agency you wish to use by clicking on it once. This will highlight the selected Agency. Go to Actions à Fees & Discounts à Fees to open the Agency Fees form.

3. This opens the Agency Fees window for that Agency, where you can view the fees based on your Distribution Type Filter.

4. Proceed to Agency Fees Setup section.

Agency Fees from an Item

1. Items can be accessed by selecting “Search” from the Dynamics 365 Business Central Banner and entering “Items” in “Tell me what you want to do” then selecting “Items” from the results in the Go to Pages and Tasks section OR by selecting the “Items” menu action (if present) from your Role Center home page.

2. Select the item you wish to use by clicking on it once. This will highlight the selected item. Go to Prices & Discounts àSpecial Fees to open the Agency Fees form from the Item.

3. This opens the Agency Fees - Item window for that Item, where you can view the fees based on your Distribution Type Filter.

4. Proceed to Agency Fees Setup section.

Agency Fees Setup

After opening the Agency Fee page either from the Agency or Item List, you can create the table of fee options.

To enter a new Agency Fee, go to a blank line. To edit an existing Agency Fee, click on the line you want to change.

Distribution Type: Choose the agencies and agency group this record applies to from the following choices.

Agency – This line applies only to the agency specified by the Distribution Code field.

Agency Fee Group – This line applies to agencies with the same Agency Fees Group as specified by the Distribution Code field. If you wish to export Agency/Item fees to Agency Express 3, you need to specify a Fee Group on every Item that matches the Agency Fee group. This is required for the Item Fees and Items to show on Agency Express. Please note that this is not the same as Agency Groups for Qualifiers.

All Agencies – This line applies to all agencies. (Do not use this if your Item Fees need to export to Agency Express 3, use Agency Fee Groups instead).

Campaign – This line applies to agencies associated with the selected campaign specified by the Distribution Code field.

Distribution Code: Specify the appropriate code pertaining to the Distribution Type field selected. If the Distribution Type is All Agencies, then this field is left blank. The AssistButton will display valid entries for the distribution type selected.

Item No.: Specify the Item Number this fee applies to. Multiple Items require setting up multiple lines.

Unit of Measure Code: This will default to the Item’s base unit of measure and should not be changed.

Minimum Quantity: Enter the Quantity needed to order to qualify for this fee if desired. Quantity breaks can be accomplished by added multiple records with different Minimum Quantities for the same Distribution Code and Item Code relationship.

Cost Adjustment Type: Enter the Cost Adjustment Type. See Item Overview for more information.

Amount – The Cost Adjustment factor will be added to the unit cost of the item.

Percent – The Cost Adjustment Factor will be multiplied times the unit cost of the item.

Fixed – The Cost Adjustment Factor will be used and with considering the cost of the item.

Cost Adjustment Factor: This field relates to the Cost Adjustment Type and should be entered accordingly. This field is used to help determine the Unit Fees. If the item’s cost should not be included in the fee charged to agencies, leave this field blank. See Item Overview for more information.

Handling Fee (per Lb) amount: This field is used to calculate the Handling Fee ($) based on the gross weight of the item. Typically used for Donated Items and/or when the cost of the Item should not be a factor in the fee calculation. See Item Overview.

VAP Fee (per Lb) amount: This field is used to calculate the VAP Fee ($) based on the gross weight of the item. See Item Overview.

Starting Dates: If this fee should only be valid for a period of time enter the date this fee begins. If no starting and ending dates are specified, the agency fee record never expires. If the distribution type is campaign, the starting and ending dates for the agency fee record will default to the corresponding dates from the campaign card.

Ending Dates: If this fee should only be valid for a period of time enter the date this fee ends. If no starting and ending dates are specified, the agency fee record never expires. If the distribution type is campaign, the starting and ending dates for the agency fee record will default to the corresponding dates from the campaign card.

Calculation of Agency Fees

The Unit Fees will calculate based on a formula of:

If Cost Adjustment Type = Percent; then Unit Fees = (Unit Cost [on the Item Card] x Cost Adjustment Factor) + Handling Fee $ + VAP Fee $.

If Cost Adjustment Type = Amount; then Unit Fees = Unit Cost [on the Item Card] + Handling Fee $ + VAP Fee $ + Cost Adjustment Factor.

If Cost Adjustment Type = Fixed; then Unit Fees = Cost Adjustment Factor + Handling Fee $ + VAP Fee $.

Note: The Default is Cost Adjustment Type of Percent with a Cost Adjustment Factor of 0. The result is that the cost has no impact on the Item Fee in Fee Groups.

See Item Overview Procedure for more information on the relationship of Costs and Fees for Items.

Agency Fees with Agency Express

Starting with Ceres 4, Ceres no longer requires that an agency fee be set up for each agency fee group. In the absence of a specified agency fee for the agency fee group, Ceres will default the fee established on the distribution tab of the item. However, Agency Express requires that a matching agency fee records exist for all defined agency fee groups for every item. For this reason, Ceres has been modified to send valid agency fee records for all agency fee groups for all items. When creating the item fee’s update transmission file to Agency Express, Ceres will always create a record for every agency fee group defined in the system regardless of whether any have been set up on the item’s distribution fee table. Ceres will first check if the combination of item number and agency fee group exist and if it does it will send that record. If the combination of item number and agency fee group does not exist in the item’s distribution fee table, Ceres will use the fee from the Item Card and send that fee for the combination of item number and agency fee group. Ceres does not create any additional records in the database nor does it require any additional maintenance. The process is in place only to satisfy the Agency Express requirement to have valid fee records for every combination of item and agency fee group.