5.4.0 to 6.1.0
What's New
There is a new REST endpoint version of the service, offering the same functionalities as v5.4.0 and some new content which is not always backward compatible with v5.4.0.
All new capabilities are listed below – any customer planning to consume new capabilities is required to analyze and adapt accordingly to the new feature requirements.
This step is optional.
All changes from v5.4.0 which are no more compatible with v6.1.0, are listed in the next section of the migration guide. This step is obligatory to consume the service through the higher endpoint versions. See release notes for further details.
The Revalidate Itinerary Request has been enhanced with the following changes:
- Flight type (A: Air Segment, K: ARUNK, O: Open Segment) has been changed from required to optional.
- Deleted Passenger Type Code. NOTE: The below optional parameter is no longer available for our customers: PassengerType/@Code - more information available in SAN 15673 from 10th SEP 2019.
The Revalidate Itinerary GIR Response has been enhanced with the new parameters and other changes listed below:
- ElapsedTime attribute has been added at the ScheduleDesc and LegDesc levels.
- The MandatoryInd indicates mandatory Offer Items that cannot be removed from the Offer. Added at the Fare and Passenger Information levels.
- New attribute LastTicketTime added at FareType level.
- Ancillaries Baggage information - For carriers migrated to new ATPCO baggage processing, new ancillaryTypeCode value "C" will occur, along with new optional elements: "subgroup", "description1", "description2", "firstOccurrence", "lastOccurrence".
- The Parameters FareAmount and FareCurrency at FareComponentDesc level have been changed to optional.
- The Operating Carrier Code has been changed from required to optional.
How to migrate from the 5.4.0 version to 6.1.0 version?
Revalidate Itinerary v6.1.0 is backward compatible with previous version (v5.4.0) with the following exceptions (changes, updates or new elements which are not backward compatible):
| v5.4.0 | v6.1.0 |
|---|---|
| RQ changes for migration: | RQ changes for migration: |
| Parameter Flight type (A: Air Segment, K: ARUNK, O: Open Segment) required: "Flight": [ { "ClassOfService": "S", "Number": 705, "DepartureDateTime": "2021-04-15T23:55:00", "ArrivalDateTime": "2021-04-16T08:35:00", "Type": "A", "Flown": false, "OriginLocation": { "LocationCode": "MAD" }, "DestinationLocation": { "LocationCode": "SCL" |
Parameter Flight type (A: Air Segment, K: ARUNK, O: Open Segment) changed to optional: "Flight": [ { "ClassOfService": "S", "Number": 705, "DepartureDateTime": "2021-04-15T23:55:00", "ArrivalDateTime": "2021-04-16T08:35:00", "Type": "A", "Flown": false, "OriginLocation": { "LocationCode": "MAD" }, "DestinationLocation": { "LocationCode": "SCL" |
| Passenger Type Code deleted. The parameter is no longer available in 6.1.0 and higher: PassengerType/@Code - SAN 15673 from 10th SEP 2019 |
|
| GIR RS changes for migration: | GIR RS changes for migration: |
| TTL parameter in 5.4.0: "pricingInformation": [ { "pricingSubsource": "NDC_CONNECTOR", "offer": { "offerId": "dg069c668cf5jknfhk6l4h6m80-2", "TTL": 900, "source": "NDC" } |
Renamed to TimeToLive in v2: "pricingInformation": [ { "pricingSubsource": "NDC_CONNECTOR", "offer": { "offerId": "dg069c668cf5jknfhk6l4h6m80-2", "timeToLive": 900, "source": "NDC" } |
| N/A | The MandatoryInd indicates mandatory Offer Items that cannot be removed from the Offer. Added at the Fare and Passenger Information levels. { "fare": { "offerItemId": "cg5fd74bdf9fwtwjsk6kloyuh0-1-1", "mandatoryInd": true, "serviceId": "cg5fd74bdf9fwtwjsk6kloyuh0-1-1-1", "validatingCarrierCode": "SQ", "vita": true, "eTicketable": true, "governingCarriers": "SQ", "passengerInfoList": [ { "passengerInfo": { "offerItemId": "cg5fd74bdf9fwtwjsk6kloyuh0-7-1", "mandatoryInd": true, "serviceId": "cg5fd74bdf9fwtwjsk6kloyuh0-7-1-1", "passengerType": "ADT", "passengerNumber": 1, "fareComponents": [ { |
| N/A | New optional parameter returned in the response lastTicketTime.
"pricingInformation": [ { "pricingSubsource": "MIP", "fare": { "validatingCarrierCode": "LO", "vita": true, "eTicketable": true, "lastTicketDate": "2020-02-15", "lastTicketTime": "10:28", "governingCarriers": "LO", "passengerInfoList": [ { |
| Parameter required: "fareComponentDescs": [ { "id": 2, "governingCarrier": "SQ", "fareAmount": 509.00, "fareCurrency": "USD", "fareBasisCode": "N15USOBA", "farePassengerType": "ADT", "publishedFareAmount": 509.00, "oneWayFare": true, "directionality": "FROM", "direction": "PA", "notValidBefore": "2020-02-28", "notValidAfter": "2020-02-28", "applicablePricingCategories": "3 4 5 6 7 8 9 10 12 15 16 18 23", "vendorCode": "ATP", "fareTypeBitmap": "00", "fareType": "XOX", "fareTariff": "3", "fareRule": "UW11", "segments": [ { |
Parameter changed to optional: "fareComponentDescs": [ { "id": 2, "governingCarrier": "SQ", "fareAmount": 509.00, "fareCurrency": "USD", "fareBasisCode": "N15USOBA", "farePassengerType": "ADT", "publishedFareAmount": 509.00, "oneWayFare": true, "directionality": "FROM", "direction": "PA", "notValidBefore": "2020-02-28", "notValidAfter": "2020-02-28", "applicablePricingCategories": "3 4 5 6 7 8 9 10 12 15 16 18 23", "vendorCode": "ATP", "fareTypeBitmap": "00", "fareType": "XOX", "fareTariff": "3", "fareRule": "UW11", "segments": [ { |
| Parameter required: "carrier": { "marketing": "HA", "marketingFlightNumber": 452, "operating": "HA", "operatingFlightNumber": 452, "equipment": { "code": "332", "typeForFirstLeg": "W", "typeForLastLeg": "W" } }
|
Parameter changed to optional: * For the NDC offers, the operating carrier value is optional and very often might not appear in the response. "carrier": { "marketing": "HA", "marketingFlightNumber": 452, "operating": "HA", "operatingFlightNumber": 452, "equipment": { "code": "332", "typeForFirstLeg": "W", "typeForLastLeg": "W" } } |