Enabling Entry Cancellation

← Setting Up Receivables/Payables Management

As a result of certain business use cases, some payment requests may no longer be justified – like, for example, when canceling an invoice or changing a payment plan. Consequently, the corresponding entries must be canceled.

If you have upgraded JustOn Cash Management from a pre-1.38 version, you may have to take several manual steps in order to enable the entry cancellation:

• Adding the status Canceled to the Entry object
• Deactivating the deprecated process Set Entry Status
• Adding the button Cancel to the Entry detail view
• Adding the cancellation-relevant fields to the page layout of the Entry object
• Configuring the cancellation credit balance strategy

Enabling Entry Status Canceled

To add the value Canceled to the Status picklist of the Entry object:

1. Click to enter Setup, then navigate to the object management settings of the Entry object.
2. Click Fields & Relationships.
3. Click the name of the Status field.

4. In the Values section, click New.

   Add the new status value Canceled.

5. Click Save.

   This saves the new status value Canceled as required.

   For details about modifying the values of picklist fields, see Add or Edit Picklist Values in the Salesforce Help.

Deactivating Deprecated Entry Process

To deactivate the deprecated process Set Entry Status:

1. Click to enter Setup, then navigate to Process Automation > Process Builder.
2. Click next to Set Entry Status to display all process versions.

3. For all active versions of the process, click Deactivate, then Confirm to confirm the operation.

   This deactivates the current process version.

   Make sure to deactivate all active versions of the Set Entry Status process.

Enabling Entry Cancellation From the UI

The default Entry record page includes the Cancel action.

If you use a custom Entry record page, your business may also require to enable the entry cancellation from the user interface. To this end, you can, optionally, add the Cancel action to the page. To do so:

1. Open your custom Entry record detail page in the Lightning App Builder.

   1. Open an Entry record.

      Click to access the App Launcher, and select Cash Management > Entries > record name.

   2. Click to open the Setup menu, then select Edit Page.

2. Select the top panel ("Highlights").

3. Click Add Action and select the action Cancel.

4. Click Done on the action window, then Save in the Lightning App Builder.

   For more details, see Create Dynamic Actions in Lightning App Builder in the Salesforce Help.

Adding Cancellation Fields to Entry

The default Entry record page shows cancellation-relevant information on the Entry Lifecycle tab when the entry has been canceled.

If you use a custom Entry record page, your business may also require to allow users managing cancellation-relevant information in the user interface. To support this, you can, optionally, add the fields Cancellation Reason, Cancellation ID, Cancellation No and Cancellation Distribution Url to the page. To do so:

1. Open your custom Entry record detail page in the Lightning App Builder.

   1. Open an Entry record.

      Click to access the App Launcher, and select Cash Management > Entries > record name.

   2. Click to open the Setup menu, then select Edit Page.

2. Modify the page layout.

   From the Fields list, drag the required fields to an appropriate region of the record page.

3. Click Save.

   This adds the cancellation-related fields to your custom Entry record page.

For more details about editing Lightning pages, see Create and Configure Lightning Experience Record Pages in the Salesforce Help.

Configuring Cancellation Credit Balance Strategy

Your business may require to define an individual credit balance strategy for the entry cancellation. To support this, JustOn Cash Management provides the picklist field Cancellation CBS on the Business Entity.

• Changing the default cancellation credit balance strategy for your organization
• Adding the cancellation credit balance strategy field to the page layout of the Business Entity object
• Defining the cancellation credit balance strategy for your business entity

Changing Organization Default Cancellation Credit Balance Strategy

JustOn Cash Management has preconfigured Future Settlement as the default credit balance strategy for the entry cancellation (see Supported Business Processes). You can, however, change the default cancellation credit balance strategy for your entire organization – setting a new default value in the Cancellation CBS picklist.

Info

Modifying values for picklist fields of an object requires the system permission Customize Application.

To change the default cancellation credit balance strategy:

1. Click to enter Setup, then navigate to the object management settings of the Business Entity object.
2. Click Fields and Relationships.
3. Click the name of the Cancellation CBS field.
4. In the Values section, click Edit in the row of the value to be set as default.
5. Select the Default checkbox.

6. Click Save.

   This makes the selected credit balance strategy the default option for the entry cancellation in your org. It will be applied if neither the business entity nor the business process define a specific credit balance strategy.

Adding Cancellation Credit Balance Strategy Field to Business Entity

If you have upgraded JustOn Cash Management from an older version, you must add the field Cancellation CBS to the page layout of the Business Entity object manually. To do so:

1. Click to enter Setup, then navigate to the object management settings of the Business Entity object.
2. Click Page Layouts.
3. In the Business Entity row, click , then select Edit.
4. Drag the field Cancellation CBS to the page layout.

5. Click Save.

   This adds the picklist field Cancellation CBS to the Business Entity detail view, enabling you to define a business entity-specific credit balance strategy for the entry cancellation.

Defining Cancellation Credit Balance Strategy for Business Entity

Note

Make sure that the field Cancellation CBS is available on the Business Entity detail view. For details, see Adding Cancellation Credit Balance Strategy Field to Business Entity.

To define an individual credit balance strategy for the entry cancellation for your business entity:

1. Click to access the App Launcher, and select Setup Cash Management.

2. Open the Business Entities tab.

   For easy access, you may want to add the Business Entities tab to the navigation bar. For details, see Personalize the Navigation Bar in the Salesforce Help.

3. Click the business entity name to open its detail view and click Edit.

4. In the Cancellation CBS field, select the intended credit balance strategy.

   The available options include:

   Credit Balance Strategy	Description
   Future Settlement	Represents a credit balance available to be settled with the next receivable.
   Prepared Refund	A prepared refund blocks the credit balance from being available for settlement. Instead, this creates a refund with the status Prepared.
   Direct Refund	A direct refund blocks the credit balance from being available for settlement. Instead, this creates a refund with the status Approved

5. Click Save.

   This defines the default credit balance strategy for the entry cancellation for your business entity.

   Be aware that users can specifically select a credit balance strategy when executing an entry cancellation, which may override the defined default strategy.