External Reservation Creation
POST/v1/api/externalReservation/create
Endpoint to create hotel reservations in the Niara system from an external call.
If the sent locator (Niara reservation ID) already exists, the request is treated as an update: the existing reservation will be updated with the new data instead of creating a new one.
Request
- application/json
Body
Hotel ID
Check-in day. (ISO 8601)
Check-out day. (ISO 8601)
Number of nights.
Reservation status [CONFIRMED or CANCELLED].
Primary guest's name.
Primary guest's email.
Currency. (ISO 4217 code)
Value without taxes.
Tax amount.
Number of adults.
Number of children.
List with the children's ages.
Room name.
Rate plan name.
Meal plan.
Hotel Name
Reservation source.
ID known by the guest.
Indicates if the rate is non-refundable.
Day the penalty starts if the reservation is refundable. (ISO 8601)
Commission value.
Reservation comments.
Guest journey status [CHECKED_IN, CHECKED_OUT, NO_SHOW, CONFIRMED or CANCELLED].
Primary guest's ID from your system.
Primary guest's CPF.
Primary guest's passport number.
Primary guest's nationality (two-letter ISO code).
Primary guest's RG identity number (for brazilian citizens).
Primary guest's RG issuing authority (for brazilian citizens).
Primary guest's phone number.
Primary guest's date of birth.
Primary guest's address street.
Primary guest's address number.
Primary guest's address zip code.
Primary guest's address complement.
Primary guest's address neighborhood.
Primary guest's address city.
Primary guest's address state.
Responses
- 200
Reservation successfully created.
- application/json
- Schema
- Example (from schema)
Schema
Niara ID of the created reservation.
{
"reservationId": "string"
}