FlightAncillaryService

FlightAncillaryService

Ancillary services, consist of the following elements:

• ID - service ID in the supplier system. Data type - int.
• Status - current status of the ancillary service. Data type - string. Possible values:
  • Booked - service is booked;
  • Canceled - service is canceled;
  • Ticketed - service is ticketed;
  • Rejected - airline did not confirm the service;
  • Requested - requested, but not yet confirmed;
  • Problematic - there are problems with the service, there is no price, it is impossible to work with it via web services, you need to correct data in PNR via the terminal.
• TravellerRef - reference to passengers in the book, to which the ancillary service applies. Data type - array.
• TravellerRef.Ref - number of passenger in the book to whom this item belongs. Data type - int.
• Name - ancillary service description. Data type - string.
• Group - ancillary service group. Data type - string.
• SubGroup - ancillary service subgroup. Data type - string.
• Type - code of the ancillary service type. Data type - string.
• RFIC - ancillary services RFIC (Reason For Issuance Codes), consists of one symbol and is used to indicate the basis (cause) for adding EMD. Data type - string. List of RFIC Codes:
  • A — Air Transportation;
  • B — Surface Transportation/Non Air Services;
  • C — Baggage;
  • D — Financial Impact;
  • E — Airport Services;
  • F — Merchandise;
  • G — In-flight Services.
• RFISC - ancillary services RFISC (Reason For Issuance Sub-Codes) consisting of three symbols. RFISC are established by the airline itself and determine the specific type of service, for example, 0DG - payment for excess baggage, 0B3 - provision of special meals. Data type - string.
• SSRCode - code of the SSR associated with the given ancillary service which must be added to the PNR in case of the booking of this ancillary service. Data type - string.
• SSRText - text of the SSR associated with the given ancillary service. Data type - string.
• SegmentRef - reference to the segment on which the ancillary service is added. Data type - int.
• CompanyCode - code of the airline to which the service belongs. Data type - string.
• Refundability - returnable or non-returnable service . Data type - enumeration.
• ServiceRefs - list of the ancillary service IDs in booking for which an operation is required. Data type - int array.
• ServiceRefs.Ref - ID of the ancillary service in the booking for which the operation is required. Data type - int.
• SSRDescription - description for the SSR of ancillary service booked (optional). Data type - string.
• SSRDescriptionRequired - attribute of the need to transfer ancillary services description from the user in order to book this service. Data type - bool.
• Quantity - number of repetitions of the service. Data type - int.
• EMDType - EMD type. Data type - string.
• OfferToken - token for service with dynamic price. Data type - string.
• OfferTtl - timelimit for service with dynamic price. Data type - datetime.

The list of available ancillary services is triggered by the SearchAncillaryServices parameter in the AdditionalOperations request. In response to this request you will receive a list of ancillary services available on the current flight.

Sample

                     <AncillaryServiceRS>
                        <ID>0</ID>
                        <Name>CHILDRENS MEAL</Name>
                        <Group>ML</Group>
                        <RFIC>G</RFIC>
                        <RFISC>0LO</RFISC>
                        <SSRCode>CHML</SSRCode>
                        <Type>F</Type>
                        <CompanyCode>AY</CompanyCode>
                        <EmdType>A</EmdType>
                     </AncillaryServiceRS>

The price of the service is returned in the block AncillaryServicePrice

                     <AncillaryServicePrice>
                        <Value>
                           <a:Amount>40.94</a:Amount>
                           <a:Currency>EUR</a:Currency>
                        </Value>
                        <ServiceRef>
                           <a:Ref>0</a:Ref>
                        </ServiceRef>
                        <SegmentRef>
                           <a:Ref>1</a:Ref>
                        </SegmentRef>
                        <TravellersTypes>
                           <a:PassTypes>ADT</a:PassTypes>
                        </TravellersTypes>
                        <TravellerRef>
                           <a:Ref>0</a:Ref>
                        </TravellerRef>
                     </AncillaryServicePrice>

In the above example, the price matches the service with ID 0 (displayed in the ServiceRef parameter) on the first segment displayed in the SegmentRef parameter).

You can add a service to the book via a BookFlight request, or, if the book has already been created, through a ModifyBook request.

Sample BookFlight request.

               <avia1:AncillaryServices>
                  <avia1:AncillaryService>
                     <avia1:ID>-1</avia1:ID>
                     <avia1:Name>OVERSIZE PC UPTO23KGOVER203LCM</avia1:Name>
                     <avia1:Group>BG</avia1:Group>
                     <avia1:RFIC>C</avia1:RFIC>
                     <avia1:RFISC>0FB</avia1:RFISC>
                     <avia1:Type>C</avia1:Type>
                     <avia1:TravellerRef>1</avia1:TravellerRef>
                     <avia1:SegmentRef>
                        <stl:Ref>1</stl:Ref>
                     </avia1:SegmentRef>
                     <avia1:Quantity>1</avia1:Quantity>
                     <avia1:EMDType>A</avia1:EMDType>
                  </avia1:AncillaryService>
                  <avia1:AncillaryService>
                     <avia1:ID>-1</avia1:ID>
                     <avia1:Name>OVERSIZE PC UPTO23KGOVER203LCM</avia1:Name>
                     <avia1:Group>BG</avia1:Group>
                     <avia1:RFIC>C</avia1:RFIC>
                     <avia1:RFISC>0FB</avia1:RFISC>
                     <avia1:Type>C</avia1:Type>
                     <avia1:TravellerRef>1</avia1:TravellerRef>
                     <avia1:SegmentRef>
                        <stl:Ref>2</stl:Ref>
                     </avia1:SegmentRef>
                     <avia1:Quantity>1</avia1:Quantity>
                     <avia1:EMDType>A</avia1:EMDType>
                  </avia1:AncillaryService>
               </avia1:AncillaryServices>

Sample BookFlight response.

               <b:AncillaryServices>
                  <b:AncillaryService>
                     <a:ID>1</a:ID>
                     <a:SupplierID>14</a:SupplierID>
                     <a:Status>Requested</a:Status>
                     <a:TravellerRef>
                        <a:Ref>1</a:Ref>
                     </a:TravellerRef>
                     <b:SegmentRef>
                        <a:Ref>0</a:Ref>
                     </b:SegmentRef>
                     <b:CompanyCode>AY</b:CompanyCode>
                     <b:Name>OVERSIZE PC UPTO23KGOVER203LCM</b:Name>
                     <b:TypeCode>C</b:TypeCode>
                     <b:RFIC>C</b:RFIC>
                     <b:RFISC>0FB</b:RFISC>
                     <b:Quantity>1</b:Quantity>
                     <b:Group>BG</b:Group>
                     <b:SubGroup i:nil="true"/>
                     <b:EmdType>A</b:EmdType>
                     <b:StatusCode i:nil="true"/>
                  </b:AncillaryService>
                  <b:AncillaryService>
                     <a:ID>2</a:ID>
                     <a:SupplierID>15</a:SupplierID>
                     <a:Status>Requested</a:Status>
                     <a:TravellerRef>
                        <a:Ref>1</a:Ref>
                     </a:TravellerRef>
                     <b:SegmentRef>
                        <a:Ref>1</a:Ref>
                     </b:SegmentRef>
                     <b:CompanyCode>AY</b:CompanyCode>
                     <b:Name>OVERSIZE PC UPTO23KGOVER203LCM</b:Name>
                     <b:TypeCode>C</b:TypeCode>
                     <b:RFIC>C</b:RFIC>
                     <b:RFISC>0FB</b:RFISC>
                     <b:Quantity>1</b:Quantity>
                     <b:Group>BG</b:Group>
                     <b:SubGroup i:nil="true"/>
                     <b:EmdType>A</b:EmdType>
                     <b:StatusCode i:nil="true"/>
                  </b:AncillaryService>
               </b:AncillaryServices>

Sample ModifyBook request.

               <avia1:AncillaryServices>
                  <avia1:ModifyAncillaryService>
                     <stl:Action>Add</stl:Action>
                     <avia1:AncillaryService>
                        <avia1:ID>-1</avia1:ID>
                        <avia1:Name>VEGETARIAN LUNCH</avia1:Name>
                        <avia1:Group>ML</avia1:Group>
                        <avia1:RFIC>G</avia1:RFIC>
                        <avia1:RFISC>0AR</avia1:RFISC>
                        <avia1:Type>F</avia1:Type>
                        <avia1:TravellerRef>1</avia1:TravellerRef>
                        <avia1:SegmentRef>
                           <stl:Ref>0</stl:Ref>
                        </avia1:SegmentRef>
                        <avia1:Quantity>1</avia1:Quantity>
                        <avia1:EMDType>A</avia1:EMDType>
                     </avia1:AncillaryService>
                  </avia1:ModifyAncillaryService>
                  <avia1:ModifyAncillaryService>
                     <stl:Action>Add</stl:Action>
                     <avia1:AncillaryService>
                        <avia1:ID>-1</avia1:ID>
                        <avia1:Name>VEGETARIAN LUNCH</avia1:Name>
                        <avia1:Group>ML</avia1:Group>
                        <avia1:RFIC>G</avia1:RFIC>
                        <avia1:RFISC>0AR</avia1:RFISC>
                        <avia1:Type>F</avia1:Type>
                        <avia1:TravellerRef>1</avia1:TravellerRef>
                        <avia1:SegmentRef>
                           <stl:Ref>1</stl:Ref>
                        </avia1:SegmentRef>
                        <avia1:Quantity>1</avia1:Quantity>
                        <avia1:EMDType>A</avia1:EMDType>
                     </avia1:AncillaryService>
                  </avia1:ModifyAncillaryService>
               </avia1:AncillaryServices>

Sample ModifyBook response.

               <b:AncillaryServices>
                  <b:AncillaryService>
                     <a:ID>1</a:ID>
                     <a:SupplierID>17</a:SupplierID>
                     <a:Status>Requested</a:Status>
                     <a:TravellerRef>
                        <a:Ref>1</a:Ref>
                     </a:TravellerRef>
                     <b:SegmentRef>
                        <a:Ref>0</a:Ref>
                     </b:SegmentRef>
                     <b:CompanyCode>AY</b:CompanyCode>
                     <b:Name>VEGETARIAN LUNCH</b:Name>
                     <b:TypeCode>F</b:TypeCode>
                     <b:RFIC>G</b:RFIC>
                     <b:RFISC>0AR</b:RFISC>
                     <b:Quantity>1</b:Quantity>
                     <b:Group>ML</b:Group>
                     <b:SubGroup>LU</b:SubGroup>
                     <b:EmdType>A</b:EmdType>
                     <b:StatusCode i:nil="true"/>
                  </b:AncillaryService>
                  <b:AncillaryService>
                     <a:ID>2</a:ID>
                     <a:SupplierID>18</a:SupplierID>
                     <a:Status>Requested</a:Status>
                     <a:TravellerRef>
                        <a:Ref>1</a:Ref>
                     </a:TravellerRef>
                     <b:SegmentRef>
                        <a:Ref>1</a:Ref>
                     </b:SegmentRef>
                     <b:CompanyCode>AY</b:CompanyCode>
                     <b:Name>VEGETARIAN LUNCH</b:Name>
                     <b:TypeCode>F</b:TypeCode>
                     <b:RFIC>G</b:RFIC>
                     <b:RFISC>0AR</b:RFISC>
                     <b:Quantity>1</b:Quantity>
                     <b:Group>ML</b:Group>
                     <b:SubGroup>LU</b:SubGroup>
                     <b:EmdType>A</b:EmdType>
                     <b:StatusCode i:nil="true"/>
                  </b:AncillaryService>
               </b:AncillaryServices>

If there was an error with ancillary service during the process of issuing the ticket, it can be issued separately through an IssueEMD request.

To void an ancillary service use a VoidEMD request.

To obtain the calculation of the EMD refund, a GetEMDRefundData request is used.

To make an EMD refund, a RefundEMD request is used.