KIU_AirRules

Owned by Natalia Pacheco (Deactivated)
Oct 07, 2019



Objective


This method call allows the user to obtain the information of the rules displayed in response to the KIU_AirShoppingRQ




KIU_AirRulesRQ

 

Example

KIU_AirRulesRQ
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirRulesRQ EchoToken="1" TimeStamp="2015-08-12T11:00:00" Target="Testing" Version="3.0" SequenceNmbr="1" PrimaryLangID="en">
    <POS>
        <Source AgentSine="NET00XXWW" TerminalID="NET00XX000" ISOCountry="AR" />
    </POS>
    <RuleReqInfo FareNumber="61244">
        <FareReference>HTEST</FareReference>
        <MarketingAirline Code="XX" />
        <DepartureAirport LocationCode="AEP" />
        <ArrivalAirport LocationCode="COR" />
        <DepartureDate>2015-12-30</DepartureDate>
    </RuleReqInfo>
</KIU_AirRulesRQ>

Elements of KIU_AirRulesRQ

  • POS: Element that groups the information of the Point of Sale from which the request is made.
    • Source: Contains information of the Point of Sale or POS 
      • AgentSine: Alphanumeric [9]. Identifies the Agent who makes the petition.
      • TerminalID: Alphanumeric [10]. Identifying code of the device from which the request is made.
      • ISOCountry: Alphabetical [2]. ISO code of the country where the request originated.
  • RuleReqInfo: Fare details whose rules are requested.
    • FareNumber: Integer. Number of the requested fare (returned by the KIU_AirShopping method call , in the IdFare attribute).
    • FareReference: Alphanumeric . Name of the requested fare .
    • MarketingAirline: Alphanumeric [2]. IATA code of the airline to which the fare belongs.
    • DepartureAirport: Airport of origin.
      • LocationCode: Alphabetical [3]. IATA Code of the airport
      • ArrivalAirport: Destination airport.
        • LocationCode: Alphabetical [3]. IATA Code of the airport
        • DepartureDate: ISO Date. Optional. Date by which you want to know the rules applicable to the requested fare. If this parameter is not sent, the default behavior is to return the applicable rules on the day of the request.


Volver al Indice



KIU_AirRulesRS


Example

KIU_AirRulesRS
<?xml version="1.0" encoding="UTF-8"?>
<KIU_AirRulesRS EchoToken="1" TimeStamp="2015-05-06T18:52:22+00:00" Target="Testing" Version="3.0" SequenceNmbr="1">
    <Success />
    <FareRuleResponseInfo>
        <FareRuleInfo FareNumber="61244">
            <DepartureAirport LocationCode="AEP" />
            <ArrivalAirport LocationCode="COR" />
            <DepartureDate>2015-12-30</DepartureDate>
            <MarketingAirline Code="XX" />
            <FareReference>HTEST</FareReference>
            <RuleInfo>
                <ResTicketingRules>
                    <AdvResTicketing FirstTicketDate="2011-07-16" LastTicketDate="OPEN" />
                </ResTicketingRules>
            </RuleInfo>
        </FareRuleInfo>
        <FareRules>
            <SubSection SubTitle="APPLICATION" Code="RU">
                <Paragraph>
                    <Text>TEST</Text>
                </Paragraph>
            </SubSection>
            <SubSection SubTitle="MINIMUN STAY" Code="MN">
                <Paragraph>
                    <Text>TEST</Text>
                </Paragraph>
            </SubSection>
            <SubSection SubTitle="MAXIMUN STAY" Code="MX">
                <Paragraph>
                    <Text>TEST</Text>
                </Paragraph>
            </SubSection>
            <SubSection SubTitle="SEASONALITY" Code="SE">
                <Paragraph>
                    <Text>TESTTRIP MUST BEGIN  BETWEEN  20JAN THROUGH 15AUG</Text>
                </Paragraph>
            </SubSection>
            <SubSection SubTitle="BLACKOUT DATES" Code="BO">
                <Paragraph>
                    <Text>TESTFLT MUST NOT BEGIN  BETWEEN  01JAN THROUGH 15JAN O
BETWEEN  10JUL THROUGH 20JUL</Text>
                </Paragraph>
            </SubSection>
            <SubSection SubTitle="DAY/TIME" Code="DA">
                <Paragraph>
                    <Text>TEST</Text>
                </Paragraph>
            </SubSection>
        </FareRules>
    </FareRuleResponseInfo>
</KIU_AirRulesRS>




Elements for KIU_AirRulesRS


  • FareRuleResponseInfo: Element that groups the information of the rules of the requested fare.
    • FareRuleInfo: Contains information about each applicable rule.
      • FareNumber: Identification number of the requested fare
      • DepartureAirport: Airport of origin.
        • LocationCode: Alphabetical.IATA Code of the airport
        • ArrivalAirport: Destination airpor.
          • LocationCode: Alphabetical. IATA Code of the airport
          • DepartureDate: ISO Date. Date on which the rules returned for the requested fare apply.
          • MarketingAirline: Alphanumeric . IATA code of the airline to which the fare belongs.
          • FareReference: Alphanumeric .Name of the requested fare.
          • RuleInfo: Rule container
            • ResTicketingRules: Information about ticketing rules.
              • AdvResTicketing: Range of issuance date for the fare
                • FirstTicketDate: ISO date, Date from which the fare can be issued.
                • LastTicketDate: ISO date|OPEN. Last date on which the issuance of the fare is accepted. Instead of a date, will accept “OPEN” value, which indicates that the fare does not have an emission deadline.
    • FareRules: Contains  specific rules of the fare.
      • Subsection: Subsection of the applicable rules.
        • SubTitle: Alphabetical. Subsection Name.
        • Code: Alphabetical. Rule code
          • Paragraph: Paragrap containing the instructions and / or specifications of the rule.
            • Text: Alphanumeric with special characters. Rule text.

 


Volver al Indice



Possible error messages 


Code

Message

Description

10035

The date must not be in the past or over 330 days in the future.

La fecha de aplicación de la regla no The date of application of the rule should not be in the past, or beyond the following 330 days at the time of consultation.

10036

Too many OriginDestinationInformation elements to process.

More than one destination source pair was requested, but the method supports querying only one at a time.

10038

Too many RuleReqInfo elements to process.

The rules for more than one fare were requested, but the method supports only one at a time.

10040

Carriers are not allowed to check other carrier's rules.

An airline was sent in the attribute Code the MarketingAirline element that does not correspond to the user who made the query.

11005

Error at parameter DepartureDateTime.

The value of the DepartureDateTime element is not a valid ISO date.

11006

Error at parameter OriginLocation.

The value of the Location Code attribute of the OriginLocation element does not correspond to the format described (alphabetic in three-character uppercase letters).

11007

Error at parameter DestinationLocation.

The value of the LocationCode attribute of the DestinationLocation element does not correspond to the format described (alphabetic in three-character uppercase letters).

11017

Error at parameter ISOCountry.

The value of the ISOCountry attribute of the Source element does not correspond to the format described (two-character uppercase alphabetic).

11043

Error at parameter Carrier.

The value of the Code attribute of the MarketingAirline element does not correspond to the format described (two-character alphanumeric in uppercase).

11087

Error at parameter FareReference.

The value of the FareReference element does not correspond to the format described (alphanumeric in uppercase).

11088

Error at parameter FareNumber.

The value of the FareNumber attribute of the RuleReqInfo element does not correspond to the format described (integer).

12014

The requested fare does not exist or is not active.

The required fare does not exist or does not apply on the date that was indicated.



Volver al indice