Overview

An example of end-to-end scenario based on on operation flow and user story

Operation flow

read (booking) → servicePrice→ addAncillaries 

User story

S7 agent wants to buy extra bag with discount for 1ADT in booking with tickets issued earlier. 

Scenario

The general process for book a trip and read reservation details such as this is:

  1. Read reservation: S7 Agent executes a read operation to get information about passengers, issued tickets and route;

  2. Get ancillaries pricing (bag): S7 Agent executes a servicePrice operation to get information about available ancillaries and ancillaries pricing (which include discount details);

  3. Issue EMD for ancillaries services: S7 Agent executes an addAncillaries operation to issue EMD for chosen ancillaries services;

Table of contents:


Before you can send a request to S7 Agent API, you must get an SSL certificate and configure your software.


Discount for ancillaries services

To receive ancillaries pricing with discount in the test environment S7 Agent API Agent can contact our technical support by Kaiten.

Certification required to use this service scenario in the production environment.

Step 1: Read reservation details


S7 Agent executes a read operation to get information about passengers, issued tickets and rout.

Request. OrderRetrieveRQ
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header />
    <Body>
        <OrderRetrieveRQ xmlns="http://www.iata.org/IATA/EDIST" Version="1.0">
            <Document />
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>test</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Query>
                <Filters>
                        <BookingReferences>
                            <BookingReference>
                                <ID>LWVIID</ID>
                                <AirlineID>S7</AirlineID>
                            </BookingReference>
                        </BookingReferences>
                </Filters>
            </Query>
        </OrderRetrieveRQ>
    </Body>
</Envelope>
Response. OrderViewRS
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:Envelope xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3="http://www.iata.org/IATA/EDIST">
    <ns2:Body>
        <ns3:OrderViewRS Version="">
            <ns3:Document>
                <ns3:Name>1.0</ns3:Name>
            </ns3:Document>
            <ns3:Success/>
            <ns3:Response>
                <ns3:OrderViewProcessing>
                    <ns3:Remarks>
                        <ns3:Remark>S7 ONLY/REF/CHNG/RESTR/ST</ns3:Remark>
                    </ns3:Remarks>
                </ns3:OrderViewProcessing>
                <ns3:Passengers>
                    <ns3:Passenger ObjectKey="SH4">
                        <ns3:PTC Quantity="1">ADT</ns3:PTC>
                        <ns3:Age>
                            <ns3:BirthDate>1992-02-27</ns3:BirthDate>
                        </ns3:Age>
                        <ns3:Name>
                            <ns3:Surname>PILATUS</ns3:Surname>
                            <ns3:Given>PONTIUS</ns3:Given>
                            <ns3:Title>MR</ns3:Title>
                            <ns3:Middle/>
                        </ns3:Name>
                        <ns3:Contacts>
                            <ns3:Contact>
                                <ns3:EmailContact>
                                    <ns3:Address>r.tkachuk@s7.ru</ns3:Address>
                                </ns3:EmailContact>
                                <ns3:PhoneContact>
                                    <ns3:Number>79999999999</ns3:Number>
                                </ns3:PhoneContact>
                            </ns3:Contact>
                        </ns3:Contacts>
                        <ns3:Gender>Male</ns3:Gender>
                        <ns3:PassengerIDInfo>
                            <ns3:PassengerDocument>
                                <ns3:Type>PP</ns3:Type>
                                <ns3:ID>111111111</ns3:ID>
                                <ns3:DateOfExpiration>2030-02-27</ns3:DateOfExpiration>
                                <ns3:CountryOfResidence>RU</ns3:CountryOfResidence>
                            </ns3:PassengerDocument>
                        </ns3:PassengerIDInfo>
                    </ns3:Passenger>
                </ns3:Passengers>
                <ns3:Order>
                    <ns3:OrderID Owner="S7">1</ns3:OrderID>
                    <ns3:BookingReferences>
                        <ns3:BookingReference>
                            <ns3:ID>M47LMA</ns3:ID>
                            <ns3:AirlineID>S7</ns3:AirlineID>
                        </ns3:BookingReference>
                    </ns3:BookingReferences>
                    <ns3:OrderItems>
                        <ns3:OrderItem>
                            <ns3:FlightItem>
                                <ns3:OriginDestination>
                                    <ns3:Flight>
                                        <ns3:SegmentKey>FL1</ns3:SegmentKey>
                                        <ns3:Status>
                                            <ns3:StatusCode>
                                                <ns3:Code>HK</ns3:Code>
                                            </ns3:StatusCode>
                                        </ns3:Status>
                                        <ns3:Departure>
                                            <ns3:AirportCode>OVB</ns3:AirportCode>
                                            <ns3:Date>2024-01-17</ns3:Date>
                                            <ns3:Time>08:40</ns3:Time>
                                        </ns3:Departure>
                                        <ns3:Arrival>
                                            <ns3:AirportCode>DME</ns3:AirportCode>
                                            <ns3:Date>2024-01-17</ns3:Date>
                                            <ns3:Time>09:15</ns3:Time>
                                        </ns3:Arrival>
                                        <ns3:MarketingCarrier>
                                            <ns3:AirlineID>S7</ns3:AirlineID>
                                            <ns3:FlightNumber>2504</ns3:FlightNumber>
                                        </ns3:MarketingCarrier>
                                        <ns3:OperatingCarrier>
                                            <ns3:AirlineID>S7</ns3:AirlineID>
                                            <ns3:FlightNumber>2504</ns3:FlightNumber>
                                        </ns3:OperatingCarrier>
                                        <ns3:CabinType>
                                            <ns3:Code>Y</ns3:Code>
                                        </ns3:CabinType>
                                        <ns3:ClassOfService>
                                            <ns3:Code>S</ns3:Code>
                                        </ns3:ClassOfService>
                                    </ns3:Flight>
                                </ns3:OriginDestination>
                            </ns3:FlightItem>
                            <ns3:Associations>
                                <ns3:Passengers>
                                    <ns3:PassengerReferences>SH4</ns3:PassengerReferences>
                                </ns3:Passengers>
                            </ns3:Associations>
                        </ns3:OrderItem>
                    </ns3:OrderItems>
                </ns3:Order>
                <ns3:TicketDocInfos>
                    <ns3:TicketDocInfo>
                        <ns3:TicketDocument>
                            <ns3:TicketDocNbr>4212105482855</ns3:TicketDocNbr>
                            <ns3:Type>
                                <ns3:Code>702</ns3:Code>
                            </ns3:Type>
                            <ns3:NumberofBooklets>1</ns3:NumberofBooklets>
                            <ns3:DateOfIssue>2023-12-08</ns3:DateOfIssue>
                        </ns3:TicketDocument>
                        <ns3:PassengerReference>SH4</ns3:PassengerReference>
                    </ns3:TicketDocInfo>
                </ns3:TicketDocInfos>
                <ns3:Metadata>
                    <ns3:Other>
                        <ns3:OtherMetadata>
                            <ns3:CountryMetadatas>
                                <ns3:CountryMetadata MetadataKey="CM1">
                                    <ns3:AugmentationPoint>
                                        <ns3:AugPoint Owner="OVB">
                                            <ns4:value xmlns:ns4="##other" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:nil="true"/>
                                        </ns3:AugPoint>
                                    </ns3:AugmentationPoint>
                                </ns3:CountryMetadata>
                            </ns3:CountryMetadatas>
                        </ns3:OtherMetadata>
                    </ns3:Other>
                </ns3:Metadata>
            </ns3:Response>
        </ns3:OrderViewRS>
    </ns2:Body>
</ns2:Envelope>

Step 2: Get ancillaries pricing (bag)


S7 Agent executes a servicePrice operation to get information about extra bag price.

Request. ServicePriceRQ
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header/>
    <Body>
        <ServicePriceRQ Version="1.0" xmlns="http://www.iata.org/IATA/EDIST">
            <Document/>
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>test</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Parameters>
                <ServiceFilters>
                    <ServiceFilter>
                        <GroupCode>bag</GroupCode>
                    </ServiceFilter>
                </ServiceFilters>
            </Parameters>
            <Travelers>
                <Traveler>
                    <AnonymousTraveler>
                        <PTC Quantity="1">ADT</PTC>
                    </AnonymousTraveler>
                </Traveler>
            </Travelers>
            <Query>
                <OriginDestination>
                    <Flight>
                        <SegmentKey>SEG1</SegmentKey>
                        <Departure>
                            <AirportCode>OVB</AirportCode>
                            <Date>2024-01-17</Date>
                        </Departure>
                        <Arrival>
                            <AirportCode>DME</AirportCode>
                        </Arrival>
                        <MarketingCarrier>
                            <AirlineID>S7</AirlineID>
                            <FlightNumber>2504</FlightNumber>
                        </MarketingCarrier>
                        <OperatingCarrier>
                            <AirlineID>S7</AirlineID>
                            <FlightNumber>2504</FlightNumber>
                        </OperatingCarrier>
                        <ClassOfService>
                            <Code>S</Code>
                        </ClassOfService>
                    </Flight>
                </OriginDestination>
            </Query>
            <DataList>
                <FareList>
                    <FareGroup refs="SEG1" ListKey="FG1">
                        <Fare>
                            <FareCode>
                                <Code>STANDARDECONOMY</Code>
                            </FareCode>
                        </Fare>
                        <FareBasisCode>
                            <Code>SSTOW</Code>
                        </FareBasisCode>
                    </FareGroup>
                </FareList>
            </DataList>
        </ServicePriceRQ>
    </Body>
</Envelope>
Response. ServicePriceRS
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:Envelope xmlns:ns2="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns3="http://www.iata.org/IATA/EDIST">
    <ns2:Body>
        <ns3:ServicePriceRS Version="2.000">
            <ns3:Document/>
            <ns3:Success/>
            <ns3:Services>
                <ns3:Service ObjectKey="SR1">
                    <ns3:ServiceID Owner="S7">SR1</ns3:ServiceID>
                    <ns3:Name>bag</ns3:Name>
                    <ns3:Descriptions>
                        <ns3:Description ObjectKey="fareFamily_SR1">
                            <ns3:Text>STANDARDECONOMY</ns3:Text>
                        </ns3:Description>
                        <ns3:Description ObjectKey="description_SR1">
                            <ns3:Text>CHECKED FIRST BAG</ns3:Text>
                        </ns3:Description>
                        <ns3:Description ObjectKey="weight_SR1">
                            <ns3:Text>23kg</ns3:Text>
                        </ns3:Description>
                        <ns3:Description ObjectKey="size_SR1">
                            <ns3:Text>203cm</ns3:Text>
                        </ns3:Description>
                    </ns3:Descriptions>
                    <ns3:Price>
                        <ns3:Total Code="RUB">3600</ns3:Total>
                        <ns3:Details>
                            <ns3:Detail>
                                <ns3:Application>discount percent</ns3:Application>
                                <ns3:Amount Code="percent">40</ns3:Amount>
                            </ns3:Detail>
                            <ns3:Detail>
                                <ns3:Application>base fare</ns3:Application>
                                <ns3:Amount Code="RUB">6000.0</ns3:Amount>
                            </ns3:Detail>
                        </ns3:Details>
                    </ns3:Price>
                    <ns3:BookingInstructions>
                        <ns3:OSIText>0CC</ns3:OSIText>
                    </ns3:BookingInstructions>
                    <ns3:Associations>
                        <ns3:Flight>
                            <ns3:OriginDestinationReferences>OD1</ns3:OriginDestinationReferences>
                        </ns3:Flight>
                    </ns3:Associations>
                    <ns3:Associations>
                        <ns3:OtherAssociations>
                            <ns3:OtherAssociation>
                                <ns3:Type>fare</ns3:Type>
                                <ns3:ReferenceValue>OD1</ns3:ReferenceValue>
                            </ns3:OtherAssociation>
                        </ns3:OtherAssociations>
                    </ns3:Associations>
                    <ns3:Associations>
                        <ns3:Traveler>
                            <ns3:TravelerReferences>SH1</ns3:TravelerReferences>
                        </ns3:Traveler>
                    </ns3:Associations>
                    <ns3:Associations>
                        <ns3:OtherAssociations>
                            <ns3:OtherAssociation>
                                <ns3:Type>media</ns3:Type>
                                <ns3:ReferenceValue>ML1</ns3:ReferenceValue>
                            </ns3:OtherAssociation>
                        </ns3:OtherAssociations>
                    </ns3:Associations>
                </ns3:Service>
                <ns3:Service ObjectKey="SR2">
                    <ns3:ServiceID Owner="S7">SR2</ns3:ServiceID>
                    <ns3:Name>bag</ns3:Name>
                    <ns3:Descriptions>
                        <ns3:Description ObjectKey="fareFamily_SR2">
                            <ns3:Text>STANDARDECONOMY</ns3:Text>
                        </ns3:Description>
                        <ns3:Description ObjectKey="description_SR2">
                            <ns3:Text>CHECKED BAG SECOND</ns3:Text>
                        </ns3:Description>
                        <ns3:Description ObjectKey="weight_SR2">
                            <ns3:Text>23kg</ns3:Text>
                        </ns3:Description>
                        <ns3:Description ObjectKey="size_SR2">
                            <ns3:Text>203cm</ns3:Text>
                        </ns3:Description>
                    </ns3:Descriptions>
                    <ns3:Price>
                        <ns3:Total Code="RUB">3000</ns3:Total>
                        <ns3:Details>
                            <ns3:Detail>
                                <ns3:Application>discount percent</ns3:Application>
                                <ns3:Amount Code="percent">40</ns3:Amount>
                            </ns3:Detail>
                            <ns3:Detail>
                                <ns3:Application>base fare</ns3:Application>
                                <ns3:Amount Code="RUB">5000.0</ns3:Amount>
                            </ns3:Detail>
                        </ns3:Details>
                    </ns3:Price>
                    <ns3:BookingInstructions>
                        <ns3:OSIText>0CD</ns3:OSIText>
                    </ns3:BookingInstructions>
                    <ns3:Associations>
                        <ns3:Flight>
                            <ns3:OriginDestinationReferences>OD1</ns3:OriginDestinationReferences>
                        </ns3:Flight>
                    </ns3:Associations>
                    <ns3:Associations>
                        <ns3:OtherAssociations>
                            <ns3:OtherAssociation>
                                <ns3:Type>fare</ns3:Type>
                                <ns3:ReferenceValue>OD1</ns3:ReferenceValue>
                            </ns3:OtherAssociation>
                        </ns3:OtherAssociations>
                    </ns3:Associations>
                    <ns3:Associations>
                        <ns3:Traveler>
                            <ns3:TravelerReferences>SH1</ns3:TravelerReferences>
                        </ns3:Traveler>
                    </ns3:Associations>
                    <ns3:Associations>
                        <ns3:OtherAssociations>
                            <ns3:OtherAssociation>
                                <ns3:Type>media</ns3:Type>
                                <ns3:ReferenceValue>ML2</ns3:ReferenceValue>
                            </ns3:OtherAssociation>
                        </ns3:OtherAssociations>
                    </ns3:Associations>
                </ns3:Service>
            </ns3:Services>
            <ns3:DataLists>
                <ns3:AnonymousTravelerList>
                    <ns3:AnonymousTraveler ObjectKey="SH1">
                        <ns3:PTC>ADT</ns3:PTC>
                    </ns3:AnonymousTraveler>
                </ns3:AnonymousTravelerList>
                <ns3:FareList>
                    <ns3:FareGroup refs="SEG1" ListKey="FG1">
                        <ns3:Fare>
                            <ns3:FareCode>
                                <ns3:Code>STANDARDECONOMY</ns3:Code>
                            </ns3:FareCode>
                        </ns3:Fare>
                        <ns3:FareBasisCode>
                            <ns3:Code>SSTOW</ns3:Code>
                        </ns3:FareBasisCode>
                    </ns3:FareGroup>
                </ns3:FareList>
                <ns3:FlightSegmentList>
                    <ns3:FlightSegment SegmentKey="SEG1">
                        <ns3:Departure>
                            <ns3:AirportCode>OVB</ns3:AirportCode>
                            <ns3:Date>2024-01-17</ns3:Date>
                            <ns3:Time>08:35</ns3:Time>
                        </ns3:Departure>
                        <ns3:Arrival>
                            <ns3:AirportCode>DME</ns3:AirportCode>
                            <ns3:Date>2024-01-17</ns3:Date>
                            <ns3:Time>09:10</ns3:Time>
                        </ns3:Arrival>
                        <ns3:MarketingCarrier>
                            <ns3:AirlineID>S7</ns3:AirlineID>
                            <ns3:FlightNumber>2504</ns3:FlightNumber>
                        </ns3:MarketingCarrier>
                        <ns3:OperatingCarrier>
                            <ns3:AirlineID>S7</ns3:AirlineID>
                            <ns3:FlightNumber>2504</ns3:FlightNumber>
                        </ns3:OperatingCarrier>
                        <ns3:Equipment refs="ML3">
                            <ns3:AircraftCode>321</ns3:AircraftCode>
                            <ns3:AirlineEquipCode>Airbus A321</ns3:AirlineEquipCode>
                        </ns3:Equipment>
                    </ns3:FlightSegment>
                </ns3:FlightSegmentList>
                <ns3:OriginDestinationList>
                    <ns3:OriginDestination OriginDestinationKey="OD1">
                        <ns3:DepartureCode>OVB</ns3:DepartureCode>
                        <ns3:ArrivalCode>DME</ns3:ArrivalCode>
                        <ns3:FlightReferences>SEG1</ns3:FlightReferences>
                    </ns3:OriginDestination>
                </ns3:OriginDestinationList>
                <ns3:MediaList>
                    <ns3:Media ListKey="ML1">
                        <ns3:MediaLink>https://static.s7cdn.online/hermes/IBE/rich-content/baggage/baggage_bag23kg.png</ns3:MediaLink>
                    </ns3:Media>
                    <ns3:Media ListKey="ML2">
                        <ns3:MediaLink>https://static.s7cdn.online/hermes/IBE/rich-content/baggage/baggage_bag23kg.png</ns3:MediaLink>
                    </ns3:Media>
                    <ns3:Media ListKey="ML3">
                        <ns3:MediaLink>https://static.s7cdn.online/hermes/IBE/image_airplane/a321-neo.png</ns3:MediaLink>
                    </ns3:Media>
                </ns3:MediaList>
            </ns3:DataLists>
        </ns3:ServicePriceRS>
    </ns2:Body>
</ns2:Envelope>

Information about discount in ServicePriceRS

 Envelope/Body/ServicePriceRS/Services/Price


Price/Total - total price for ancillaries with discount

Price/Details/Detail [Application text =discount percent]/Amount@Code="percent" - discount amount in percent

Price/Details/Detail [Application text =base fare]/Amount - base fare price for ancillaries 

Ancillarieis with discount
<ns3:Service ObjectKey="SR1">
    <ns3:ServiceID Owner="S7">SR1</ns3:ServiceID>
    <ns3:Name>bag</ns3:Name>
    <ns3:Descriptions>
        <ns3:Description ObjectKey="fareFamily_SR1">
            <ns3:Text>STANDARDECONOMY</ns3:Text>
        </ns3:Description>
        <ns3:Description ObjectKey="description_SR1">
            <ns3:Text>CHECKED FIRST BAG</ns3:Text>
        </ns3:Description>
        <ns3:Description ObjectKey="weight_SR1">
            <ns3:Text>23kg</ns3:Text>
        </ns3:Description>
        <ns3:Description ObjectKey="size_SR1">
            <ns3:Text>203cm</ns3:Text>
        </ns3:Description>
    </ns3:Descriptions>
    <ns3:Price>
        <ns3:Total Code="RUB">2950</ns3:Total>
        <ns3:Details>
            <ns3:Detail>
                <ns3:Application>discount percent</ns3:Application>
                <ns3:Amount Code="percent">50.9</ns3:Amount>
            </ns3:Detail>
            <ns3:Detail>
                <ns3:Application>base fare</ns3:Application>
                <ns3:Amount Code="RUB">6000.0</ns3:Amount>
            </ns3:Detail>
        </ns3:Details>
    </ns3:Price>
    <ns3:BookingInstructions>
        <ns3:OSIText>0CC</ns3:OSIText>
    </ns3:BookingInstructions>
    <ns3:Associations>
        <ns3:Flight>
            <ns3:OriginDestinationReferences>OD1</ns3:OriginDestinationReferences>
        </ns3:Flight>
    </ns3:Associations>
    <ns3:Associations>
        <ns3:OtherAssociations>
            <ns3:OtherAssociation>
                <ns3:Type>fare</ns3:Type>
                <ns3:ReferenceValue>OD1</ns3:ReferenceValue>
            </ns3:OtherAssociation>
        </ns3:OtherAssociations>
    </ns3:Associations>
    <ns3:Associations>
        <ns3:Traveler>
            <ns3:TravelerReferences>SH1</ns3:TravelerReferences>
        </ns3:Traveler>
    </ns3:Associations>
    <ns3:Associations>
        <ns3:OtherAssociations>
            <ns3:OtherAssociation>
                <ns3:Type>media</ns3:Type>
                <ns3:ReferenceValue>ML1</ns3:ReferenceValue>
            </ns3:OtherAssociation>
        </ns3:OtherAssociations>
    </ns3:Associations>
</ns3:Service>

Step 4: Issue EMD for bag

S7 Agent executes an addAncillaries operation to issue EMD for choosen ancillaries services.

  • Add information about passenger keys from OrderViewRS
Passenger ref in OrderViewRS
Envelope/Body/OrderViewRS/Response/Passengers/Passenger@ObjectKey
  • Add information about PNR from OrderViewRS

PNR information in OrderViewRS
Envelope/Body/OrderViewRS/Response/Order/BookingReferences/BookingReference/ID
  • Fill in the form of payment (FOP) as in example <*A*FREETEXT>

FOP
<iata:FareList>
    <iata:FareGroup>
        <iata:FareCode>Y</iata:FareCode>
        <iata:FareDetail>
            <iata:FarePriceType>
                <iata:FarePriceTypeCode/>
                <iata:Price>
                    <iata:TotalAmount CurCode="RUB">3600</iata:TotalAmount>
                </iata:Price>
            </iata:FarePriceType>
            <iata:PricingSystemCodeText>MS</iata:PricingSystemCodeText>
            <iata:StatisticalCodeText>*A*FREETEXT</iata:StatisticalCodeText>
        </iata:FareDetail>
        <iata:FareGroupID>FR1</iata:FareGroupID>
    </iata:FareGroup>
</iata:FareList>
  • PaxJourneyList and PaxSegmentList data takes from OrderViewRS

<iata:PaxJourneyList>
    <iata:PaxJourney>
        <iata:PaxJourneyID>OD1</iata:PaxJourneyID>
        <iata:PaxSegmentRefID>FL1</iata:PaxSegmentRefID>
    </iata:PaxJourney>
</iata:PaxJourneyList>
...
<iata:PaxSegmentList>
    <iata:PaxSegment>
        <iata:Arrival>
            <iata:AircraftScheduledDateTime>2024-01-17T08:40:00</iata:AircraftScheduledDateTime>
            <iata:IATA_LocationCode>DME</iata:IATA_LocationCode>
        </iata:Arrival>
        <iata:Dep>
            <iata:AircraftScheduledDateTime>2024-01-17T09:15:00</iata:AircraftScheduledDateTime>
            <iata:IATA_LocationCode>OVB</iata:IATA_LocationCode>
        </iata:Dep>
        <iata:MarketingCarrierInfo>
            <iata:CarrierDesigCode>S7</iata:CarrierDesigCode>
            <iata:MarketingCarrierFlightNumberText>2504</iata:MarketingCarrierFlightNumberText>
        </iata:MarketingCarrierInfo>
        <iata:OperatingCarrierInfo>
            <iata:CarrierDesigCode>S7</iata:CarrierDesigCode>
            <iata:OperatingCarrierFlightNumberText>2504</iata:OperatingCarrierFlightNumberText>
        </iata:OperatingCarrierInfo>
        <iata:PaxSegmentID>FL1</iata:PaxSegmentID>
    </iata:PaxSegment>
</iata:PaxSegmentList>
  • Specify discount information for ancillaries pricing

Information about discount in IATA_OrderChangeRQ

Envelope/Body/iata:IATA_OrderChangeRQ/iata:Request/ChangeOrder/iata:UpdateOrderItem/iata:AcceptOffer/iata:CreateOrderItem/iata:OfferItemType/iata:BaggageItem/iata:Price


iata:Price/iata:TotalAmount - total price for ancillaries with discount
iata:Price/iata:BaseAmount - base fare price for ancillaries
iata:Price/iata:Discount/iata:DiscountPercent - discount amount in percent

Ancillaries pricing with discount
<iata:CreateOrderItem>
    <iata:OfferItemID>OI1</iata:OfferItemID>
    <iata:OfferItemType>
        <iata:BaggageItem>
            <iata:BagItemDetails>
                <iata:BaggageAllowanceRefID>BG1</iata:BaggageAllowanceRefID>
            </iata:BagItemDetails>
            <iata:Price>
                <iata:BaseAmount CurCode="RUB">6000</iata:BaseAmount>
                <iata:Discount>
                    <iata:DiscountPercent>40</iata:DiscountPercent>
                </iata:Discount>
                <iata:TotalAmount CurCode="RUB">3600</iata:TotalAmount>
            </iata:Price>
        </iata:BaggageItem>
    </iata:OfferItemType>
    <iata:OwnerCode>S7</iata:OwnerCode>
</iata:CreateOrderItem>
Request. IATA_OrderChangeRQ
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:iata="http://www.iata.org/IATA/2015/00/2019.1/IATA_OrderChangeRQ">
    <soapenv:Header/>
    <soapenv:Body>
        <iata:IATA_OrderChangeRQ>
            <iata:Party>
                <iata:Sender>
                    <iata:TravelAgency>
                        <iata:AgencyID>test</iata:AgencyID>
                        <iata:PseudoCityID>S7AGN8224</iata:PseudoCityID>
                    </iata:TravelAgency>
                </iata:Sender>
            </iata:Party>
            <iata:Request>
                <iata:BookingRef>
                    <iata:BookingEntity>
                        <iata:Carrier>
                            <iata:AirlineDesigCode>S7</iata:AirlineDesigCode>
                        </iata:Carrier>
                    </iata:BookingEntity>
                    <iata:BookingID>M47LMA</iata:BookingID>
                </iata:BookingRef>
                <iata:ChangeOrder>
                    <iata:UpdateOrderItem>
                        <iata:AcceptOffer>
                            <iata:CreateOrderItem>
                                <iata:OfferItemID>OI1</iata:OfferItemID>
                                <iata:OfferItemType>
                                    <iata:BaggageItem>
                                        <iata:BagItemDetails>
                                            <iata:BaggageAllowanceRefID>BG1</iata:BaggageAllowanceRefID>
                                        </iata:BagItemDetails>
                                        <iata:Price>
                                            <iata:BaseAmount CurCode="RUB">6000</iata:BaseAmount>
                                            <iata:Discount>
                                                <iata:DiscountPercent>40</iata:DiscountPercent>
                                            </iata:Discount>
                                            <iata:TotalAmount CurCode="RUB">3600</iata:TotalAmount>
                                        </iata:Price>
                                    </iata:BaggageItem>
                                </iata:OfferItemType>
                                <iata:OwnerCode>S7</iata:OwnerCode>
                            </iata:CreateOrderItem>
                        </iata:AcceptOffer>
                    </iata:UpdateOrderItem>
                </iata:ChangeOrder>
                <iata:DataLists>
                    <iata:BaggageAllowanceList>
                        <iata:BaggageAllowance>
                            <iata:ApplicableBagText>OD1</iata:ApplicableBagText>
                            <iata:ApplicablePartyText>P4</iata:ApplicablePartyText>
                            <iata:BaggageAllowanceID>BG1</iata:BaggageAllowanceID>
                            <iata:DescText>0CC</iata:DescText>
                            <iata:TypeCode>Checked</iata:TypeCode>
                        </iata:BaggageAllowance>
                    </iata:BaggageAllowanceList>
                    <iata:FareList>
                        <iata:FareGroup>
                            <iata:FareCode>Y</iata:FareCode>
                            <iata:FareDetail>
                                <iata:FarePriceType>
                                    <iata:FarePriceTypeCode/>
                                    <iata:Price>
                                        <iata:TotalAmount CurCode="RUB">3600</iata:TotalAmount>
                                    </iata:Price>
                                </iata:FarePriceType>
                                <iata:PricingSystemCodeText>MS</iata:PricingSystemCodeText>
                                <iata:StatisticalCodeText>*A*FREETEXT</iata:StatisticalCodeText>
                            </iata:FareDetail>
                            <iata:FareGroupID>FR1</iata:FareGroupID>
                        </iata:FareGroup>
                    </iata:FareList>
                    <iata:PaxJourneyList>
                        <iata:PaxJourney>
                            <iata:PaxJourneyID>OD1</iata:PaxJourneyID>
                            <iata:PaxSegmentRefID>FL1</iata:PaxSegmentRefID>
                        </iata:PaxJourney>
                    </iata:PaxJourneyList>
                    <iata:PaxList>
                        <iata:Pax>
                            <iata:PaxID>P4</iata:PaxID>
                            <iata:PTC>ADT</iata:PTC>
                        </iata:Pax>
                    </iata:PaxList>
                    <iata:PaxSegmentList>
                        <iata:PaxSegment>
                            <iata:Arrival>
                                <iata:AircraftScheduledDateTime>2024-01-17T08:40:00</iata:AircraftScheduledDateTime>
                                <iata:IATA_LocationCode>DME</iata:IATA_LocationCode>
                            </iata:Arrival>
                            <iata:Dep>
                                <iata:AircraftScheduledDateTime>2024-01-17T09:15:00</iata:AircraftScheduledDateTime>
                                <iata:IATA_LocationCode>OVB</iata:IATA_LocationCode>
                            </iata:Dep>
                            <iata:MarketingCarrierInfo>
                                <iata:CarrierDesigCode>S7</iata:CarrierDesigCode>
                                <iata:MarketingCarrierFlightNumberText>2504</iata:MarketingCarrierFlightNumberText>
                            </iata:MarketingCarrierInfo>
                            <iata:OperatingCarrierInfo>
                                <iata:CarrierDesigCode>S7</iata:CarrierDesigCode>
                                <iata:OperatingCarrierFlightNumberText>2504</iata:OperatingCarrierFlightNumberText>
                            </iata:OperatingCarrierInfo>
                            <iata:PaxSegmentID>FL1</iata:PaxSegmentID>
                        </iata:PaxSegment>
                    </iata:PaxSegmentList>
                </iata:DataLists>
                <iata:Order>
                    <iata:OrderID>DFRРLDH</iata:OrderID>
                    <iata:OwnerCode>S7</iata:OwnerCode>
                </iata:Order>
            </iata:Request>
        </iata:IATA_OrderChangeRQ>
    </soapenv:Body>
</soapenv:Envelope>
Response. IATA_OrderViewRS
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Header/>
    <SOAP-ENV:Body>
        <ns2:IATA_OrderViewRS xmlns:ns2="http://www.iata.org/IATA/2015/00/2019.1/IATA_OrderViewRS">
            <ns2:Response>
                <ns2:DataLists>
                    <ns2:PaxJourneyList>
                        <ns2:PaxJourney>
                            <ns2:PaxJourneyID>OD1</ns2:PaxJourneyID>
                            <ns2:PaxSegmentRefID>FL1</ns2:PaxSegmentRefID>
                        </ns2:PaxJourney>
                    </ns2:PaxJourneyList>
                    <ns2:PaxList>
                        <ns2:Pax>
                            <ns2:Individual>
                                <ns2:GenderCode>M</ns2:GenderCode>
                                <ns2:GivenName>Pontius</ns2:GivenName>
                                <ns2:Surname>Pilatus</ns2:Surname>
                                <ns2:TitleName>MR</ns2:TitleName>
                            </ns2:Individual>
                            <ns2:PaxID>pax4</ns2:PaxID>
                            <ns2:PTC>ADT</ns2:PTC>
                        </ns2:Pax>
                    </ns2:PaxList>
                    <ns2:PaxSegmentList>
                        <ns2:PaxSegment>
                            <ns2:Arrival>
                                <ns2:AircraftScheduledDateTime>2024-01-17T09:15:00</ns2:AircraftScheduledDateTime>
                                <ns2:IATA_LocationCode>DME</ns2:IATA_LocationCode>
                            </ns2:Arrival>
                            <ns2:Dep>
                                <ns2:AircraftScheduledDateTime>2024-01-17T08:40:00</ns2:AircraftScheduledDateTime>
                                <ns2:IATA_LocationCode>OVB</ns2:IATA_LocationCode>
                                <ns2:TerminalName>A</ns2:TerminalName>
                            </ns2:Dep>
                            <ns2:MarketingCarrierInfo>
                                <ns2:CarrierDesigCode>S7</ns2:CarrierDesigCode>
                                <ns2:MarketingCarrierFlightNumberText>2504</ns2:MarketingCarrierFlightNumberText>
                                <ns2:RBD_Code>S</ns2:RBD_Code>
                            </ns2:MarketingCarrierInfo>
                            <ns2:OperatingCarrierInfo>
                                <ns2:CarrierDesigCode>S7</ns2:CarrierDesigCode>
                                <ns2:OperatingCarrierFlightNumberText>2504</ns2:OperatingCarrierFlightNumberText>
                            </ns2:OperatingCarrierInfo>
                            <ns2:PaxSegmentID>FL1</ns2:PaxSegmentID>
                        </ns2:PaxSegment>
                    </ns2:PaxSegmentList>
                    <ns2:ServiceDefinitionList>
                        <ns2:ServiceDefinition>
                            <ns2:Desc>
                                <ns2:DescText>4214101990621</ns2:DescText>
                            </ns2:Desc>
                            <ns2:Name>bag</ns2:Name>
                            <ns2:ServiceCode>0CC</ns2:ServiceCode>
                            <ns2:ServiceDefinitionID>SD_1</ns2:ServiceDefinitionID>
                            <ns2:ValidatingCarrierCode>S7</ns2:ValidatingCarrierCode>
                        </ns2:ServiceDefinition>
                    </ns2:ServiceDefinitionList>
                </ns2:DataLists>
                <ns2:Order>
                    <ns2:BookingRef>
                        <ns2:BookingEntity>
                            <ns2:Carrier>
                                <ns2:AirlineDesigCode>S7</ns2:AirlineDesigCode>
                            </ns2:Carrier>
                        </ns2:BookingEntity>
                        <ns2:BookingID>M47LMA</ns2:BookingID>
                    </ns2:BookingRef>
                    <ns2:OrderID>QSXAXHY</ns2:OrderID>
                    <ns2:OrderItem>
                        <ns2:CreationDateTime>2023-12-08T21:24:29.43691</ns2:CreationDateTime>
                        <ns2:OrderItemID>4214101990621</ns2:OrderItemID>
                        <ns2:Price>
                            <ns2:TotalAmount CurCode="RUB">3600</ns2:TotalAmount>
                        </ns2:Price>
                        <ns2:Service>
                            <ns2:PaxRefID>pax4</ns2:PaxRefID>
                            <ns2:ServiceAssociations>
                                <ns2:ServiceDefinitionRef>
                                    <ns2:FlightAssociations>
                                        <ns2:PaxJourneyRefID>OD1</ns2:PaxJourneyRefID>
                                    </ns2:FlightAssociations>
                                    <ns2:ServiceDefinitionRefID>SD_1</ns2:ServiceDefinitionRefID>
                                </ns2:ServiceDefinitionRef>
                            </ns2:ServiceAssociations>
                            <ns2:ServiceID>SRV_1</ns2:ServiceID>
                            <ns2:StatusCode>ISSUED</ns2:StatusCode>
                        </ns2:Service>
                    </ns2:OrderItem>
                    <ns2:OwnerCode>S7</ns2:OwnerCode>
                    <ns2:TotalPrice>
                        <ns2:TotalAmount CurCode="RUB">3600</ns2:TotalAmount>
                    </ns2:TotalPrice>
                </ns2:Order>
            </ns2:Response>
            <ns2:PayloadAttributes>
                <ns2:CorrelationID>3.62:f1470462-4fce-49ec-b575-148beb53d427</ns2:CorrelationID>
            </ns2:PayloadAttributes>
        </ns2:IATA_OrderViewRS>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
  • No labels