User Tools

Site Tools


leon:integrations

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision Both sides next revision
leon:integrations [2021/11/30 12:41]
rafal [FlightDocs]
leon:integrations [2021/12/06 14:34]
rafal [Export]
Line 139: Line 139:
 ==== Export ==== ==== Export ====
  
-First step the export aircraft availability is integrating Leon with Avinode. This process is explained [[leon:integrations|here]].+In order to allow buyers to search available aircraft for requested trips, Avinode requires a precise aircraft schedule from aircraft operators. 
 + 
 +Leon allows automatic schedule export to Avinode for selected aircraft. All aircraft for which the schedule is sent automatically to Avinode should be configured in Avinode for receiving data from Leon. 
 + 
 +The first step in the export aircraft availability is integrating Leon with Avinode. This process is explained [[leon:integrations|here]].
  
 If you want to receive messages after each export of flights to Avinode, type your code or first letters of your name in the field **Recipients**. If you want to receive messages after each export of flights to Avinode, type your code or first letters of your name in the field **Recipients**.
Line 145: Line 149:
 Once all has been set up tick aircraft of which flights you want to be exported.  Once all has been set up tick aircraft of which flights you want to be exported. 
  
-Apart from **automatic** export to Avinode, in this section you can also send flights **manually** by clicking on 'Export now' button. 
  
 +
 +<html>
 +<span style="color:red;font-size:150%;">EXPORT INSIGHTS</span>
 +</html>
 +
 +Before sending the data to Avinode there are steps required to be done:
 +
 +  * The aircraft needs to be active in Avinode Marketplace with the status: Fully Active.
 +  * An API connection needs to be set up in the Avinode Marketplace for the company marketing the aircraft in the Avinode Marketplace. This company is usually the operator, but it can also be a different company (i.e. not the operator holding the AOC for the aircraft) marketing the aircraft. API Connections can only be set up by Avinode staff and is usually done by product specialists (support@avinode.com) upon request from the company marketing the aircraft.
 +  * The aircraft must be configured in the Avinode Marketplace to receive automatic schedule updates (i.e. Aircraft Schedule Update Type = Integrated). This can only be configured by Avinode staff and is usually done by our product specialists (support@avinode.com). 
 +  * The company marketing the aircraft should have Activity Type Mappings configured in their Avinode Marketplace account. More information below
  
  
 <html> <html>
-<span style="color:red;font-size:150%;">IMPORTANT INFORMATION</span>+<span style="color:blue;font-size:125%;">Export frequency</span>
 </html> </html>
  
  
 +Leon sends a schedule for all configured aircraft **every 15 minutes**. It is also possible to make manual exports from the Avinode Add-on control panel.
  
-Avinode will get schedule from Leon if the below conditions are met:+<html> 
 +<span style="color:blue;font-size:125%;">What is being sent</span> 
 +</html> 
 + 
 + 
 +Leon sends all activities from the time of export to the last aircraft activity in the database. Leon by standard sends all flights, reservations, and maintenances. It is also possible to send options and opportunities as regular activities. 
 + 
 +The schedule for each aircraft has a form of a continuous timeline. Spaces between activities in the exported period are filled with special ONGROUND activities. 
 + 
 +<html> 
 +<span style="color:blue;font-size:125%;">Activity Type Mapping – Leon Side</span> 
 +</html> 
 + 
 + 
 +Aircraft activities prepared to send are mapped on codes corresponding to available Avinode activity types. However, operator doesn’t have to configure the Avinode side with the same corresponding codes (see the section below). 
 + 
 +**There are five activity types on Leon side**: 
 + 
 +  * **FLIGHT** – every flight with PAX 
 +  * **EMPTY** – every ferry flight and opportunity flight  if the export is configured to send opportunities 
 +  * **MAINT** – every reservation and maintenance is mapped to this code 
 +  * **OPTION** – every flight option (if the export is configured to send options) 
 +  * **ONGROUND** – every space between the above activities is filled with this activity (this include time before first activity and after the last activity if reposition to homebase after hours is configured)) 
 + 
 +<html> 
 +<span style="color:blue;font-size:125%;">Activity Type Mapping – Avinode Side</span> 
 +</html> 
 + 
 + 
 +Activities exported from Leon can be mapped to one of Avinode's available statuses and therefore be subject to the search engines for trip requests and empty legs. 
 + 
 +__**Empty Leg Availability**__ 
 + 
 +All activities mapped to this type will be considered empty leg availability and posted in the Empty Legs list in the Avinode System. 
 + 
 +__**Ferry Availability**__ 
 + 
 +Activities mapped to this type will be considered available. This option will not post an Empty Leg as the aircraft is assumed available until occupied for the "passenger leg". The engine will take into account the following "passenger leg" and will ensure that the aircraft has enough time to be in position for that. 
 + 
 +__**Flight Occupied**__ 
 + 
 +Aircraft will be considered occupied and will not show when searches are performed in the Avinode System. This option should be used for all flight-related occupancy e.g. 135 trips, 91 trips, etc. 
 + 
 +__**Occupied**__ 
 + 
 +Aircraft will be considered occupied and will not show when searches are performed in the Avinode System. This option should be used for all non-flight occupancy e.g Maintenance. 
 + 
 +__**Onground Availability**__ 
 + 
 +Aircraft will be considered available on-ground. This option can be used to indicate transient (away from home base) availability. This will price the aircraft from the indicated airport, rather than the home base. 
 + 
 +__**Option Availability**__ 
 + 
 +This is an “information only” type. Activities mapped to this type will be shown in the Schedule for the aircraft, but do in no way affect the schedule when searches are performed in the Avinode System as the aircraft is still considered available. This can be used for non-confirmed trips.
 [{{ :leon:schedule-eksport:avinode mapping.jpg?200|Mapping activity types in Avinode}}] [{{ :leon:schedule-eksport:avinode mapping.jpg?200|Mapping activity types in Avinode}}]
-  - The aircraft needs to be active in Avinode Marketplace with the statusFully Active. +**Default Avinode mapping**: 
-  - An API connection needs to be set up in the Avinode Marketplace for the company marketing the aircraft in the Avinode MarketplaceThis company is usually the operator, but it can also be a different company (i.enot the operator holding the AOC for the aircraft) marketing the aircraftAPI Connections can only be set up by Avinode staff and is usually done by product specialists (support@avinode.com) upon request from the company marketing the aircraft. + 
-  - The aircraft must be configured in the Avinode Marketplace to receive automatic schedule updates (i.e. Aircraft Schedule Update Type = Integrated). This can only be configured by Avinode staff and is usually done by our product specialists (support@avinode.com).  +  * **FLIGHT** – Flight Occupied 
-  - The company marketing the aircraft should have Activity Type Mappings configured in their Avinode Marketplace accountThese mappings are configured on a company level and are important for Avinode to be able to interpret the different type of schedule activities sent by the uploading software. Users at the company can also view, create and edit these mappings (if the user has been set up with the permission to do this). The page for this is available by navigating to Schedule - Activity types in the main menu in the online Avinode Marketplace interface. If no Activity Type Mappings are configured, the upload call will still succeed (without warnings). A mapping will be automatically created for each activity type in the uploaded data. Each type mapping created this way will have Display color = Black, and the aircraft will by default be considered as Occupied during these activitiesAn activity displaying with the color black should be an indication to the user that they need to configure the Activity Type Mappings.+  * **EMPTY** – Empty Leg Availability 
 +  * **MAINT** – Occupied 
 +  * **OPTION** – Option Availability 
 +  * **ONGROUND** – Onground Availability 
 + 
 +Operators can manually change mapping settings in Avinode for their own purposes. 
 + 
 +<html> 
 +<span style="color:blue;font-size:125%;">Special configuration options</span> 
 +</html> 
 + 
 +__**Send Options**__ 
 + 
 +If this setting is configured Leon also exports flight options. Options have different mapped status OPTION, discriminating them from a confirmed flightNote that reservation and maintenance options are never sent to Avinode regardless of this setting. 
 + 
 +__**Send Opportunities**__ 
 + 
 +If this setting is configured Leon also exports flights with opportunity statusOpportunities are sent to Avinode as empty legs with EMPTY status. 
 + 
 +__**Continuous availability from aircraft homebase**__ 
 + 
 +This option changes normal schedule export and exports only one activity for each aircraft indicating ONGROUND status of aircraft in it’s homebase airport. This artificial activity is an only day long and the Avinode system extends this status to future times
 +Note that Leon in that mode doesn’t send any real activity for all aircraft. 
 + 
 +__**Auto reposition availability to homebase after specified time [h]**__ 
 + 
 +It is possible to set automatic (artificialreposition to homebase after each activity. If the time between the last and next activity is greater than this factor (set in hourssystem will add artificial repositioning activity lasting one minute indicating ONGOUND status from the aircraft homebase. 
 + 
 +This option is disabled when set to 0. 
 + 
  
 +  
  
 ==== Import ==== ==== Import ====
leon/integrations.txt · Last modified: 2024/03/14 10:01 by marek