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
CONFIGURATIONConfiguration
1) Setup the MXP WebAPI URL, the default location is http://localhost/MXP_Virgin.exe
2) Setup Payroll Transaction: Look up to Crew Folio entry code.
Field Assignments:
3) Select the entry codes. 
4) 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 create a list for each transaction.
To get the correct placement of the crew folio, the forth row is the numorgid to select the vessel's unique id. 
5) For the current site, we can setup the Organization should be Import Crew Folio in the Adonis Replicator.
Location: Adonis Personal Manager > Seup > Adonis Replicator
Functionality
How to Import Crew Folios From MXP
Import MXP Crew Folio Records button
Click Import MXP Crew Folio Records button
Set 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.
Import all transaction upto:
This is the end of the voyage or end date of payroll.
Successfully Imported MXP Crew Folio
You will be notified that the import is successful.
How to Transfer the MXP Crew Folios Records
Function to Show/Hide Columns
List of MXP Crew Folio that are not yet transfered to payroll
In the Collapse View, all the POS transaction of the person will be displayed.
To transfer, select/check the box and click Transfer to Payroll button
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 view.
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.