Contact us Blog

Setting up the Batch Gift Entry tool


As an administrator, you can set up the Apsona Batch Gift Entry tool for your users via the following steps.
  1. Install the Apsona Batch Gift Entry package from our AppExchange listing.
  2. Add licenses for all users who need the Batch tool, via Setup - Installed Packages - Apsona Batch Entry - Manage Licenses.
  3. Ensure that each Salesforce user profile that needs access to the tool includes access to the native Salesforce objects Contact, Account, Opportunity, Campaign and Opportunity Contact Role, the NPSP objects Payment, General Accounting Unit and GAU Allocation, and the Batch and Batch Item objects from the Apsona Batch Gift Entry package.
    • Users will need full read/write access to all the fields of all of the above objects. They will also need delete access to the GAU Allocation object and the Batch Item object.
    • If you do not provide access to the General Accounting Unit and GAU Allocation objects, your users will not be able to create Allocation records via the batch tool.
  4. For each user profile that needs access to the tool, ensure that the corresponding Apsona configuration includes all of the above objects as visible objects.
  5. Ensure that your organization has a valid license for the Batch tool. You can do this via Setup - Manage licenses in Apsona. Please contact us if you need a license.
  6. If a user has recently been assigned a license, she needs to click Settings - Clear cache in Apsona so that the license assignment takes effect.
  7. Do not add the Batch or Batch item objects to Apsona's menu bar. If the above setup steps are correctly carried out, the Batches menu item will appear to the right of the Settings menu.


You can also configure the Batch Gift Entry tool to suit the needs and operational processes of your organization. Begin by clicking the Configure menu item in the Batches menu. The configuration popup is displayed. The screen shot below shows this popup with annotations.

These configuration settings are intended to be made just once for your org. After you configure your org using this popup and have started using the batch tool to create batches, making changes in this popup can have unexpected consequences.

General options

  1. The above screen shot shows the "General Options" section. If your organization uses payments (i.e., the NPSP Payment object), you can check this box and select whether the batch totals are determined by Opportunity amounts (i.e., the Opportunity's Amount field) or Payment amounts (i.e., the Payment object's Payment Amount field).

    If your organization does not use payments, you can un-check this box. If you do so:
    • Batch totals will always be determined by the Opportunity's Amount field
    • Fields from the Payment object will not be available for use in your batches.
    Bear in mind that if you un-check this box, you will not be able to create or use any batch that contains one or more Payment fields in it.
  2. If you check the "Show pending payments" box, the Batch tool will automatically display pending payments or opportunities (depending on your choice for the above checkbox) when you select a donor from a search result. To see how this feature works, watch this animation. Notice how the "Select a Payment record" popup appears immediately after the user selects the Donor record. Without this box being checked, you would need to explicitly search for matching payments (by clicking the search button next to the Payment field) after selecting a donor.

Related records

The options in this group determine the panels to be shown in the related records area underneath the main Opportunity and Payment fields area.
  1. Check the "Show Contact Roles" box if you want to add contact roles as part of the gift entry process, as described elsewhere. If you un-check this box, the Contact Roles panel will not appear.
  2. Check the "Show Fund Allocations" box if you want to add allocations as part of the gift entry process, as described elsewhere. If you un-check this box, the Funds panel will not appear. Note also that, if you have the KELL Funds package installed in your org, this configuration screen enables you to select that package as your Funds data store, instead of the NPSP GAU objects. If you do not have the KELL package installed, you won't see this option.
  3. Check the "Show Products" box if you want the Opportunity Product object to be included in the related records area, so that you can add Product line items to each gift.

Search result columns

In the second panel (screen shot below), you can configure the columns that appear in the batch data entry screen when you search for an Account or Contact.

Pending gifts

The third panel (screen shot below) lets you configure the filters used for pending gifts. These filters are used when you have selected a particular donor, either an individual or an organization, and you wish to view their pending gifts. These filters let you define what a "pending gift" means for your organization. The default setting is that, for individual donors, the gift must have probability 50% or more, and there must be at least one unpaid payment against the gift; and for organization donors, the default looks for probability 50% or more, and the gift should not be in Closed state. But of course you can use this configuration popup to set the filters exactly the way your organization requires.

Access rights

In the Access rights panel, you can set up access rights for different classes of non-admin users. Administrators will always have full access to all aspects of the Batch tool. But if you wish non-admins to have access to only selected aspects of the tool, you can configure the access via this section.

You can select up to two different non-admin profiles (for the second and third column in this panel) and set the corresponding access rights. For example, a non-admin user whose profile matches the one selected in the second column will have the access rights you set in that column. Similarly, a non-admin user whose profile matches the one selected in the third column will have the access rights you set in that column. Non-admin users whose profiles do not match the selected ones will have the access rights set in the last column.

These settings apply, of course, only to those users who have valid licenses to use the Apsona Batch Gift Entry tool.