Open Setup > Global Options > Datagroups > Travel Interface, select RightRez from drop-down in Interface field:

1. If RightRez interface is chosen, it may be necessary to contact RightRez for settings details: http://www.rightrez.com/

2. There are new possibilities to identify sites which make bookings and distinguish between vessels/account codes.
   
   Earlier, vessel account information could be taken from Ship Code and Account Code fields. It was not always convenient for companies where several vessels could be charged for booking flights.
   
   This situation has been amended in the following way:
   A new option Ship code from vessel rates is added to Global Options. It is possible to select this option and define, which vessel rates will store ship code and account information in Vessel properties > Rates tab.
   When this option is set, the Ship Code and Account Code fields become disabled and not taken into account. For the program to understand, vessel rates of which Vessel should be considered, you need to choose a vessel from the drop-down in Vessel to be Charged field that was added to Book Flight window in Flight Details datagroup.
   To identify, which site makes bookings, it is needed to define, which security level will be making bookings for this or that site. This can be done also in Global Options:
   Click , input level and vessel.
   To remove the record, click .
   
   In our example, the settings are defined in such a way:
   
   
   
   all users on security level 01 (security level 01 on each site) will make bookings for
   Spring vessel;
   from security level 02 - for an Office;
   security level 03 - for Summer vessel.
   
   When Default arriving date one day before Crew change ETA option is selected, the default arrive date/time for On-signing crew is one day before the ETA of the crew change. 
   This means that if the Book button is clicked on the Flight Bookings tab (on to Vessel view), the Arr.Date is set to ETA minus 1 day and Arr. before time to 23:59. If a user manually enters another Date, this Date is used for the booking. 
   This option is used for those companies who use Crew Change module for flight bookings.
   
   

   
   

   Info
   In addition to information that is needed for input in Global Options, Passport data and Nationality must be defined for the person that is going to fly. That can be done in Personal Details datagroup > Personal tab. Passport can also be defined in Travel Documents datagroup.

   
   

To open the datagroup, click icon on Datagroups ribbon or press Ctrl+I hotkeys.

You'll see the following screen:

In case if RightRez interface has been chosen, it is needed to click button to create a new record (to book a flight):

Several fields are obligatory for input here: Departure and Arrival Airport, Departure and Arrival Date.

• Departure Date can't be less than today's.

Passenger Type, Nationality, Passport Country, Passport Expires and Passport Number are filled in automatically (fetched from Personal Details and Travel Documents datagroups).
Choose Direction:

• if From Vessel is selected, Home Airport is shown automatically in the Arrival Airport field;
• If To Vessel is selected, Home Airport is shown in the Departure Airport field.
• If Home Airport is not defined in the Personal Details datagroup, these fields will be blank in both cases, and you need to choose the needed airports.

To select an airport, click a button with dots near airport field. Select Airport window will appear: It is possible to search airport name or airport code. Just start typing and the program will prompt you a variant.
If you set Training check-box, select another Direction:
button is disabled until all mandatory fields are filled in and the Departure Date is chosen correctly.

• Besides, it is impossible to book a flight if passport expires before the arrival date.|

When you click button, all typed information is sent to RightRez server.
Then it is possible to retrieve confirmation and costs information from RightRez server (use Retrieve button under Manage menu).
To view a record, select it and click Itinerary button or double-click the needed record.

Note, please:

Statuses Explanation:

To open the datagroup, click icon on Datagroups ribbon or press Ctrl+I hotkeys.
If None interface is chosen, Flight Details datagroup window looks like the below one:

You need to click button to create a record for a flight.
In Flight Details window, please define the necessary information:

Input Flight name, Departure/Arrival Date and Time, Departure/Arrival Airport.
To select an airport, click a button with dots near airport field.
Select Airport window will appear: It is possible to search by airport name or airport code. Just start typing and the program will prompt you a variant.
Enter Ticket details, Currency (currency codes should be previously created in General Codes > Payroll > Currency), Amount, Tax and Fees, etc.

Manage Buttons

To open the datagroup, click icon on Datagroups ribbon or press Ctrl+I hotkeys.
You'll see the following screen:

It is needed to click button to create a new request record. In appeared window, input all needed data:

Several fields are obligatory for filling here: Departure and Arrival Airport, Departure Date

• Departure Date can not be less than today's.

Nationality, Passport Country, Passport Expires and Passport Number are filled in automatically (fetched from Personal Details, Travel Documents datagroups).

The Purchase Number is the unique number which can be used to indicate the flight booking in Adonis. If you can ask other persons involved to refer to this number. It is possible to cross check the information coming from them with the flight bookings made in Adonis.
Choose Direction:

• if From Vessel is selected, Home Airport is shown automatically in the Arrival Airport field;
• If To Vessel is selected, Home Airport is shown in the Departure Airport field.

If you set Training check-box, select another Direction:

• If Home Airport is not defined in the Personal Details datagroup, these fields will be blank in both cases, and you need to choose the needed airports.

To select an airport, click a button with dots near airport field. Select Airport window will appear: It is possible to search airport name or airport code. Just start typing and the program will prompt you a variant.
Depart after time is/can be used to indicate earliest time the flight can be booked based on the vessel ETA (used for bookings from the vessel).
Arrival before time is/can be used to indicate the last time a person should arrive to catch the vessel ETD (used for booking to the vessel).|
When this is done, it is needed to click Send booking request button.
The message box appears, e.g.:

You can edit the info or attach files to the mail, if needed.
Click button and a mail with the all details will be sent to the person, whose address was defined in Global Options

To add travel costs record, click button under Manage menu.

• Costs codes should be previously created in General Codes > Travel > Costs.

If you want to leave notes, click button under Manage menu.

• Then they will be visible for all users here and in Notes datagroup.

Step 1:
To enable Manual travel interface functionality, please select it in Global Options > Datagroups > Travel Interface:

Step 2:
Manual interface also provides you with possibility to add book flights records in activities screen (link the flight to the activity).
This functionality is enabled when Enable Flight Bookings option is set in Global Options > Datagroups > Activities:

Step 3:
Add the column Flights to the activities views.
Go to Setup > General Codes > Activities > Activities Views, open the view that needs to display icons (arrows) for flights and add Flights column to the view:

Step 4:
Add needed Airline companies to General Codes > Travel > Airlines:

Click icon on Datagroups ribbon or press Ctrl+I hotkeys to access the Flight Details datagroup.
Click button to create a record:

1. First, you should choose Direction:
   
   If From Vessel is selected, Home Airport is shown automatically in the Arrival Airport field;
   
   If To Vessel is selected, Home Airport is shown in the Departure Airport field.
   If you set Training check-box, select another Direction:
   
   If Home Airport is not defined in the Personal Details datagroup, these fields will be blank in both cases, and you need to choose the needed airports.
   
   To select an airport, click a button with dots near airport field. Select Airport window will appear: It is possible to search airport name or airport code. Just start typing and the program will prompt you a variant.
   Input Arrival/Departure Date/Time.
   
   For Manual interface the system will allow input Arrival Date/Time < Departure Date/Time because this happens a lot due to time difference.
   
   Leave some comments in Comments field, if needed.
2. When creating a new book flight record, you will be able to input one or several segments, update them or delete.
   
   Click button to add a record.
   
   Each segment contains the following fields: Segment/Voyage Nr, Carrier (select needed airplane company from the drop-down list), Flight Nr, Cos, Departure/Arrival Airports, Departure/Arrival Date and Time.
   
   The flight booking record can contain the first Departure airport and the final Arrival airport in the Details part of the window. While in Flight Segments section, it is possible to mention all the connection flights the person will have.
   
   Click OK to save the record.

Let's look at Manage menu commands:

To view the record, select it and click Open button or double-click the record).
Delete button removes the selected record.
To view flight segments, click Segments button.
To add travel costs record, click Travel Costs button.

• Costs codes should be previously created in General Codes > Travel > Costs. 

You can leave notes, click Notes button.

• Then they will be visible for all users here and in Notes datagroup.

When all settings are performed (see Setup section), Flights drop-down appears in the Activities datagroup under Manage menu:

Select the activity record to which you need to add a flight. Click Flights drop-down and choose Book Flight command.
The screen the same as in Flight Details datagroup will appear. Input the required data and click OK to save.
See Inserting Flights in Flight Details Datagroup section.
Blue and green arrows in the Grid > Flights column are displayed if there is a linked flight to the activity:

If there is a flight with the direction To Vessel, the blue arrow will be displayed.
The green arrow identifies that the activity has a flight with the From Vessel direction.
Both arrows are displayed when flights for both directions are defined.

When it is needed to cancel the flight, select the activity record to which this flight is linked, click Flights drop-down and choose Cancel Booking command:



You'll get the warning:



To confirm cancelling, click Yes.
The flight record will disappear from the activity screen and from Flight Details datagroup.
Note, please:

• Once you clicked Book Flight and input the data (in Activities datagroup), the flight record will appear in Flight Details datagroup.

• The flight details also will be seen in the Activity Details on Crewing tab > Flight Booking section:

  

• The flight details in the activity screen are for viewing purpose only.

• It is possible to update the data in Flight Details datagroup.|

The workflow of Griffin Marine can be described by the diagram below:

Currently, there are two places in APM where this integration is implemented:

• the Flight Details datagroup (to book a flight for one person);
• the Crew Change module (to book for several crew members at the same time).

Use button or command from right-click menu to create a booking for the tagged person.
In Book Flight form input all needed information:

Booking/Purchase Nrs. are inputted automatically.
You should first select the Direction of the trip. It will define which fields are mandatory and which are disabled:

• For To Vessel direction Arrival Date & Time are mandatory, Departure Date & Time are disabled & vice versa;
• For To Vessel direction your Home airport is offered for Departure Airport by default;
  
  Your Home airport is offered for Arrival Airport when From Vessel direction is selected.
• If you set Training check-box, select another Direction:
  
  Departure/Arrival Airport and Vessel to be Charged are mandatory for any direction.
  To select an airport, click a button with dots near airport field. Select Airport window will appear.
  It is possible to search airport name or airport code. Just start typing and the program will prompt you a variant.
  Passenger Type, Nationality, Passport Country, Passport Expires and Passport Number fields are filled in automatically
  (fetched from Personal Details and Travel Documents datagroups).
  Click button to leave some notes.
  Click OK to save the request.
  
  

To access Crew Change module, click icon on Modules ribbon.

You should switch to Flight Booking tab:

1. Select the view in View Filter section: From Vessel (for Off-signers)/To Vessel (for On-signers) to operate with.
   
   
2. button will open Add Crew box containing all the crew that is assigned for On-/Off-signing crew change respectfully.
   Tag pins that you want to book flights for & use Copy Selection button to proceed. Crew members will be added to the Flight Booking tab:
   
   
   

   
   Tag the requests that you would like to be processed by your travel agent & click Book button under Manage menu. So, the requests will be sent to your travel agent.
   Their status of the sent requests will be changed from NONE to Flights_Req.

   
   

   As from now, your flight booking can be found in the Travels module at Flights Requested tab.
   
   Use Remove/Delete button if you do not want to create booking request for some tagged persons.
   
   

   Please note that it is only possible to remove a crew until you've sent a request using Book button.
   
   If the request has already been created/sent, you should use Cancel button instead (tagged crew members will have their booking status as Cancelled once this is processed by your travel agent).
   Change Request – click if you would like to modify the details that have already been requested.
   This will remove existing flight segments for a request & offer you to input data on another possible segment (this is possible only for bookings with Approved status).
    

   If you cancel a booking with Flights_Req status, it gets the Cancelled status.

   If you cancel Approved booking, it gets the Cancel_Req status.
   
   Click Notes button to leave some notes.
   By using button you will be switched to The Travels Module on-line user's manual.

Once the request is created (via Flight Details datagroup or Crew Change module), it is added to the Flights Requested tab of the Travels module.

Each request offers you an expanded list with the description of flight options that are related to your itinerary (flight connection, transit airports, etc.).
To access it, click icon on Modules ribbon.

• Travels module is enabled only if Griffin Marine travel interface is chosen for flights booking (in Global Options). 

You'll see the next screen:

Use View Filter to switch between From/To Vessel pages to see corresponding requests.

Flights Requested tab displays the requests that were created in Flight Details datagroup/Crew Change module.
Cancel Requests tab displays the requests that were cancelled in APM but not yet cancelled by the travel agent. Once they are, system moves them to Cancelled tab.
Change Requests tab displays all bookings that were modified to change departure/arrival details as per initial request.
Using Approve button is possible only for Flights Requested to confirm that you agree on the offered flight options for selected request. This operation can be performed for several bookings simultaneously.
Import button performs the check of flight segments on the side of travel agent & imports them into Adonis database for corresponding bookings, linking them via Purchase Order field. The status is automatically set to Approved & bookings are moved Approved tab.

The Purchase Order (PO) is generated by the following rule: <PIN><SiteNo><Number> where SiteNo contains 3 symbols defining the site that creates the booking, Number contains 4 symbols for unique order from 0001 to 9999 bookings.

Expired button sets the status of tagged bookings to Expired & moves them to Expired tab.
Move Expired Requests button is used when Arrival Date (for Joining flights) or Departure Date (for Leaving flights) is greater than the current date. Requests are set to Expired status & moved to Expired tab. You don't need to tag any records, the whole displayed list for requested flights is being checked.
Travel Costs button calls a pop-up window where you can add specific info related to the person's expenses that correspond to a trip. This may be accommodation, taxi bills or other. Grid also displays the total amount of expenses but does not distinguish if these are in different currencies (e.g. USD 100 & EUR 200 are displayed as 300).

The list of available expense types should be modified beforehand in General Codes > Travel > Costs.

The list of available currencies should be modified beforehand in General Codes > Payroll > Currency.
Update button calls a pop-up window allowing you to modify data for a batch of tagged records.

Note that normally the Vessel column displays the value that corresponds to the selected Vessel To Be Charged. Usually, it is the same as the crew change vessel. But if they differ, the Vessel field displays two values (first - for crew change Vessel; second - for Vessel To Be Charged) separated by semicolon.

Leave notes, if needed. For this: click Notes button under Manage menu.
By using button you will be switched to The Travels Module on-line user's manual

Please note:

• Any person can be added to a crew change from Rotation Planning module. There exist situations when a person is assigned to another shift but the previous shift has some already booked flights.
  You may want to keep these bookings. This is also possible.If a shift is modified from Rotation module, the system checks for existing bookings. If it finds any, the user is informed & offered whether he wants to keep the bookings. 

• If a person is kept assigned to remaining shift, it is not possible to remove bookings, they will be kept as they are.
  
  This also works when a user modifies the end date for Promoted_From shift of the promotion procedure. Warning message is displayed & system behaves according to user's decision. 

• It is useful to know: if a flight cancelling is the result of manipulations in Rotation module (modifying shift dates for a crew member), then the flight is set to Cancel_Req status.
  New booking is not created.

This is the travel interface introduced for booking flights through Instone travel company.
First you should make the necessary settings:

Step 1:
To be able to work with Instone travel interface you should select it in Setup > Global Options > Datagroups > Travel Interface:

Please select Instone from dropdown menu, then provide url for server that will process your bookings, your Client ID, login ID & password.
Server url, Client ID, Login section are mandatory as they should contain your credentials for data exchange with your travel agent.
Mandatory fields - you can as well define whether Admin code & Cost center will be required as mandatory fields for your flight bookings.
Show XML before/after send/receive - this is more an administrative option for debugging. When it is turned on, you will see each xml to be sent/received when you create bookings & get confirmations from processing center

Step 2: Admin Code & Cost Center
These fields are necessary for managing ATP & can be defined in General Codes > Travel.
Click button to add needed codes:

You can also allocate Cost Center & Account Number for corresponding Cost Centre general code.
This was done because various teams can have the same Cost Center but different Account Nr.

• Account Nr. is stored as text value (as an account number can start with zero).
  
  

Info
As there can be numerous codes defined for your company, we recommend you to set the availability filter (next to code field).

Setting the checkbox (in appeared window) for an organization level will make current code available for this level only.

You can proceed with bookings using Crew Change module or Flight Details datagroup.
A booking can be created in Flight Details datagroup for one person at a time.
Please select the correct person in your crew list then switch to the datagroup: click icon on Datagroups ribbon or press Ctrl+I hotkeys.

You'll see the folllowing screen, use button or command from right-click menu to create a booking for tagged person.
In Book Flight form input all needed information, e.g.:

You should first select the Direction of your trip. It will define which fields are mandatory and which are disabled:

• For To Vessel direction Arrival Date & Time are mandatory, Departure Date & Time are disabled.
  
  And vice versa:
  
  
• From Vessel - Departure Date & Time are mandatory, Arrival Date & Time are disabled.
  
  
• For To Vessel direction your Home airport is offered for Departure Airport, by default;
  
  When From Vessel direction is selected, your Home airport is offered for Arrival Airport.
• If you set Training check-box, select another Direction:
  
  Departure/Arrival Airport and Vessel to be Charged are mandatory for any direction.
  Select an airport from drop-down list.
  Passenger Type, Nationality, Passport Country, Passport Expires and Passport Number fields are filled in automatically (fetched from Personal Details/Travel Documents datagroups).
  button is disabled until all mandatory fields are filled in and the Departure Date is chosen correctly.
  After all requested data are filled, click Book! button.
  
  
• As from now, your flight booking can be found in the Flight Inbox module at Flights Requested tab and all further steps should be done there.
  
  To get last update from Instone, click Refresh button.
  button will remove selected record.
  To view flight itinerary, click Itinerary button.
  To add travel costs record, click  button.

• Costs codes should be previously created in General Codes > Travel > Costs.
  To leave some notes, click  button. Then they will be visible for all users here and in Notes datagroup.

To access Crew Change module, click icon on Modules ribbon.

To perform bookings, please select the required crew change port & switch to its Flight Booking tab:

1. Select the target view in View Filter section to operate with:

   From Vessel (for Off-signers);

   To Vessel (for On-signers).

2. button will open Add Crew box containing all the crew that is assigned for On-/Off-signing crew change respectively.
   Tag pins that you want to book flights for & click Copy Selection button to proceed.
   Requests with NONE/Created status for crew members will be added to the Flight Booking tab:
   
   
   Use Remove button if you do not want to create booking request for some tagged persons.
   Certain fields are mandatory to fill before you are able to book.
   You can add some travel information in a batch. If you update/select the Nearest Airport, Dpt.Date, Dpt.after time & click Apply button, this airport will be added as Arrival or Departure Airport (for tagged On-/Off-signers respectively).
   You can as well tag needed persons & select Admin Code & Cost Center for any of them, then this value will be populated for all tagged crew members.
   

   Note that Admin Code & Cost Center can be setup as mandatory fields in Global Options.

   Standard grid functionality enables you to change columns order, sort by any field & hide some columns that are not relevant for your workflow – see User Interface chapter.
   
   

   Once you've filled in all necessary fields, tag your crew members & click Book Flight button. A progress window will be displayed to see persons being processed.
   The status of processed bookings is changed from NONE to PENDING.

   As from now, your flight booking can be found in the Flight Inbox module at Flights Requested tab and all further steps should be done there.
   
   Refresh – used to update latest status for tagged bookings. The request to a travel agent is re-sent to force the update of a booking status & get the latest information.
   Email Agent - opens you email client, setting the Agency Email (from Global Options). The subject of email is generated as Vessel Name + PNR + Person Name.
   Click Notes button, to leave some comments, if needed.

The Flight Inbox module manages the flights requests for a crew member created in the APM, follows all processions of flights performed by the end user.

• Flight Inbox module is developed specially for Instone travel interface.
  It is not available if any other interface is used. 

Currently, there are two places in APM where this integration is implemented:

• the Flight Details datagroup to book a flight for one person;
• the Crew Change module to book for several crew members at the same time.

For details, see Booking from Flight Details/Crew Change sections below.

After you booked travels from Crew Change module or Flight Details datagroup, it is added to the Flights Requested tab of the Flight Inbox module with NONE or PENDING status.
Then you proceed to work there.
To access the module, click icon on Modules ribbon or press Ctrl+Alt+T hotkeys:

1. Views Filtering
   You can filter the records to review My Flights & All Flights pages.
   They respectively display flights booked by current user or by all users.
   You can also switch between From Vessel/To Vessel views.
   They respectively display flights booked:

   for Off-signers (From Vessel);

   for On-signers (To Vessel).

2. Flights Requested tab contains information for bookings that were sent to travel agent for processing but you have not yet received any feedback with flight options. These are normally bookings with PENDING status.
   If it's with NONE status - the booking is created but is not sent to ATPI.

   Just click Refresh button -to update latest status for tagged bookings.
   
   Options Received tab displays the flight options for a booking, received from the travel agent.
   Each flight option provides detailed information of how to get to requested destination point.

   An option can contain several segments that correspond to transit airports (connections) that appear on your destination.
   
   Confirmed tab displays bookings that are confirmed by the user, but not ticketed by ATPI yet.
   Cancel Request tab displays all bookings & flight options that were cancelled but the cancellation has not yet been confirmed by the travel agent.

   You can cancel the flight request on the following process stages (tabs) – Options Received, Confirmed and Ticketed.
   
   Ticketed tab displays the bookings for which the tickets have been issued by the agent.
   Cancelled tab displays cancelled bookings & flight options that have been confirmed by travel agent.
   Expired tab contains expired requests.

Menu buttons
We provide you with several menu buttons to perform operations over existing bookings.

• Please note that some buttons are available on certain tabs and disabled on the others.

This is to support the functional logic that doesn't allow to confirm cancelled requests or vice versa.

Booking Statuses list:

Requests sent from APM:

1. Login request – receive Login confirmation.
2. New booking request – receive confirmation that booking request is received.
3. Refresh Booking List request – receive List of bookings that currently exists in the queue, each booking in the list has the "secure Item Id" that used by us to request details of booking.
4. Request Details of booking using received "secure Item Id" – receive Details of booking (e.g. air segments info, ticket number, amount, fare, etc.).
5. Accept/Cancel request - send list of PNRs which should be accepted/cancelled – receive confirmation that request is received.
6. Group Cancel request – send PNR and list of PAX names which should be cancelled.
7. Renew PNR request – refresh all booking data.