Description
The Crew Card Maintenance is implemented as an APM plug-in.
Compatibility
Compatible with APM 2019.60 or higher*
*Requires cross-reference table; PW_CREWCARD, MXP_CREWFOLIO
Terminologies
| Crew Folio | This is the crew members journal of all his spendings onboard for a particular period. Normally for one payroll period or for a voyage. This is used on cruise vessels onboard merchant navy vessels like tank/bulk etc this is referring to like the slop chest or bonded stores. Onboard cruise vessel crew members are equipped with a crew card, that is used onboard in the various chops/stores to purchase various goods. These purchases are listed in the Crew Folio. |
| POS | The POS is the place in a shop where a product is passed from the seller to the customer. POS is an abbreviation for 'point of sale'. POS System is the system registration the purchase, cost product date etc. |
| MXP | http://www.marinexchange.com/index.php?id=222 MarineXchange MXP is the first enterprise software suite for the cruise industry. Through interfaces, MXP data flows to other systems like the company website, reservations, financial systems, or data warehouses. MXP provides a “best practices” approach and is fully SOX compliant. |
Process Flow
At the end of the voyage, the crew folios are entered into the payroll so that that cost and eventual earnings (hours/gratuities) are added and subtracted from a person's payroll.
MXP identifies a person using the Charge_Id which is added on the crew card when printing and programming the card. During a purchase, the crew members charge id is registered in the MXP POS System. The crew folios are linked to the Charge_Id.
The Crew folios can be subtracted using MXP's API.
Housekeeping
Download the Plugin
Installing the Plugin
Install the plugin installer to the workstation where your APM (Adonis Personal Manager) is installed.
Step 1: Click Next
Step 2: Locate the Adonis Personal Manager (there's a default location where the APM is detected)
Step 3: Wait for the Installation to complete
Step 4: Successfully installed
Location
Adonis Personal Manager > Tools > Import > Crew Folio
Configuration
1) Setup the MXP WebAPI URL, the default location is http://localhost/MXP_Virgin.exe
2) Click Append to add an Entry Code.
3) Setup Payroll Transaction: Look up to Crew Folio entry code.
4) Click OK to save.
4
Field Assignments:
3) Select the entry codes.
5) Click on Field Assignments.
6) Click on Append to select Payroll Fields.
7) Select Payroll Fields.
8) Select Group by
The Group by column is where the response will be grouped.
Note: If the group by is not set, the plugin will will create a list for each transaction.
To get the correct placement of the crew folio, the forth row is the numorgid to select vessel_numorgid must be selected to get the vessel's unique id.
9) Click Save.
Functionality
How to Import Crew Folios From MXP
Import MXP Crew Folio Records button
1) Click Import MXP Crew Folio Records button
2) Set the initial date:
For the first import, there were no initail date set first, you will select a date where to start the search. Normally the initial date should be same with the start of the voyage or start of the payroll date.
3) Set Import all transaction upto:
This is the end of the voyage or end date of payroll.
Select query's end date.
4) Click Import MXP Crew Folio Records.
5) Successfully Imported MXP Crew Folio Folio.
You will be notified that the import is successful.
How to Transfer to Payroll the MXP Crew Folios Records
Function to Show/Hide Columns
List 
1) From the list of MXP Crew Folio that are not yet transfered to payroll, select persons that you want to Transfer to Payroll.
In the Collapse View, all the POS transaction of the person will be displayed.
To transfer, select/check the box and 2) To continue click Transfer to Payroll button
3) Successfully transfered to payroll
The successfully transfered to payroll will be displayed to the Transfered to Payroll
Debug Mode - Technical View
In APM's Debug Mode it is possible to see the response from the MXP WebAPI.
Log File is also possible to view4) The persons were removed from the list Not Transferred to Payroll.
5) In the list Is Transferred to Payroll you will view the transactions already transferred to Payroll.
View the Transfered MXP Crew Folio in the Payroll Module
Location: Payroll Module > Payroll
We group by location, in the TEXT column there were two locations detected (Computer Shop and Administration) The total amount for each location will be totaled and displayed as one entry.