Advance Change

Change policies are returned when responding to a request for UTAs that have no filter or a filter for "advance_change".

Copy
Copied
// Use "ticket_attributes_filter" key in request body:
{
  "control": {
  	"includes": [
  	  "uta"                             // response should return UTAs
  	],
    "ticket_attributes_filter": [       // optional filter specifies the UTA
                                        // categories to be returned
        "advance_change",               // include advance change policies in the response
        // ...
    ],
    // ...
  }
// ...
}

Policy Types

Field Description
anytime the change policy conditions apply to the period both before and after departure
before_departure the change policy conditions apply only to the period before departure
after_departure the change policy conditions apply only to the period after departure
anytime_no_show (requires the policies_extended_fields feature) the change policy no show conditions apply to the period both before and after departure
before_departure_no_show (requires the policies_extended_fields feature) the change policy no show conditions apply only to the period before departure
after_departure_no_show (requires the policies_extended_fields feature) the change policy no show conditions apply only to the period after departure

Each of the Policy Types has the following attributes:

Response

Attributes Type Description/Value
headline string headline, up to 40 characters
description string description, up to 140 characters
assessment_code string possible values: Neutral, Benefit, Fee, Restriction
fee object See Fee object table
travel_portion string Defines at which level of the travel the policy should be applied. Possible values: R (round trip), T (ticket), B (blank)
fee_application integer (requires policy_fee_application feature) Defines at which level of the travel the policy should be applied.

Fee object

Attributes Type Description/Value
amount number The fee amount for this policy in the selected currency.
currency_code string The selected currency for the request. If this is not exclusively set, then POS will be taken into consideration.
percentage number A percent of the base fare amount used for obtaining the charge amount. This may be returned in company with the amount field or on its own. When returned with the amount fee, then the headline states which field to choose depending on the policy (e.g., "whichever is higher" or "whichever is lower").
higher_lower string Identifies when to pick percentage value over amount value or vice versa. Possible return values are: H - Higher; L - Lower; N - No Application.

NOTE: The higher_lower field should always be read to identify which field you should pick (i.e., amount or percentage).

In case of:
N - You should always pick the amount since percentage should be zero.
H - You should compare the calculated value of the base fare amount after applying percentage field with amount and then pick whichever value is higher.
L - You should compare the calculated value of the base fare amount after applying percentage field with amount and then pick whichever value is lower.