AirDocIssue

AirDocIssue

Ticket issuance.

Request

  • AirDocIssueRQ - ticketing request. Data type - custom.
  • AirDocIssueRQ.Document - common elements.
  • AirDocIssueRQ.Party - common elements.
  • AirDocIssueRQ.Query - contents of the request (required). Data type - custom.
  • Query.TicketDocQuantity - number of tickets needed to be issued (required). Data type - positive integer.
  • Query.TicketDocInfo - information about the order needed to be issued (required). Data type - custom.
  • TicketDocInfo.PassengerReference - reference to the passenger in DataLists.PassengerList (required). If there are several passengers in the order, then a separate TicketDocInfo is formed for each passenger.
  • TicketDocInfo.OrderReference - contains the order ID (required). Data type - custom.
  • TicketDocInfo.OrderReference.OrderID - unique order ID. Owner attribute contains the owner of the order (GDS code). Element and attribute required.
  • TicketDocInfo.Payments - payment information (optional), accepts a collection of items. Payment information must be specified only in the first TicketDocInfo element, data from other TicketDocInfo is ignored. It is possible to set several payment methods.
  • TicketDocInfo.Payments.Payment - detailed payment information (required). Data type - custom.
  • TicketDocInfo.Payments.Payment.Type - payment type (required). Depending on it, a number of elements of the Method block change. The following are the possible values:
    • CA - Cash.
      <ns:Method>
      <ns:Cash CashInd="true"/>
      </ns:Method>
    • CC - Credit card.
      <ns:Method>
      <ns:PaymentCard>
      <ns:CardCode>VI</ns:CardCode>
      <ns:CardNumber>4111111111111111</ns:CardNumber>                       
      <ns:EffectiveExpireDate>
      <ns:Expiration>2020-10</ns:Expiration>
      </ns:EffectiveExpireDate>
      </ns:PaymentCard>
      </ns:Method>
    • CK - Check.
      <ns:Method>
      <ns:Check/>
      </ns:Method>
    • MS - Mescellaneous.
      <ns:Method>
      <ns:Voucher>
      <ns:Number>XYZ123</ns:Number>
      </ns:Voucher>
      </ns:Method>
  • TicketDocInfo.Payments.Payment.Amount - payment amount (required). The element includes two attributes:
    • Code - currency code, data type - string.
    • Taxable - taxable, data type - boolean.
  • TicketDocInfo.Payments.Payment.Order - The OrderID attribute of the Order element containing the order ID. Element and attribute required.
  • TicketDocInfo.Commission - commission information (optional). The element must contain either an absolute value or a percentage. Commission information should be set only in the first TicketDocInfo element, data from other TicketDocInfo is ignored. Data type - custom.
  • Commission.Amount - absolute value of the commission. Data type - decimal.
  • Commission.Percentage - commission in percent. Data type - decimal.
  • Query.DataLists - contains passenger data (required). Data type - custom.
  • DataLists.PassengerList - information about passengers for whom an order is being created (required). Data type - custom.
  • PassengerList.Passenger - PassengerID attribute containing a unique passenger ID (required).
Sample
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:avi="http://websky.travel/AviaNDC" xmlns:ns="http://www.iata.org/IATA/EDIST/2017.2">
    <soapenv:Header>
        <avi:UserID> *** </avi:UserID>
        <avi:Requisites>
            <avi:Login> *** </avi:Login>
            <avi:Password> *** </avi:Password>
            <avi:UserContextId> *** </avi:UserContextId>
        </avi:Requisites>
    </soapenv:Header>
    <soapenv:Body>
        <ns:AirDocIssueRQ Version="17.2">
            <ns:Document>
                <ns:Metadata/>
                <ns:Name>NDC GATEWAY</ns:Name>
                <ns:ReferenceVersion>1.0</ns:ReferenceVersion>
            </ns:Document>
            <ns:Party>
                <ns:Sender>
                    <ns:TravelAgencySender>
                        <ns:AgencyID> *** </ns:AgencyID>
                    </ns:TravelAgencySender>
                </ns:Sender>
            </ns:Party>
            <ns:Query>
                <ns:TicketDocQuantity>2</ns:TicketDocQuantity>
                <ns:TicketDocInfo>
                    <ns:PassengerReference>PAX1</ns:PassengerReference>
                    <ns:OrderReference>
                        <ns:OrderID Owner="1W">ORD610158</ns:OrderID>
                    </ns:OrderReference>
                    <ns:Payments>
                        <ns:Payment>
                            <ns:Type>CA</ns:Type>
                            <ns:Method>
                                <ns:Cash CashInd="true"/>
                            </ns:Method>
                            <ns:Amount Code="USD" Taxable="false">112.7</ns:Amount>
                            <ns:Order OrderID="ORD610158" Owner="1A"/>
                        </ns:Payment>
                    </ns:Payments>
                    <ns:Commission>
                        <ns:Percentage>1</ns:Percentage>    
                    </ns:Commission>
                </ns:TicketDocInfo>
                <ns:TicketDocInfo>
                    <ns:PassengerReference>PAX2</ns:PassengerReference>
                </ns:TicketDocInfo>
                <ns:DataLists>
                    <ns:PassengerList>
                        <ns:Passenger PassengerID="PAX1">
                            <ns:PTC>ADT</ns:PTC>
                        </ns:Passenger>
                        <ns:Passenger PassengerID="PAX2">
                            <ns:PTC>CHD</ns:PTC>
                        </ns:Passenger>
                    </ns:PassengerList>
                </ns:DataLists>
            </ns:Query>
        </ns:AirDocIssueRQ>
    </soapenv:Body>
</soapenv:Envelope>

Response

In general, the contents of the order check response correspond to the response OrderCreate, with the exception of the element describing electronic documents.

  • OrderViewRS.Response.TicketDocInfos - information about electronic documents. Data type - array.
  • TicketDocInfos.TicketDocInfo - information about electronic documents (required). Data type - custom.
  • TicketDocInfos.TicketDocInfo.TicketDocument - electronic document (ticket, EMD). Data type - custom. Element is optional.
  • TicketDocInfos.TicketDocInfo.TicketDocument.TicketDocNbr - electronic document number. Data type - string.
  • TicketDocInfos.TicketDocInfo.TicketDocument.Type - electronic document type. Data type - string. Possible values:
    • T - Ticket;
    • J - EMD A;
    • Y - EMD S;
    • 700 - Other document;
  • TicketDocInfos.TicketDocInfo.TicketDocument.NumberofBooklets - number of tickets issued for this passenger. Data type - integer.
  • TicketDocInfos.TicketDocInfo.TicketDocument.DateOfIssue - discharge date in the format yyyy-mm-dd.
  • TicketDocInfos.TicketDocInfo.TicketDocument.TimeOfIssue - discharge time in hh:mm format.
  • TicketDocInfos. TicketDocInfo. TicketDocument. ReportingType - type of ticketing contract (BSP, ARC, Airline).
  • TicketDocInfos.TicketDocInfo.PassengerReference - reference to the passenger to whom the ticket corresponds.
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
    <s:Header>
        <h:ResponseID xmlns:h="http://websky.travel/AviaNDC" xmlns="http://websky.travel/AviaNDC">143982731</h:ResponseID>
    </s:Header>
    <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
        <OrderViewRS Target="Prod" Version="17.2" xmlns="http://www.iata.org/IATA/EDIST/2017.2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.iata.org/IATA/EDIST/2017.2">
            <Document>
                <Name>NDC GATEWAY</Name>
                <ReferenceVersion>1.0</ReferenceVersion>
            </Document>
            <Party>
                <Sender>
                    <TravelAgencySender>
                        <Contacts>
                            <Contact>
                                <PhoneContact>
                                    <Number>7927000722</Number>
                                </PhoneContact>
                            </Contact>
                        </Contacts>
                        <AgencyID> *** </AgencyID>
                        <AgentUser>
                            <OtherIDs>
                                <OtherID Description="Source"> *** </OtherID>
                            </OtherIDs>
                            <AgentUserID> *** </AgentUserID>
                        </AgentUser>
                    </TravelAgencySender>
                </Sender>
                <Participants xsi:nil="true"/>
                <Recipient xsi:nil="true"/>
            </Party>
            <Success/>
            <Warnings>
                <Warning Code="1">Text</Warning>
            </Warnings>
            <Response>
                <Order OrderID="ORD610158" Owner="1W">
                    <BookingReferences>
                        <BookingReference>
                            <ID>TRJPCT</ID>
                            <AirlineID>SU</AirlineID>
                        </BookingReference>
                    </BookingReferences>
                    <TotalOrderPrice>
                        <SimpleCurrencyPrice Code="USD" Taxable="false">112.7</SimpleCurrencyPrice>
                    </TotalOrderPrice>
                    <TimeLimits>
                        <PaymentTimeLimit DateTime="2018-11-14T07:59:00+03:00"/>
                    </TimeLimits>
                    <OrderItems>
                        <OrderItem OrderItemID="ORI1" Owner="ZZ">
                            <ItemStatus>T</ItemStatus>
                            <PriceDetail>
                                <TotalAmount>
                                    <SimpleCurrencyPrice Code="USD" Taxable="false">112.7</SimpleCurrencyPrice>
                                </TotalAmount>
                                <BaseAmount Code="USD" Taxable="false">44</BaseAmount>
                                <Taxes>
                                    <Total Code="USD" Taxable="false">68.7</Total>
                                </Taxes>
                            </PriceDetail>
                            <Service ServiceID="SVC1">
                                <PassengerRef>PAX1</PassengerRef>
                                <SegmentRef>SEG0</SegmentRef>
                            </Service>
                            <Service ServiceID="SVC2">
                                <PassengerRef>PAX2</PassengerRef>
                                <SegmentRef>SEG0</SegmentRef>
                            </Service>
                            <Service ServiceID="SVC3">
                                <PassengerRef>PAX1</PassengerRef>
                                <ServiceDefinitionRef SegmentRef="SEG0">SVD1</ServiceDefinitionRef>
                            </Service>
                            <Service ServiceID="SVC4">
                                <PassengerRef>PAX2</PassengerRef>
                                <ServiceDefinitionRef SegmentRef="SEG0">SVD1</ServiceDefinitionRef>
                            </Service>
                            <FareDetail>
                                <PassengerRefs>PAX1</PassengerRefs>
                                <Price>
                                    <TotalAmount>
                                        <SimpleCurrencyPrice Code="USD" Taxable="false">60.4</SimpleCurrencyPrice>
                                    </TotalAmount>
                                    <BaseAmount Code="USD" Taxable="false">25</BaseAmount>
                                    <FareFiledIn>
                                        <BaseAmount Code="EUR" Taxable="false">16</BaseAmount>
                                    </FareFiledIn>
                                    <Taxes ApproxInd="false">
                                        <Total Code="USD" Taxable="false">35.4</Total>
                                        <Breakdown>
                                            <Tax>
                                                <Amount Code="USD" Taxable="false">31.2</Amount>
                                                <TaxCode>YQ</TaxCode>
                                            </Tax>
                                            <Tax>
                                                <Amount Code="USD" Taxable="false">4.2</Amount>
                                                <TaxCode>RI</TaxCode>
                                            </Tax>
                                        </Breakdown>
                                    </Taxes>
                                </Price>
                                <FareComponent>
                                    <FareBasis>
                                        <FareBasisCode>
                                            <Code>NVOR</Code>
                                        </FareBasisCode>
                                        <RBD>N</RBD>
                                        <CabinType>
                                            <CabinTypeCode>Y</CabinTypeCode>
                                            <CabinTypeName>Economy</CabinTypeName>
                                        </CabinType>
                                    </FareBasis>
                                    <PriceClassRef>PRC1</PriceClassRef>
                                    <SegmentRefs>SEG0</SegmentRefs>
                                </FareComponent>
                            </FareDetail>
                            <FareDetail>
                                <PassengerRefs>PAX2</PassengerRefs>
                                <Price>
                                    <TotalAmount>
                                        <SimpleCurrencyPrice Code="USD" Taxable="false">52.3</SimpleCurrencyPrice>
                                    </TotalAmount>
                                    <BaseAmount Code="USD" Taxable="false">19</BaseAmount>
                                    <FareFiledIn>
                                        <BaseAmount Code="EUR" Taxable="false">12</BaseAmount>
                                    </FareFiledIn>
                                    <Taxes ApproxInd="false">
                                        <Total Code="USD" Taxable="false">33.3</Total>
                                        <Breakdown>
                                            <Tax>
                                                <Amount Code="USD" Taxable="false">31.2</Amount>
                                                <TaxCode>YQ</TaxCode>
                                            </Tax>
                                            <Tax>
                                                <Amount Code="USD" Taxable="false">2.1</Amount>
                                                <TaxCode>RI</TaxCode>
                                            </Tax>
                                        </Breakdown>
                                    </Taxes>
                                </Price>
                                <FareComponent>
                                    <FareBasis>
                                        <FareBasisCode>
                                            <Code>NVOR/CH25</Code>
                                        </FareBasisCode>
                                        <RBD>N</RBD>
                                        <CabinType>
                                            <CabinTypeCode>Y</CabinTypeCode>
                                            <CabinTypeName>Economy</CabinTypeName>
                                        </CabinType>
                                    </FareBasis>
                                    <PriceClassRef>PRC1</PriceClassRef>
                                    <SegmentRefs>SEG0</SegmentRefs>
                                </FareComponent>
                            </FareDetail>
                        </OrderItem>
                    </OrderItems>
                </Order>
                <TicketDocInfos>
                    <TicketDocInfo>
                        <TicketDocument>
                            <TicketDocNbr>5557208883536</TicketDocNbr>
                            <Type>T</Type>
                            <NumberofBooklets>1</NumberofBooklets>
                            <DateOfIssue>2018-11-06</DateOfIssue>
                            <TimeOfIssue>17:11</TimeOfIssue>
                            <ReportingType>BSP</ReportingType>
                        </TicketDocument>
                        <PassengerReference>PAX1</PassengerReference>
                    </TicketDocInfo>
                    <TicketDocInfo>
                        <TicketDocument>
                            <TicketDocNbr>5557208883537</TicketDocNbr>
                            <Type>T</Type>
                            <NumberofBooklets>1</NumberofBooklets>
                            <DateOfIssue>2018-11-06</DateOfIssue>
                            <TimeOfIssue>17:11</TimeOfIssue>
                            <ReportingType>BSP</ReportingType>
                        </TicketDocument>
                        <PassengerReference>PAX2</PassengerReference>
                    </TicketDocInfo>
                </TicketDocInfos>
                <DataLists>
                    <PassengerList>
                        <Passenger PassengerID="PAX1">
                            <PTC>ADT</PTC>
                            <CitizenshipCountryCode>US</CitizenshipCountryCode>
                            <Individual>
                                <Birthdate>1980-01-01</Birthdate>
                                <Gender>Male</Gender>
                                <GivenName>ALEX</GivenName>
                                <Surname>BROWN</Surname>
                            </Individual>
                            <IdentityDocument>
                                <IdentityDocumentNumber>199999991</IdentityDocumentNumber>
                                <IdentityDocumentType>PT</IdentityDocumentType>
                                <IssuingCountryCode>US</IssuingCountryCode>
                                <ExpiryDate>2039-08-15</ExpiryDate>
                            </IdentityDocument>
                            <ContactInfoRef>CTC1</ContactInfoRef>
                        </Passenger>
                        <Passenger PassengerID="PAX2">
                            <PTC>CHD</PTC>
                            <CitizenshipCountryCode>US</CitizenshipCountryCode>
                            <Individual>
                                <Birthdate>2010-02-02</Birthdate>
                                <Gender>Female</Gender>
                                <GivenName>ALEXA</GivenName>
                                <Surname>BROWN</Surname>
                            </Individual>
                            <IdentityDocument>
                                <IdentityDocumentNumber>2999999992</IdentityDocumentNumber>
                                <IdentityDocumentType>PT</IdentityDocumentType>
                                <IssuingCountryCode>US</IssuingCountryCode>
                                <ExpiryDate>2021-01-01</ExpiryDate>
                            </IdentityDocument>
                        </Passenger>
                    </PassengerList>
                    <ContactList>
                        <ContactInformation ContactID="CTC1">
                            <ContactProvided>
                                <Phone>
                                    <Label>Mobile</Label>
                                    <PhoneNumber>7813111231234</PhoneNumber>
                                </Phone>
                            </ContactProvided>
                            <ContactProvided>
                                <EmailAddress>
                                    <EmailAddressValue>[email protected]</EmailAddressValue>
                                </EmailAddress>
                            </ContactProvided>
                        </ContactInformation>
                    </ContactList>
                    <BaggageAllowanceList>
                        <BaggageAllowance BaggageAllowanceID="BAG1">
                            <BaggageCategory>Checked</BaggageCategory>
                            <AllowanceDescription Concept="N">
                                <ApplicableParty>Traveler</ApplicableParty>
                                <Descriptions>
                                    <Description>
                                        <Text>Free baggage</Text>
                                    </Description>
                                </Descriptions>
                            </AllowanceDescription>
                            <PieceAllowance>
                                <ApplicableParty>Traveler</ApplicableParty>
                                <TotalQuantity>1</TotalQuantity>
                                <PieceMeasurements Quantity="1"/>
                            </PieceAllowance>
                        </BaggageAllowance>
                    </BaggageAllowanceList>
                    <FlightSegmentList>
                        <FlightSegment SegmentKey="SEG0" ElectronicTicketInd="true">
                            <Departure>
                                <AirportCode>ALA</AirportCode>
                                <Date>2018-12-12</Date>
                                <Time>09:05</Time>
                                <Terminal>
                                    <Name>1</Name>
                                </Terminal>
                            </Departure>
                            <Arrival>
                                <AirportCode>NQZ</AirportCode>
                                <Date>2018-12-12</Date>
                                <Time>10:30</Time>
                                <Terminal>
                                    <Name>1</Name>
                                </Terminal>
                            </Arrival>
                            <MarketingCarrier>
                                <AirlineID>ZZ</AirlineID>
                                <FlightNumber>12</FlightNumber>
                            </MarketingCarrier>
                            <OperatingCarrier>
                                <AirlineID>ZZ</AirlineID>
                                <FlightNumber>12</FlightNumber>
                            </OperatingCarrier>
                            <Equipment>
                                <AircraftCode>320</AircraftCode>
                            </Equipment>
                            <ClassOfService>
                                <Code>N</Code>
                            </ClassOfService>
                            <FlightDetail>
                                <FlightDuration>
                                    <Value>PT1H25M</Value>
                                </FlightDuration>
                            </FlightDetail>
                        </FlightSegment>
                    </FlightSegmentList>
                    <FlightList>
                        <Flight FlightKey="FLT0">
                            <SegmentReferences>SEG0</SegmentReferences>
                        </Flight>
                    </FlightList>
                    <PriceClassList>
                        <PriceClass PriceClassID="PRC1">
                            <Name>ECOMONY</Name>
                        </PriceClass>
                    </PriceClassList>
                    <ServiceDefinitionList>
                        <ServiceDefinition ServiceDefinitionID="SVD1">
                            <Name>Free baggage</Name>
                            <BaggageAllowanceRef>BAG1</BaggageAllowanceRef>
                            <Descriptions>
                                <Description>
                                    <Text>Free baggage</Text>
                                </Description>
                            </Descriptions>
                        </ServiceDefinition>
                    </ServiceDefinitionList>
                </DataLists>
            </Response>
        </OrderViewRS>
    </s:Body>
</s:Envelope>