Master Cash Account - Payroll Payments

Owned by Erick Meijer
Last updated: Jun 01, 2023 by yuriy.biryukov
5 min read

Description

Plugin to administrate the Master Cash Statement

Latest Version

2021.19.2.4

Release Date

Aug 5, 2021

Download Path

Download

Type

APM Plugin

 

Description

The Master Cash Account is an APP module used onboard, to administrate the Master Cash Statement. The purpose of the Master Cash Statement is to record  the expenditure and receipt of cash and the use of the ships checks from the master cash account .   Expenditures linked to the Adonis Payroll like onboard payments cash or by check are transferred to the master cash account. The MCA Plugin list the payment transaction, linked to cash or Check Onboard.  When confirmed the plugin connects to the Adonis Personnel Portal and add the transaction in the open master cash account. 

Compatible

Compatible with APM 2020.20.7 Patch 6 / APM 2020.30.1  or higher*

*Requires new balance action Check Onboard and the added functionality with regards to the existing cash balance action.

Location 

After installing the plug-in the plug-in is available in the following location

Tools > Export > Master Cash Account

Functionality

After setting up the plug-in as described in 'House keeping' section below, you start the plug-in.  

The payments are divided by cash and check payments, the check payments do not need any user input information needed to create a payroll cash transaction is retrieved from the payroll transaction.  
In the example below the description is retrieved from field L38 a text field and is calculated as follows: 

Select the payment from the payment list and hit the Transfer to APP MCA button. This will transfer the transaction to the currently open master cash account. 

After transferring the transaction is visible in the open master cash account: 

If the balance in the open master cash account is insufficient the transactions are declined. 

Check payments. 

The check payments require the following user input check number and check date. 

Open the plug in and enter the tab labeled Check,  select the transaction and hit Add Check Details.

 

The check numbers are mandatory, the system throws an error message and rejects the payment if no Check number or Issue Date exist. 



The process of transferring the check payments is similar as for the cash payments and it creates a master cash transaction identifying the payroll payments made by check.



Housekeeping

Connecting to the Adonis Personnel Portal

To transfer the payment transaction the system needs an connection to the Adonis Personnel Portal.   The URL and  authentication to connect to the APP are found the global settings in the section Web Service.

The URL and API password you find and define in the Administrator Portal > General Settings > Configuration > WEB Services. 

  1. The plugin uses the Adonis_API user to connect. For a successful connection the password defined in the portal need to match the password used in the APM Global settings. 

  2. You find the proper url in the portal client side requests.



Setup

The setup dialog box in the plug is used to map the payroll transaction fields to the Master Cash Account method properties.   

Cash Payments

  1. Transaction id of the MCA transaction that will be contain the cash payments. 


    Elements 2, 3, 4, and 5 are linked to payroll field numbers.  

  2. Identify the field containing the amount

  3. Description: Advice to use L38 and program this field to contains proper text identifying the pin name and the words cash payment. See functionality above for the script settings

  4. Payee, If blank the persons name is used,  can be linked to payroll field number. This is not relevant for cash payments

  5. Transaction Date if blank todays date is used. 



Check Payments

Check payments differ from cash payments, The end user needs to enter the check and and issue date.  This information is stored in a payroll transaction field.  The information is not stored in the additional payment details.  



  1. Similar as for the cash payment. Input the transaction id identifying the check payments.  

  2. Check Number: Add the field in which the check number will be stored. 

  3. Issue date: Add the field used to store the issue date. The date will be added in the format yyymmdd

  4. Description: Similar as for cash payments (see above)

  5. Payee: If empty the crew members name is used. 

  6. Transaction Date: If empty the plug in will use todays date. 



Download the Plug-In 

http://download.adonis.no/files/upgrade/PersonnelManager/Plugins/Plugins/MasterCashAccount/



Installing the plugin

After downloading the plug-in on the server where APM is installed execute the file, the installation set will prompt you for the APM location.  After adding or selecting the correct location hit install. 

The plug-in will be installed below the given location in directory labeled PLUGIN

On start-up APM will detect the plug-in and make it available in menu Tools>Export 



Access Rights

The plug-in is also detected by the Adonis Control Center, once detected the administrator can give user groups access to the interface. 







Related Pages