This article provides all the necessary information about the Time Cards module.

Functionality

Get Started

The Adonis Timecard Registration module gives you access to flexible and time-saving registration of TimeCard data based on daily, weekly, biweekly, or monthly Time Card periods.

The number and types of TimeCard data you need to register can be defined by the employing company.

After registration, the data is pushed to Adonis Payroll and automatically included in the periodical payroll calculation.

To access the Timecard Registration module:

• either Click Timecard Registration on the Modules ribbon

• or use the Ctrl+Alt+M hotkey combination.

 Make sure access to the 470 Time Cards routine is granted to you in the Adonis Control Center:

Open

471 Time Card Transactions allows regulating the rights to send data to payroll. Besides, you can specify whether a user can send timecards for a person or an organization:

• 472 Organization

• 473 Current Person

Creating Timecard Record

Current Page

When opening the module, you are on the current page by default. It shows all records from the current period, even if they are related to another activity.

Click to begin registration.
To enable the New button, a person must have at least one activity that covers the Time Card Period (defined in org. structure) you are going to link the time card registration to.

The activity must be set up accordingly - Work Time option set.

See the Housekeeping section for setup details.

Depending on the Date From, the program locates the corresponding activity automatically:

Open

Here we can see read-only information (on the light-yellow background):

Suitable activity that covers Time Card Period.

Days field shows the number of days in the time card period.

Payscale table and code fields show payscale information defined in the selected activity (if there is no pay scale information in the activity, payscale information from Personal Details is shown).

Additional information - this field shows additional information from the payscale if defined.

Leave Days Balance information (B/F; leave days for this period; C/F).

The rules defining the base on which date you would like to see leave balance information is set up in Global Options > Time Cards (Time Card Period; Clients Payroll Period or Current Date – see Housekeeping section).
To see the Leave Account of a selected person, please use

button: 

From Date is the first day of the timecard period, Balance Date is today's, by default.
But you can define your parameters.

You can also switch between tabs to review total balance, by vessel, by payscale, etc., and also to print it.

After you enabled and clicked New, you can start registration.

By default, the first date within the Time Card period will be proposed as From/To dates.

But these dates can be overridden.

If the current date as default for a first new entry option is ON (global options) then the module creates a new first entry for a person with the current date.

It is possible to have more than one registration per day if Allow new entry on the same date option is ON (global options), in case it is necessary to put hours or costs on various projects or other cost dimensions.

If the option is ON, then It becomes possible to select a new entry with the same date from right-click menu:

if Date To is hidden for Timecards module overview (Global options-> Modules -> Time Cards -> Hide columns section (An Overview), the system believes that the user expects to have the same Date From and Date To.

So, Date To is automatically changed to the same date as Date From each time the date is changed by a user.

If Date To is not hidden, the system will update Date To automatically only in the case when the user moves Date From forward.

Timecard entry is automatically re-linked to the activity that covers its date.

When dates are entered, you can fill in work types information.

To open the Worktype details window, select the work type column and click the Open button under the manage menu or just double-click it.

Date From/To and Worktype are read-only fields.

Enter all needed values and define properties. The number of available fields in the Timecard Registration Properties window depends on the setup made in Global options-> Modules -> Time Cards -> Hide columns section (In Details).

They also differ per work type setup: hours field for Time work type and amount with currency for Amount work type.

It is possible to input decimal and negative figures in the Timecards module as well.

See the Housekeeping section.

To be available in drop-down lists, Currency/Projects/Vessel Locations (Cost Group)/Person Cost Place (Group) must be previously added in General Codes.

The accounting cost dimensions, including the project, will as default be proposed from the activity that covers the registration day or period. When the project has been set, all the following registrations on the line will by default be allocated to the same project, if it is not overridden. If you need to override any of the Cost Dimensions -here it is possible to override any of the values.

Click Save.

Create Records for Planned/Historical Activities

It is possible to register timecard entries for historical and planned activities within the current timecard period.

This possibility is defined in Global Options > Modules >Time Cards:

Allow registration for planned activities option is ON by default.

It allows using planned activity (within the current timecard period) in the Timecard Registration module.

In some cases, you may need to register timecard entries for historical activities (within the current timecard period).

In this case, please set Allow registration for historical activities option.

As a result, a special option - Show Previous Activities will be ticked by default, and you can use activities with Historical status while performing timecard registrations.

View History

History page - shows timecards records from previous periods:

You just need to define what period you want to review in Year, From Period To Period fields and click the History button.

Transfer Timecard Entries to Payroll

When registration is done, it is possible to push the Time Card entries to Payroll by clicking Send To Payroll button under the Manage menu.

You can send entries for a current person or transfer entries for full organization.

As a result, corresponding entry codes (with amounts) linked to every work type (see Housekeeping section) will appear in the person's payroll entries.

• If a person does not have any records to be transferred to payroll, the Send To Payroll button is disabled.

It is also disabled if the Payroll period and Timecard period do not match.

Make sure the access rights to the 470 Time Cards routine are granted to you in the Adonis Control Center:

471 Time Card Transactions allows regulating the rights to send data to payroll. Besides, you can specify whether a user can send timecards for a person or an organization:

• 472 Organization

• 473 Current Person

There are two main approaches for timecard entries to be transferred into Payroll, depending on the option set for Transfer To Payroll in Global Settings:

If an Activity organization connection is selected (it is the default value), the program will pick up all the timecard entries connected to activities running on corresponding organizations and transfer them to Payroll.
If a Person organization connection is selected, timecard entries for all people connected to a corresponding organization will be transferred to the Payroll.

On Current view, click Send To Payroll button and select to push entries only for the current pin or all organizations:

In our example, we chose the current person.
The system asks if the user wants to transfer the records for the current timecard period to payroll.
If your answer is Yes, all the timecards records that have not been transferred earlier will be sent.
The system will show a message 'Sent to Payroll has been completed' when done.

Transferred entries became grey after successful sending:

As a result, corresponding entry codes (with amounts) linked to every work type (see Housekeeping section) will appear in the person's payroll entries.
Note: To have the accounting cost dimensions, like Project, Cost Place, Cost Group transferred correctly to payroll, it is required that a proper set-up of the corresponding Entry Codes in payroll has been prepared. The same rule applies to correct handling when other currencies than the company's base currency are used.

For Organization:

1. If you select to push all timecard entries for the organization (all the crew members on the Crew List), you should select an organization for which transferring will be run. 

    

   See Housekeeping section.
   The list of organizations displays only one current vessel name if the current client is a vessel. 

   Tag needed org. unit(s) and click the OK button.

2. Confirmation.

3. After the transfer, you will see the following message: 'Timecard period will be closed. Do you want to continue?'.
   If you answer 'yes', the current timecard period will be closed for this organization and set to the next timecard period;
   If' no', you will be able to continue working with this period.
   So, be careful when making choice.
   Transferred entries became grey in the Timecard module after successful sending. 
   The details from the Timecard module will appear on the payroll screen. 

All further work should be done there, checking, calculation, etc.

Housekeeping

To activate and work with the Timecard Registration module, you need to perform the following setup:

Company Configuration

Go to Setup > Organization Structure > Company > Payroll (General):

Set Time Card Registration Enabled option.

Specify Time Card Period. Must be the same as Payroll Period.

Click Apply button. 

In Organization Structure -> Company -> Payroll -> Period, the Time Card intervals must be defined for each Payroll Period:

TimeCard data can only be pushed to payroll after the First Date and before the Last Date set as Time Card period.
The first date of each Time Card period is calculated as the next day after a Time Card Finish Date of the previous period and you set manually a finish date of a Time Card period in the payroll period properties.

Use payroll period dates for the Timecard option – set it if you prefer using the First Date of a payroll period as the first date of a corresponding Time Card period.

Click OK.

Activities Configuration

You can register Time Card entries only for the activities for which the Work Time option is set in the General Codes -> Activities -> Activity Codes.

To be able to register Time Card entries you should specify at least one Activity Code with the Work Time option set.

Work Types Configuration

You should specify the Work Types that will appear during registration of Work Time under General Codes > Time Card > Work types.

The number of Work Types is unlimited.

Click New to add a work type code:

1. Enter Code – unique Adonis alphanumeric code.
   Text – code name (description).
   Sort is used to define the order of codes.
   '0' means the very first.
   
   Is Passive. Set this option for the code which you do not want to be in use. 
   Security Code field. When a security code other than '0' is defined, it is possible to set up different access rights (Read, Write, None) to this work type code for different users' levels. 
   This can be done by the administrator in Adonis Control Centre > General Codes > Time Card > Work types:
   
   
   
   Each Worktype can be set as registration of Time (normally Hours/Days) or as an Amount.
   For any Amount registration, there will be a possibility to override the standard Currency Code during data registration.
   The corresponding value for Amount will be pushed to the Payroll Entry Code which is linked here.

   
   
   

2. Currency handling
   Each work type is linked to an entry code. The entry codes in their turn are linked to currency.
   Corresponding entry codes should be previously created and set up.
   Please note, Adonis creates and sets up ECs.
   When a user creates new entries in the Timecards module, the system will automatically fetch the currency that is defined for the entry code of this work type.
   The Disable Currency Column option allows hiding the currency column for the selected work type.

3. It is possible to display additional columns in the Timecard Registration module for each Worktype by setting checkboxes in the Additional Columns section.
   
   These columns will be displayed in Timecard Registration Module to the right of the selected Worktype (e.g.: Advances):
   
   
   

Create as many work types as you need.

Projects, Vessel Locations, Vessel Cost Group, Person Cost Place, Person Cost Group Definition

In the Timecard entries properties, you may need to define such optional properties, as Projects, Vessel Locations, Vessel Cost Group, Person Cost Place, and Person Cost Group.

They can be found/added under:

Projects - Setup -> Tables -> Projects.
Vessel Locations - General Codes Table > Vessel > Vessel Location.
Vessel Cost Group - General Codes Table > Vessel > Cost Group.
Person Cost Place - General Codes Table > Person Details > Cost Place.
Person Cost Group - General Codes Table > Person Details > Cost Groups.

Payscale Settings

On the payscales level, it is possible to filter a work type, person cost group, and cost place records for certain pay scale(s).

Timecards the module shows only those Work types, Person Cost Place/Groups records that are available for the pay scale table to which an activity is linked.
Open payscale properties > Timecard:

By default, all records are tagged, i.e. all of them will be available.

Clear the checkbox near a record that should be hidden for this payscale in the Timecards Registration module.

Global Options

Go to Global Options > Modules > Time Card:

1. Transfer To Payroll section
   According to the selected option, the program will check organization connection either in the Personal Details or in the Activities.
   If Activity organization connection is selected (it is the default value), the program will pick up all the timecard entries connected to activities running on corresponding organizations and transfer them to the Payroll;
   If a Person organization connection is selected, timecard entries for all people connected to a corresponding organization will be transferred to the Payroll.

2. It is possible to register timecard entries for historical and planned activities within the current timecard period.
   Allow registration for planned activities is ON by default.
   It allows using planned activity in the Timecard Registration module.
   In some cases, you may need to register timecard entries for historical activities, for example, if you receive information about seaman's onboard expenses later on.
   In this case please set Allow registration for historical activities option.
   A special option - Show Previous Activities will be ticket by default in the module then:
   
   

   
   
   

3. Leave Days Balance information is shown in the Time Cards module. 

   It is possible to choose, according to which date you would like to see leave balance information in the module.
   Choose one of the available options in the Leave Days Balanced Base On section

   
   Time Card Period - If the option is ON, leave days information will be displayed according to Time Cards period start and end (setup in org. structure).
   
   Clients Payroll Period –If the option is ON, the information will be shown in the following way:
   
   a. if Leave Balance Dates are defined for payroll periods in Organization Properties > Payroll > Periods, then Leave Balance B/F shows leave balance up to leave balance date of the previous payroll period, C/F - up to leave balance date of the current payroll period, This Period - leave days earned from previous leave balance date to leave balance date of the current period.
   b. if Leave Balance Dates are not defined, leave days information is shown according to start and end dates of the payroll period.
   c. Current Date - If the option is ON, leave days balance on today's date will be shown in the C/F field, while the other fields will be disabled.

4. Current date as default for the first new entry:
   
   if ON then the module creates a new first entry for a person with the current date, and the next new entries start the next day.
   if OFF then the module creates a new first entry for a person with the first date of the current timecard period. And the next new entries start the next day.
   
   When Allow new entry on the same date option is ON, it is possible to create entries with the same date.
   It is also possible to select a new entry with the same date from right-click menu:
   
   
   

   
   
   

5. Hide Fields
   In case the user wants to hide columns (Project, Person Cost Place, Date To) in the Details (Timecard Transactions Properties) / Overview window, it is possible to set necessary checkboxes.
   The columns will then be hidden, for example:
   
   

   
   As a result, there is no Project field:
   
   

   
   
   If Date To is hidden for Timecards module Overview, the system believes that the user expects to have a date from and date to equal. So, Date To is automatically changed to the same date as Date From each time when the date from is changed by the user.
   If Date To is not hidden, the system will update Date To automatically only in the case when the user moves Date From forward. If, the user changes the Date From – October, 10 to October, 5. Date To will remain as October, 10.

6. If the Date-time registration in the Date From and Date To columns option is ON, it gives the possibility to show Time From and Time To columns. Can be used for timecard registrations of Amount kind to indicate time.

7. Periods information section - depending on the selected option, the Timecards module will fetch the timecards period either from the Current Client or from the company a pin is linked to.

User Interface

You can open the Timecard Registration module either by selecting the icon on the Modules ribbon or pressing Ctrl+Alt+M hotkeys.

Let's look at an example screen:

1. You can use View Filter – to select the Current or Historical page.
   The Current shows all records from the current period, even if they are related to another activity.
   When a current client is a vessel, only the activities belonging to this vessel are shown in the Timecards module.
   The History shows timecards records from previous periods.

2. Your working area with various data: linked activity; days field shows the number of days in the time card period.
   Payscale table and code fields show payscale information defined in the selected activity (if there is no pay scale information in the activity, payscale information from Personal Details is shown).
   Additional information - like in Personal Details -> Seniority, this field shows some additional information from the pay scale. This info is read-only.
   
   Leave Days Balance information (B/F; this period; C/F) is also shown in the Time Cards module.
   The rules defining the base on which date you would like to see leave balance information is set up in Global Options > Time Cards (Time Card Period; Clients Payroll Period or Current Date).
   To see the Leave Account of a selected person, please use the Leave Days button.
   
   Below you can see Timecards registration Grid with defined work types.
   Its layout depends on settings performed in global options and on the pay scale (see Housekeeping section).

   
   
   

3. Total

   Here you can see some of all amounts for every work type for the current Employee (pin) and the whole Current opened organization.
   Currency depends on defined currency code in Organization Structure > Company > Payroll >General:
   
   

    

4. When registration is done, it is possible to push the Time Card entries (for a current person or all organizations) to the Payroll module by clicking Send To Payroll button.
   As a result, corresponding entry codes (with amounts) linked to every work type (see Housekeeping section) will appear in the person's payroll entries.

To add a time card record, click the button under the Manage menu or use the Insert key.
To view, any work type details, select needed and click the button under the Manage menu or using double-click.
If you need to remove the record, click the button.
By clicking icon, you will be switched to The Timecard Registration Module help user manual.
For all details, see the Functionality section.

Customization - Dock Crew List

We propose you the new customization approach to make your work with APM even more convenient.

We replaced internal Crew Lists (hide/show option) from Personal Details, Payroll & Timecard modules with new functionality to Dock the current crew list.

This gives you full filter and searches functionality in the crew list view that was not available earlier in the embedded crew list.

It also allows you to open any module, in our case - Timecards Registration or data group.

So, the result can be as below:

1. Docked Crew List to Left.
   The Crew List view will always be visible in the area you selected.
   Its appearance will not be affected by other modules/data groups being open.
   You can customize the width of the Docked area according to your needs by moving borders with the cursor.

2. Opened Timecards module will appear on the rest of the screen in tabbed or window mode according to your preference. You can switch between them freely.
   When selecting another pin in the Crew list, the Timecard module will be updated according to the new person's data

3. Context/Manage buttons will be shown belonging to the docked crew list and data group/module currently selected at the main workspace area.

• Open Crew List module, under Manage the tab you will find the possibility to dock the crew list to the place on your working area as you wish (to left, right, top or bottom):
  
  

When we dock the crew list to the selected area for example to left, it fixes/freezes the crew list screen:

• The remaining part can then be used to display the other screens (modules, data groups) according to your needs without overwriting the crew list.
  
  We will be displayed on the right side of the crew list. 
  
  

• In addition to the crew list, you can also dock almost every data group (Activities, Competence, Overview, etc.) to various screen areas, using the same Dock button under the Manage menu of the opened data group.
  
  This allows you to customize your workspace most suitably, for example in addition to the Timecard module, we can dock the Activities data group:

We docked the Crew list and Activities data group to the Left.
On the right-hand side, we can work with the Time Card Registration module.

These Docking settings are user-related and will not affect any other application user.
To reset the Dock functionality back, click the button under the Manage menu.