Upgrading to Accounting Summer 2022

This section describes changes to make for the following features when upgrading to Summer 2022:

See the Upgrade Steps section under each feature for details of any action required. If you do not want to use or upgrade a feature, you can skip the upgrade steps for that feature. To perform upgrade steps, you must have administrator-level user permissions in your organization.

See the Included in this Feature section under each feature for details of items such as objects, fields, or buttons that have been added in this release.

Note:

Where new objects, fields, or buttons have been added for a feature, we recommend that you add them to any relevant page layouts, profiles, and permission sets. For information on how to do this, see the Salesforce Help.

For information on new features and changes to existing features in Summer 2022, see New Features and Enhancements in Accounting Summer 2022 or the "What’s New in Accounting Summer 2022" document available from the Accounting Documentation in the FinancialForce Community.

Mandatory Steps to Upgrade Payments Plus

Upgrade Steps

If you have previously set up the vendor payments feature using Asperato in your Spring 2022 org, complete the following mandatory upgrade steps to use Payments Plus in the Summer 2022 release:

Upgrade steps for Summer 2022

Step

Action

Further Information
1

Remove the following custom values if they are included in the Payment Method field on the Account object:

  • Asperato - Domestic - Bank_Transfer
  • Asperato - Domestic - Sepa
  • Asperato - Domestic - SEPA

Custom Account Fields

2 Rename the custom value "Asperato - Domestic - Fedwire" to "Asperato - Domestic - FEDWIRE" if it is included in the Payment Method field on the Account object. Custom Account Fields
3

Remove the following custom values if they are included in the Local Clearing System field on the Payment and Payment Details Template objects:

  • Bank transfer
  • SEPA
4 Rename the custom value "Fedwire" to "FEDWIRE" if it is included in the Local Clearing System field on the Payment and Payment Details Template objects.

Disable Dimensions

Upgrade Steps

To start using this feature in Summer 2022, take the following action.

Upgrade steps for Summer 2022

Action

Further Information

Enable the Disable Dimensions feature in the Feature Console.

Enabling the Disable Dimensions Feature

Included in this Feature

This section details the items that have been added in this release for this feature.

Fields

Fields added in Summer 2022

Field

Object

Further Information
Disabled Dimension 1 Dimension Fields
Dimension 2
Dimension 3
Dimension 4

Currency Exchange Gains and Losses

In some countries, it is a legal requirement to differentiate between currency exchange gains and losses by using different general ledger accounts for each. We have updated the currency exchange functionality to include this functionality. If your country has this requirement, you can use this functionality.

For information on how to use this functionality, see Defining Currency Exchange Gain/Loss GLAs.

Upgrade Steps

To start using this feature in Summer 2022, take the following action.

Upgrade steps for Summer 2022

Step

Action

Further Information
1.

Add Use Currency Write-Off Loss GLA checkbox to the Accounts Receivable Analysis - Currency Write-Off section of all Page Layouts.

 Setting up Currency Exchange Gain/Loss GLAs
2.

Add Currency Write-Off Loss GLA field to the Accounts Receivable Analysis - Currency Write-Off section of all Page Layouts.

Included in this Feature

This section details the items that have been added in this release for this feature.

Fields

Fields added in Summer 2022

Field

Object

Further Information
Currency Write-Off Loss GLA Accounting Company Accounting Company Fields
Use Currency Write-Off Loss GLA
Currency Write-Off Loss GLA Payment Payment Proposal Fields

Local GLAs in Currency Write-Off

Upgrade Steps

No steps are required to upgrade this feature to Summer 2022.

Included in this Feature

This section details the items that have been added in this release for this feature.

Fields

Fields added in Summer 2022

Field

Object

Further Information
Currency Write-Off GLA Accounting Company Accounting Company Fields

Accounting and Datastream

In order to make it easier for you to set up your org, the following sample templates have been added and can be imported using Datastream.

Chart of Accounts:

Chart of Accounts Mappings:

SAF-T Mappings:

Intercompany:

Upgrade Steps

Chart of Accounts and Mappings Templates

To start using this feature in Summer 2022, take the following action.

Upgrade steps for Summer 2022

Step

Action

Further Information
1.

Install and configure Datastream.

 FinancialForce Datastream in Community
2. Download the Chart of Accounts and Mappings Templates ZIP folder from Community.
3. Copy and paste the data from the XLSX file into Datastream.

SAF-T Standard Accounts and Tax Codes Mappings Templates

To start using this feature in Summer 2022, take the following action.

Upgrade steps for Summer 2022

Step

Action

Further Information
1.

Install and configure Datastream.

 FinancialForce Datastream in Community
2. Download the SAF-T Standard Accounts and Tax Codes Mappings Templates ZIP folder from Community.
3. Use Data Export in Setup to export the data for column A in both the Standard Accounts tab and Standard Tax Codes tab of the XLSX file.
4. Copy and paste the data from the XLSX file into Datastream.

Intercompany Definitions and Tax Codes Mappings

To start using this feature in Summer 2022, take the following action.

Upgrade steps for Summer 2022

Step

Action

Further Information
1.

Install and configure Datastream.

 FinancialForce Datastream in Community
2. Download the Intercompany Definitions and Tax Codes Mappings Templates ZIP folder from Community.
3. Copy and paste the data from the XLSX file into Datastream.

Deprecated APIs

This section details the APIs that have been deprecated and will be removed in a future release.

Sales Credit Notes

The following Sales Credit Note APIs have been deprecated in Summer 2022.

Name

Replaced By

c2g.CODAAPISalesCreditNote_9_0 and earlier

c2g.CODAAPISalesCreditNote_10_0

c2g.CODAAPICreditNoteLineItemTypes_9_0 

c2g.CODAAPICreditNoteLineItemTypes_10_0 

c2g.CODAAPICreditNoteTypes_9_0 

c2g.CODAAPICreditNoteTypes_10_0 

You can also use the following services instead of Sales Credit Note APIs:

Bank Reconciliation

Automated bank reconciliation has been updated to include new auto-match settings that allow you to specify how transactions are selected for matching with bank statement lines. You can select the following:

You can set your auto match settings as defaults, used in future bank reconciliations.

Upgrade Steps

To use this feature take the following actions.

Upgrade Steps

Step

Action

Further Information
1. Enable the new steps in the Reconciliation Processes Feature Console feature, to add new statuses to the Reconciliation Status and Bank Statement Status picklists. Reconciliation Processes
2. Manually add the Error Message field (codaBankReconciliation__c ErrorMessage__c) to your Bank Reconciliation Lightning page layout. "Customizing Page Layouts" in the Salesforce Help.

Included in this Feature

This section details the items that have been added in this release for this feature.

Custom Objects

Custom Objects

Object

Further Information
Auto Match Rule Auto Match Rule Fields
Auto Match Rule Details

Custom Fields

Field

Object

Further Information

Error Message

Bank Reconciliation

Bank Reconciliation Fields

Enhancements to the Consolidation Group Structure

Consolidation Group Structure Feature Console

Upgrade Steps

To start using the new Consolidation Group Structure feature, take the following action.

Action Further Information
Perform Step 3 to set default values for the fields on the company card and company details window in the Consolidation Group Structure Chart. Enabling the Consolidation Structure Feature

Included in this Feature

This section details the items that have been added in this release for this feature.

Custom Objects

Custom Objects

Object

Further Information
Consolidation Group Structure Setting Consolidation Group Structure Setting Fields

Fields

Fields added in Summer 2022

Field

Object

Further Information
Add to Card Consolidation Group Structure Setting Consolidation Group Structure Setting Fields
Add to View Details
Category
Consolidation Group Structure Set Name
Custom Field Label
Field Order for View Details
Field Order on Card
Field Type
Field API Name
Object API Name
Query Condition
Selectable Fields

Lightning Actions

Lightning Actions added in Summer 2022

Lightning Actions

Page

Further Information
Search Companies Consolidation Group Consolidation Group Structure Setting Fields
Date
Center
Zoom In
Zoom Out

Expand All

Collapse All
Track/Untrack Root
Show Companies with Structural Changes in the Selected FY
Show Entities Only

Compact and Tiered View

Rotate Left
Settings

Support Multiple Tax Statuses on Account

Upgrade Steps

To start using this feature in Summer 2022, take the following action.

Upgrade steps for Summer 2022

Step

Action

Further Information
1.

Enable the Multiple Companies Configuration feature in the Feature Console.

Note: A step of this feature automatically adds two new custom objects to layouts on the Account and Product objects. However, if you have custom layouts, after enabling this feature you must add them manually. See step 2 below.
 Enabling Multiple Companies Configuration
2.

Only required if you have custom layouts.

Manually add two new custom objects to page layouts:

  • Add the Multiple Companies Account Config custom object to the FinancialForce Account Layout on the Account object.
  • Add the Multiple Companies Product Config custom object to the FinancialForce Product Layout (Accounting) on the Product object.
 Customizing Page Layouts (and Search Layouts)
3.

Ensure the following permission sets are assigned to the necessary users:

  • Accounting and Billing - Sales Credit Note
  • Accounting and Billing - Sales Invoice
 Permission Sets Added Incrementally

Included in this Feature

This section details the items that have been added in this release for this feature.

Custom Objects

Custom Objects

Object

Further Information
Multiple Companies Account Config Multiple Companies Account Config Fields
Multiple Companies Product Config Multiple Companies Product Config Fields

Custom Settings

Custom Settings

Custom Setting

Further Information
Use Multiple Companies Configuration Accounting Settings

Functional Permissions

Upgrade Steps

Included in this Feature

This section details the items that have been updated in this release for this feature.

Permission Set Groups

Permission Set Groups

Previous Label for Permission Set Group

New Label for Permission Set Group

Further Information

FF Group - Accounting - Manage Accountant FF Group - Accounting - Mgmt Accountant Permission Sets and Other Technical Documentation

Foundations Tax Connector

Upgrade Steps

If you are upgrading to Summer 2022, enable the Foundations Tax Connector feature in the Feature Console to use the Foundations processes. New customers to Summer 2022 use Foundations external tax calculation processes by default.

For more information, see Upgrading to the Foundations Tax Connector.

Included in this Feature

This section details the items that have been added in this release for this feature.

Lightning Component Added in Summer 2022

Name

Description

Further Information
FFA Tax Calculation Settings Manage external tax settings for FinancialForce Accounting. Upgrading to the Foundations Tax Connector
Remote Sites Added in Summer 2022

Name

Description

Further Information
AvalaraV2Sandbox The Avalara AvaTax REST v2 sandbox environment. Upgrading to the Foundations Tax Connector
AvalaraV2Production The Avalara AvaTax REST v2 production environment.

Creating Documents and Dimensions from Integrations without an Accounting License

Upgrade Steps

No upgrade steps are required in Accounting to use this feature. For more information about the upgrade steps in SRP, see Upgrading to SRP Summer 2022 in the SRP Help.

Included in this Feature

Custom Permissions

Custom Permissions Added in Summer 2022
Custom Permission Description

Further Information
Create Documents without an Accounting License Create Accounting documents using the API without being assigned an Accounting license. Permission Sets and Other Technical Documentation
Manage Supporting Records without an Accounting License Create and edit supporting records, such as dimension 1-4 records, using the API without being assigned an Accounting license.

Enhancements to the Billing Document to Sales Invoice or Credit Note Integration

Upgrade Steps

No upgrade steps are required to upgrade this feature to Summer 2022.

Sales Invoice Consolidation Enhancements

Upgrade Steps

No upgrade steps are required to upgrade this feature to Summer 2022.

Included in this Feature

This section details the items that have been added in this release for this feature.

Field

Field added in Summer 2022

Field

Object

Further Information
Original Invoice Credit Note Line Item Sales Credit Note Fields

Archiving Billing Documents

Warning:

The archiving process must be performed by a FinancialForce business consultant. Contact your FinancialForce business consultant if you have a requirement to archive data from your org.

Included in this Feature

This section details the items that have been added in this release for this feature.

Field

Field added in Summer 2022

Field

Object

Further Information
Accounting Data Archived Billing Document Billing Document Fields

Custom Setting

Custom Setting

Custom Setting

Further Information
Summarization Journal Group By Criteria Archiving Settings

Deprecation of Chart of Accounts Localization Tab in Winter 2023 Release

In localization, the method to load a chart of accounts or chart of accounts mapping using the Chart of Accounts Localization tab will be superseded by the Datastream method in the Winter 2023 release. If you use the Chart of Accounts Localization tab method, we recommend that you begin using the Datastream method in preparation for the deprecation of the Chart of Accounts Localization tab method in the Winter 2023 release.

For more information, see the Datastream section in the following topics:

Lightning Experience

For the Summer 2022 release, we have improved our user experience using Lightning Experience across Accounting. This ensure that Accounting is intuitive, consistent, configurable, and flexible.

New Lightning Record Pages for Journals

We have redesigned Accounting Journals in Lightning Experience. This provides a robust and focused approach to managing journals. From Summer 2022, we have implemented a series of basic journal features in Lightning Experience. For more information on the updates for this release, see New Features and Enhancements in Accounting Summer 2022.

The Local Chart of Account, Override Currency, Duplicate Document and other features will be implemented in the future releases.

Upgrade Steps

To start using the new Lightning record pages in Summer 2022, take the following action.

Action

Further Information

Enable the Lightning Page and In-App Assignment feature in the Feature Console.

If the feature is already enabled, perform the following feature steps:

  • Set the Journal Lightning record pages as org defaults.
  • Update the page layouts.
  • Assign the Lightning page layouts.

Assigning Lightning Record Pages and In-App Guidance

 

Assign the Journal Layout (extended) page layout to the users of the new record pages.

 For more information about assigning page layouts, see the Salesforce Help.

Review the relevant field sets for the Journal Line Item objects and update them if required. The field sets control which columns are displayed in the line item grids for each company type.

Note: When you upgrade Accounting to Summer 2022, new fields that have been added to a field set display at the bottom of the list. This means that the columns in the grid might not be ordered as expected. You can manually change the order by editing the relevant field set.

Activating and Configuring Lightning Record Pages for Documents

Journal Line Items

Journal Line Item Fields

Included in this Feature

This section details the items that have been added in this release to support this functionality.

Lightning Record Pages

The Lightning record pages added for this feature in Summer 2022.

Page

Object

Description

Further Information

Journal Lightning Journal

It enables users to:

  • Create, view, edit, post, reverse, amend, cancel, and discard a journal.
  • Add, view, search, edit, clone, and delete line items via a customizable and feature-rich grid.

Journal Fields

Journal Line Item Fields

 

 

Lightning Components

The Lightning components added for this feature in Summer 2022.

Page

Object

Description

Further Information
FFA Journal Panel Journal Displays a grid that contains the line items linked to a journal. It enables users to add, view, search edit, amend, and delete line items.

Journal Fields

Journal Line Item Fields

Lightning Actions

The Lightning actions added for this feature in Summer 2022.

Action

Page Layout

Further Information
Amend Journal Journal Fields
Cancel Journal
Discard
Edit
Post
Reverse

Custom Settings

Custom Settings added for this feature in Summer 2022.

Field

Custom Setting

Further Information

Show Single Debit/Credit column (LWC)

Accounting Settings

Accounting Settings

Enable Edit Dimensions (after posting)

Fields

Fields added for this feature in Summer 2022.

Field

Object

Further Information

Owner

Journals - Details tab - Company Details

Journal Fields

Credit

Journal Line Item

Journal Line Item Fields

Debit

New Lightning Actions for the Year End Processes

For the Summer 2022 release, we have migrated the following year end processes to Lightning Experience:

Upgrade Steps

There are no upgrade steps for this feature.

Included in this Feature

This section details the items that have been added in this release for Lightning Experience.

Lightning actions added for Summer 2022.

Action

Page Layout

Further Information

Processing Adjustments

N/A

Year and Period Fields

Start Year End

Year End

Multi-Company Year End Processing

You can now run the year end process for up to 80 companies and years as a single batch job using the Run Year End For Multiple Companies task. For more information, see Running the Year End Process.

Upgrade Steps

There are no upgrade steps for this feature.

Included in This Feature

There are no new objects or fields included for this feature.

Opening Periods in a Closed Year

You can now reopen and adjust the following periods of the last closed year:

Upgrade Steps

There are no upgrade steps for this feature.

Included in This Feature

There are no new objects or fields included for this feature.

Inbound Customer Payments using Asperato

Upgrade Steps

You must add the new fields included in this feature to the applicable page layouts.

Included in This Feature

This section details the items that have been added in this release for this feature.

Fields

Fields added in Summer 2022

Field

Object

Further Information
Asperato Payout Reference Transaction Transaction Fields
Payment Cash Entry Cash Entry Fields
Payment Matching Reference Matching Reference Fields

Outbound Vendor Payments using Asperato

Upgrade Steps

If you have previously set up this feature in your Spring 2022 org, take the following actions:

Upgrade steps for Summer 2022

Step

Action

Further Information
1

Remove the following custom values if they are included in the Payment Method field on the Account object:

  • Asperato - Domestic - Bank_Transfer
  • Asperato - Domestic - Sepa
  • Asperato - Domestic - SEPA

Custom Account Fields

2 Rename the custom value "Asperato - Domestic - Fedwire" to "Asperato - Domestic - FEDWIRE" if it is included in the Payment Method field on the Account object. Custom Account Fields
3

Remove the following custom values if they are included in the Local Clearing System field on the Payment and Payment Details Template objects:

  • Bank transfer
  • SEPA
4 Rename the custom value "Fedwire" to "FEDWIRE" if it is included in the Local Clearing System field on the Payment and Payment Details Template objects.