Completing Optionally Required Setup
Setting up JustOn Cash Management may include additional, optional tasks. This may be necessary for specific business use cases or if you have upgraded JustOn Cash Management from an older version.
Optional setup steps include:
- Common setup tasks
- Banking-related setup tasks
-
- Configuring the SEPA payment run
- Enabling the download of bank data
- Configuring the automatic bank data download
- Adding the button Credit Transfer to the Entry or Refund list view
- Adding the button Settle Automatically to the Bank Statement Item list view
- Enabling SEPA batch booking control
- Enabling proprietary bank account identifiers
- Enabling chargeback-relevant fields to the Bank Statement Item detail view
Enabling Entry Cancellation
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:
- Click to enter Setup, then navigate to the object management settings of the Entry object.
- Click Fields & Relationships.
- Click the name of the
Status
field. -
In the Values section, click New.
Add the new status value
Canceled
. -
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
:
- Click to enter Setup, then navigate to Process Automation > Process Builder.
- Click next to
Set Entry Status
to display all process versions. -
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
Your business may require to enable the entry cancellation from the user interface. To this end, you can, optionally, add the button Cancel to the Entry detail view manually. To do so:
- Click to enter Setup, then navigate to the object management settings of the Entry object.
- Click Page Layouts.
- In the Entry Layout row, click , then select Edit.
-
Add the Cancel button to the page layout.
In Salesforce Lightning, drag the button from the Mobile & Lightning Actions palette to the Salesforce Mobile and Lightning Experience Actions section.
In Salesforce Classic, drag the button from the Buttons palette to the Custom Buttons area.
-
Click Save.
Adding Cancellation Fields to Entry
Your business may 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 layout of the Entry object. To do so:
- Click to enter Setup, then navigate to the object management settings of the Entry object.
- Click Page Layouts.
- In the Entry row, click , then select Edit.
- Drag the fields
Cancellation Reason
,Cancellation ID
,Cancellation No
andCancellation Distribution Url
to the page layout. -
Click Save.
This adds the cancellation-related fields to the Entry detail view.
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:
- Click to enter Setup, then navigate to the object management settings of the Business Entity object.
- Click Fields and Relationships.
- Click the name of the
Cancellation CBS
field. - In the Values section, click Edit in the row of the value to be set as default.
- Select the
Default
checkbox. -
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:
- Click to enter Setup, then navigate to the object management settings of the Business Entity object.
- Click Page Layouts.
- In the Business Entity row, click , then select Edit.
- Drag the field
Cancellation CBS
to the page layout. -
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:
- Click to access the App Launcher, and select Cash Management.
-
Open the Business Entity tab.
For easy access, you may want to add the Business Entity tab to the navigation bar. For details, see Personalize the Navigation Bar in the Salesforce Help.
-
Click the business entity name to open its detail view and click Edit.
-
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. The credit balance is not paid back to the customer automatically. The money is effectively "frozen" on the debtor's account until the money is actually moved. Direct Refund A direct refund is defined by refunding money with a reference to the original payment transaction.
The behavior differs depending on the payment transaction context:
For payments made via a payment provider, this triggers a Referenced Refund.
For payments made via a bank account, this triggers a SEPA Credit Transfer. -
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.
Enabling Large Error Reports
In case of communication errors between Heroku, Salesforce and third-party systems, JustOn Cash Management writes error reports. The relevant information is saved to the Details
field of the dedicated Error Report records. The field length is limited to 131.072 characters. If the information exceeds this limit, JustOn Cash Management writes the complete error report to a file, which is attached to the corresponding Error Report record. You can access the attached error report file via the Files related list on the relevant Error Report record.
If you have upgraded JustOn Cash Management from a pre-1.32 version, you must add the Files related list to the Error Report detail view manually. This enables error reports that are larger than 131.072 characters.
To add the Files related list to the Error Report detail view:
-
Navigate to the object management settings of the Error Report (JPAY1__ErrorReport__c) object.
Click to open the Setup menu and select Setup, then open Objects and Fields > Object Manager > Error Report.
-
Click Page Layouts.
- Click Edit in the row of the layout you intend to modify.
- Select the Related Lists palette.
- Drag the Files list to the Related Lists section.
-
Click Save.
This adds the Files related list to the Error Report detail view. This enables error reports that are larger than 131.072 characters.
Enabling Payment Statuses
To enable specific operations on payments, you may have to add the required Status
values manually if you have upgraded JustOn Cash Management from an older version. To do so:
- Click to enter Setup, then navigate to the object management settings of the Payment object (
JPAY1__Payment__c
). - Click Fields & Relationships.
- Click the name of the
Status
field. -
In the Values section, click New.
Add the relevant status values, like
Canceled
,Failed
,Pending
, each in a new line. -
Click Save.
This saves the specified status values as required.
For details about modifying the values of picklist fields, see Add or Edit Picklist Values in the Salesforce Help.
Enabling Payment Matching Results
If you have upgraded JustOn Cash Management from a pre-1.28 or pre-1.40 version, you may have to add the new values
to the Matching Result
picklist of the Payment object manually in order to make the payment matching operational. To do so:
- Click to enter Setup, then navigate to the object management settings of the Payment object (
JPAY1__Payment__c
). - Click Fields & Relationships.
- Click the name of the
Matching Result
field. -
In the Values section, click New.
Add the relevant status values
Payment Id matched
andUnmatched, multiple results
, each in a new line.For a list of required values, see the description of the
Matching Result
field in the Payment object reference. If necessary, add all missing values. -
Click Save.
This saves the specified status values as required.
For details about modifying the values of picklist fields, see Add or Edit Picklist Values in the Salesforce Help.
Enabling Matching Configuration Search Templates
If you have upgraded JustOn Cash Management from a pre-1.24 version, you may have to add the value FindEntryByCustomField
to the Template
picklist of the Matching Configuration object manually in order to enable the new matching configuration type Entry by custom field
.
- Click to enter Setup, then navigate to the object management settings of the Matching Configuration object.
- Click Fields & Relationships.
- Click the name of the
Template
field. -
In the Values section, click New.
Add the new search template API Name
FindEntryByCustomField
.For a list of required values, see the description of the
Template
field in the Matching Configuration object reference. -
Click Save.
- Click Edit in the row of the new picklist value.
- In the
Label
field, specify the nameEntry by custom field
. -
Click Save.
This saves the specified search template value as required.
For details about modifying the values of picklist fields, see Add or Edit Picklist Values in the Salesforce Help.
Configuring SEPA Payment Run
JustOn Cash Management can execute SEPA payment runs in order to automatically initiate bank transfers on a regular basis.
To this end, JustOn Cash Management provides two dedicated Apex classes
- DirectDebitPaymentRunJob for SEPA Direct Debit, and
- CreditTransferPaymentRunJob for SEPA Credit Transfer.
These Apex classes are to be scheduled using the standard Salesforce Schedule Apex functionality.
Note
Users who intend to schedule a SEPA payment run must be able to access the relevant EBICS bank account credential record. There are two ways to achieve this:
- The user has created the relevant EBICS bank account credential record, or
- The relevant EBICS bank account credential record is not locked to the user who has created it (see How to share bank access configurations with other users?)
-
Click to enter Setup, then open Apex Classes.
In Salesforce Lightning, navigate to Custom Code > Apex Classes.
In Salesforce Classic, navigate to Develop > Apex Classes.
-
Click Schedule Apex on top of the list.
-
Specify the details as required.
- Job Name, like
Direct Debit Job
orCredit Transfer Job
, respectively -
Apex Class:
DirectDebitPaymentRunJob
for SEPA Direct DebitCreditTransferPaymentRunJob
for SEPA Credit Transfer
-
Frequency:
Weekly
orMonthly
(with an according day of week or day of month setting) - Start
-
End
Required, so if you want it to run virtually forever, select a date far in the future.
-
Preferred Start Time
- Job Name, like
-
Click Save.
This sets up the SEPA payment run to be executed at the specified time.
Enabling Bank Statement Download
Enabling the download of bank statements involves the following tasks:
- Adding the button Retrieve to the Bank Statement list view
- Adding the Files related list to the UI
- Optionally, enabling the structured storage of bank documents to Salesforce libraries and folders
Adding Retrieval Button to UI
To enable the option for starting the bank statement download from the user interface, you may have to add the button Retrieve to the Bank Statement list view manually. To do so:
- Click to enter Setup, then navigate to the object management settings of the Bank Statement object.
- Click List View Button Layout.
- In the List View row, click , then select Edit.
-
Under Custom Buttons, move
Retrieve
to the Selected Buttons column. -
Click Save.
Adding Files Related List to UI
You can access the downloaded bank statements or other bank documents via the Files related list on the relevant Bank Account record.
If you have upgraded JustOn Cash Management from a pre-1.42 version, you may have to add the Files related list to the Bank Account layout view manually manually. To do so:
-
Navigate to the object management settings of the Bank Account object.
Click to open the Setup menu and select Setup, then open Objects and Fields > Object Manager > Bank Account.
-
Click Page Layouts.
- Click Edit in the row of the layout you intend to modify.
- Select the Related Lists palette.
- Drag the Files list to the Related Lists section.
-
Click Save.
This adds the Files related list to the Bank Account detail view.
Enabling Structured Bank Document Storage
JustOn Cash Management can download different types of documents from initialized bank accounts and store these documents in Salesforce Files in a dedicated library/folder structure (named by BIC/IBAN).
To enable the structured bank data storage for your org:
- Click to access the App Launcher, and select Cash Management.
-
Open the Global Configuration tab.
Users who intend to access the global configuration must be assigned the System Administrator profile and explicitly allowed accessing the Global Configuration dialog.
-
Click Edit.
This launches a screen flow that shows the global configuration input fields.
-
In the Bank Statement Download section, select the
Structured File Storage
checkbox. -
Click Save to save your settings, then Finish to complete the screen flow.
This enables the structured bank data storage for your org. At the same time, JustOn Cash Management creates dedicated file libraries (named by BIC) and folders (named by IBAN) for all initialized banks based on all active EBICS bank account credentials.
Note
You must not modify the IBAN-specific folder names as created by JustOn Cash Management.
For any changes that may be necessary (for new or removed bank accounts, for example), repeat the activation step in the global configuration dialog.
Once set up, JustOn Cash Management has created the library/folder structure (named by BIC/IBAN) in Salesforce Files. In order to actually store downloaded bank account documents in the corresponding library, the users who retrieve bank data require write access.
To grant library write access to a user:
- Click to access the App Launcher, and select View All > Files.
- Click Libraries.
-
In the row of the library for which you want to edit accesses, click and select Manage Members.
-
In the
Add Members
field, select the relevant user or group. - From the
Access
picklist, selectAuthor
. -
Click Add.
This enables the selected user or group to add files to the current library.
Configuring Automatic Bank Data Download
JustOn Cash Management can automatically download bank data on a regular basis.
To this end, JustOn Cash Management provides the dedicated Apex class DownloadBankStatementsJob, which is to be scheduled using the standard Salesforce Schedule Apex functionality.
Note
Users who intend to schedule the bank data download must be able to access the relevant EBICS bank account credential record. There are two ways to achieve this:
- The user has created the relevant EBICS bank account credential record, or
- The relevant EBICS bank account credential record is not locked to the user who has created it (see How to share bank access configurations with other users?)
-
Click to enter Setup, then open Apex Classes.
In Salesforce Lightning, navigate to Custom Code > Apex Classes.
In Salesforce Classic, navigate to Develop > Apex Classes.
-
Click Schedule Apex on top of the list.
-
Specify the details as required.
- Job Name, like
Download Bank Statements Job
- Apex Class:
DownloadBankStatementsJob
-
Frequency:
Weekly
orMonthly
(with an according day of week or day of month setting)We recommend a daily interval (
Weekly
with every day selected) so that there will be no gaps in the bank data.In case of data gaps after the automatic download, a user must fetch the corresponding bank data manually. Be aware, however, that banks usually provide data for a limited period only, like 14 days.
-
Start
-
End
Required, so if you want it to run virtually forever, select a date far in the future.
-
Preferred Start Time
- Job Name, like
-
Click Save.
This sets up the bank data download to be executed automatically at the specified time.
Enabling Credit Transfer
If you have upgraded JustOn Cash Management from a pre-1.18 or pre-1.43 version, you may have to add the button Credit Transfer to the Entry or Refund list view manually in order to enable the option for creating credit transfer orders.
To do so:
- Click to enter Setup, then navigate to the object management settings of the Entry or Refund object.
- Click List View Button Layout.
- In the List View row, click , then select Edit.
-
Under Custom Buttons, move
Credit Transfer
to the Selected Buttons column. -
Click Save.
This adds the button Credit Transfer to the Entry list view or, respectively, the Refund list view, enabling users to create SEPA Credit Transfer orders.
Enabling Settlement From Bank Statement Items
To enable the option for starting the automatic settlement from a list of bank statement items, you may have to add the button Settle Automatically to the Bank Statement Item list view manually. To do so:
- Click to enter Setup, then navigate to the object management settings of the Bank Statement Item object.
- Click List View Button Layout.
- In the List View row, click , then select Edit.
-
Under Custom Buttons, move
Settle Automatically
to the Selected Buttons column. -
Click Save.
Enabling SEPA Batch Booking Control
SEPA Direct Debit and SEPA Credit Transfer allow to combine multiple transactions using a Batch Booking
parameter. This setting controls how the combined transactions are displayed on bank statements – usually, batched transactions appear as one bank statement item. Organizations use this option to avoid information disclosure.
Be aware that banks still process batched transactions individually. The subsequent handling does not change: each transaction results in a single payment, whether it is part of a batch or not.
To enable the option for enabling SEPA batch bookings for a bank account, you may have to add the corresponding picklist fields SEPA Direct Debit Batch Booking
, SEPA Credit Transfer Batch Booking
and Initial Payment Status
to the Bank Account layout manually if you have upgraded JustOn Cash Management from an older version. To do so:
- Click to enter Setup, then navigate to the object management settings of the Bank Account object.
- Click Page Layouts.
- In the Bank Account Layout row, click , then select Edit.
- Drag the fields
SEPA Direct Debit Batch Booking
,SEPA Credit Transfer Batch Booking
andInitial Payment Status
to the page layout. -
Click Save.
This adds the picklist fields to the bank account detail view, enabling users to control the batch booking creation for an individual bank account.
Enabling Proprietary Bank Account Identifiers
Some banks work with old or proprietary bank account identifiers instead of the IBAN, and, accordingly, produce CAMT.053 bank statement files without IBAN. In that case, the bank data retrieval with JustOn Cash Management will fail. To support these banks, you must add the proprietary bank identifier to the relevant bank account record.
Info
Check whether your bank's listing includes a corresponding note in Supported Banks.
To enable the option for specifying a proprietary bank account identifier, you may have to add the corresponding field Proprietary Bank Account Identifier
to the Bank Account layout manually if you have upgraded JustOn Cash Management from an older version. To do so:
- Click to enter Setup, then navigate to the object management settings of the Bank Account object.
- Click Page Layouts.
- In the Bank Account Layout row, click , then select Edit.
- Drag the field
Proprietary Bank Account Identifier
to the page layout. -
Click Save.
This adds the field to the bank account detail view, enabling users to specify a proprietary bank account identifier for an individual bank account.
Enabling Chargeback Information Display
When using SEPA Direct Debit, return debits or other chargeback operations may occur if a direct debit transaction cannot be carried out or is rejected by the debtor. In this case, the debtor's bank will reverse the original direct debit – returning the corresponding amount to the debtor. This produces a credit to the debtor's account and a debit to the creditor's account. Any banking fees will also be charged to the creditor.
JustOn Cash Management uses specific amount fields to indicate the instructed (originally initiated) amount, the transaction amount, cumulated charges and the effective amount on bank statement items.
Field | Description |
---|---|
Cumulated Charges | Sum of charges that are included in the current banking transaction. |
Effective Amount | The absolute amount without charges and interests. If set, will be used for further processing instead of Total Amount . |
Instructed Amount | The originally initiated amount before charges deduction. The currency may differ from the reported currency. |
Transaction Amount | The amount of money moved in the current banking transaction plus internal charges. External charges are not included. |
If required by your business, you may have to add the chargeback-related amount fields to the Bank Statement Item detail view manually. To do so:
- Click to enter Setup, then navigate to the object management settings of the Bank Statement Item object.
- Click Page Layouts.
- In the Bank Statement Item Layout row, click , then select Edit.
- Drag the fields
Cumulated Charges
,Effective Amount
,Instructed Amount
andTransaction Amount
to the page layout. -
Click Save.
This adds the chargeback-related amount fields to the bank statement item detail view.