Overview
Offer Criteria and Order Criteria package the filtering the Seller can perform at various stages within the flow. The Offer Criteria seen pre-Order stage (for example AirShoppingRQ and OfferPriceRQ) and the Order Criteria follows the same constructs but in the context of an Order (for example OrderReshopRQ).
Currently, both types contain the same Criteria options.
Baggage Pricing Criteria
Used to request specific types of baggage when searching for Offers, for example CarryOn or Checked.
Code Block |
---|
|
<cns:BaggagePricingCriteria>
<cns:BaggageOptionCode>Checked</cns:BaggageOptionCode>
</cns:BaggagePricingCriteria> |
Fare Criteria
Used to specify underlying fares which the seller would like the airline to either include, exclude or preference in the return (PrefLevel). For example published or negotiated fares (FareTypeCode) and the seller and airline may also further classify these fare preferences further using the FareSubTypeCode as bilaterally agreed.
The seller may send in multiple instances of the Fare Criteria object to better qualify the search.
Code Block |
---|
|
<cns:FareCriteria>
<cns:FareSubTypeCode>Humanitarian</cns:FareSubTypeCode>
<cns:FareTypeCode>758</cns:FareTypeCode>
<cns:PrefLevel>
<cns:PrefLevelCode>Required</cns:PrefLevelCode>
</cns:PrefLevel>
</cns:FareCriteria> |
Pricing Method Criteria
Used to request how the airline prices the Offer. For example, does the seller want the cheapest available in a cabin or on flight, regardless of cabin.
Code Block |
---|
|
<cns:PricingMethodCriteria>
<cns:BestPricingOptionText>Y</cns:BestPricingOptionText>
</cns:PricingMethodCriteria> |
Program Criteria
Mainly used to instruct the airline which negotiated fares to return based on bilaterally agreed corporate codes.
This structure can also be used to advise the airline which Vouchers, CLID, or pre-paid certificates may be used in the purchase.
Code Block |
---|
|
<cns:ProgramCriteria>
<cns:ProgamContract>
<cns:ContractID>ABC</cns:ContractID>
</cns:ProgamContract>
<cns:ProgramOwner>
<cns:Carrier>
<cns:AirlineDesigCode>XB</cns:AirlineDesigCode>
</cns:Carrier>
</cns:ProgramOwner>
</cns:ProgramCriteria> |
Promotion Criteria
Used for the Seller to advise of a promotional code or similar for the airline to take into consideration when computing the Offers.
Its considered good practice to identify the source of the Promotional code when sending this value to the airline; in the below example, the ‘PROMO’ Promo code has been previously issued by airline XB.
Seat Criteria
Used to advise the airline the seat preferences, or specific seat that the passenger would like an Offer for.
In the most basic of cases the seller can advise the airline that the passenger would like a seat in 1A.
Code Block |
---|
|
<cns:SeatCriteria>
<cns:ColumnID>A</cns:ColumnID>
<cns:RowNumber>1</cns:RowNumber>
</cns:SeatCriteria> |
To request seats with specific criterion, the seller may use the ATSB Seat Characteristics Codeset to signify the passengers needs. In the below, the passenger would like either a Window or an Aisle seat.
Code Block |
---|
|
<cns:SeatCriteria>
<cns:ColumnID>Z</cns:ColumnID>
<cns:RowNumber>0</cns:RowNumber>
<cns:SeatCharacteristicCode>A</cns:SeatCharacteristicCode>
<cns:SeatCharacteristicCode>W</cns:SeatCharacteristicCode>
</cns:SeatCriteria> |
Service Criteria
Used to further specify what additional services (such as ancillaries) the passenger would prefer, require or happy to exclude from the Offer. This can be done using the RFIC/RFISC Codes for optional services or the Airline Taxonomy which covers optional services and flight characteristics.
Criteria using Airline Taxonomy
Code Block |
---|
|
<cns:ServiceCriteria>
<cns:PrefLevel>
<cns:PrefLevelCode>Preferred</cns:PrefLevelCode>
</cns:PrefLevel>
<cns:TaxonomyCode>0190</cns:TaxonomyCode>
<!-- Refundable -->
</cns:ServiceCriteria> |
Criteria using RFIC
Code Block |
---|
|
<cns:ServiceCriteria>
<cns:PrefLevel>
<cns:PrefLevelCode>Exclude</cns:PrefLevelCode>
</cns:PrefLevel>
<cns:RFIC>0NX</cns:RFIC>
<!-- Bicycle -->
</cns:ServiceCriteria> |
Special Needs Criteria
Used to further clarify any requirements for persons requiring special assistance or aid during their journey.
Code Block |
---|
|
<cns:SpecialNeedsCriteria>
<cns:Qty>1</cns:Qty>
<cns:SpecialServiceCode>WHCR</cns:SpecialServiceCode>
</cns:SpecialNeedsCriteria> |
Trip Purpose Code
Additional information to advise the airline if the passenger is flying for business or leisure.
Code Block |
---|
|
<cns:TripPurposeCode>Business</cns:TripPurposeCode> |
Waitlist Criteria
A simple preference to advise the airline if the passenger is looking or happy to be waitlisted and see Waitlist Offers returned. By default, the airline may choose to exclude Waitlist Offers, but may return a collection of waitlist and standard offers if waitlist is preferred, or simply just Waitlist Offers if waitlist is Required.
Code Block |
---|
|
<cns:WaitListCriteria>
<cns:PrefLevelCode>Required</cns:PrefLevelCode>
</cns:WaitListCriteria> |