Travelport / travelport-uapi-tutorial-php

The travelport-uapi-tutorial-php is a PHP project for Universal API that will help you connect and code a standard workflow including Air, Vehicle, and Hotel.
35 stars 47 forks source link

Clarification on ActionStatus in AirCreateReservationReq #226

Open zhanfoo13 opened 5 years ago

zhanfoo13 commented 5 years ago

Hi, i am trying to create the request body of the AirCreateReservation. The following parameter

Question: When set TTL (in AirCreate), we will set date time. Is it OK to set current date/time? Or better with 1 or 2 minutes later? Will it be treated as expired if we put current date/time? This is because, Additional system-generated statuses that cannot be modified indicate that TLCXL, where PNR is canceled by TTL. Indicates that the TTL time expired for the PNR, and the system automatically canceled the air segments (AirSegment). What specifically is TicketDate referring to and what are suggested values?

vivekjyotipramanik commented 5 years ago

Hi zhanfoo13,

TicketDate means , the user must ticket the booking within that time, otherwise the booking will be cancelled and released from hold. To confirm the booking and get the E-ticket number you have to execute the AirTicketingReq within the time frame of ticketing date.

Example, The Ticket Date is Current Date & Time + 24 hours. This means the user has to complete the ticketing within 24 hours otherwise, the booking will be released.

Having said that, it is completely should be based on your requirement. You can add 2 minutes or 2 days to the current date and time and it should be still fine. Thanks.

https://support.travelport.com/webhelp/uapi/uapi.htm#Air/Shared_Air_Topics/Action_Status.htm?Highlight=TicketDate

zhanfoo13 commented 5 years ago

Thanks for this!! Is there a difference between setting ActionStatus to TAW or TTL? Noticed in the documentation that there is no difference and both tickets wont be automatically issued. However, noticed that we hit an error everytime we set it to TTL.

Based on the documentation "...Typically, the 'TTL' value is preferred so that the PNR will be canceled automatically if there is a problem or if it is never ticketed...", when will the PNR auto cancel?

vivekjyotipramanik commented 5 years ago

Hi zhanfoo13,

The PNR will be auto-cancelled after the time & Date defined in the TicketDate attribute is passed, Until then the Booking will stay active on hold. The only major difference between TAW and TTL is that with TAW it will be placed in a ticketing queue. If you are facing some issue with TTL , please share the request and response xml. Thanks.

umer-fa commented 2 years ago

can anyone help me i am unable to book air ticket please solve my this issue `<?xml version="1.0"?> <AirCreateReservationReq xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" TargetBranch="P105159" RetainReservation="Both">

<BookingTraveler Key="gr8AVWGCR064r57Jt0+8bA==" TravelerType="ADT" Gender="M" Nationality="US" xmlns="http://www.travelport.com/schema/common_v50_0">
    <BookingTravelerName Prefix="Mr" First="Jack" Last="Smith"/>
    <DeliveryInfo>
        <ShippingAddress>
            <AddressName>Home</AddressName>
            <Street>2914 N. Dakota Avenue</Street>
            <City>Denver</City>
            <State>CO</State>
            <PostalCode>80206</PostalCode>
            <Country>US</Country>
        </ShippingAddress>
    </DeliveryInfo>
    <PhoneNumber Location="DEN" CountryCode="1" AreaCode="303" Number="3333333"/>
    <Email Type="Home" EmailID="test@travelport.com"/>
    <SSR SegmentRef="NKG05RAqWDKAPNWCAAAAAA==" Type="DOCS" Status="HK"
         FreeText="P/US/F1234567/US/11Sep92/M/11Sep22/Smith/Jack" Carrier="WE"/>
    <Address>
        <AddressName>Home</AddressName>
        <Street>2914 N. Dakota Avenue</Street>
        <City>Denver</City>
        <State>CO</State>
        <PostalCode>80206</PostalCode>
        <Country>US</Country>
    </Address>
</BookingTraveler>
<BookingTraveler Key="8s04Fns2SiizjV5Zn7T6Xw==" TravelerType="ADT" Gender="F" Nationality="US" xmlns="http://www.travelport.com/schema/common_v50_0">
    <BookingTravelerName Prefix="Ms" First="Mary" Last="Smith"/>
    <PhoneNumber Location="DEN" CountryCode="1" AreaCode="303" Number="3333333"/>
    <Email Type="Home" EmailID="test@travelport.com"/>
    <SSR SegmentRef="NKG05RAqWDKAPNWCAAAAAA==" Type="DOCS" Status="HK" FreeText="P/US/F1234567/US/11Sep00/F/11Sep22/Smith/Mary" Carrier="WE"/>
</BookingTraveler>
<ContinuityCheckOverride Key="1T" xmlns="http://www.travelport.com/schema/common_v50_0">true
</ContinuityCheckOverride>
<FormOfPayment Type="Cash" Key="jwt2mcK1Qp27I2xfpcCtAw==" xmlns="http://www.travelport.com/schema/common_v50_0"/>
<AirPricingSolution Key="NKG05RAqWDKARNWCAAAAAA==" TotalPrice="AUD74.50" BasePrice="THB1565"
                    ApproximateTotalPrice="AUD74.50" ApproximateBasePrice="AUD70.00" Taxes="AUD4.50"
                    ApproximateTaxes="AUD4.50" xmlns="http://www.travelport.com/schema/air_v50_0">
    <AirSegment Key="NKG05RAqWDKAPNWCAAAAAA==" AvailabilitySource="A" Equipment="32S"
                AvailabilityDisplayType="Fare Specific Fare Quote Unbooked" Group="0" Carrier="WE"
                FlightNumber="110" Origin="BKK" Destination="CNX" DepartureTime="2020-09-21T13:10:00.000+07:00"
                ArrivalTime="2020-09-21T14:20:00.000+07:00" FlightTime="70" TravelTime="70" Distance="365"
                ProviderCode="1G" ParticipantLevel="Secure Sell"
                PolledAvailabilityOption="O and D cache or polled status used with different local status"
                ClassOfService="W"/>
    <AirPricingInfo LatestTicketingTime="2020-09-21T23:59:00.000+10:00" PricingMethod="Guaranteed"
                    BasePrice="THB1565" Key="NKG05RAqWDKATNWCAAAAAA==" TotalPrice="AUD74.50"
                    ApproximateTotalPrice="AUD74.50" ApproximateBasePrice="AUD70.00" Taxes="AUD4.50"
                    ProviderCode="1G">
        <FareInfo EffectiveDate="2020-09-11T13:53:00.000+10:00" Amount="AUD70.00" Destination="CNX" Origin="BKK"
                  PassengerTypeCode="ADT" FareBasis="W03MTH" Key="NKG05RAqWDKAVNWCAAAAAA==">
            <Endorsement Value="NONEND/NO PARTIAL REFUND/" xmlns="http://www.travelport.com/schema/common_v50_0"/>
            <Endorsement Value="CHANGE OR UPGRADE" xmlns="http://www.travelport.com/schema/common_v50_0"/>
            <Endorsement Value="CONDITIONS AND FEE" xmlns="http://www.travelport.com/schema/common_v50_0"/>
            <Endorsement Value="APPLY BY SECTOR AND BY RBD" xmlns="http://www.travelport.com/schema/common_v50_0"/>
            <FareRuleKey FareInfoRef="NKG05RAqWDKAVNWCAAAAAA==" ProviderCode="1G">
                6UUVoSldxwhMXvW9Bbok3sbKj3F8T9EyxsqPcXxP0TLGyo9xfE/RMsuWFfXVd1OAly5qxZ3qLwOXLmrFneovA5cuasWd6i8Dly5qxZ3qLwOXLmrFneovA/I8g8djrfLlxWa1uaqI55k3aSkvhp2ybfQACAOt7X0oVoe2ctv4NGRSD5QULEHOHYMuExxiKq91cJajOBEKqiLmvg3OtVhcszvQIlbeGa6Ahf6E18cRejF6+WRr8tqYPG4ErTU7tBAv3C2h2AWMhtJW8vSBNa8ZUmwC02UUzMsnhMzrhOa9evWGjBBfStP1HWLkBcYKI+Vxv4Xvb2u1Qx+/he9va7VDH7+F729rtUMfv4Xvb2u1Qx+/he9va7VDHzQapDbCAMr/TUGWlPDKj6v0aMBFljDuP9NE5OQYAbQxKSytXAIyNVDGIymxJ1+EOYRYMwQ757LHjsx/lPEQhh4=
            </FareRuleKey>
        </FareInfo>
        <BookingInfo BookingCode="W" CabinClass="Economy" FareInfoRef="NKG05RAqWDKAVNWCAAAAAA=="
                     SegmentRef="NKG05RAqWDKAPNWCAAAAAA=="/>
        <TaxInfo Amount="AUD4.50" Category="TS" Key="NKG05RAqWDKAUNWCAAAAAA=="/>
        <FareCalc>BKK WE CNX Q10.00 39.79W03MTH NUC49.79END ROE31.41172</FareCalc>
        <PassengerType Code="ADT" BookingTravelerRef="gr8AVWGCR064r57Jt0+8bA=="/>
        <ChangePenalty>
            <Amount>AUD22.00</Amount>
        </ChangePenalty>
        <AirPricingModifiers>
            <ManualFareAdjustment AppliedOn="Base" AdjustmentType="Amount" Value="40"
                                  PassengerRef="gr8AVWGCR064r57Jt0+8bA=="/>
        </AirPricingModifiers>
        <BaggageAllowances>
            <BaggageAllowanceInfo Origin="BKK" Destination="CNX" Carrier="WE" TravelerType="ADT">
                <URLInfo>
                    <URL>VIEWTRIP.TRAVELPORT.COM/BAGGAGEPOLICY/WE</URL>
                </URLInfo>
                <TextInfo>
                    <Text>20K</Text>
                    <Text>BAGGAGE DISCOUNTS MAY APPLY BASED ON FREQUENT FLYER STATUS/ ONLINE CHECKIN/FORM OF
                        PAYMENT/MILITARY/ETC.
                    </Text>
                </TextInfo>
                <BagDetails ApplicableBags="1stChecked">
                    <BaggageRestriction>
                        <TextInfo>
                            <Text>CHGS MAY APPLY IF BAGS EXCEED TTL WT ALLOWANCE</Text>
                        </TextInfo>
                    </BaggageRestriction>
                </BagDetails>
                <BagDetails ApplicableBags="2ndChecked">
                    <BaggageRestriction>
                        <TextInfo>
                            <Text>CHGS MAY APPLY IF BAGS EXCEED TTL WT ALLOWANCE</Text>
                        </TextInfo>
                    </BaggageRestriction>
                </BagDetails>
            </BaggageAllowanceInfo>
            <CarryOnAllowanceInfo Origin="BKK" Destination="CNX" Carrier="WE"/>
        </BaggageAllowances>
    </AirPricingInfo>
</AirPricingSolution>
<ActionStatus Type="TAW" TicketDate="2020-09-21T23:59:00.000+10:00" ProviderCode="1G"
              xmlns="http://www.travelport.com/schema/common_v50_0"/>

`