OptionalService ServiceStatus

[yatinmistry]

Hello,

1. I need list of all possible ServiceStatus availbale in Optional Services with their details. When i booking flight with AirCreateReservationReq with OptionalServices, i get OptionalServies response in AirCreateReservationRes with ServiceStatus. with status "Offered". So wanted know when optional service booked, pending, any error etc..? Need all details of all statuses.
2. In response some optional service, i don't get SSRCode . Check 1,2,3 <air:OptionalService tag. Please check attached AirCreateReservationRes.
3. Also Check Warnings in response. Why these optional services failed ? And How to identify the failed OptionalService statuses in proper format as warning is coming in textual format.

Thanks, Yatin Mistry

AirCreateReservationRes_07735Y.txt

[yatinmistry]

Awaiting for reply.

[vivekjyotipramanik]

Hi Yatin,

Please find below the comments regarding your questions. Please let me know how it goes. Thanks.

1. I need list of all possible ServiceStatus availbale in Optional Services with their details. When i booking flight with AirCreateReservationReq with OptionalServices, i get OptionalServies response in AirCreateReservationRes with ServiceStatus. with status "Offered". So wanted know when optional service booked, pending, any error etc..? Need all details of all statuses.

ServiceStatus can be of these categories, Offered - This generally indicates the Segment offers the Optional Service. Priced - Once the Offered Optional Service is priced through AirPriceReq, on successful pricing it will become part of the AirPriceInfo and can be booked directly using AirCreateReservationReq. Confirmed/Fulfilled - Once the Optional Service is booked through AirCreateReservationReq or AirMerchandisingfulfillmentReq, On successful booking this status will show. Fulfilled - If the OptionalService returns an ASVC SSR in KD status, then the EMDIssuanceReq is required to fulfill the OptionalService and in that scenario, on successful EMDIssuance, Fulfilled status will show. Canceled - Once the booked OptionalService is cancelled.

1. In response some optional service, i don't get SSRCode . Check 1,2,3 <air:OptionalService tag. Please check attached AirCreateReservationRes.

Depdending on the OptionalService and off course the Airline/Carrier the SSR Code might or might not come in the response.

1. Also Check Warnings in response. Why these optional services failed ? And How to identify the failed OptionalService statuses in proper format as warning is coming in textual format.

Please find below the link which list the OptionalServices errors. Please look for 'Show OptionalService Errors' as there is no direct link from the pages listed below.

    When the request is sent and multiple Universal Records exist.

    Multiple Universal Records present. All air segments must be in one Universal Record for Merchandising optional services to be returned.
    When the request is sent and a PNR cannot be retrieved.

    Unable to retrieve reservation for Provider [Provider Code].
    When the request is sent and a Universal Record cannot be imported.

    Unable to Import PNR for Provider [Provider Code].
    When the request is sent without OptionalSerivce @SSRFreeText and free text is required by the carrier for the optional service.

    Merchandising request unsuccessful - please retrieve UR/PNR, check status and report issue immediately [Carrier Code] - Free text is required for this type of SSR [SSR Code]

https://support.travelport.com/webhelp/uapi/uAPI.htm#Air/Air_Pricing/Air_Pricing_for_Optional_Services.htm%3FTocPath%3DAir%7CAir%2520Shopping%2520and%2520Booking%7CAir%2520Pricing%7C_____2

https://support.travelport.com/webhelp/uapi/uAPI.htm#Standalone_Merchandising/Fulfillment/Air_Merchandising_Fulfillment.htm%3FTocPath%3DAir%7CAir%2520Merchandising%7CAir%2520Merchandising%2520Fulfillment%2520Overview%7C_____1

Thanks & Regards Vivekjyoti Pramanik

[yatinmistry]

Unable to get below point :

Fulfilled - If the OptionalService returns an ASVC SSR in KD status, then the EMDIssuanceReq is required to fulfill the OptionalService and in that scenario, on successful EMDIssuance, Fulfilled status will show.

For booking optional services our api flow is as below, LowFareSearchReq -> AirPriceReq -> AirCreateReservationReq Please confirm Optional Service Booking flow. Are we going in right flow or we have to do any other api in between LowFareSearchReq and AirCreateReservationReq.

Thanks, Yatin Mistry

[vivekjyotipramanik]

Hi Yatin,

For booking optionalServices as part of AirCreate or Pre-Boooking Flow, the procedure is LowFareSearchReq -> AirPriceReq -> AirPriceReq (with Optional Services) - > AirCreateReservationReq. Please find below the sample and details regarding this. Please let me know how it goes. Thanks.

https://support.travelport.com/webhelp/uapi/uAPI.htm#SampleWeb/Individual_Sample_Pages/044-ACH_Air_LFS-AC_OptSvce-Meals.htm%3FTocPath%3DGetting%2520Started%7CSamples%7CXML%2520Samples%2520%7CAir%7CAir%2520Workflows%7CAirline%2520Content%2520Hub%2520(ACH)%2520Workflows%7C_____6

https://support.travelport.com/webhelp/uapi/uAPI.htm#Standalone_Merchandising/Air_Merchandising_Process_Flow.htm%3FTocPath%3DAir%7CAir%2520Merchandising%7C_____1

Thanks & Regards Vivekjyoti Pramanik