Change Log

Version	When	Release Notes

Version	When	Release Notes
2024.10.2.1	Oct 25, 2024	APMPI-1379 - Not possible to enroll people with existing accounts From now plugin will check if there is any account on the Kadmos side with Reference field equal to APM PIN. If yes, then will link this person to the existing Kadmos account and move person to corresponding tab in the Kadmos Plugin. If no, then new account will be created.   APMPI-1380 - Тot possible to enroll people from the vessel Kadmos plugin will fetch all employed persons under current crew list view.   APMPI-1381 - Error when opening the plugin Fixed error that was appearing, when there are more than one PostCode with the same PostName under the same country. From now City field will be fetched directly from the P01.PostPlace.   APMPI-1382 - Тot possible to set needed payment date Added possibility to select Payment date during creating Payments. Paid Payroll Entries will be locked using selected payment date.   Open   APMPI-1383 - Тot possible to cover payments to Kadmos and Berenberg at the same time Added new option Use Kadmos as Primary Payment method. By default option is turned on; If turned on, then person`s balance action will become Kadmos during enrollment to Kadmos; If turned off, then person`s balance action will not be changed during enrollment. Open
2024.10.3.1	Oct 31, 2024	APMPI-1397 Use the Reference_Name of the Payment in the Payout description   APMPI-1398 The package should be applied to each Payout, not in the Payment A default package was added to the Payout window. Possibility to change the payout for some person. Possibility to apply the package to the first salary of the period.   APMPI-1399 Removed the mobile number in the request of the user creation. Simplified the enrollment process, and removed the mobile number, postal code, and street number.   APMPI-1407 Include a prefix when enrolling a user In the General Settings of the plugin, we included the possibility to define and add a prefix into the Reference (worker reference) in Kadmos.
2024.10.4.1	Nov 26, 2024	APMPI-1388 - Scramble the ClientID and SecretKey in the authentication tab of the Kadmos Plugin Settings In Kadmos, applied the following changes: The Client Id and Security key values have been encrypted on the Authentication tab. The ClientId and Security key values have been encrypted in the database.   APMPI-1389 - Hide Authentication tab from Non-Super users The Authentication tab is accessible only to 99 level users (superuser).   APMPI-1412 - Duplicate and UserId not found errors Fixed the error when the user ID was not found. Logs are correctly saved in the debug folder.   APMPI-1424 - Several users were matched to a Worker Reference without 'A' prefix. The issue is fixed. People are successfully enrolled. The A Prefix is correctly set.   APMPI-1427 - Restrict the access to the General Settings tab to administrators only The Kadmos plugin setup is restricted to Administrators only (99-level users in Adonis Control Center).   APMPI-1428 - Improve the Log File Added adjustments: UserId is listed in the log file. Kadmos reference is listed in the log while new users are created during the enrollment. Kadmos reference is listed in the log when person has been linked to the existing Kadmos account during the enrollment. Errors from Kadmos are listed in the log. A separate error file is then created for each error. Added the Remove log files older than parameter to plugin`s settings. This parameter defines the number of days log files to be stored. It doesn’t affect error files.
2024.10.5.1	Dec 2, 2024	APMPI-1455 - Adjusted the selection of participants for the Waiting for eWallet tab. The issue is fixed.

Introduction

Kadmos is an end-to-end salary payments platform that powers secure payments to employees across the globe. The platform is a reliable and efficient payment platform that can handle various payment methods.

The Kadmos plug-in collects transactions and transfers them to the Kadmos interface. Based on the collected transactions, Kadmos compensates the amounts to crew members' eWallets.

This guide will walk you through the procedure on how to select the required payment type (Net Payment, Advance Payment, Additional Payment) as well as transferring the transactions to the Kadmos interface. 

Functionality

The section will teach you how to operate the plugin.

To get started, first, open the plugin. For this, switch to the Tools ribbon tab and click the Export button. From the drop-down list, select Kadmos:

The Kadmos main screen then appears:

The Kadmos plugin includes 4 tabs:

• Candidates

• Waiting for eWallet

• Active Members

• Payment

Kadmos Enrollment

The Candidates tab shows a list of employed crew members based on the current crew list view as well crew members' personal details:

To enroll crew member(s) in Kadmos, follow the steps below:

1. On the Candidates tab, select crew member(s) to be enrolled in Kadmos.

2. Click Enroll to Kadmos.

As a result, a crew member is successfully enrolled:

As part of crew enrollment, the plugin checks whether crew members already have active accounts in Kadmos by comparing their Worker Reference numbers in Kadmos with the PIN numbers in APM. Other option is to add a prefix before the PIN where a Worker Reference should contain the same prefix. Active crew members are then fetched directly to the Active Members tab, while inactive crew members are then listed on the Waiting for eWallet tab.

Waiting for eWallet

Once successfully enrolled in Kadmos, crew members get invitation emails. By following the directions in invitation emails, crew members must activate their accounts. Employees with pending activations are displayed on the Waiting for eWallet tab:

Besides, you can resend the invitation to an employee. For this, select a crew member and click the Resend Invitation button.

There can be different Wallet Statuses displayed. Below 2 are specific ones:

Active Members

On activating accounts, affected crew members are moved to the Active Members tab:

On enrollment, the Payroll balance action may be either automatically set to Kadmos or manually set to any other balance action. It depends on the preset setup. For more information, see General Settings.

Payment

There are three payment types that may be processed:

• Net Payment stands for the amounts registered as Entry Code 994 Net wages (default value).

• Advance Payment is meant for the amounts registered in Entry Codes with the Advance Entry Code option. 

• Additional Payment stands for the amounts registered in Entry Codes with the Additional Payment option.

The section will walk you through the detailed instructions on how to process each type of payment.

Net Payment

To process the net payment, access the Payment tab and proceed with the steps below:

1. Click the Add Payment button. This opens the Add New Payment dialog:

2. On the dialog, select Net Payment. This invokes the Net Payment dialog where you can see a list of payment records ready for transfer.
   Only members with active eWallets are validated to receive a Payout.
   
   

   
   Please note that employees are filtered out based on the assigned entry code and Kadmos balance action.

3. The Default Package can be applied at once to the selected rows. In the Settings, it can be defined as well if the package should only be applied to the first salary of the period.

4. Select the record(s) to be transferred and click Create New Payment:
   
   
   

5. On the Payment Details dialog, fill out the payment details to be processed:

   • Payment Name. Enter the payment name. The field is grayscaled, and, thus, locked for editing, in case the default payment name is defined in Setup (see General Settings).

   • Description. Enter the payment description.

   • Currency. Select the currency for payment processing. In case the default currency is defined in Setup (see General Settings), it appears in the field, however, you can still change it based on your preferences.

   • Payment Date. In the calendar picker, select the date for payment processing. Please note the selected payment date will be displayed in Payroll after locking transactions marked as PAID.
     
     

     Once completed, click OK to proceed.

As a result, a new package appears in the Payment grid:

Advance Payment

To process the net payment, access the Payment tab and proceed with the steps below:

1. Click the Add Payment button. This opens the Add New Payment dialog:

2. On the dialog, select Advance Payment. This invokes the Advance Payment dialog where you can see a list of payment records ready for transfer:
   
   

   
   Please note that employees are filtered out based on the assigned entry code and Kadmos balance action.

3. The Default Package can be applied at once to the selected rows. In the Settings, it can be defined as well if the package should only be applied to the first salary of the period.

4. Select the record(s) to be transferred and click Create New Payment.

5. On the Payment Details dialog, fill out the payment details to be processed and click OK to proceed:

   • Payment Name. Enter the payment name. The field is grayscaled, and, thus, locked for editing, in case the default payment name is defined in Setup (see General Settings).

   • Description. Enter the payment description.

   • Currency. Select the currency for payment processing. In case the default currency is defined in Setup (see General Settings), it appears in the field, however, you can still change it based on your preferences.

   • Payment Date. In the calendar picker, select the date for payment processing. Please note the selected payment date will be displayed in Payroll after locking transactions marked as PAID.
     
     

     Once completed, click OK to proceed.

As a result, a new payment is successfully created in Kadmos and new package appears in the grid:

Additional Payment

To process the net payment, access the Payment tab and proceed with the steps below:

1. Click the Add Payment button. This opens the Add New Payment dialog:

2. On the dialog, select Additional Payment. This invokes the Additional Payment dialog where you can see a list of payment records ready for transfer:
   
   

   
   Please note that employees are filtered out based on the assigned entry code and Kadmos balance action.

3. The Default Package can be applied at once to the selected rows. In the Settings, it can be defined as well if the package should only be applied to the first salary of the period.

4. Select the record(s) to be transferred and click Create New Payment.

5. On the Payment Details dialog, fill out the payment details to be processed and click OK to proceed:

   • Payment Name. Enter the payment name. The field is grayscaled, and, thus, locked for editing, in case the default payment name is defined in Setup (see General Settings).

   • Description. Enter the payment description.

   • Currency. Select the currency for payment processing. In case the default currency is defined in Setup (see General Settings), it appears in the field, however, you can still change it based on your preferences.

   • Package (available only in case predefined in General Settings). From the drop-down list, select the

   • Payment Date. In the calendar picker, select the date for payment processing. Please note the selected payment date will be displayed in Payroll after locking transactions marked as PAID.
     
     

     Once completed, click OK to proceed.

As a result, a new payment is successfully created in Kadmos and new package appears in the grid:

Housekeeping

This section describes a one-time setup you need to perform to make the plug-in fully functional.

Installation

To install the plug-in, navigate to Install APM Plugin and follow the step-by-step instructions carefully.

The latest plug-in version is available here: http://download.adonis.no/files/upgrade/PersonnelManager/Plugins/Kadmos/

Connection and Authentication

For data transfer, you need to configure the Kadmos connection and authentication settings. To do this, follow the steps below:

1. On the Kadmos plugin main screen, click the Setup button. This invokes the Setup dialog.

2. On the Setup dialog, navigate to the Authentication tab:

3. Fill in the fields in the Authentication tab.

4. On entering the connection and authentication details, click Save.

Additionally, you can define the path to the folder where log files will be stored. Simply, select Is Debug and select a folder.

General Settings

You can define general settings related to package usage, default payment names and default currency. For this, on the Kadmos plugin main screen, navigate to Setup > the General tab:

The Reference Prefix will add a prefix to the crew member’s PIN and it will be mapped to the Worker Reference in Kadmos.

In the Payment section, define payment-related parameters:

• Set the default payment names for each payment type (Net, Advanced, Additional). For this, simply select the Use Default Payment Name and Payment Date option and, in the table, set the values corresponding to the payment types.

• Specify the default currency to be used on the Payment Details dialog.

• Select the Use Kadmos as Primary Payment Method checkbox to use the Kadmos balance action by default for all payouts.

In the Payout section, define whether packages are to be used as part of payment details:

• Apply package only to first salary of the period. Select the option to make the package applied only to the crew members who receives their first payment of the period.

Entry Codes

There are three payment types that may be processed:

• Net Payment stands for the amounts registered as Entry Code 994 Net wages (default value).

• Advance Payment is meant for the amounts registered in Entry Codes with the Advance Entry Code option.
  
  

• Additional Payment stands for the amounts registered in Entry Codes with the Additional Payment option.

Make sure to select the entry codes to be considered in each payment type: Net Payment, Advance Payment, and Additional Payment.

Once done, click Save to apply the changes.

Field Mapping