Documentation

ReferenceReservations

cancelReservationReconciliation mutation

Cancels a reservation after the check-in date has passed, enabling the partner to reconcile a reservation if a guest does not show up or if the cancellation was requested by the guest.

Syntax

1mutation {
2  cancelReservationReconciliation(
3    input: CancelReservationReconciliationInput!
4  ): CancelReservationReconciliationPayload
5}

Example

This example cancels a reservation because the guest was a no show. It returns reservation details.

Request
Response

1mutation { 
2  cancelReservationReconciliation(
3    input: {
4      propertyId: "123",
5      currencyCode: "SEK",
6      penaltyAmount: 50.29,
7      reason: NO_SHOW,
8      reservationId: "123123123"
9    })
10    {
11    reservation {
12      id
13    } 
14  } 
15}

Arguments

Name	Description
`input`	Required. Reservation ID and other details needed to cancel a reservation. Type: CancelReservationReconciliationInput

Types

Name

Type

Boolean

The Boolean scalar type represents true or false.

BusinessModel

Enum

Entity that collects payment.

Name	Description
`EXPEDIA_COLLECT`	Expedia collects payment.
`HOTEL_COLLECT`	Property collects payment.

CancelReservationReconciliationInput

InputObject

Reservation ID and other details needed to cancel a reservation.

Field	Description
`currencyCode`	Not nullable. Currency for the amounts specified in the reservation. This code should match the original currency code of the reservation. Type: String
`penaltyAmount`	Not nullable. Cancellation penalty amount that was paid by the guest. This amount must be less than or equal to the original booking amount, and it cannot be a negative value. Type: Float
`propertyId`	Not nullable. Expedia ID of the property for which the cancellation has been requested. Type: ID
`reason`	Not nullable. Reason the reservation was cancelled. Type: ReservationCancellationReason
`reservationId`	Not nullable. ID of the reservation to be cancelled. Type: ID

CancelReservationReconciliationPayload

Object

Details about the cancelled reservation.

Field	Description
`reservation`	Reservation details. Type: Reservation

ExpediaSupplierAmount

Object

Field	Description
`currencyCode`	Not nullable. Currency in which the amount is shown. Type: String
`rates`	Not nullable. Nightly rates for the reservation. Type: Array of non nullable SupplierRate
`rateType`	Not nullable. Rate type: NET for Expedia Collect or SELL for Hotel Collect. Type: RateType
`total`	Not nullable. Total rates for the reservation. Type: SupplierTotal

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Guest

Object

Field	Description
`firstName`	Not nullable. Guest's first (given) name. Type: String
`lastName`	Not nullable. Guest's last name (surname). Type: String

GuestContact

Object

Contact information for the guest who made the reservation.

Field	Description
`phoneNumbers`	Phone numbers of the guest. Type: Array of non nullable GuestContactPhoneNumber

GuestContactPhoneNumber

Object

Guest phone number.

Field	Description
`areaCode`	Not nullable. Area code (three digits). Type: String
`countryCode`	Not nullable. Country code (two digits). Type: String
`number`	Not nullable. Phone number (seven digits, no hyphen). Type: String

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

IdNode

Object

Known IDs in the source system.

Field	Description
`id`	ID in the source system. Type: ID
`idSource`	Not nullable. Source of the ID. Type: IdSource

IdSource

Enum

Source of a given ID.

Name	Description
`EXPEDIA`	Expedia is the source of the ID.
`SUPPLIER`	Connectivity provider or lodging partner is the source of the ID. This value is not supported for use in `promotions`.
`VRBO`	Vrbo (HomeAway) is the source of the ID. This value cannot be used as an argument value, and it is not supported for use in `promotions`.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

InvalidScenario

Object

Reason and description of the scenario that makes the reservation ineligible for reconciliation.

Field Description

reason

Not nullable.

Description of why the reservation is ineligible for reconciliation.

Type: String

scenario

Not nullable.

Reason why the reservation cannot be reconciled. Values include the following:

GUEST_REQUESTED_CANCEL - Traveler cancelled the reservation
NO_SHOW - Traveler was a no-show
MODIFY_DATES_AMOUNTS - There was a difference in the booking price when the lodging partner charged the traveler (for example, because an extra night was added at the time of stay)

Type: String

LocalDate

A type representing a date in ISO 8601 format: YYYY-MM-DD (such as 2007-12-03).

RateTimeUnit

Enum

Time frame to which the rate is applied.

Name	Description
`PER_DAY`
`PER_WEEK`
`PER_STAY`

RateType

Enum

Name	Description
`NET`	Net amount (excludes compensation and taxes).
`SELL`	Gross amount (includes compensation and taxes).

ReconEligibility

Object

Reason(s) why the reservation can or cannot be reconciled.

Field Description

invalidScenarios

Reasons and descriptions why the reservation cannot be reconciled.

Type: Array of non nullable InvalidScenario

validScenarios

Reason why the reservation can be reconciled. Values include the following:

GUEST_REQUESTED_CANCEL - Traveler cancelled the reservation
NO_SHOW - Traveler was a no-show
MODIFY_DATES_AMOUNTS - There was a difference in the booking price when the lodging partner charged the traveler (for example, because an extra night was added at the time of stay)

Type: Array of non nullable String

Reservation

Object

Reservation details.

Field	Description
`accessibilityText`	Accessibility requests made by the guest for the reservation. We strongly recommend that you include this field in your implementation. Type: Array of non nullable String
`adultCount`	Not nullable. Count for all adult guests associated with the reservation. Type: Int
`bedTypes`	Bed type of the reservation. Type: String
`businessModel`	Not nullable. Entity that collects payment for the reservation. Type: BusinessModel
`checkInDate`	Not nullable. Check-in date (format: YYYY-MM-DD) of the reservation. Type: LocalDate
`checkOutDate`	Not nullable. Checkout date (format: YYYY-MM-DD) of the reservation. Type: LocalDate
`childCount`	Not nullable. Count for all child guests associated with the reservation. Type: Int
`creationDateTime`	Not nullable. Timestamp of when the reservation was created (format: yyyy-mm-ddThh:mm:ssTZD, where TZD is a time zone designator in the form +/-hh:mm). Type: String
`guestContact`	Contact information for the guest who made the reservation. Type: GuestContact
`id`	Expedia's reservation ID. Type: ID
`isReconciled`	Whether one or more reconciliation attempts have been made on the reservation. Type: Boolean
`lastUpdatedDateTime`	Not nullable. Date and time when the reservation was last updated. Type: String
`loyaltyTier`	Guest loyalty tier. Values include MEMBER, VIP, PREMIUMVIP, and null. You must include this field to complete certification. Type: String
`multiRoomText`	Text that is displayed to guests if there is a multi-room booking associated with the reservation. Type: String
`paymentInstructions`	Not nullable. Text that is displayed to guests if a payment type is associated with the reservation. Type: String
`primaryGuest`	Not nullable. Guest who made the reservation. Type: Guest
`rateIds`	Not nullable. ID of the rate/rate plan and the source of the ID. In the response, when `idSource` is set to SUPPLIER, the `id` field returns the same value as returned by the existing booking APIs. However, for Hotel Collect properties, the A- prefix is no longer added to the ‘source’ value and the A suffix is no longer appended to the rate ID as was done by the booking APIs. Type: Array of non nullable IdNode
`reconciliationEligibility`	The reason(s) why the reservation can or cannot be reconciled. Type: ReconEligibility
`reconciliationType`	Reconciliation type of the reservation, either MODIFY, CANCEL, NO_SHOW, or null. Type: String
`reservationIds`	Not nullable. IDs associated with the reservation and the source of the IDs. Type: Array of non nullable IdNode
`smokingType`	Not nullable. Whether smoking is allowed for the reservation. Type: String
`source`	Not nullable. Source of the reservation. Type: String
`specialRequest`	Text that is displayed to guests if there is a special request associated with the reservation. Type: String
`status`	Not nullable. Current status of the reservation. Type: ReservationStatus
`supplierAmount`	Connectivity or lodging partner's amount for the reservation. Type: SupplierAmount
`totalGuestCount`	Not nullable. Total number of guests associated with the reservation. Type: Int
`unitIds`	Not nullable. Known IDs for the unit/room in the source system(s). IDs that are returned depend on where the property was onboarded: If the property was onboarded onto Vrbo, three IDs are returned: the partner’s (external ID), Vrbo’s (Vrbo internal ID), and Expedia's (EID). If the property was onboarded onto Expedia, only the Expedia ID is included in the response. Type: Array of non nullable IdNode
`valueAddedPromotions`	Not nullable. Value add promotion(s) used to book the reservation. If a value add promotion (VAP) was not used, an empty array is returned. We strongly recommend that you include this field in your implementation. Type: Array of non nullable ReservationValueAddedPromotion

ReservationCancellationReason

Enum

Reason the reservation was cancelled.

Name	Description
`GUEST_REQUESTED_CANCEL`
`NO_SHOW`

ReservationStatus

Enum

Status of the reservation.

Name	Description
`BOOKED`
`CANCELLED`

ReservationValueAddedPromotion

Object

Value add promotion(s) used to book the reservation. If no value add promotion (VAP) was used, an empty array is returned.

Field	Description
`description`	Not nullable. Description of the promotion. Type: String
`id`	Not nullable. ID of the promotion. Type: String

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

SupplierAmount

Interface

Implemented by

ExpediaSupplierAmount

Field	Description
`currencyCode`	Not nullable. Currency in which the amount is shown. Type: String
`rateType`	Not nullable. Rate type. Type: RateType

SupplierFeeType

Enum

Type of fee charged by the lodging partner.

Name	Description
`BASE_RATE`	Nightly rate with no additional taxes, fees, or surcharges.
`EXTRA_GUEST_FEES`	Fees that are included in the price that guests see when booking. They are paid in advance for Expedia Collect reservations or upon arrival for Hotel Collect reservations.
`SERVICE_FEES`	Fees that only apply to guests who make use of specific facilities or services, such as resort fees, parking fees, or fees for rollaway beds.
`RECONCILED_AMOUNT`	Updated rate, which must be the commissionable value for the stay date. Amounts for dates included in the original reservation cannot be modified to a value of three times more than the commissionable rate applicable to that date.

SupplierRate

Object

Field	Description
`fromDate`	Not nullable. Date when the rate becomes effective (format: YYYY-MM-DD). Type: LocalDate
`rateItems`	Not nullable. Itemized list of fees. Type: Array of non nullable SupplierRateItem
`rateTimeUnit`	Not nullable. Time unit of the rate. Type: RateTimeUnit
`toDate`	Not nullable. Date when the rate expires (format: YYYY-MM-DD). Type: LocalDate

SupplierRateItem

Object

Field	Description
`amount`	Not nullable. Amount of the fee. Type: Float
`feeType`	Not nullable. Type of fee for this itemized rate. Type: SupplierFeeType

SupplierTotal

Object

Field	Description
`amountAfterTax`	Not nullable. Total amount of the fee after tax is applied. Type: Float
`amountBeforeTax`	Not nullable. Total amount of the fee before tax is applied. Type: Float

Availability and Rates APIs

Booking APIs

Property Mgmt APIs

Reservations

cancelReservationReconciliation mutation

Syntax

Example

Arguments

Types

Availability and Rates APIs

Booking APIs

Property Mgmt APIs

Reservations

cancelReservationReconciliation mutationCopy link

Syntax

Example

Arguments

Types

cancelReservationReconciliation mutation