action.skip

Setting Up JustOn Cash Management

Info

JustOn Cash Management requires at least the Salesforce Enterprise Edition.

Setting up JustOn Cash Management involves the following tasks:

Depending on your intended use cases, you can then proceed to

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 may include:

Installing JustOn Cash Management

  1. Open the app listing in Salesforce AppExchange to get JustOn Cash Management.
  2. Click Get It Now to invoke the installation procedure.
  3. Follow the instructions and provide the required information as necessary.

    When prompted, choose the option Install for Admins Only.

    Why installing for admins only?

    For installing JustOn Cash Management, we strongly recommend to choose the option Install for Admins Only. This requires to set the appropriate permissions for the users in your org manually, using the permission sets shipped with the JustOn Cash Management package.

    This approach, however, has important advantages:

    • Permission sets allow accessing objects and object fields, that is, they control which data users can see and edit. This way, users can do their job without seeing data they do not need to see, which helps to minimize the risk of abuse and loss of data.
    • Using the permission sets makes sure that JustOn Cash Management works consistently as intended. Since the permission sets are included with the JustOn Cash Management package, they are upgraded as new objects or fields, Visualforce pages etc. are added with new JustOn Cash Management releases.

Enabling App Access

JustOn Cash Management provides two Salesforce apps: the Lightning Experience App JustOn Cash Management and the Connected App JustOn Cash Management Connected (see App Overview). For JustOn Cash Management to work properly, make sure to enable the access to the two apps for all users who will work with JustOn Cash Management.

Enabling App Access for JustOn Cash Management

The access to the JustOn Cash Management app is controlled using profiles. So when creating the users who will work with JustOn Cash Management, you must assign the relevant profile to each of them. You can use the standard profiles or create custom profiles.

To enable access to the Lightning Experience App JustOn Cash Management for all relevant profiles:

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

    column_select

  5. Click Save.

    This makes JustOn Cash Management available for the selected user profiles in the App Launcher.

Enabling App Access for JustOn Cash Management Connected

The access to the JustOn Cash Management Connected app is controlled using profiles. So when creating the users who will work with JustOn Cash Management, you must assign the relevant profile to each of them. You can use the standard profiles or create custom profiles.

To enable access to the Connected App JustOn Cash Management Connected for all relevant profiles:

  1. Click to enter Setup, then navigate to Apps > Connected Apps > Manage Connected Apps.
  2. Click Edit in the row of JustOn Cash Management Connected.
  3. In the Permitted Users field, select Admin approved users are pre-authorized.

    Confirm the selection when prompted.

  4. Click Save.

    This will prevent all users from accessing JustOn Cash Management Connected, including org admins.

  5. On the Connected Apps list, click JustOn Cash Management Connected.

    This displays the app detail page.

  6. Add the intended profile.

    1. In the Profiles section, click Manage Profiles.
    2. Select the relevant profile, at least, System Administrator.
    3. Click Save.

Note

JustOn Cash Management allows only users with the associated profile to access the app, which relies on the option Admin approved users are pre-authorized in the Permitted Users field. Leaving the default value All users may self-authorize will prevent users from accessing the app and produce the following error:

Platform not available, please contact customer support if the problem persists!

Assigning Permissions

JustOn Cash Management provides dedicated permission sets, which allow users to

  • Access the Lightning Experience App JustOn Cash Management
  • Read, create and edit records of the objects delivered with the JustOn Cash Management package

The package ships with the following default permission sets:

Permission Set Description
JustOn Payments Full Access Read/write access to JustOn Payments objects, irrespective of any role-based restrictions.
Can be used only in combination with the Read/Write permission set.
JustOn Payments Read Only Read-only access to JustOn Payments objects.
JustOn Payments Read/Write Read/write access to JustOn Payments objects.

Info

If you bundle JustOn Cash Management permission sets in permission set groups, always make sure their status is Updated. This indicates that the bundled permissions are up-to-date.

Assign the relevant permission sets to all users who will work with JustOn Cash Management. To do so:

  1. Click to enter Setup, then navigate to Users > Permission Sets.
  2. Click the name of the relevant permission set.

    Select either JustOn Payments Read/Write, JustOn Payments Read Only or JustOn Payments Full Access.

  3. Click Manage Assignments, then Add Assignments.

  4. Select the checkboxes next to the users who will work with JustOn Cash Management.
  5. Click Next.

    If applicable, specify an assignment expiration option.

  6. Click Assign.

Note

Irrespective of the assigned default permission set, all users who work with JustOn Cash Management must be enabled to use the Salesforce API via their profile or a permission set. This is necessary to allow calling business logic on the Heroku-based platform (see App Overview).

To check for the API access in profiles or permission sets, click to enter Setup, then navigate to Users > Profiles | Permission Sets > Profile/Permission Set Name > System Permissions, and make sure that API Enabled is selected.

Enabling Global Configuration Access

In addition to be assigned the System Administrator profile, users who intend to access the global configuration must be explicitly allowed to access the Global Configuration dialog – preferably, using a dedicated permission set.

To enable the access to the Global Configuration dialog:

  1. Create a dedicated permission set.

    For details, see Create Permission Sets in the Salesforce Help.

  2. In the new permission set, click Flow Access in the Apps section.

  3. Click Edit.
  4. Select JPAY1.Global Configuration and move it to the Enabled Flows column.

    column_enabled

  5. Click Save.

  6. Assign the permission set to the relevant users.

    For details, see Assign Permission Sets to a Single User in the Salesforce Help.

    Together with the System Administrator profile, this makes the Global Configuration dialog available for the selected users.

Creating Remote Site

Some list views, like on the Entries tab, in JustOn Cash Management may become very large. To allow executing operations from large list views, for example creating direct debit orders, JustOn Cash Management has to call Salesforce's REST API. To this end, you must allowlist your site as a remote site.

  1. Click to enter Setup, then open Remote Site Settings.

    In Salesforce Lightning, navigate to Security > Remote Site Settings.

    In Salesforce Classic, navigate to Security Controls > Remote Site Settings.

  2. Click New Remote Site.

    alt text

  3. Provide a descriptive name.

    The provided name must be unique and can only contain alphanumeric characters and underscores.

  4. Specify the URL of your current instance as required, like https://eu5.salesforce.com.

    Do not specify the My Domain subdomain but the instance URL. Find the instance part of the URL on the Company Information page in Setup, or use nslookup <my-domain>.my.salesforce.com in a terminal window (as explained in View instance information for your Salesforce Organization in the Salesforce Help).

  5. Click Save.

Enabling Lightning Runtime for Flows

Some operations, like creating direct debit orders or manually settling entries, are implemented as Salesforce flows. To support all relevant functionality, enable the Lightning runtime for flows.

  1. Click to enter Setup, then navigate to Process Automation > Process Automation Settings.
  2. Select the checkbox Enable Lightning runtime for flows.
  3. Click Save.

Defining Platform Integration User

JustOn Cash Management exposes websites via Heroku, like the payment page or the API. All data management, however, takes place on Salesforce, as explained in App Overview.

Your business use cases may involve relevant features. In this case, you must define a platform integration user. This is a (technical) user that is employed for the communication between Salesforce and Heroku whenever a real user triggers relevant business logic via these websites.

To define an integration user:

  1. Optionally, create a dedicated technical user for the integration.

    The integration user

    • does not necessarily need to be associated with a real person
    • must be assigned the permission set JustOn Payments Read/Write
    • must be enabled to use the Salesforce API via a profile or a permission set

    To check for the API access in profiles or permission sets, click to enter Setup, then navigate to Users > Profiles | Permission Sets > Profile/Permission Set Name > System Permissions, and make sure that API Enabled is selected.

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

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

  4. Click Edit.

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

  5. In the Platform Integration section, select the intended integration user in the New User field.

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

Some operations involve user-facing web links, like the payment page or the API. In order to produce unique links that are specific to your organization, you define an alias for your organization (a tenant on Heroku), which will then be part of the URL path, like

https://payment.juston.cloud/pay/:link-id/to/:tenant

To define the URL alias:

  1. Click to access the App Launcher, and select 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 Platform Integration section, specify the intended alias in the New URL Alias field.

    The allowed characters include a-z, 0-9, -, _. The alias must not start with - or _ and can include up to 20 characters.

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

Integrating With Third-Party Application

Remember that the business operations in JustOn Cash Management are centered around entries. They represent receivables and payables, and are based on statements that justify the corresponding request – like an invoice, installment, order, credit note, etc.

This is why setting up JustOn Cash Management usually involves an integration with a "counterpart" application in your environment. You need (at least) a way to create entries based on your statements that entail receivables and payables. Note, however, that this integration is not covered with this documentation, as it is project-specific and cannot be generalized.

Info

For details about enabling JustOn Cash Management in JustOn Billing & Invoice Management, see Enabling JustOn Cash Management.