action.skip

Completing Additional Setup

← Setting Up JustOn Cash Management

Setting up JustOn Cash Management may include additional, optional or potentially required 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
Payment provider-related setup tasks
Banking-related setup tasks

Adapting Navigation Bar

The Lightning Experience App Cash Management by JustOn (see App Overview) comes with a default configuration of basic tabs necessary to do your daily business:

Tab Description Related Object
Entries Entries are used to hold all relevant information with regard to a certain amount of money owed to or requested by a business partner (debtor, creditor). They are the basis of your cash management operations. Entry
Payments Payments are used to track a money transfer and its status. They are the entries' "counterparts" used to settle them. Payment
Refunds Refunds track money returned to a debtor in relation to a previously received payment. Refund
Accounts Accounts (standard Salesforce object) represent your customers and business partners and are the primary place to manage customer-related data and related objects like payment instruments. Account

However, depending on your individual business use cases and involved processes, you may want to add more tabs to the navigation bar. The following table lists the other available tabs in Cash Management by JustOn.

Tab Description Related Object
Bank Accounts Bank accounts hold all relevant information on actual bank accounts, through which business entities can execute EBICS-based transactions. The records are created on EBICS initialization. Bank Account
Bank Statements Bank statements hold summarized data for a particular bank account at a specific date. Starting here, users can manually retrieve bank data if your org has not set up the automatic bank statement retrieval. Bank Statement
Bank Statement Items Bank statement items represent a single money transfer as reported by the bank. Usually, bank statement items are automatically associated with payments used to settle entries upon retrieval. However, the automatic settlement may fail, so users may need to check for unmatched bank statement items and to settle them manually. Bank Statement Item
Payment Notifications Payment notifications represent updates for payments and refunds processed via a payment provider. They are always linked to a payment or refund and can be accessed via the payment record page or refund record page. Payment Notification
Payment Customers A payment customer represents a customer from customer-based payments as used by some payment service providers. It is tightly linked to the account. Payment Customer
Payment Instruments Payment instruments hold online payment, credit card or bank account information, which is used for the automatic payment collection or SEPA payment order export. They are tightly connected to accounts and are accessible via the account record page. Payment Instrument
Jobs Jobs represent automated (payment) processes in JustOn Cash Management. This tab allows for reviewing the jobs' execution statuses. Job
Error Reports Error reports allow to analyze communication issues between the JustOn Cash Management platform and Salesforce or other third-party systems (for example, banks). JustOn Support may request error reports for troubleshooting purposes. Error Report
Entry Items Entry items are used to associate payments with entries. Thus, they are a rather technical object and are usually not needed in daily business. Entry Item

Defining App Default Navigation Bar

Administrators can define additional Cash Management by JustOn tabs that will be displayed to all users of their org. To do so:

  1. Click to enter Setup, then navigate to Apps > App Manager.
  2. In the row of Cash Management by JustOn, click to open the action menu, then select Edit.
  3. Navigate to Navigation Items.
  4. Select the intended tabs and move them to the Selected Items column.

    column_select

  5. Click Save.

    This makes the selected tabs available to all users of the org.

    For details, see Customize Lightning Apps with the Lightning App Builder.

Customizing Navigation Bar

Users can can add and reorder tabs so that they suit their way to work. To do so:

  1. Click in the navigation bar.
  2. Modify the navigation items as necessary.

    This opens the Edit App Navigation Items dialog.

    jpay_tabs

    To add new tabs:

    1. Click Add More Items.
    2. Click next to the tabs you want to add.
    3. Click Add Nav Items.
    4. Click Save.

    To reorder tabs:

    1. Drag and drop the items in the list.
    2. Click Save.

    To remove tabs:

    1. Click next to the tab you want to remove.
    2. Click Save.

      You cannot remove tabs that are set as default with the app or by an administrator.

    For details, see Personalize the Navigation Bar in Lightning Experience.

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:

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 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. 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.
  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.

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:

  1. 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.

  2. Click Page Layouts.

  3. Click Edit in the row of the layout you intend to modify.
  4. Select the Related Lists palette.
  5. Drag the Files list to the Related Lists section.
  6. 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:

  1. Click to enter Setup, then navigate to the object management settings of the Payment object (JPAY1__Payment__c).
  2. Click Fields & Relationships.
  3. Click the name of the Status field.
  4. In the Values section, click New.

    Add the relevant status values, like Canceled, Failed, Pending, Refunded, each in a new line.

    pay_app_payment_status_values

  5. 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 Status Display

Users may require to easily assess the current processing status of payments in a graphical representation. To this end, JustOn Cash Management provides a dedicated status component, which is part of the default Payment record page.

If you use a custom Payment record page, you can, optionally, add the payment status component to your page.

To do so:

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

    1. Open a Payment record.

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

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

  2. Modify the page layout.

    Add the Payment Processing Status component (under Custom - Managed) to an appropriate region of the record page.

  3. Click Save.

    This makes the customized record page available to users, enabling them to easily assess the current payment processing status on the payment detail view.

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

Enabling Refund Statuses

If you have upgraded JustOn Cash Management from a pre-1.33 or pre-1.49 version, you may have to add the new picklist values to the Status field of the Refund object. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Refund object (JPAY1__Refund__c).
  2. Click Fields & Relationships.
  3. Click the name of the Status field.
  4. In the Values section, click New.

    Add the relevant status values, each in a new line. The required values include

    Prepared
    Approved
    Pending
    Refunded
    Failed
    Canceled

  5. 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.

Info

As of v1.49, you can remove the deprecated values Issued, Open, Reversed and Rejected from the Status picklist.

Setting Refund Reasons

Your business can define custom refund reasons and allow users to specify individual reasons.

Defining Custom Refund Reasons

To add org-specific refund reasons:

  1. Click to enter Setup, then navigate to the object management settings of the Refund object (JPAY1__Refund__c).
  2. Click Fields & Relationships.
  3. Click the name of the Refund Reason field.
  4. In the Values section, click New.

    Add the relevant refund reasons, like Retry with SEPA, each in a new line.

  5. Click Save.

    This saves the specified refund reasons, making them available for users when creating refunds.

Enabling Individual Refund Reasons

To allow users specifying individual refund reasons, add the value Other to the Refund Reason picklist. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Refund object (JPAY1__Refund__c).
  2. Click Fields & Relationships.
  3. Click the name of the Refund Reason field.
  4. In the Values section, click New.

    Add the value Other.

  5. Click Save.

    This saves the value Other. When selecting Other as the refund reason on refund creation, users can specify an individual refund reason.

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

  • Payment Id matched (new with v1.28)
  • Unmatched, multiple results (new with v1.40)

to the Matching Result picklist of the Payment object manually in order to make the payment matching operational. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Payment object (JPAY1__Payment__c).
  2. Click Fields & Relationships.
  3. Click the name of the Matching Result field.
  4. In the Values section, click New.

    Add the relevant status values Payment Id matched and Unmatched, 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.

  5. 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.

  1. Click to enter Setup, then navigate to the object management settings of the Matching Configuration object.
  2. Click Fields & Relationships.
  3. Click the name of the Template field.
  4. 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.

  5. Click Save.

  6. Click Edit in the row of the new picklist value.
  7. In the Label field, specify the name Entry by custom field.
  8. 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 PSP Payment Run

JustOn Cash Management can execute payment runs in order to automatically collect payments on a regular basis.

Scheduling Payment Run

JustOn Cash Management provides the dedicated Apex class PaymentRunJob, which is to be scheduled using the standard Salesforce Schedule Apex functionality.

  1. 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.

  2. Click Schedule Apex on top of the list.

  3. Specify the details as required.

    • Job Name, like Payment Run Job
    • Apex Class: PaymentRunJob
    • Frequency: Weekly or Monthly (with an according weekday 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

  4. Click Save.

    This sets up the payment run to be executed at the specified time.

Ad hoc execution

Certain circumstances may require to execute the payment run on an ad hoc basis. To this end, you can execute the Apex class using a flow whenever required.

  1. Create a flow to call the Apex class PaymentRunJob.

    1. Click to enter Setup, then navigate to Process Automation > Flows.
    2. Click New Flow.
    3. Select Screen Flow and click Create.
    4. Click and add the following Action element.

      Option Value
      Action Execute Payment Run

      Specify a label and an API name as required.

    5. Click Save.

      Specify a label and an API name as required.

  2. Execute the payment run flow.

    1. Open the payment run flow in the Flow Builder or the detail view.
    2. Click Run.

This will immediately execute the payment run.

Adjusting Payment Run Retry Threshold

If a payment provider causes too many (by default, 10) temporary failures in consecutive payment runs, JustOn Cash Management will deactivate it. To define the deactivation threshold according to your org's requirements:

  1. Click to access the App Launcher, and select Setup Cash Management.
  2. 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.

  3. Click Edit.

    This launches a screen flow that shows the global configuration input fields.

  4. In the Payment Provider Configuration section, specify the intended value in the Retry Threshold field.

    The threshold defined here will apply to all payment providers.

  5. Click Save to save your settings, then Finish to complete the screen flow.

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 Sharing Bank Access Configurations).
  1. 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.

  2. Click Schedule Apex on top of the list.

  3. Specify the details as required.

    • Job Name, like Direct Debit Job or Credit Transfer Job, respectively
    • Apex Class:

      • DirectDebitPaymentRunJob for SEPA Direct Debit
      • CreditTransferPaymentRunJob for SEPA Credit Transfer
    • Frequency: Weekly or Monthly (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

  4. 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 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:

  1. Click to enter Setup, then navigate to the object management settings of the Bank Statement object.
  2. Click List View Button Layout.
  3. In the List View row, click , then select Edit.
  4. Under Custom Buttons, move Retrieve to the Selected Buttons column.

    column_select

  5. Click Save.

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:

  1. 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.

  2. Click Page Layouts.

  3. Click Edit in the row of the layout you intend to modify.
  4. Select the Related Lists palette.
  5. Drag the Files list to the Related Lists section.
  6. 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:

  1. Click to access the App Launcher, and select Setup Cash Management.
  2. 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.

  3. Click Edit.

    This launches a screen flow that shows the global configuration input fields.

  4. In the Bank Statement Download section, select the Structured File Storage checkbox.

  5. 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:

  1. Click to access the App Launcher, and select View All > Files.

    For easy access, you may want to add the Files tab to the navigation bar. For details, see Customizing Navigation Bar.

  2. Click Libraries.

  3. In the row of the library for which you want to edit accesses, click and select Manage Members.

    library_members

  4. In the Add Members field, select the relevant user or group.

  5. From the Access picklist, select Author.
  6. 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 Sharing Bank Access Configurations).
  1. 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.

  2. Click Schedule Apex on top of the list.

  3. Specify the details as required.

    • Job Name, like Download Bank Statements Job
    • Apex Class: DownloadBankStatementsJob
    • Frequency: Weekly or Monthly (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

  4. 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 enable the option for creating credit transfer orders manually. This involves

Adding Credit Transfer Button

To add the button Credit Transfer to the Entry or Refund list view manually:

  1. Click to enter Setup, then navigate to the object management settings of the Entry or Refund object.
  2. Click List View Button Layout.
  3. In the List View row, click , then select Edit.
  4. Under Custom Buttons, move Credit Transfer to the Selected Buttons column.

    column_select

  5. 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.

Activating Refund Credit Transfer Flow

To activate the Refund Credit Transfer flow:

  1. Click to enter Setup, then navigate to Process Automation > Flows.
  2. In the row of Refund Credit Transfer, click , then select View Details and Versions.
  3. In the row of the newest flow version, click Activate.

    This activates the Refund Credit Transfer dialog, enabling users to create SEPA Credit Transfer orders from refunds.

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:

  1. Click to enter Setup, then navigate to the object management settings of the Bank Statement Item object.
  2. Click List View Button Layout.
  3. In the List View row, click , then select Edit.
  4. Under Custom Buttons, move Settle Automatically to the Selected Buttons column.

    column_select

  5. 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.

Depending on your JustOn Cash Management version, enabling the SEPA batch booking control for a bank account may involve two tasks:

Adding SEPA Batch Booking Control Fields

If you have upgraded JustOn Cash Management from a pre-1.24 version, 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. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Bank Account object.
  2. Click Page Layouts.
  3. In the Bank Account Layout row, click , then select Edit.
  4. Drag the fields SEPA Direct Debit Batch Booking, SEPA Credit Transfer Batch Booking and Initial Payment Status to the page layout.
  5. 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 Initial Payment Statuses

JustOn Cash Management 1.49 has changed the default initial status of the produced payment from Issued to Pending. As of version 1.49, Issued will no longer be used.

If you have upgraded from a pre-1.49 version, you may have to manually adjust the required values in the Initial Payment Status picklist accordingly – adding Pending as a new value and setting it the default option. To do so:

  1. Click to enter Setup, then navigate to the object management settings of the Bank Account object (JPAY1__BankAccount__c).
  2. Click Fields & Relationships.
  3. Click the name of the Initial Payment Status field.
  4. In the Values section, click New.

    Add the new status value Pending.

  5. Click Save.

  6. Click Edit in the row of Pending.
  7. Select the checkbox Default.

    pay_app_paym_stat_pending

  8. Click Save.

    This saves the new status value Pending and makes it the default option.

  9. Click Del in the row of the obsolete value Issued, then OK to confirm the operation.

  10. When prompted, select Replace value on records with Pending.
  11. Click Save.

    This deletes the obsolete value Issued and replaces any occurrences with Pending.

Info

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

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:

  1. Click to enter Setup, then navigate to the object management settings of the Bank Account object.
  2. Click Page Layouts.
  3. In the Bank Account Layout row, click , then select Edit.
  4. Drag the field Proprietary Bank Account Identifier to the page layout.
  5. 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 or SEPA Credit Transfer, return debits or other chargeback operations may occur if a direct debit or credit transfer cannot be carried out or is rejected by the business partner. In this case, the other party's bank will reverse the original direct debit or credit transfer – returning the corresponding amount to the payer.

Assume a merchant-buyer relation, where the merchant initiates the SEPA orders:

  • For direct debit chargebacks, this produces a credit to the buyer's (the debtor's) account and a debit to the merchant's account.
  • For credit transfer chargebacks, this produces a credit to the merchant's account.

Any banking fees will usually be charged to the party who has initiated the SEPA request.

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:

  1. Click to enter Setup, then navigate to the object management settings of the Bank Statement Item object.
  2. Click Page Layouts.
  3. In the Bank Statement Item Layout row, click , then select Edit.
  4. Drag the fields Cumulated Charges, Effective Amount, Instructed Amount and Transaction Amount to the page layout.
  5. Click Save.

    This adds the chargeback-related amount fields to the bank statement item detail view.

Enabling Refund Information Display

JustOn Cash Management 1.49 has enhanced the support for handling refunds. If you have upgraded JustOn Cash Management from a pre-1.49 version, you may have to manually add two new fields to the user interface:

  • Refund → Bank Statement Item layout
  • Matching Result → Refund layout

To do so:

  1. Click to enter Setup.
  2. Navigate to the object management settings of the Bank Statement Item object.
  3. Click Page Layouts.
  4. In the Bank Statement Item Layout row, click , then select Edit.
  5. Drag the field Refund to the page layout.
  6. Click Save.
  7. Navigate to the object management settings of the Refund object.
  8. Click Page Layouts.
  9. In the Refund Layout row, click , then select Edit.
  10. Drag the field Matching Result to the page layout.
  11. Click Save.