Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Functional Description - Release

...

2023.

...

09

OrderReshop API is used to reshop for changes and cancellations cancelations to the itinerary of an existing Order.

This service supports the following types of actions:

  • Reprice(Retarify) → Allows to know the price of paying and issuing a previous generated order.

  • OrderReshop (Delete / Cancel) → To know in advance what is the refundable amount of a partial or total refund of a specific group of passengers (not all passenger of the order) or for a previos booking (all passenger of the order). Passenger/s can be deleted when at least one coupon is in Open for Use/Airport Control status. Available to calculate the cost of delete some paxes from UNPAID Orders Repricing to change UNPAID Orders is also available.

    • Available for orders with Conjunction tickets.

    • Available for orders with Special Discounts (Spanish Resident & Spanish Large Family Discounts).

    • Available for all or some of the passengers of the initial booking or even for not all of them.in the Order. (If done for some passenger(s) this will result in a split and a new Order for the split will be returned)

    • Available for code share flights.

    • Available for Private Fare orders (Only for all passengers of the initial booking).

    • Not available for reissued orders.

    • Available, any time, for orders paid completely with voucher.

    • Available, within 24 hours of purchase, for orders paid with cash + voucher.

  • OrderReshop Availability (Add & Delete (Reshop flow - New AvailabilityDelete) → Allows searching new date, time or cabin availability availabilities to change the initial booking for all pax or for some pax of the order (limited to the same number of slices (direct flights can ) and the same airport codesOrigin and Destination). All coupons (issued orders) have to be in Open for Use/Airport Control status.

    • Available for orders with Conjunction tickets.

    • Available for orders with Special Discounts (Spanish Resident & Spanish Large Family Discounts) and Private Fare orders.

    • Available for all passengers of the initial booking or even for not all of them.

    • Available for code share flights.

    • Available for orders with Private Fares (No Split change, so change may affect all passengers).

    • Available for reissued orders.

    • Available for paid and or unpaid orders (some or all flights (some original flight/s can be fixed) and all or even for only some paxes of the order without changing original product).

    • Ability to request new availability by introducing simply the origin and destination instead of all the segments from the original journey.

    • Ability to request new availability by introducing cities codes in paid or unpaid orders

    • Available for partially used orders, including those with Private Fares, Spanish Resident Discount and Spanish Large Family discount, when the search is for coupons in the following states:

      • Open for Use

      • Airport Control (and able to take control)

      • No Show (and if the fare allows changes)

  • Reprice (Reshop flow - New Fare) → Allows selecting and pricing one of the offer resulting on previous order reshop(new availability). This previous call to order reshop is mandatory(new availability). 

  • OrderReshop - Reprice → Is used to select one of the specific Offers returned in the previous OrderReshop Availability (Add & Delete), it is also used to requote the price of a held booking.

Whenever servicing an existing Order, an OrderRetrieve should allways be done before using this service. This ensures you have the latest version of the Order, which could have changed.

\If you want to reshop an order generated in v16, it is necessary to launch an OrderRetrieve v17 previously

Examples of messages with complete flows can be downloaded from here.

ActionType

Use

Reprice (Retarify)

This service is used to know the price of paying and issuing a previous generated order

Delete / Cancel

To know in advance what is the refundable amount of a partial or total refund of a specific group of passengers (not all passenger of the order).

To know in advance what is the cost of a partial or total refund for an initial booking (all passenger of the order):

  • At least one coupon have to be in Open for Use/Airport Control status.

Add & Delete

(

Reshop flow - New

OrderReshop Availability) → Paid Orders

This combination allows to look for new availability for date, time and/or cabin for an initial booking.

To know in advance what is the cost of a flight change:

  • All coupons (issued orders) have to be in Open for Use/Airport Control status.

Search preferences that can be applied in this flow are:

  • Flight Number

  • Cabin type

  • DirectPreferences (Number of flight stops)

 

Add & Delete

(

Reshop flow - New

OrderReshop Availability) → Unpaid Orders

This combination allows to look for new

availability

availabilities for date, time and/or cabin for an initial booking.

  • Available for unpaid orders (some or all flights (some original flight/s can be fixed) and all or even for only some paxes of the order without changing original product).

Search preferences that can be applied in this flow are:

  • BestPricingOption (Cheapest → “C”)

  • DirectPreferences (Number of flight stops)

Reprice

(Reshop flow - New Fare)Allows selecting and pricing

To select one of the

offer resulting on previous order reshop(new availability)
  • Previous call to order reshop(new availability).

  • PaymentTimeLimit will only be displayed in unpaid orders flights changes. If this field is not present in response, instant purchase is mandatory

    specific Offers returned in the previous OrderReshop Availability (Add & Delete)

    This service is also used to requote the price of a held booking.

    A PaymentTimeLimit will only be returned when servicing an unpaid Order that does not require instant purchase. If no PaymentTimeLimit is returned, then the Offer is instant purchase and payment must be included in the subsequent OrderChange message.

    v16 Compatibility

    Allows to reshop a previously created order with v16