You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Overview

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


Operation flow

searchFlightsJourney → book (Flight) → reprice without PNR → reprice with PNR → servicePrice → demandTickets (ETK)

User story

S7 agent wants to buy one way flight from Moscow (DME) to Saint Petersburg (LED) for one adult traveler. He also wants to buy two extra bags with discount. He chooses direct S7 flight.

Scenario

The general process for buying a trip such as this is:

  1. Initial search for flight solutions: S7 Agent executes a searchFlightsJourney operation with itinerary criteria and passenger types count;

  2. Book a reservation: S7 Agent executes a book operation with passenger details and itinerary info of chosen solution from search results;

  3. Request for informative reservation pricing: S7 Agent executes a reprice operation with itinerary info of chosen solution;

  4. Request for reservation pricing: S7 Agent executes a reprice operation with itinerary info of chosen solution;

  5. Request for ancillaries pricing: S7 Agent executes a servicePrice operation with the whole journey details and passenger type list;

  6. Issue tickets with EMD for each passenger: S7 Agent executes a demandTickets operation with reservation reference, baggage codes and pricing details for air and baggage.

Table of contents:


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

(lightbulb) Extra baggage is available for each slice.

Step 1: Initial search for flight solutions

S7 Agent executes a searchFlightsJourney operation with itinerary criteria and passenger types count


AirShoppingRQ
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header/>
    <Body>
        <AirShoppingRQ xmlns="http://www.iata.org/IATA/EDIST" Version="1.0">
            <Document/>
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>test</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Parameters>
                <CurrCodes>
                    <CurrCode>RUB</CurrCode>
                </CurrCodes>
            </Parameters>
            <Travelers>
                <Traveler>
                    <AnonymousTraveler>
                        <PTC Quantity="1">ADT</PTC>
                    </AnonymousTraveler>
                </Traveler>
            </Travelers>
            <CoreQuery>
                <OriginDestinations>
                    <OriginDestination>
                        <Departure>
                            <AirportCode>DME</AirportCode>
                            <Date>2024-01-06</Date>
                        </Departure>
                        <Arrival>
                            <AirportCode>LED</AirportCode>
                        </Arrival>
                    </OriginDestination>
                </OriginDestinations>
            </CoreQuery>
        </AirShoppingRQ>
    </Body>
</Envelope>


Received solutions divided by fare family and mostly includes 6 sub solutions (BASIC ECONOMY, STANDARD ECONOMY, PLUS ECONOMY, BASIC BUSINESS, STANDARD BUSINESS, PLUS BUSINESS) for each itinerary solution.

Step 2: Book a reservation

S7 Agent executes a book operation with passenger details and itinerary info of chosen solution from search results.

<DetailedFlightItem> block consists of journey information, where each slice is described by the <OriginDestination> element.

<OriginDestination>  block takes from appropriate AirShoppingRS

(lightbulb) Segments (Flight) must be devided into slices (OriginDestination):

  • one OriginDestination for One Way trip;

  • two for Round Trip and more for MultiCity;

  • for Transfer Trip all segments included in one slice have to be pass in one OriginDestination;

  • for Transfer Trip segments with stopover between have to be divided into two OriginDestination.

Envelope/Body/AirShoppingRS/DataLists/FlightSegmentList

and <ClassOfService> (RBD) from

Envelope/Body/AirShoppingRS/OffersGroup/AirlineOffers/AirlineOffer/PricedOffer/OfferPrice/RequestedDate/Associations/ApplicableFlight/FlightSegmentReference/ClassOfService/Code
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header/>
    <Body>
        <OrderCreateRQ xmlns="http://www.iata.org/IATA/EDIST" Version="1.0">
            <Document/>
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>test</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Query>
                <Passengers>
                    <Passenger ObjectKey="SH1">
                        <PTC>ADT</PTC>
                        <Age>
                            <BirthDate>1992-02-27</BirthDate>
                        </Age>
                        <Name>
                            <Surname>Pilatus</Surname>
                            <Given>Pontius</Given>
                            <Title>MR</Title>
                        </Name>
                        <Contacts>
                            <Contact>
                                <EmailContact>
                                    <Address>r.tkachuk@s7.ru</Address>
                                </EmailContact>
                                <PhoneContact>
                                    <Number CountryCode="7" AreaCode="999">9999999</Number>
                                </PhoneContact>
                            </Contact>
                        </Contacts>
                        <Gender>Male</Gender>
                        <PassengerIDInfo>
                            <PassengerDocument>
                                <Type>PP</Type>
                                <ID>111111111</ID>
                                <BirthCountry>RU</BirthCountry>
                                <DateOfIssue>2012-02-27</DateOfIssue>
                                <DateOfExpiration>2030-02-27</DateOfExpiration>
                                <CountryOfResidence>RU</CountryOfResidence>
                            </PassengerDocument>
                        </PassengerIDInfo>
                    </Passenger>
                </Passengers>
                <OrderItems>
                    <ShoppingResponse>
                        <Owner>S7</Owner>
                        <ResponseID>UNKNOWN</ResponseID>
                        <Offers>
                            <Offer>
                                <OfferID Owner="S7">UNKNOWN</OfferID>
                                <OfferItems>
                                    <OfferItem>
                                        <OfferItemID Owner="S7">UNKNOWN</OfferItemID>
                                        <Passengers>
                                            <PassengerReference>SH1</PassengerReference>
                                        </Passengers>
                                        <ApplicableFlight>
                                            <FlightReferences>FL1</FlightReferences>
                                        </ApplicableFlight>
                                    </OfferItem>
                                </OfferItems>
                            </Offer>
                        </Offers>
                    </ShoppingResponse>
                    <OfferItem>
                        <OfferItemID Owner="S7">UNKNOWN</OfferItemID>
                        <OfferItemType>
                            <DetailedFlightItem>
                                <OriginDestination>
                                    <Flight>
                                        <SegmentKey>FL1</SegmentKey>
                                        <Departure>
                                            <AirportCode>DME</AirportCode>
                                            <Date>2024-01-16</Date>
                                            <Time>10:15</Time>
                                        </Departure>
                                        <Arrival>
                                            <AirportCode>LED</AirportCode>
                                            <Date>2024-01-16</Date>
                                            <Time>11:55</Time>
                                        </Arrival>
                                        <MarketingCarrier>
                                            <AirlineID>S7</AirlineID>
                                            <FlightNumber>1009</FlightNumber>
                                        </MarketingCarrier>
                                        <OperatingCarrier>
                                            <AirlineID>S7</AirlineID>
                                            <FlightNumber>1009</FlightNumber>
                                        </OperatingCarrier>
                                        <ClassOfService>
                                            <Code>Y</Code>
                                        </ClassOfService>
                                    </Flight>
                                </OriginDestination>
                            </DetailedFlightItem>
                        </OfferItemType>
                    </OfferItem>
                </OrderItems>
            </Query>
        </OrderCreateRQ>
    </Body>
</Envelope>



Step 3: Request for informative pricing

S7 Agent executes a reprice operation with itinerary info of chosen solution

All information must be taken from AirShoppingRS:

  • itinerary details (airport codes and dates for origin and departure, airline code and flight number);

(lightbulb) <FlightItem> block must fill in like in OrderCreateRQ. Each slice is described by the <OriginDestination> element.

  • passenger types (PTC);

  • fare details (RBD and fare code).


<Envelope
	xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header />
    <Body>
        <ItinReshopRQ Version=""
			xmlns="http://www.iata.org/IATA/EDIST">
            <Document />
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>test</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Query>
                <Reshop>
                    <Actions>
                        <ActionType />
                        <OrderItems>
                            <OrderItem>
                                <FlightItem>
                                    <OriginDestination>
                                        <Flight>
                                            <SegmentKey>FL1</SegmentKey>
                                            <Departure>
                                                <AirportCode>DME</AirportCode>
                                                <Date>2023-09-20</Date>
                                                <Time>08:55</Time>
                                            </Departure>
                                            <Arrival>
                                                <AirportCode>KUF</AirportCode>
                                                <Date>2023-09-20</Date>
                                                <Time>11:40</Time>
                                            </Arrival>
                                            <MarketingCarrier>
                                                <AirlineID>S7</AirlineID>
                                                <FlightNumber>1071</FlightNumber>
                                            </MarketingCarrier>
                                            <OperatingCarrier>
                                                <AirlineID>S7</AirlineID>
                                                <FlightNumber>1071</FlightNumber>
                                            </OperatingCarrier>
                                        </Flight>
                                    </OriginDestination>
                                    <FareDetail>
                                        <FareComponent refs="FL1">
                                            <FareBasis>
                                                <FareBasisCode>
                                                    <Code>YBSOW</Code>
                                                </FareBasisCode>
                                                <RBD>Y</RBD>
                                            </FareBasis>
                                        </FareComponent>
                                    </FareDetail>
                                </FlightItem>
                                <Associations>
                                    <Passengers>
                                        <PassengerReferences>SH4</PassengerReferences>
                                    </Passengers>
                                </Associations>
                            </OrderItem>
                        </OrderItems>
                        <Passengers>
                            <Passenger ObjectKey="SH4">
                                <PTC Quantity="1">ADT</PTC>
                                <Name>
                                    <Surname />
                                </Name>
                            </Passenger>
                        </Passengers>
                    </Actions>
                </Reshop>
            </Query>
        </ItinReshopRQ>
    </Body>
</Envelope>



Step 4: Request for reservation pricing

S7 Agent executes a reprice operation with itinerary info of chosen solution

All information must be taken from AirShoppingRS:

  • itinerary details (airport codes and dates for origin and departure, airline code and flight number);

(lightbulb) <FlightItem> block must fill in like in OrderCreateRQ. Each slice is described by the <OriginDestination> element.

  • passenger types (PTC);

  • fare details (RBD and fare code).


<Envelope
	xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header />
    <Body>
        <ItinReshopRQ Version=""
			xmlns="http://www.iata.org/IATA/EDIST">
            <Document />
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>test</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Query>
                <Reshop>
                    <Actions>
                        <ActionType />
                        <BookingReferences>
                            <BookingReference>
                                <ID>LODBFB</ID>
                                <AirlineID>S7</AirlineID>
                            </BookingReference>
                        </BookingReferences>
                        <OrderItems>
                            <OrderItem>
                                <FlightItem>
                                    <OriginDestination>
                                        <Flight>
                                            <SegmentKey>FL1</SegmentKey>
                                            <Departure>
                                                <AirportCode>DME</AirportCode>
                                                <Date>2023-09-20</Date>
                                                <Time>08:55</Time>
                                            </Departure>
                                            <Arrival>
                                                <AirportCode>KUF</AirportCode>
                                                <Date>2023-09-20</Date>
                                                <Time>11:40</Time>
                                            </Arrival>
                                            <MarketingCarrier>
                                                <AirlineID>S7</AirlineID>
                                                <FlightNumber>1071</FlightNumber>
                                            </MarketingCarrier>
                                            <OperatingCarrier>
                                                <AirlineID>S7</AirlineID>
                                                <FlightNumber>1071</FlightNumber>
                                            </OperatingCarrier>
                                        </Flight>
                                    </OriginDestination>
                                    <FareDetail>
                                        <FareComponent refs="FL1">
                                            <FareBasis>
                                                <FareBasisCode>
                                                    <Code>YBSOW</Code>
                                                </FareBasisCode>
                                                <RBD>Y</RBD>
                                            </FareBasis>
                                        </FareComponent>
                                    </FareDetail>
                                </FlightItem>
                                <Associations>
                                    <Passengers>
                                        <PassengerReferences>SH4</PassengerReferences>
                                    </Passengers>
                                </Associations>
                            </OrderItem>
                        </OrderItems>
                        <Passengers>
                            <Passenger ObjectKey="SH4">
                                <PTC Quantity="1">ADT</PTC>
                                <Name>
                                    <Surname />
                                </Name>
                            </Passenger>
                        </Passengers>
                    </Actions>
                </Reshop>
            </Query>
        </ItinReshopRQ>
    </Body>
</Envelope>



Step 5: Request for ancillaries pricing

S7 Agent executes a servicePrice operation with the whole journey details and passenger type list

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>
                <Traveler>
                    <AnonymousTraveler>
                        <PTC Quantity="0">CHD</PTC>
                    </AnonymousTraveler>
                </Traveler>
                <Traveler>
                    <AnonymousTraveler>
                        <PTC Quantity="0">INF</PTC>
                    </AnonymousTraveler>
                </Traveler>
            </Travelers>
            <Query>
                <OriginDestination>
                    <Flight>
                        <SegmentKey>SEG1</SegmentKey>
                        <Departure>
                            <AirportCode>DME</AirportCode>
                            <Date>2024-01-16</Date>
                        </Departure>
                        <Arrival>
                            <AirportCode>LED</AirportCode>
                        </Arrival>
                        <MarketingCarrier>
                            <AirlineID>S7</AirlineID>
                            <FlightNumber>1009</FlightNumber>
                        </MarketingCarrier>
                        <OperatingCarrier>
                            <AirlineID>S7</AirlineID>
                            <FlightNumber>1009</FlightNumber>
                        </OperatingCarrier>
                        <ClassOfService>
                            <Code>Y</Code>
                        </ClassOfService>
                    </Flight>
                </OriginDestination>
            </Query>
            <DataList>
                <FareList>
                    <FareGroup refs="SEG1" ListKey="FG1">
                        <Fare>
                            <FareCode>
                                <Code>BASICECONOMY</Code>
                            </FareCode>
                        </Fare>
                        <FareBasisCode>
                            <Code>YBSOW</Code>
                        </FareBasisCode>
                    </FareGroup>
                </FareList>
            </DataList>
        </ServicePriceRQ>
    </Body>
</Envelope>
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>BASICECONOMY</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">2050</ns3:Total>
                        <ns3:Details>
                            <ns3:Detail>
                                <ns3:Application>discount percent</ns3:Application>
                                <ns3:Amount Code="percent">61.4</ns3:Amount>
                            </ns3:Detail>
                            <ns3:Detail>
                                <ns3:Application>base fare</ns3:Application>
                                <ns3:Amount Code="RUB">5300.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>BASICECONOMY</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">3800.0</ns3:Total>
                        <ns3:Details>
                            <ns3:Detail>
                                <ns3:Application>base fare</ns3:Application>
                                <ns3:Amount Code="RUB">3800.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>BASICECONOMY</ns3:Code>
                            </ns3:FareCode>
                        </ns3:Fare>
                        <ns3:FareBasisCode>
                            <ns3:Code>YBSOW</ns3:Code>
                        </ns3:FareBasisCode>
                    </ns3:FareGroup>
                </ns3:FareList>
                <ns3:FlightSegmentList>
                    <ns3:FlightSegment SegmentKey="SEG1">
                        <ns3:Departure>
                            <ns3:AirportCode>DME</ns3:AirportCode>
                            <ns3:Date>2024-01-16</ns3:Date>
                            <ns3:Time>10:15</ns3:Time>
                        </ns3:Departure>
                        <ns3:Arrival>
                            <ns3:AirportCode>LED</ns3:AirportCode>
                            <ns3:Date>2024-01-16</ns3:Date>
                            <ns3:Time>11:55</ns3:Time>
                        </ns3:Arrival>
                        <ns3:MarketingCarrier>
                            <ns3:AirlineID>S7</ns3:AirlineID>
                            <ns3:FlightNumber>1009</ns3:FlightNumber>
                        </ns3:MarketingCarrier>
                        <ns3:OperatingCarrier>
                            <ns3:AirlineID>S7</ns3:AirlineID>
                            <ns3:FlightNumber>1009</ns3:FlightNumber>
                        </ns3:OperatingCarrier>
                        <ns3:Equipment refs="ML3">
                            <ns3:AircraftCode>73H</ns3:AircraftCode>
                            <ns3:AirlineEquipCode>Boeing 737-800</ns3:AirlineEquipCode>
                        </ns3:Equipment>
                    </ns3:FlightSegment>
                </ns3:FlightSegmentList>
                <ns3:OriginDestinationList>
                    <ns3:OriginDestination OriginDestinationKey="OD1">
                        <ns3:DepartureCode>DME</ns3:DepartureCode>
                        <ns3:ArrivalCode>LED</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/737-800.png</ns3:MediaLink>
                    </ns3:Media>
                </ns3:MediaList>
            </ns3:DataLists>
        </ns3:ServicePriceRS>
    </ns2:Body>
</ns2:Envelope>

Step 6: Issue tickets with EMD for each passenger

S7 Agent executes a demandTickets operation with with reservation reference, baggage codes and pricing details for air and baggage.

  • It is necessary correctly indicate passenger reference (RPH) for whom a ticket is issued. Used passenger SH number from the book operation

Envelope/Body/OrderViewRS/Response/Passengers/Passenger@ObjectKey
  • Add information about PNR from OrderViewRS

Envelope/Body/OrderViewRS/Response/Order/BookingReferences/BookingReference/ID
  • Specify payment object key like "ETK" for ticket and "EMD" for EMD baggage.

  • Fill in the form of payment as in example <*A*TEXT>

(lightbulb) FOP for ETK and EMD must be the same.

  • CheckedBagAllowanceList and FareList data takes from ServicePriceRS

(lightbulb) It is available to buy only 0CC bag, or combination of 0CC and 0CD bag. The only 0CD bag is not available.

  • FlightSegmentList and OriginDestinationList data takes from OrderViewRS


<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
    <Header/>
    <Body>
        <AirDocIssueRQ xmlns="http://www.iata.org/IATA/EDIST" Version="1.0">
            <Document/>
            <Party>
                <Sender>
                    <AgentUserSender>
                        <PseudoCity>S7AGN8224</PseudoCity>
                        <AgentUserID>gaia</AgentUserID>
                    </AgentUserSender>
                </Sender>
            </Party>
            <Query>
                <TicketDocQuantity>1</TicketDocQuantity>
                <TicketDocInfo>
                    <TravelerInfo>
                        <Surname>Pilatus</Surname>
                        <Given>Pontius</Given>
                        <PTC>ADT</PTC>
                    </TravelerInfo>
                    <BookingReference ObjectKey="RPH4">
                        <Type>
                            <Code>14</Code>
                        </Type>
                        <ID> </ID>
                        <AirlineID>S7</AirlineID>
                    </BookingReference>
                    <Payments>
                        <Payment ObjectKey="ETK">
                            <Type>
                                <Code>MS</Code>
                            </Type>
                            <Amount Code="RUB"> </Amount>
                            <Other>
                                <Remarks>
                                    <Remark>*A*TEXT</Remark>
                                </Remarks>
                            </Other>
                        </Payment>
                        <Payment ObjectKey="EMD">
                            <Type>
                                <Code>MS</Code>
                            </Type>
                            <Amount Code="RUB">2050</Amount>
                            <Other>
                                <Remarks>
                                    <Remark>*A*TEXT</Remark>
                                </Remarks>
                            </Other>
                        </Payment>
                    </Payments>
                </TicketDocInfo>
                <DataLists>
                    <CheckedBagAllowanceList>
                        <CheckedBagAllowance refs="FC3" ListKey="BG1">
                            <AllowanceDescription>
                                <ApplicableParty>Traveller</ApplicableParty>
                                <Descriptions>
                                    <Description>
                                        <Text>0CC</Text>
                                    </Description>
                                </Descriptions>
                            </AllowanceDescription>
                        </CheckedBagAllowance>
                    </CheckedBagAllowanceList>
                    <FareList>
                        <FareGroup ListKey="FG3">
                            <Fare>
                                <FareCode>
                                    <Code>ANY</Code>
                                </FareCode>
                                <FareDetail>
                                    <FareComponent ObjectKey="FC3" refs="OD1">
                                        <PriceBreakdown>
                                            <Price>
                                                <BaseAmount Code="RUB">2050</BaseAmount>
                                                <FareFiledIn ObjectKey="DC1">
                                                    <BaseAmount Code="RUB" Taxable="false">5300</BaseAmount>
                                                </FareFiledIn>
                                            </Price>
                                        </PriceBreakdown>
                                        <TicketDesig Application="discount">61.4</TicketDesig>
                                    </FareComponent>
                                </FareDetail>
                            </Fare>
                            <FareBasisCode>
                                <Code>ANY</Code>
                            </FareBasisCode>
                        </FareGroup>
                    </FareList>
                    <FlightSegmentList>
                        <FlightSegment refs="OD1" SegmentKey="SEG1">
                            <Departure>
                                <AirportCode>DME</AirportCode>
                                <Date>2024-01-16</Date>
                                <Time>10:15</Time>
                            </Departure>
                            <Arrival>
                                <AirportCode>LED</AirportCode>
                                <Date>2024-01-16</Date>
                                <Time>11:55</Time>
                            </Arrival>
                            <MarketingCarrier>
                                <AirlineID>S7</AirlineID>
                                <FlightNumber>1009</FlightNumber>
                            </MarketingCarrier>
                            <OperatingCarrier>
                                <AirlineID>S7</AirlineID>
                                <FlightNumber>1009</FlightNumber>
                            </OperatingCarrier>
                        </FlightSegment>
                    </FlightSegmentList>
                    <OriginDestinationList>
                        <OriginDestination OriginDestinationKey="OD1">
                            <DepartureCode>DME</DepartureCode>
                            <ArrivalCode>LED</ArrivalCode>
                            <FlightReferences>SEG1</FlightReferences>
                        </OriginDestination>
                    </OriginDestinationList>
                </DataLists>
            </Query>
        </AirDocIssueRQ>
    </Body>
</Envelope>


<?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:AirDocDisplayRS Version="">
            <ns3:Document>
                <ns3:Name>1.0</ns3:Name>
            </ns3:Document>
            <ns3:Success/>
            <ns3:Response>
                <ns3:TicketDocInfos>
                    <ns3:TicketDocInfo>
                        <ns3:Traveler>
                            <ns3:Surname>PILATUS</ns3:Surname>
                            <ns3:Given>PONTIUS</ns3:Given>
                            <ns3:PTC>ADT</ns3:PTC>
                        </ns3:Traveler>
                        <ns3:IssuingAirlineInfo>
                            <ns3:AirlineName>S7</ns3:AirlineName>
                        </ns3:IssuingAirlineInfo>
                        <ns3:BookingReferences>
                            <ns3:BookingReference>
                                <ns3:ID>LODBFB</ns3:ID>
                                <ns3:AirlineID>S7</ns3:AirlineID>
                            </ns3:BookingReference>
                        </ns3:BookingReferences>
                        <ns3:Payments>
                            <ns3:Payment>
                                <ns3:Method/>
                                <ns3:Amount Code="RUB">31451.0</ns3:Amount>
                            </ns3:Payment>
                        </ns3:Payments>
                        <ns3:OriginDestination>
                            <ns3:Origin>DME</ns3:Origin>
                            <ns3:Destination>KUF</ns3:Destination>
                        </ns3:OriginDestination>
                        <ns3:FareInfo>
                            <ns3:BaseFare>
                                <ns3:Amount Code="RUB">31100.00</ns3:Amount>
                            </ns3:BaseFare>
                            <ns3:EquivFare>
                                <ns3:Amount Code="RUB">31100.00</ns3:Amount>
                            </ns3:EquivFare>
                            <ns3:Total>
                                <ns3:Amount Code="RUB">31451.00</ns3:Amount>
                            </ns3:Total>
                            <ns3:Taxes>
                                <ns3:Total Code="RUB">351.00</ns3:Total>
                                <ns3:Breakdown>
                                    <ns3:Tax>
                                        <ns3:Amount Code="RUB">171.00</ns3:Amount>
                                        <ns3:TaxCode>RI</ns3:TaxCode>
                                    </ns3:Tax>
                                    <ns3:Tax>
                                        <ns3:Amount Code="RUB">180.00</ns3:Amount>
                                        <ns3:TaxCode>RI</ns3:TaxCode>
                                    </ns3:Tax>
                                </ns3:Breakdown>
                            </ns3:Taxes>
                            <ns3:UnstructuredFareCalcInfo>
                                <ns3:Info>MOW S7 KUF31100RUB31100END</ns3:Info>
                            </ns3:UnstructuredFareCalcInfo>
                        </ns3:FareInfo>
                        <ns3:TicketDocument>
                            <ns3:TicketDocNbr>4212104196642</ns3:TicketDocNbr>
                            <ns3:Type>
                                <ns3:Code>702</ns3:Code>
                            </ns3:Type>
                            <ns3:NumberofBooklets>1</ns3:NumberofBooklets>
                            <ns3:DateOfIssue>2023-05-19</ns3:DateOfIssue>
                            <ns3:CouponInfo>
                                <ns3:CouponNumber>1</ns3:CouponNumber>
                                <ns3:FareBasisCode>
                                    <ns3:Code>YBSOW</ns3:Code>
                                </ns3:FareBasisCode>
                                <ns3:CouponValid>
                                    <ns3:EffectiveDatePeriod>
                                        <ns3:Expiration>2024-05-19</ns3:Expiration>
                                    </ns3:EffectiveDatePeriod>
                                </ns3:CouponValid>
                                <ns3:Status>
                                    <ns3:Code>OPEN FOR USE</ns3:Code>
                                </ns3:Status>
                                <ns3:SoldAirlineInfo>
                                    <ns3:Departure>
                                        <ns3:AirportCode>DME</ns3:AirportCode>
                                        <ns3:Date>2023-09-20</ns3:Date>
                                        <ns3:Time>08:55</ns3:Time>
                                    </ns3:Departure>
                                    <ns3:Arrival>
                                        <ns3:AirportCode>KUF</ns3:AirportCode>
                                        <ns3:Date>2023-09-20</ns3:Date>
                                        <ns3:Time>11:40</ns3:Time>
                                    </ns3:Arrival>
                                    <ns3:OperatingCarrier>
                                        <ns3:ResBookDesigCode>Y</ns3:ResBookDesigCode>
                                    </ns3:OperatingCarrier>
                                    <ns3:MarketingCarrier>
                                        <ns3:AirlineID>S7</ns3:AirlineID>
                                        <ns3:FlightNumber>1071</ns3:FlightNumber>
                                    </ns3:MarketingCarrier>
                                    <ns3:TicketedBaggageAllowance>
                                        <ns3:AllowableBag Type="PC" Number="0"/>
                                    </ns3:TicketedBaggageAllowance>
                                </ns3:SoldAirlineInfo>
                            </ns3:CouponInfo>
                        </ns3:TicketDocument>
                        <ns3:TicketDocument>
                            <ns3:TicketDocNbr>4214101872541</ns3:TicketDocNbr>
                            <ns3:Type>
                                <ns3:Code>Y</ns3:Code>
                            </ns3:Type>
                            <ns3:NumberofBooklets>1</ns3:NumberofBooklets>
                            <ns3:DateOfIssue>2023-05-19</ns3:DateOfIssue>
                            <ns3:CouponInfo>
                                <ns3:CouponNumber>1</ns3:CouponNumber>
                                <ns3:Status>
                                    <ns3:Code>ISSUED</ns3:Code>
                                </ns3:Status>
                                <ns3:DateOfService>2023-09-20</ns3:DateOfService>
                                <ns3:Value Code="RUB">3800.00</ns3:Value>
                                <ns3:PresentInfo To="KUF" At="DME"/>
                            </ns3:CouponInfo>
                        </ns3:TicketDocument>
                        <ns3:TicketDocument>
                            <ns3:TicketDocNbr>4214101872540</ns3:TicketDocNbr>
                            <ns3:Type>
                                <ns3:Code>Y</ns3:Code>
                            </ns3:Type>
                            <ns3:NumberofBooklets>1</ns3:NumberofBooklets>
                            <ns3:DateOfIssue>2023-05-19</ns3:DateOfIssue>
                            <ns3:CouponInfo>
                                <ns3:CouponNumber>1</ns3:CouponNumber>
                                <ns3:Status>
                                    <ns3:Code>ISSUED</ns3:Code>
                                </ns3:Status>
                                <ns3:DateOfService>2023-09-20</ns3:DateOfService>
                                <ns3:Value Code="RUB">3800.00</ns3:Value>
                                <ns3:PresentInfo To="KUF" At="DME"/>
                            </ns3:CouponInfo>
                        </ns3:TicketDocument>
                        <ns3:Commission>
                            <ns3:Amount>0</ns3:Amount>
                            <ns3:Remarks>
                                <ns3:Remark>S7/NON-REF/CHNG/RESTR/BS</ns3:Remark>
                                <ns3:Remark>INCL VAT 2859.18RUB</ns3:Remark>
                                <ns3:Remark>2023-05-19T19:06</ns3:Remark>
                            </ns3:Remarks>
                        </ns3:Commission>
                        <ns3:PassengerSpecificData>111111111</ns3:PassengerSpecificData>
                    </ns3:TicketDocInfo>
                </ns3:TicketDocInfos>
            </ns3:Response>
        </ns3:AirDocDisplayRS>
    </ns2:Body>
</ns2:Envelope>
  • No labels