OrderChange Functional Capabilities

Add Seats with no Itinerary Changes

OrderChangeRQ

Requirements when adding seats with no itinerary changes:

  1. To change the language of the response payload, include your preferred language code (e.g., fr-CA or en-CA) in OrderChangeRQ/@PrimaryLangID

  2. For seats and ancillary services, the offer and offer items from the previous step (OrderReshopRS - Price) need to be included in OrderChangeRQ

  3. /OrderChangeRQ/Query/ActionContext needs to be “8” for Optional Services and seats. The complete list of values are as follows:

    a. ActionContext = 5 (Itinerary Servicing)

    b. ActionContext = 8 (Optional Services and Seats)

    c. ActionContext = 11 (Frequent Flyer)

    d. ActionContext = 7 (Air + Seat + Ancillary)

    e. ActionContext = 6 (splitting a PNR)

  4. /OrderChangeRQ/Query/Payments/Payment needs to be included with one form of payment

  5. /…/Payment/Amount needs to be taken from the previous step OrderReshopRS - Price/…/ReshopOffer/TotalPrice/DetailCurrencyPrice/Total

  6. All the values for /…/PassengerList/Passenger/@PassengerID should be taken from the step OrderRetrieve - OrderViewRS/…/PassengerList/Passenger/@PassengerID

OrderChange - OrderViewRS

Response for when seats are added with no itinerary changes:

  1. OrderChange - OrderViewRS is similar to OrderCreate - OrderViewRS or OrderRetrieve - OrderViewRS

  2. Historical payments for the old tickets or EMDs would not be returned in OrderChange - OrderViewRS

  3. /OrderViewRS/Response/Order/OrderItems/OrderItem/OrderItemDetails/OrderItemDetail/OrderInstructions/FreeFormTextInstruction/Remark is the path to find associated documents for the respective order item

  4. Any refund (RSVR) or penalty (PENF) will be returned as an order item. The path /OrderViewRS/Response/Order/OrderItems/OrderItem/Service/ServiceDefinitionRef and the respective /OrderViewRS/Response/DataLists/ServiceDefinitionList/ServiceDefinition will return the name of the service, reason for issuance code (i.e., RFIC), and associated bounds for a passenger.

  5. /…/ServiceDefinition/Encoding/RFIC values are:

    a. “A” for "SEAT"

    b. “G” for “MEAL”

    c. “E” for “MLLW” (Lounge)

    d. “D” for "PENF” (Penalty)

    e. “I” for “RSVR” (Refund)

  6. /…/TicketDocument/Type “702” indicates eTicket. When “J” is returned for EMA-A (i.e., Associated Electronic Miscellaneous Document), “Y” will be returned for EMA-S (i.e., Standalone Electronic Miscellaneous Document).

  7. /…/TicketDocInfos/TicketDocInfo/TicketDocument/Remark will return the status of the document

Add Ancillaries with no Itinerary Changes

OrderChangeRQ

Requirements when adding ancillaries with no itinerary changes:

  1. To change the language of the response payload, include your preferred language code (e.g., fr-CA or en-CA) in OrderChangeRQ/@PrimaryLangID

  2. For seats and ancillary services, the offer and offer items from the previous step (OrderReshopRS - Price) need to be included in OrderChangeRQ

  3. /OrderChangeRQ/Query/ActionContext needs to be “8” for Optional Services and seats. The complete list of values are as follows:

    a. ActionContext = 5 (Itinerary Servicing)

    b. ActionContext = 8 (Optional Services and Seats)

    c. ActionContext = 11 (Frequent Flyer)

    d. ActionContext = 7 (Air + Seat + Ancillary)

    e. ActionContext = 6 (splitting a PNR)

  4. /OrderChangeRQ/Query/Payments/Payment needs to be included with one form of payment

  5. /…/Payment/Amount needs to be taken from the previous step OrderReshopRS - Price/…/ReshopOffer/TotalPrice/DetailCurrencyPrice/Total

  6. All the values for /…/PassengerList/Passenger/@PassengerID should be taken from the step OrderRetrieve - OrderViewRS/…/PassengerList/Passenger/@PassengerID

OrderChange - OrderViewRS

Response for when ancillaries are added with no itinerary changes:

  1. OrderChange - OrderViewRS is similar to OrderCreate - OrderViewRS or OrderRetrieve - OrderViewRS

  2. Historical payments for the old tickets or EMDs would not be returned in OrderChange - OrderViewRS

  3. /OrderViewRS/Response/Order/OrderItems/OrderItem/OrderItemDetails/OrderItemDetail/OrderInstructions/FreeFormTextInstruction/Remark is the path to find associated documents for the respective order item

  4. Any refund (RSVR) or penalty (PENF) will be returned as an order item. The path /OrderViewRS/Response/Order/OrderItems/OrderItem/Service/ServiceDefinitionRef and the respective /OrderViewRS/Response/DataLists/ServiceDefinitionList/ServiceDefinition will return the name of the service, reason for issuance code (i.e., RFIC), and associated bounds for a passenger.

  5. /…/ServiceDefinition/Encoding/RFIC values are:

    a. “A” for "SEAT"

    b. “G” for “MEAL”

    c. “E” for “MLLW” (Lounge)

    d. “D” for "PENF” (Penalty)

    e. “I” for “RSVR” (Refund)

  6. /…/TicketDocument/Type “702” indicates eTicket. When “J” is returned for EMA-A (i.e., Associated Electronic Miscellaneous Document), “Y” will be returned for EMA-S (i.e., Standalone Electronic Miscellaneous Document).

  7. /…/TicketDocInfos/TicketDocInfo/TicketDocument/Remark will return the status of the document

Add both Seats and Ancillaries with no Itinerary Changes

OrderChangeRQ

Requirements when adding both seats and ancillaries with no itinerary changes:

  1. To change the language of the response payload, include your preferred language code (e.g., fr-CA or en-CA) in OrderReshopRQ/@PrimaryLangID

  2. For seats and ancillary services, the offer and offer items from the previous step (OrderReshopRS - Price) need to be included in OrderChangeRQ

  3. OrderChangeRQ/Query/ActionContext needs to be “8” for Optional Services and Seats. The complete list of values are as follows:

    a. ActionContext = 5 (Itinerary servicing)

    b. ActionContext = 8 (Optional Services and Seats)

    c. ActionContext = 11 (Frequent Flyer)

    d. ActionContext = 7 (Air + Seat + Ancillary)

    e. ActionContext = 6 (splitting a PNR)

  4. /OrderChangeRQ/Query/Payments/Payment needs to be included with one form of payment

  5. /…/Payment/Amount needs to be taken from the previous step OrderReshopRS - PRICE/…/ReshopOffer/TotalPrice/DetailCurrencyPrice/Total

  6. All the values for /…/PassengerList/Passenger/@PassengerID should be taken from the step OrderRetrieve - OrderViewRS/…/PassengerList/Passenger/@PassengerID

OrderChange - OrderViewRS

Response for when both seats and ancillaries are added with no itinerary changes:

  1. OrderChange - OrderViewRS is similar to OrderCreate - OrderViewRS or OrderRetrieve - OrderViewRS

  2. Historical payments for the old tickets or EMDs would not be returned in OrderChange - OrderViewRS

  3. /OrderViewRS/Response/Order/OrderItems/OrderItem/OrderItemDetails/OrderItemDetail/OrderInstructions/FreeFormTextInstruction/Remark is the path to find associated documents for the respective order item

  4. Any refund (RSVR) or penalty (PENF) will be returned as an order item. The path /OrderViewRS/Response/Order/OrderItems/OrderItem/Service/ServiceDefinitionRef and the respective /OrderViewRS/Response/DataLists/ServiceDefinitionList/ServiceDefinition will return the name of the service, reason for issuance code (i.e., RFIC), and associated bounds for a passenger.

  5. /…/ServiceDefinition/Encoding/RFIC values are:

    a. “A” for "SEAT"

    b. “G” for “MEAL”

    c. “E” for “MLLW” (Lounge)

    d. “D” for "PENF” (Penalty)

    e. “I” for “RSVR” (Refund)

  6. /…/TicketDocument/Type “702” indicates eTicket. When “J” is returned for EMA-A (i.e., Associated Electronic Miscellaneous Document), “Y” will be returned for EMA-S (i.e., Standalone Electronic Miscellaneous Document).

  7. /…/TicketDocInfos/TicketDocInfo/TicketDocument/Remark will return the status of the document