KIU_ DemandEMDDoc

Objective:

The method allows to issue EMD of type A and S associated with a booking. Requires a pre-existing quotation of ancillaries (PQ).

KIU_DemandEMDDocRQ:

Request example:

KIU_DemandEMDDocRQ - Full

Message elements:

• BookingReferenceID: Mandatory. Alphanumeric (6). It contains the information of the reservation code where the items to be processed are located.

  • ID: Attribute. Required. Alphanumeric (6). Reservation code.

  • LastModificationType: Attribute. Optional. ISO DateTime. Information that comes in the answer of KIU_AirPriceRS where the ancillaries are included. It corresponds to the last date / time that the reservation was modified. This attribute will be implemented in the future to control the issuing will be done on the last version of the referenced booking.

  • Orders: Element. Mandatory List the issuing orders of the documents to be processed.

    • Order: Element. Mandatory Individual order of processing. Corresponds to each quote done.

      • OrderID: Attribute. Mandatory. IDREF corresponding to the quote number (<Priced>) obtained from the response of KIU_AirPriceRS. This data corresponds to the PQ number of the reservation.

• PaymentInformation: Element. Mandatory. Group the payment methods to be used during documents processing.

  • PaymentInfo: Element. Mandatory Contains the description of single payment method.

    • PaymentType: Positive integer. Mandatory. OTA code of the payment method, listed in the OpenTravel Code List Payment Type (1: Cash, 5: Credit Card, 6: Debit Card, 7: Check, 34: Invoice, 37: Miscellaneous).

    • PayCode: Alphanumeric. Optional. It is included when the payment method is 37.

    • InvoiceCode: Alphanumeric. Code of the client's corporate account used as a form of payment (this attribute must be present in the PaymentInformation element when the form of payment is 34).

    • Text: Alphanumeric. 30. Optional. Information associated with payment method. Eg PaymentType 7 - Include text.

    • PaymentRPH: Positive integer. Required. Reference ID for internal associations of the method.

    • TravelerRefNumberRPH. Integer Positive. Reference associated to a passenger.

    • Check: Element. Contains the information of the check number.

      • CheckNumber: Attribute. Required. Integer. Check number.

      • Number: Numeric (10). Check number when the payment method is 7.

    • CreditCardInfo: Optional. Element to include credit card information..

      • CardCode: Attribute. Required. Credit card code

      • ApprovalCode: Attribute. Optional. Payment approval number through external validation process.

      • ExpirationDate: Attribute. Required. Date, format DDYY - Expiration date of the credit card..

      • CardNumber: Element that groups the credit card number data..

        • Number: Element. Required. It contains the credit card number.

        • CVS: Element. Positive integer. Required. Credit card security code.

• DebitCardInfo: Optional. Element to include credit card information.

  • CardCode: Required. Credit card code.

  • ApprovalCode: Optional. Payment approval number through external validation process.

  • ExpirationDate: Attribute. Required. ISO valid date of credit card.

  • CardNumber: Element. Required. Contains the debit card number data.

  • Number: Element. Required. Contains the credit card number.

  • CVS: Positive integer. Credit card security code.

• PaymentAssociations: Required element. List the payment instructions of the item for each Order.

  • PaymentAssociation: Required element Payment instruction for each order. There must be as many elements as orders are declared in the Orders element

    • OrderID: Attribute. Required. Positive integer IDREF corresponds to the reference number to the Order element.

    • PaymentReference: Element that contains the form of payment instruction to be used to process the reference order. Minimum 1 item or maximum 2 is required for a double payment.

      • PaymentRPH: Attribute. Required. Positive integer. IDREF payment method reference number (PaymentInfo).

      • Amount: Attribute. Required. Positive. Decimal figure. Amount to be included in the form of payment.

      • TaxAmount: Attribute. Required. Decimal figure. Total amount of taxes to be included in the form of payment. .

Sample Request by payment method:

Cash:

Credit card:

Debit card:

Check:

Miscellaneous:

Invoice (Prepaid account):

KIU_DemandEMDDocRS

Message example:

KIU_DemandEMDDocRS

Message elements:

• Errors: Element that contains the errors that determine the non-processing of the transaction.

  • Error: Element. Error description.

    • ErrorCode: Numeric. Positive integer. Error number.

• Success: Element that informs that the message was executed correctly.

• Warnings: Optional element. List of warnings associated with the process.

  • Warning: Description of the warning.

    • Type: Positive integer. Warning code.

• BookingReferenceID: Element that groups the documents processed for a reservation.

• ID: Alphanumeric (6). Reservation code.

• DocumentItemInformation: Element that contains the information of the issued document

  • Type: Alphabetical. (EMDA / EMDS). Type of document processed.

  • Number: Positive integer. (13) Document number issued.

  • TravelerReferenceRPH: Positive integer. Passenger order number in the reservation associated with the document issued.

  • Status: Boolean (true|false). Indicator if the EMD is processed or not. In case of a false value, the IssueInfo element is added to the description.

    • IssueInfo: Element that contains the information referring to the non-processing of an issuing order.

      • Error: Element that contains the individual description of each cause of non-processing.

        • Code: integer. Error identification number.