Expense Settings
You can control the expense and expense report settings using the Expense configuration group A collection of configuration options contained in the configuration groups tab that defines behavior of a FinancialForce PSA object or feature..
Key: D - PSA desktop app only. Does not apply to expenses created or updated via Mobile Expenses in the Salesforce mobile app
Field | Key | Description |
Default |
---|---|---|---|
additional-er-fields | D | Comma separated list of API names of expense report fields to be displayed on the Edit Expense page as additional fields. The fields you specify only appear when they exist and the user has write permissions on them. If you specify fields that are already displayed, they are ignored. For instance, you can specify the following fields:
|
|
additional-expense-fields | D | Comma separated list of API names of expense fields to be displayed on the Edit Expense page as additional fields in the Notes Detail section. The fields you specify only appear when they exist and the user has write permissions on them. If you specify fields that are already displayed, they are ignored. You can specify the following fields:
|
|
allow-billable-expense-fees | Indicates whether users can add Billable Expense Fees to Expense Billable amounts. | ||
allow-delegated-expense-report-entry | D | Indicates whether the expense report page loads resources that the user has permission to create expense reports for. | |
allow-deletion-of-submitted-expenses | Determines when submitted expenses can be deleted. | True | |
allow-post-submit-edits-after-close | Indicates whether the Closed for Expense Entry checkboxes on parent records such as projects, assignments and milestones only stops entry of new or unsubmitted expenses. When the option is enabled, users cannot enter a new expense report or submit a new expense report that was not previously submitted. | ||
Allow_Mixed_Billable_Non_Billable_Expense_Reports |
Indicates whether an individual expense report can contain both billable and non-billable expenses:
When submitting expenses for a project or assignment:
|
True | |
always-use-project-expense-limit-amount | Indicates whether limits and rates assigned directly to a project are used regardless of other limits. When this configuration option is set and an expense limit or rate exists with the project set, that expense limit or rate is used for the project regardless of whether an equivalent expense limit or rate exists for the RPG. | ||
assignment-lookup-columns | D |
List of API names of assignment fields to display as columns on the Project/Assignment lookup in the Expense Entry page. Do not include the pse__ namespace prefix in the API name of a field. |
Name, Nick_Name__c |
assignment-project-editable-after-save |
If true, the project or assignment can be changed for the given expense, provided the Calculation Mode configuration option in the Actuals configuration group is SCHEDULED. |
False | |
assignment-project-editable-after-save-audit-notes | The assignment-project-editable-after-save configuration option enables users to change the project or assignment for saved expenses. However, this requires audit notes to be created for expenses using this configuration option. This configuration contains tokens which are replaced during an update. Valid token names are as follows: <user> - the current user performing the action in the Expense UI. <date> - today's date. <oldproject> - the original project name. <newproject> - the new project name. |
User <user> changed the Project from <oldproject> to <newproject> on <date> | |
assignment-project-editable-after-save-audit-notes-on-expense-report | D |
The assignment-project-editable-after-save-audit-notes-on-expense-report configuration option enables users to change the project or assignment for saved expense reports. However, this requires audit notes to be created for expense reports using this configuration option.
This configuration contains tokens which are replaced during an update. Valid token names are as follows: <user> - the current user performing the action in the Edit Expense UI. <date> - today's date. <oldproject> - the original project name. <newproject> - the new project name. |
User <user> changed the Project from <oldproject> to <newproject> on <date> |
assignment-project-editable-after-save-on-expense-report | D | If true, the project or assignment can be changed for the given expense report if the report's status is: Draft or Rejected and Submitted, Approved and Include In Financials are false. | False |
assignment-tooltip-fields | D | List of assignment fields to be shown as tooltips on the Expense Entry page. | |
auto-share-with-project-manager-user | D | Defines the level of sharing with the project manager for newly created expenses. You can choose from the values None, Read, or Edit. | None |
auto-share-with-project-resources | D | Defines the level of sharing with assigned project resources for newly created expenses. You can choose from the values None, Read, or Edit. | None |
custom-assignment-lookup-columns-fieldset-name | D | Defines the name of a field set containing assignment fields to display as columns in the Project/Assignment lookup on the Expense Entry page. | |
custom-edit-expense-header-row-editable-fieldset-name | D | Enables you to create a custom field set on the Expense object and write its API name to this configuration. Fields added to this field set will be displayed as editable fields on the header lines on the Edit Expense page. | |
custom-expense-header-row-read-only-fieldset-name | D | Enables you to create a custom field set on the Expense object and write its API name to this configuration. Fields added to this field set will be displayed as read only fields on the header lines on the Edit Expense and Expense Entry UI pages | |
custom-expense-notes-editable-fieldset-name | D | Enables you to create a custom field set on the Expense object and write its API name to this configuration. Fields added to this field set will be shown as editable fields in the expense line notes section on the Edit Expense and Expense Entry UI pages. | |
custom-expense-notes-read-only-fieldset-name | D | Enables you to create a custom field set on the Expense object and write its API name to this configuration. Fields added to this field set will be shown as read only fields in the expense line notes section on the Edit Expense and Expense Entry UI pages. | |
custom-expense-report-editable-fieldset-name | D | Enables you to create a custom field set on the Expense Report object and write its API name to this configuration. Fields added to this field set will be displayed as editable in the additional expense report fields section on the Edit Expense page. | |
custom-expense-report-read-only-fieldset-name | D | Enables you to create a custom field set on the Expense Report object and write its API name to this configuration. Fields added to this field set will be displayed as read only fields in the additional expense report fields section on the Edit Expense page. | |
custom-multi-expense-header-row-editable-fieldset-name | D | Enables you to create a custom field set on the Expense object and write its API name to this configuration. Fields added to this field set will be displayed as editable fields on the header lines on the Expense Entry UI page. | |
custom-project-lookup-columns-fieldset-name | D | Defines the name of a field set containing project fields to display as columns in the Project/Assignment lookup in the Expense Entry page. | |
default-incurred-tax-non-billable | D |
Indicates the default value of the Non-Billable Tax checkbox in the details of each expense line. |
|
default-milestone-to-assignment-milestone | D |
Indicates whether the milestone from the assignment is used when a user does not enter a milestone for an expense report. |
|
delete-expenses-on-er-delete | Indicates whether expenses that belong to an expense report are deleted when that expense report is deleted. | False | |
disable-milestone-copy-from-er-to-expense | D |
Indicates whether the trigger that automatically copies the expense report milestone to expenses in the same expense report is disabled. |
False |
display-account-on-resource-lookup |
Use the resource-lookup-columns option instead and include Account.Name in the delimited list of fields to show Account in a column on the Resource lookup pop-up. |
||
display-billable-amount | D |
Indicates whether the Billable Amount Field is shown in the details of an expense line. |
|
display-incurred-tax-non-billable | D |
Indicates whether the Non-Billable Tax checkbox appears in the details for each expense line. |
|
display-methodology-field | D |
Indicates whether the Methodology field is displayed on the Expense Entry page and when creating, editing, and cloning expense reports. |
False |
display-milestone-field | D |
Indicates whether the Milestone field appears on the expense report and clone expense UI. |
False |
display-non-billable-incurred-amount | D |
Indicates whether the Non Billable Amount field appears on the expense report. When the option is set to false, the Exchange Rate field only appears when the resource has a different currency to that set on the project. |
|
display-non-reimbursable-amount | D |
Indicates whether the Non-Reimbursable checkbox appears on the details of an expense line. |
|
display-phase-field | D |
Indicates whether the Phase field is displayed on the Expense Entry page and when creating, editing, and cloning expense reports. |
False |
display billable checkbox for expenses | Indicates whether the Billable checkbox appears on each expense line. | ||
empty-expense-lines-to-append-by-default | D | The minimum number of blank expense lines to be available for new expense entry on the Expense Entry page. | |
empty-expense-lines-to-append-on-add-lines | D | The minimum number of expense lines to add when a user clicks Add New Rows on the Expense Entry page. | |
expense-attachment-batch-size | D | Maximum number of expenses to process in a single batch when creating expense reports using the Submit button on the Expense Entry page in the desktop app. When creating expense reports using the Submit button on the Expense Entry page, PSA processes the expenses in batches to avoid reaching a platform limit. | 5 |
expense-line-updates-synchronous-only | D | Indicates whether expense lines in an expense report are always updated when the expense report changes. When the value is set to false PSA updates the expense lines when the record count is greater than the value in the max synchronous expense lines configuration option. | |
expense-queue-batch-size | Determines the batch size of assignments, milestones, and expense reports used when rolling up data from expenses to assignments, milestones, and expense reports. This option also determines the batch size of expenses or expense reports to be processed in a single queueable when parent expense reports or child expenses are updated. Contact FinancialForce Customer Support before changing this setting. | 1000 | |
expense-report-approval-process-all-or-none | D | When using the Submit button on the Expense Entry page to automatically submit expenses for approval, indicates whether all selected expense reports are only submitted for approval if none of them report errors during submission. See Setting up Workflow and Approval Processes. | |
expense-report-auto-submit-for-approval | D | Indicates whether a newly created or updated expense report is submitted for approval when Submitted is selected and Approved is not selected. This uses the expense approval process if one has been set up on the organization. For information about setting up an approval process, see Setting up Workflow and Approval Processes. | |
expense-report-name-required | Indicates whether users must enter an expense report name when creating an expense report. | ||
group-by-methodology | D | Indicates whether expenses are to be grouped into expense reports based on the selected methodology when creating expense reports from the Expense Entry page. | False |
group-by-milestone | D | When true, expenses are grouped into expense reports based on milestones. | True |
group-by-phase | D | Indicates whether expenses are to be grouped into expense reports based on the selected phase when creating expense reports from the Expense Entry page. | False |
max-synchronous-expense-lines | Maximum number of Expenses lines for which cascading updates from Expense Reports are to be handled synchronously. | ||
minimum-expense-amount-limit-for-attachment |
Expenses that are equal to or greater than this value in the corporate currency must have a receipt attachment. Expenses lower than this value do not need a receipt attachment. If users enter expenses in non-corporate currencies, PSA converts the expense amounts into the corporate currency, and then determines if receipt attachments are required. |
0 | |
move-non-image-attachments-to-ER | D | Indicates whether receipt attachments that are not saved as image files will be copied from the expense to the expense report when you combine expense attachments using the Combine Attachments button on the expense report. | False |
multi-expense-auto-move-attachments-to-er | D | Indicates whether expense attachment files on the selected expense lines are moved to the expense report when creating an expense report using the Submit button on the Expense Entry page. | False |
multi-expense-er-name-date-time-suffix | D | Indicates whether expense reports created using the Submit button on the Expense Entry page are created with a name that contains the date time suffix YYYYMMDD-HHMMSS. When true, expenses are created with the suffix. When false, the expenses are created without the suffix. | False |
multi-expense-er-submit-status | D | The value to set in the Status field of an expense report when created using the Submit button on the Expense Entry page. | Submitted |
multi-expense-recent-ers-to-show | D | Number of expense reports to display per page of results on the Expense Entry page when the multi-expense-show-most-recently-created-ers configuration option is true. | |
multi-expense-show-most-recently-created-ers | D | Indicates whether an additional section is displayed at the bottom of the Expense Entry page that shows the most recent expense reports for a resource. The number of expense reports that are listed is determined by the multi-expense-recent-ers-to-show configuration option. Expense reports are ordered by their creation date. | True |
NonReimbursable-field-position-is-popup | D |
Indicates whether the reimbursement checkbox appears in the details of the expense line or on the expense line next to the Billable checkbox. |
|
prevent-update-calculated-total-fields-on-er | D | Determines whether the values of the Total Billable Amount, Total Non Billable Amount and Total Reimbursement Amount fields can be edited in expense reports and on the Edit Expenses page. If true, manual user updates are not saved and an error message is displayed. The default value is false where they can be edited. | False |
proj-assig-dropdown-account-custom-field | The name of the field to add as a prefix to the Project/Assignment lookup on the Expense Entry page. | ||
project-lookup-columns | D |
List of API names of project fields to display as columns on the Project/Assignment lookup in the Expense Entry page. Do not include the pse__ namespace prefix in the API name of a field. |
Name, Account__r.Name |
project-tooltip-fields | D |
List of project fields to be shown as tooltips on Expense Entry page. |
|
rate-unit-decimal-places-digits | D | Determines how many digits to display to the right of the rate unit field's decimal point on the Edit Expense and Multi Expense pages. Values are 2, 3, and 4. See the Rate Unit field for more information. | 2 |
records-per-page-count | D | Determines the amount of expense lines displayed per page. | |
remove-exchange-rate-overrides-on-resource-defined-rate-removal | D | Removes all incurred and reimbursement currency overrides when resource-defined exchange rates change to zero. If the billing currency matches the incurred or reimbursement currency, removes billing currency overrides. | True |
resource-load-limit | D | Number of Resources to be loaded for the expense resource drop down. | |
resource-lookup-columns | D | A list of columns to display on the Resource lookup for the Expense Report Admin Edit page. | |
retain-attachments-on-expense | D | Indicates whether receipt photos that have been combined to PDF on the expense report will remain on the expense line. | True |
set-owner-to-resource-salesforce-user | D | Indicates whether PSA sets the owner of expenses to the assigned resource. When set to true and an expense is entered for a resource whose Salesforce user is inactive, the owner field of that expense report remains unchanged. This allows users to enter expenses for an inactive user without an error occurring because that user is inactive. | |
show-assignmentNumber-assignment-dropdown | D | Indicates whether the assignment number appears in the expense report project/assignment drop down or custom lookup. | |
show-methodology-as-field | D | The field to use as the methodology name field. When you specify a valid field name, the value of that field is displayed in place of the Methodology Name for all the methodologies shown in the list. Lookup __r references are not allowed. | |
show-methodology-on-popup | D | Indicates whether the Methodology field on the Expense Entry page is displayed in the Additional Fields section that appears when you click Edit Details on an expense line. When false, the field is displayed in the expense line. | False |
show-milestone-as-field | D | The field to use as the milestone name field. When you specify a valid field name, the value of that field is displayed in place of the Milestone Name for all the milestones shown in the lookup list. | |
show-milestone-on-popup | D | Indicates whether the Milestone field is show in the Additional fields section or the expense line on the Expense Entry page. When true, the Milestone field is shown at the top of the Additional Fields section of the Expense Entry page. When false, the Milestone field is displayed on the main Expense Entry page in the expense line. | |
show-phase-as-field | D | The field to use as the phase name field. When you specify a valid field name, the value of that field is displayed in place of the Phase Name for all the phases shown in the list. Lookup __r references are not allowed. | |
show-phase-on-popup | D | Indicates whether the Phase field on the Expense Entry page is displayed in the Additional Fields section that appears when you click Edit Details on an expense line. When false, the field is displayed in the expense line. | False |
show-projectName-assignment-dropdown | D |
Indicates whether the project name appears in the expense report project/assignment drop down or custom lookup. |
|
show-tax-type-on-popup | D | Indicates whether the Tax Type field is displayed in the Detail section of the Expense Entry and Edit Expense pages. When false, the field is displayed in the expense line. | True |
top-assignments-to-show-count | Number of recent assignments to be listed in the Project/Assignment lookup. | ||
top-projects-to-show-count | Number of recent projects to be listed in the Project/Assignment lookup. | ||
ui-ajax-timeout-ms | D | The maximum number of milliseconds to wait on the Expense Entry page before enabling the input fields. | 1000 |
undelete-expenses-on-er-undelete | D |
Indicates whether expenses that belong to an expense report are undeleted when that expense report is undeleted. |
False |
update-approver-on-edit | D | Indicates whether the Approver field on an expense report is updated when a user edits it. This configuration option is dependent on the AssignProjectManagerToExpenseReportApprover configuration option in the Triggers configuration group A collection of configuration options contained in the configuration groups tab that defines behavior of a FinancialForce PSA object or feature.. | |
update-er-from-exp-sync | D | Indicates whether changes made on expenses are carried out on the related expense report at the time the change is made on the expense record. | |
update-expense-exchange-rate-amounts-post-submit | If set to true, it is possible to update expense amounts post-submit based on updated currency exchange rates for expense dates. If set to false, the exchange rates on expenses remain as-is post-submit. | ||
use-expense-date-to-convert-rates-limits | Indicates whether the date on an expense line is used to convert the expense limits and rates to the target currency. When true, the date on an expense line is used. When false, the effective date on the expense limits and rates is used. | False | |
use-fieldset-for-expense-ui | D |
Allows you to switch your preferred method of managing visible fields on the Expense Entry and Edit Expense pages. If False, PSA will use configuration options to configure the user interface. If True, PSA will use field sets to configure the user interface. |
|
use-highest-expense-limit-amount |
Where expense limits/rates have values for Start Date and End Date, indicates whether the highest or lowest expense limit/rate is used when there are expense limits/rates for the same expense type with overlapping date ranges. Enter true for highest and false for lowest.
|
||
width-px-for-currency | D | Width of the Currency column on the Expense Entry page in pixels. Enter a whole number for this value. | 120 |
width-px-for-date | D | Width of the Date column on the Expense Entry page in pixels. Enter a whole number for this value. | 70 |
width-px-for-description | D | Width of the Description column on the Expense Entry page in pixels. Enter a whole number for this value. | 120 |
width-px-for-methodology-drop-down | D | The width of the Phase drop-down list on the Expense Entry page in pixels when show-methodology-on-popup is false. | |
width-px-for-milestone-drop-down | D | Width of the Milestone drop-down list on the Expense Entry page in pixels. Enter a whole number for this value. | |
width-px-for-phase-drop-down | D | The width of the Phase drop-down list on the Expense Entry page in pixels when show-phase-on-popup is false. | |
width-px-for-project-assig-lookup | D | Width of the Project/Assignment column on the Expense Entry page in pixels. Enter a whole number for this value. | 230 |
width-px-for-status | D | Width of the Status column on the Expense Entry page in pixels. Enter a whole number for this value. | 50 |
width-px-for-total-amount | D | Width of the Total Amount column on the Expense Entry page in pixels. Enter a whole number for this value. | 80 |
width-px-for-type | D | Width of the Type column on the Expense Entry page in pixels. Enter a whole number for this value. | 170 |
Fields to Exclude From Additional ER and Expense Fields Settings
Fields to Exclude from additional-er-fields
You must not include any of these fields in the comma delimited list of API names for field names in the additional-er-fields configuration option:
API Name | Field Label |
---|---|
Action_Check_Include_In_Financials__c | Action: Update Include In Financials |
Approved__c | Approved |
Assignment__c | Assignment |
Audit_Notes__c | Audit Notes |
Billable__c | Billable |
Description__c | Description |
Exclude_from_Billing__c | Exclude from Billing |
Include_in_Financials__c | Include in Financials |
Billed__c | Lines Billed |
Invoiced__c | Lines Invoiced |
Milestone__c | Milestone |
Override_Group__c | Override Group |
Override_Practice__c | Override Practice |
Override_Region__c | Override Region |
Project__c | Project |
Project_Expense_Notes__c | Project Expense Notes |
Resource__c | Resource |
Status__c | Status |
Submitted__c | Submitted |
Total_Billable_Amount__c | Total Billable Amount |
Total_Non_Billable_Amount__c | Total Non-Billable Amount |
Total_Reimbursement_Amount__c | Total Reimbursement Amount |
Fields to Exclude from additional-expense-fields
You must not include any of these fields in the comma delimited list of API names for field names in the additional-expense-fields configuration option:
API Name | Field Label |
---|---|
Admin_Global_Edit__c | Admin Global Edit |
Amount__c | Amount |
Amount_To_Bill__c | Amount to Bill |
Amount_To_Reimburse__c | Amount To Reimburse |
Approved__c | Approved |
Assignment__c | Assignment |
Billable__c | Billable |
Billable_Amount__c | Billable Amount |
Billable_Fee_Flat__c | Billable Fee Flat |
Billable_Fee_Percentage__c | Billable Fee Percentage |
Bill_Date__c | Bill Date |
Billed__c | Billed |
Billing_Amount__c | Billing Amount |
Billing_Amount_Pre_Fee_Subtotal__c | Billing Amount (Pre-Fee Subtotal) |
Billing_Currency__c | Billing Currency |
Billing_Event__c | Billing Event |
Billing_Event_Invoiced__C | Billing Event Invoiced |
Billing_Event_Item__c | Billing Event Item |
Billing_Event_Released__c | Billing Event Released |
Billing_Event_Status__c | Billing Event Status |
Bill_Transaction__c | Bill Transaction |
Cost_Transaction__c | Cost Transaction |
Description__c | Description |
Distance__c | Distance |
Eligible_for_Billing | Eligible for Billing |
Exchange_Rate_Billing_Currency__c | Exchange Rate (Billing Currency) |
Exchange_Rate_Incurred_Currency__c | Exchange Rate (Incurred Currency) |
Exchange_Rate_Reimbursement_Currency__c | Exchange Rate (Reimbursement Currency) |
Exchange_Rate_Resource_Defined__c | Exchange Rate (Resource-Defined) |
Expense_Date__c | Expense Date |
Expense_Report__c | Expense Report |
Expense_Split_Parent__c | Expense Split Parent |
Include_In_Financials__c | Include in Financials |
Incurred_Tax__c | Incurred Tax |
Incurred_Tax_Non_Billable__c | Incurred Tax Non-Billable |
Invoiced__c | Invoiced |
Invoice_Date__c | Invoice Date |
Invoice_Number__c | Invoice Number |
Invoice_Transaction__c | Invoice Transaction |
Non_Billable_Amount__c | Non-Billable Amount |
Non_Billable_Incurred_Amount__c | Non-Billable Incurred Amount |
Non_Billable_Incurred_Subtotal__C | Non-Billable Incurred Subtotal |
Non_Reimbursible__c | Non-Reimbursible |
Notes__C | Notes |
Override_Group__c | Override Group |
Override_Group_Currency_Code__C | Override Group Currency Code |
Override_Practice__c | Override Practice |
Override_Practice_Currency_Code__C | Override Practice Currency Code |
Override_Rate_Billing_Currency__c | Override Rate (Billing Currency) |
Override_Rate_Incurred_Currency__c | Override Rate (Incurred Currency) |
Override_Rate_Reimbursement_Currency__c | Override Rate (Reimbursement Currency) |
Override_Region__c | Override Region |
Override_Region_Currency_Code__C | Override Region Currency Code |
Project__c | Project |
Rate_Unit__c | Rate Unit |
Reimbursement_Amount__c | Reimbursement Amount |
Reimbursement_Currency__c | Reimbursement Currency |
Resource__C | Resource |
Revenue_Transaction__c | Revenue Transaction. |
Split_Expense__c | Split Expense |
Status__c | Status |
Submitted__c | Submitted |
Synchronous_Update_Required__c | Synchronous Update Required |
Tax_Type__c | Tax Type |
Type__c | Type |
Vendor_Invoice_Item__c | Vendor Invoice Item |
Expense Approval UI Configuration Settings
The Expense Approval UI custom setting controls the behavior of the Manage Expense Reports to Approve page.
Key: D – This setting is no longer used and has been replaced by the Expense Report Approval Columns field set. See Expense Report Field Sets.
Setting | Description | |
---|---|---|
Number of Expenses Shown Per Page | Number of expenses to display per page on the Manage Expense Reports to Approve page. | |
DEPRECATED: Show Assignment Name | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Billable Field | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show First Expense Date | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Last Expense Date | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Milestone Name | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Project Name | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Resource Name | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Total Billable Amount | OD | This setting is deprecated and no longer used. |
DEPRECATED: Show Total Non-Billable Amount | OD | This setting is deprecated and no longer used. |
Tooltip Fields | Comma delimited list of API names of expense fields to display on the Manage Expense Reports to Approve page when hovering over the tooltip icon. |