Upgrading to Accounting Winter 2023

This page describes the changes to make when upgrading to Winter 2023.

See the Upgrade Steps section under each feature for details of any action required. If you don't want to use or upgrade an optional feature, you can skip the upgrade steps for that feature. To perform upgrade steps in your org, you must be assigned administrator permissions.

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 Winter 2023, see New Features and Enhancements in Accounting Winter 2023.

Introducing FinancialForce Trailhead: Release Highlights

If you want to learn more about the new features in this release, see the ERP Cloud - Winter 2023 Release Highlights Trailhead module. This module will guide you through the new features in our ERP Cloud products.

Upgrade Steps

No upgrade steps are required to upgrade this feature to Winter 2023.

Mandatory Steps to Upgrade Payments Plus

If you have previously set up this feature in your org, complete the mandatory upgrade by enabling the Vendor Payment Customizations feature in the Feature Console. For more information, see Enabling the Vendor Payment Customizations Feature.

FinancialForce Help

To view the FinancialForce Help from your org, you require Apex class access to be enabled for the fferpcore.ContextSensitiveHelpController class.

By default, access to this class has been added to all Foundations permission sets. If you use custom permission sets, you must add access to this class to the relevant permission sets. For more information about customizing permission sets, see the Salesforce Help.

The FinancialForce Help is available via the default utility bar associated with FinancialForce apps. If you use the default utility bar, no upgrade steps are required and the FinancialForce Help will be available from the utility bar automatically.

If you use a custom utility bar, complete the steps in Setting up the FinancialForce Help.

Enhancements to Multiple Tax Statuses on Account to Support Payable Documents

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps for Winter 2023
Step	Action	Further Information
1.	Either, if in the Summer 2022 release you did not use this functionality, you must enable the Multiple Companies Configuration feature in the Feature Console. Or, if in the Summer 2022 release you did enable the Multiple Companies Configuration feature, you must: Revert steps 2 and 3. Perform steps 2 and 3. Perform step 4.	Enabling Multiple Companies Configuration
2.	Ensure the following permission sets are assigned to the necessary users: Accounting and Billing - Payable Credit Note Accounting and Billing - Payable Invoice	Permission Sets Added Incrementally
3.	Edit the Help Text field for the Use Multiple Companies Configuration custom setting. Remove: If selected, uses the multiple companies configuration to calculate tax on sales documents. Add: If selected, uses the multiple companies configuration to calculate tax on sales and payable documents.	Accounting Settings

Included in this Feature

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

Fields

Fields added in Winter 2023
Field	Object	Further Information
Input VAT/GST Code	Multiple Companies Account Config	Multiple Companies Account Config Fields
Input VAT/GST Code	Multiple Companies Product Config	Multiple Companies Product Config Fields
VAT/GST Place of Supply Rules
VAT/GST Reverse Charge

Enhancements to the Disable Dimensions Feature

The Disable Dimensions feature was introduced in Summer 2022. In the Winter 2023 release, this feature is now also supported for:

Automated Eliminations
Journals

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps for Winter 2023
Action	Further Information
Enable the Disable Dimensions feature in the Feature Console. Note: Ignore this action if you enabled this feature in the Summer 2022 release.	Enabling the Disable Dimensions Feature

New Posting Effective Dates Section for Dimensions and General Ledger Accounts

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps for Winter 2023
Step	Action	Further Information
1.	Perform the steps for the Posting Effective Dates feature in the Feature Console to update the page layouts. Note: Ignore this step if you are a new user.	Updating Page Layouts For Posting Effective Dates Feature
2.	Ensure necessary users have the following permission sets assigned as required: Accounting and Billing - Dimension1 Accounting and Billing - Dimension2 Accounting and Billing - Dimension3 Accounting and Billing - Dimension4 Accounting and Billing - General Ledger Accounts	Permission Sets Mapping to Profiles

Included in this Feature

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

Fields

Fields added in Winter 2023
Field	Object	Further Information
Allow Posting	Dimension 1, 2, 3, and 4	Dimension Fields
Date From
Date To
Allow Posting	General Ledger Account	General Ledger Account Fields
Date From
Date To

Currency Exchange Gains and Losses Feature

Manual Steps Now Automated

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps for Winter 2023
Action	Further Information
Enable the Currency Exchange Gains and Losses feature in the Feature Console. Note: To use this functionality in Summer 2022 manual steps were required, but this is now automated using this Feature Console feature.	Enabling the Currency Exchange Gains and Losses Feature

Included in this Feature

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

Fields

Fields added in Winter 2023
Field	Object	Further Information
Unrealized Gains/Losses GLA	Accounting Company	Accounting Company Fields
Unrealized Losses GLA
Use Unrealized Losses GLA

Currency Revaluation and Currency Revaluation Template

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps for Winter 2023
Action	Further Information
Enable the Currency Exchange Gains and Losses feature in the Feature Console.	Enabling the Currency Exchange Gains and Losses Feature

Included in this Feature

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

Fields

Fields added in Winter 2023
Field	Object	Further Information
Revaluation Unrealized Gains GLA	Currency Revaluation	Currency Revaluation Fields
Revaluation Unrealized Losses GLA	Currency Revaluation	Currency Revaluation Fields
Unrealized Losses GLA	Currency Revaluation Template	Currency Revaluation Template Fields

Deprecated Validation Messages

Object	Field	Deprecated API Name	New API Name	Further Information
Currency Revaluation	Currency Translation Adjustment GLA	BothCrvAndCrtGainLossesGLAFieldRequiredValidation	N/A	These fields are obsolete and have been removed in this release.
	Revaluation Unrealized Gains/Losses GLA	BothCrvAndCrtGainLossesGLAFieldRequiredValidation	N/A
	Currency Translation Adjustment GLA	GLACurrencyISOCodeDoesNotBelongToCurrentCompany	GlaUnrealizedCurrencyIsoCodeDoesNotBelongToCurrentCompany
	Revaluation Unrealized Gains/Losses GLA	GLACurrencyISOCodeDoesNotBelongToCurrentCompany	UnrealizedGainsGlaFieldRequiredValidation
	Revaluation Unrealized Gains/Losses GLA	UnrealizedGainLossesGLAFieldRequiredValidation	UnrealizedGainsLossesGLAFieldRequiredValidation	These fields have been renamed in this release. Its functionality has not changed.
	Currency Translation Adjustment GLA	Deprecated API Name	New API Name	These fields are obsolete and have been removed in this release.
	Revaluation Unrealized Gains GLA	Deprecated API Name	N/A
	Revaluation Unrealized Gains/Losses GLA	CurrencyRevaluationTranslationGLACurrencyISOCodeDoNotBelongToCurrentCompany	N/A	These fields have been renamed in this release. Its functionality has not changed.

Bank Reconciliation

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps for Winter 2023
Action	Further Information
Enable the Allow Transactions Auto Creation field in the Reconciliation Settings custom setting.	Reconciliation Settings
Ensure that you have populated the following fields on your bank accounts: Bank Charge Analysis Interest Paid Analysis Interest Received Analysis	Bank Account Fields

Included In This Feature

New Fields

The following field has been added for this feature in Winter 2023.

Field	Object	Further Information
Total Running Processes	Bank Reconciliation	Bank Reconciliation Fields

New Custom Settings

The following custom setting has been added for this feature in Winter 2023.

Field	Custom Setting	Further Information
Allow Transactions Auto Creation	Reconciliation Settings	Reconciliation Settings

Transaction Reconciliation

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Upgrade steps forWinter 2023
Action	Further Information
Perform step 5 in the Reconciliation Processes feature in Feature Console.	Enabling the Reconciliation Processes

Included In This Feature

New Picklist Values

The following picklist value has been added for this feature in Winter 2023.

Object	Field	Picklist Value	Further Information
Auto Match Rule	Auto Match Rule Type	Transaction Reconciliation	Auto Match Rule Fields

Lightning Experience

New Lightning Record Pages for Cash Entries

We have introduced the Cash Entry Lightning record page. This page provides a modern user experience and enables you to perform your daily tasks in a streamlined way.

For more information, see New Features and Enhancements in Accounting Winter 2023.

Upgrade Steps

To start using this feature in Winter 2023, take the following action.


Step	Action	Further Information
1.	Perform step 4 in the Lightning Page and In-App Assignment feature to assign the Cash Entry Lightning page as the org default.	Assigning Lightning Record Pages and In-App Guidance
2.	Assign the Cash Entry Compact Layout manually.

Included in this Feature

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

Lightning Record Pages

The Lightning record page added for this feature in Winter 2023
Page	Object	Tabs	Description	Further Information
Cash Entry Lightning Page	Cash Entry	Details	This page enables users to: Add, clone, and delete lines. View Matched Payments. Post, cancel, edit, amend, and discard the cash entry. Match the cash entry in background or manually as required.	Creating a Cash Entry
		Files
		Line Items
		Transactions
		Matched Payments
		Related

Lightning Components

The Lightning components added for this feature in Winter 2023
Name	Description	Further Information
FFA Cash Entry Lines Panel	Displays cash entry lines on the Cash Entry page and allows to perform various actions.	Accounting Lightning Components Overview Creating a Cash Entry

Fields

Fields added in Winter 2023
Object	Field	Page Layout	Lightning Component	Further Information
Cash Entry	Bank Account	Cash Entry Layout and Cash Entry Layout (extended)	FFA Record Summary Section	Cash Entry Fields
	Cash Entry Currency
	Date
	Derive Company Bank Account	Cash Entry Layout (extended)
	Derive Bank Account Dimensions
	Derive Bank Charges Analysis
	Derive Bank Account Currency
	Derive Period
	Reference	Cash Entry Layout and Cash Entry Layout (extended)
	Type
	Bank Account		Highlights Panel
	Cash Entry Value
	Net Value
	Status
	Total Charges

Field Sets

Field Sets added in Winter 2023
Name	Used on Pages	Further Information
Manage Cash Entry Lines	Cash Entry Lightning Page	Cash Entry Line Item Field Sets

Updated Permission Sets

The following permission sets have been updated for this feature in Winter 2023
Permission Set	Controller Added	Further Information
Accounting-Cash Entry-Amend	Cash Entry Lightning Amend Controller	Permission Sets and Other Technical Documentation
Accounting-Cash Entry-Edit	Cash Entry Save Controller
Accounting-Cash Entry-Post	Cash Entry Post Controller
Accounting-Cash Entry-Save	Cash Entry Save Controller

Lightning Actions

Lightning Actions added in Winter 2023
Lightning Action	Page	Further Information
Amend Details	Cash Entry	Cash Entry Fields
Cancel Cash Entry
Discard
Manual Match
Post
Post and Background Match
Post and Manual Match

Lightning Actions

Lightning Actions renamed in Winter 2023
Original Label	New Label	Further Information
Match	Background Match	Cash Entry Fields

New Lightning Record Pages for Period Close Template

We have introduced Period Close Template in Lightning Experience. This provides a robust and focused approach to close periods. For more information, see New Features and Enhancements in Accounting Winter 2023.

Upgrade Steps

No upgrade steps are required to upgrade this feature to Winter 2023.

Included in this Feature

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

Lightning Record Pages

Lightning record pages added for this feature in Winter 2023
Page	Description
Period Close Template Lightning Page	Default Period Close Template Lightning Record Page.

Lightning Components

The Lightning components added for this feature in Winter 2023
Name	Further Information
Close Periods	Accounting Lightning Components Overview
FFA Period Close Options Panel
FFA Selected Accounting Companies
Manage Period Close Options
Select Accounting Companies
Selected Period Close Options

Custom Objects

Custom Objects added for this feature in Winter 2023
Objects	Further Information
Period Close Template	Period Close Template Fields
Selected Company	Period Close Template Fields

Fields

Fields added for this feature in Winter 2023
Fields	Object	Further Information
Description	Period Close Template	Period Close Template Fields
Hard Close Options
Period Close Template Name
Soft Close Options
Companies	Selected Company
Period Close Template
Period Close Template Line Item Name

Lightning Actions

Lightning Actions added for this feature in Winter 2023
Lightning Action	Page	Further Information
Close Periods	Period Close Template	Period Close Template Fields

Enhancements to Journals

For the Winter 2023 release, we have introduced various functionalities in Lightning Experience.

Upgrade Steps

No upgrade steps are required to upgrade this feature to Winter 2023.

Lightning Record Pages

The Lightning record page updated for this feature in Winter 2023
Page	Object	Description	Further Information
Journal Lightning	Journal	It enables users to: Create, view, edit, post, reverse, amend, cancel, duplicate, and discard a journal. Create recurring journals. 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 updated for this feature in Winter 2023
Name	Object	Description	Further Information
FFA Journal Line Items Grid	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
FF Journal List View	Journal	Displays a table that contains the list of journals. It enables users to add, view, search, cancel, duplicate, discard, reverse, and post a journal. It also allows users to perform mass actions such as cancel, discard, duplicate, post, and reverse journals.	Viewing Journal Lists

Buttons

Buttons added in Winter 2023
Button	Page Layout	Further Information
Create Recurring Journals	Journal	Journal Fields
Duplicate	Journal	Journal Fields
Cancel	Journal List View - Mass Actions	Viewing Journal Lists
Discard
Duplicate
Post
Reverse

Custom Setting Fields

Custom setting fields added for this feature in Winter 2023

Field	Custom Setting	Further Information
Allow use of Local GLAs	Accounting Settings	Accounting Settings
Mass Actions Settings (FF)
Override Currency Values on Journal Line (after posting)

Field

Custom Setting

Further Information

Allow use of Local GLAs

Accounting Settings

Mass Actions Settings (FF)

Override Currency Values on Journal Line

(after posting)

Deprecation of Chart of Accounts Localization Tab in Winter 2023 Release

As mentioned in the Summer 2022 release, the method to load a chart of accounts or chart of accounts mapping using the Chart of Accounts Localization tab has been superseded by the Datastream method in the Winter 2023 release.

For more information, see the Datastream section in Loading Chart of Accounts and Mappings with Datastream.

Deprecated Features and Functionality

The following tabs are deprecated in Winter 2023
Tab	Description	Replaced Tab
DEPRECATED: Cash Matching	This tab is now obsolete. This tab opened the Visualforce version of the Cash Matching page.
DEPRECATED: Cash Matching Lightning	This tab is now obsolete. It is replaced with Cash Matching tab that opens the Lightning page for cash matching.	Cash Matching

Vendor Payments using Asperato

New Feature Console Step for Vendor Payment Customization

We have added a new Vendor Payment Customizations feature in the Feature Console.

Upgrade Steps

If you are upgrading to Winter 2023, enable the Vendor Payment Customizations feature in the Feature Console to use the outbound vendor payments feature in Payments Plus. For more information, see Enabling the Vendor Payment Customizations Feature.

Single Payment for Multiple Invoices

Included in This Feature

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

New Fields

Fields added in Winter 2023
Object	Field	Further Information
Payment Media Summary	Asperato Payment	Payment Media

Deprecated Fields

Fields deprecated and removed in Winter 2023
Object	Field	Further Information
Payment Detail	Asperato Payment	This field is obsolete and has been removed in this release. Its functionality has been replaced with that of the Asperato Payment field of the Payment Media Summary object. For more information, see Payment Media.

Creating Vendor Payments at Account Level

To reduce the transaction cost per vendor, we have made the "Select Invoices for Separate Payments" checkbox available for the Asperato payment method in Payments Plus. If you deselect this checkbox, you can create payments at account level instead of invoice level when paying vendors via Asperato.

For more information, see 1. Payment.

Upgrade Steps

Complete the mandatory upgrade by enabling the Vendor Payment Customizations feature in the Feature Console. For more information, see Enabling the Vendor Payment Customizations Feature.

Collections Plus

Changing the On Hold Status of Billing Documents

To help you manage your billing documents, in this release we have added the ability to manually change their On Hold status. You can now select and deselect the On Hold checkbox on a billing document as long as the document does not have the status of "Complete" or "Posted".

You can also change the On Hold status of a billing document using the API by setting the On Hold value to:

"true" to place a billing document on hold.
"false" to release a billing document for collection.

Upgrade Steps

To start using this feature in Winter 2023, see Placing Billing Documents On Hold.

Payable Invoices

Creating Payable Invoices in Multi-Company Mode

For the Winter 2023 release, we have added the ability to create and process payable invoices in multi-company mode when using Lightning Experience. In multi-company mode you do not need to change the current company when processing payable invoices.

For more information, see Activating and Configuring Lightning Record Pages for Documents.

Improved Processing of Large Payable Invoices

We have also improved the support for large documents by adding the ability to create payable invoices with up to 9,980 lines using Lightning Experience. For more information, see Payable Invoice Line Volumes.

Upgrade Steps

To use these new features, use the new Lightning record page for payable invoices.

Included in This Feature

The following fields have been included in the Winter 2023 release and are available immediately on upgrade.

Fields added in Winter 2023
Field	Object	Further Information
Expense Line Count	Payable Invoice	Payable Invoice Fields
Intercompany A/R PIN Batch Line Limit	Document Line Volume Settings	Document Line Volume Settings
Intercompany A/R PIN Lines Threshold	Accounting Settings	Accounting Settings
Product Line Count	Payable Invoice	Payable Invoice Fields

Years and Periods

Multi-Book Accounting Support for the Year End Process for Multiple Years and Companies

The year end process for multiple years and companies now supports Multi-Book Accounting. If you are using Multi-Book Accounting, the process takes into account your accounting books and:

Runs a year end process for each book.
Calculates year end journals by identifying the balances book by book.
Associates the resulting year end journals with the correct accounting book.

This is done automatically so you do not need to run a year end process per company and accounting book. Multi-Book Accounting is compatible with both year end modes: General Ledger Account and Full Accounting Code.

For more information, see:

Upgrade Steps

There are no upgrade steps for this feature.

Preventing Changes to the Company Selection during the Year End Process

We have added additional validations to prevent users from deselecting the companies for which the year end process is running. In this release, when the year end process is running for a current company, you cannot deselect that company until the process is complete. This ensures that users do not interrupt the year end process by accidentally changing the company for which the process is running.

For more information, see About the Year End Process.

Upgrade Steps

There are no upgrade steps for this feature.

New Fields Included for this Feature

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

Fields added in Winter 2023
Field	Object	Further Information
Year End User	Year	Year and Period Fields

Desktop Notifications for the Year End Process

In the Winter 2023 release, you receive a notification when the year end process completes.

For more information, see About the Year End Process.

Upgrade Steps

There are no upgrade steps for this feature.

Trigger-Posting Documents

Upgrade Steps

To start using this feature in Winter 2023, take the following action.

Action	Further Information
Enable the Trigger Posting of Documents feature in the Feature Console. We recommend enabling this feature to automatically add the Trigger Posting and Trigger Posting Error fields to the following document page layouts: Cash Entry Journal Payable Credit Note Payable Invoice Sales Credit Note Sales Invoice If you use other page layouts, you must add these fields manually.	Enabling the Trigger Posting of Documents Feature

Action

Further Information

Enable the Trigger Posting of Documents feature in the Feature Console.

We recommend enabling this feature to automatically add the Trigger Posting and Trigger Posting Error fields to the following document page layouts:

Cash Entry
Journal
Payable Credit Note
Payable Invoice
Sales Credit Note
Sales Invoice

If you use other page layouts, you must add these fields manually.

Enabling the Trigger Posting of Documents Feature

Included in this Feature

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

Fields

Fields added in Winter 2023
Object	Field	Further Information
Cash Entry	Trigger Posting Trigger Posting Error	Cash Entry Fields
Journal		Journal Fields
Payable Credit Note		Payable Credit Note Fields
Payable Invoice		Payable Invoice Fields
Sales Credit Note		Sales Credit Note Fields
Sales Invoice		Sales Invoice Fields