Skip to main content

External Reservation Update

PATCH 
/v1/api/externalReservation/:reservationId

This API endpoint allows the update of existing hotel reservations. It enables clients to modify reservation details based on specific criteria provided in the request payload.

Clients can send a PATCH request to this endpoint with appropriate parameters, including the reservation ID to be updated and the new details to be applied, such as revised check-in/out dates, room type changes, guest information updates, or additional requests.

The endpoint ensures flexibility by allowing partial updates, enabling clients to modify only the necessary fields without having to resend the entire reservation details.

Upon successful update, the client application will receive a confirmation response containing the updated reservation details, including any changes made and the new booking status.

In case of errors or conflicts during the update process, the response structure is designed to provide detailed information on the issue encountered, facilitating efficient error handling and resolution.

Request​

Path Parameters

    reservationId stringrequired

Body

    externalId stringrequired

    ID único da reserva (locator ou ID retornado no CreateExternalReservation).

    locator stringnullable

    ID que o hóspede conhece.

    hotelId stringnullable

    ID do Hotel

    startDate stringnullable

    Dia do checkin. (ISO 8601)

    endDate stringnullable

    Dia do checkout. (ISO 8601)

    numberOfNights integernullable

    Número de noites.

    status stringnullable

    Status da reserva [CONFIRMED ou CANCELLED].

    source stringnullable

    Origem da reserva.

    primaryGuestName stringnullable

    Nome do hóspede principal.

    primaryGuestCpf stringnullable

    CPF do hóspede principal.

    primaryGuestEmail stringnullable

    Email do hóspede principal.

    currency stringnullable

    Moeda. (código ISO 4217)

    netPrice numbernullable

    Valor sem impostos.

    taxesPrice numbernullable

    Valor dos impostos.

    adultCount integernullable

    Número de adultos.

    childrenCount integernullable

    Número de crianças.

    childrenAges integer[]nullable

    Lista com a idade das crianças.

    roomDescription stringnullable

    Nome do quarto.

    ratePlanName stringnullable

    Nome da tarifa.

    isNonRefundable booleannullable

    Indica se a tarifa é não reembolsável.

    penaltyDate stringnullable

    Dia em que começa a penalidada caso reserva seja reembolsável. (ISO 8601)

    meal stringnullable

    Regime de alimentação.

    comissionPrice numbernullable

    Valor da comissão.

    comment stringnullable

    Comentários da reserva.

    guestJourneyStatus stringnullable

    Status da jornada do Hóspede [CHECKED_IN, CHECKED_OUT, NO_SHOW].

    primaryGuestExternalId stringnullable

    ID do seu sistema do hóspede principal.

    reservationId string

    ID Niara de reserva externa.

Responses​

UpdateExternalReservationResponse()

Schema

    object

Loading...