예약 생성

빠른 설정

단일 객실 예약은 대부분 2-3분이면 완료됩니다. 여러 객실이 있는 예약은 조금 더 걸립니다.

워크인, 전화 예약, 또는 여러 객실이 포함된 하나의 예약을 추가해야 할 때 AVA에서 직접 새 예약을 생성하세요.

이동: Operations View

---

빠른 참고

필드	필수	참고
First Name	✓ 예	게스트 이름
Last Name	✓ 예	게스트 성
Check-in Date	✓ 예	형식: YYYY-MM-DD
Check-out Date	✓ 예	형식: YYYY-MM-DD
Room Type	✓ 예	객실마다 하나의 유형을 선택
Rate	상황에 따라 다름	eZee 예약에는 필수
Rooms	아니오	여러 객실 예약은 Add another room을 클릭
Nationality/Country	✓ 예	검색 가능한 목록, 가능하면 호텔 국가가 기본값으로 표시됨
Adults	아니오	기본값 1
Children	아니오	기본값 0
Infants	아니오	기본값 0
Email	상황에 따라 다름	Cloudbeds와 eZee에서 필수
Phone Number	아니오	게스트 전화번호

---

예약 생성하기

1. Operations View로 이동합니다.

2. Create Reservation을 클릭합니다.

3. 객실 1의 투숙 정보를 입력합니다.

   • Check-in date
   • Check-out date
   • Room type
   • eZee 예약의 경우 Rate
   • Adults, Children, Infants
   • 추가 객실이 있으면 각 객실마다 Add another room을 클릭
   • OTA Number(선택 사항)

4. 게스트 정보를 입력합니다.

   • First Name(필수)
   • Last Name(필수)
   • Email(Cloudbeds와 eZee에서는 필수, 모든 PMS에서 권장)
   • Phone Number(선택 사항이지만 연락용으로 권장)
   • Nationality/Country(정부 규정 준수를 위해 필수)
     • 입력을 시작해 검색한 뒤 결과를 선택합니다(또는 Enter를 눌러 상단 일치 항목을 선택).

5. Create Reservation을 클릭합니다.

   ✓ 예약이 예약 목록에 표시됩니다.

단일 및 다객실 예약

객실이 하나면 익숙한 평면 레이아웃이 유지됩니다. 두 번째 객실을 추가하면 번호가 붙은 객실 카드와 요약 칩이 표시됩니다.

"OTA Number"란 무엇인가요?

OTA Number는 Booking.com이나 Expedia 같은 외부 예약 참조 번호를 저장할 때 사용합니다. 직접 예약이면 비워 두세요.

AVA PMS 전용

입력하는 동안 기존 게스트를 검색하고 선택할 수 있습니다.

Nationality/Country 검색

Nationality/Country에 입력을 시작하면 목록이 필터링됩니다. 호텔 국가가 설정되어 있으면 해당 값이 미리 채워집니다.

eZee 예약

eZee를 사용한다면 저장하기 전에 Rate를 선택하고 게스트 Email을 입력하세요. AVA는 선택한 요금 세부 정보를 예약과 함께 eZee로 전송합니다.

---

예약 생성 후

예약 생성에 성공하면 즉시 객실을 배정할 수 있는 확인 메시지가 표시됩니다.

AVA는 백그라운드 새로고침도 시작하므로 새 예약이 최신 목록에 표시됩니다.

다음을 할 수 있습니다.

• 한 객실 예약은 Assign Room 클릭
• 여러 객실 예약은 Assign Rooms 클릭
• 나중에 객실을 배정하려면 Skip for Now 클릭

객실 배정 전에 예약 새로고침

Assign Room을 클릭하면 AVA가 객실 목록을 열기 전에 예약을 새로고침합니다. 새로고침이 지연되면 AVA는 최신 예약 세부 정보를 사용합니다.

즉시 객실 배정

Assign Room을 클릭하면 Room Assignment 모달이 열리고 다음 내용이 표시됩니다.

• 예약의 객실 유형으로 필터링된 사용 가능한 객실
• 객실 상태 배지(Clean, Vacant 등)
• 객실 번호로 검색하는 옵션
• PMS에서 새로고침된 예약 스냅샷

eZee의 경우 같은 유형 객실은 선택기에서 계속 보입니다. 객실 배정 규칙이 허용하면 더러운 상태의 Vacant 객실도 계속 사용할 수 있습니다.

객실 교체 감지

이미 다른 게스트에게 배정된 객실을 선택하면 시스템이 객실 교체를 확인하라고 요청합니다. 이전 게스트는 해당 객실에서 자동으로 배정 해제됩니다.

---

기존 게스트 프로필 사용(AVA PMS 전용)

숙소에서 AVA를 PMS로 사용한다면 기존 게스트 프로필을 검색하고 선택해 게스트 정보를 자동으로 채울 수 있습니다.

기존 게스트 검색

1. First Name, Last Name, 또는 Email 필드에 입력을 시작합니다.

2. 검색을 트리거하려면 최소 두 글자를 입력합니다.

3. 제안 드롭다운이 나타날 때까지 기다립니다.

4. 목록에서 게스트를 선택합니다.

   ✓ 게스트 정보(이름, 이메일, 전화번호, 국적)가 프로필에서 자동으로 채워집니다.

5. 필요하면 세부 정보를 확인하고 조정합니다.

6. 투숙 정보를 완료한 뒤 Create Reservation을 클릭합니다.

게스트 프로필의 장점

기존 게스트 프로필을 선택하면:

• 데이터 입력 시간을 줄일 수 있습니다
• 게스트 정보의 일관성을 유지할 수 있습니다
• 예약이 게스트 이력과 연결됩니다

제안이 나타나지 않을 때

드롭다운이 보이지 않으면:

• PMS가 AVA인지 확인하세요(이 기능은 AVA 전용입니다)
• 최소 두 글자를 입력하세요
• 결과가 로드될 때까지 2-3초 기다리세요
• 인터넷 연결을 확인하세요

게스트를 찾지 못하면 수동으로 계속 입력하세요. 새 게스트 프로필이 생성됩니다.

---

필드 상세

투숙 정보

필드	설명	검증
Check-in Date	게스트 도착일	YYYY-MM-DD 형식이어야 함
Check-out Date	게스트 출발일	체크인 날짜보다 뒤여야 함
Room Type	예약할 객실 유형	드롭다운에서 선택해야 함
Adults	성인 게스트 수	최소 1, 기본값 1
Children	아동 게스트 수	최소 0, 기본값 0
Infants	유아 게스트 수	최소 0, 기본값 0

게스트 정보

필드	설명	검증
First Name	게스트 이름	필수, 최소 1자
Last Name	게스트 성	필수, 최소 1자
Email	연락용 이메일	유효한 이메일 형식
Phone Number	연락처 전화번호	어떤 형식이든 허용
Nationality/Country	게스트 국적	검색 가능한 목록, 가능하면 호텔 국가가 기본값으로 표시됨
Gender	게스트 성별	선택 사항: Male, Female, Other

선택 필드

필드	설명	사용할 때
Payment Method	게스트가 결제할 방식	결제 유형을 추적할 때
OTA Number	외부 예약 참조 번호	예약이 OTA에서 시작된 경우
Source	예약 유입 경로	예약이 어디서 왔는지 추적할 때

---

PMS별 동작

Cloudbeds

• 예약에 숙소의 source ID가 포함됩니다
• 예약 생성 시 Email이 필수입니다
• 게스트에게 이메일 확인이 자동으로 발송됩니다
• 제공한 경우 결제 수단이 기록됩니다

Opera

• Opera 예약은 Operations View에서 생성할 수 있습니다
• 저장하기 전에 유효한 Rate Plan Code, Market Code, Source Code를 입력하세요
• Opera 예약은 예약당 하나의 객실만 지원합니다
• 일부 고급 필드는 동기화되지 않을 수 있습니다

Mews

• Mews 예약과 완전히 통합됩니다
• 게스트 프로필이 자동으로 동기화됩니다

eZee

• 예약을 저장하기 전에 Rate를 선택하세요
• 예약을 저장하기 전에 게스트 Email을 입력하세요
• AVA는 선택한 eZee 요금 메타데이터를 예약과 함께 상위 시스템으로 전송합니다
• 객실 선택기는 배정 중에도 같은 유형 객실을 계속 보여줍니다

AVA

• 게스트 검색과 선택을 사용할 수 있습니다
• 선택하면 기존 게스트 프로필과 연결됩니다
• 전체 게스트 이력이 유지됩니다
• 객실 유형이 없으면 AVA가 Rooms 링크가 있는 경고를 표시합니다

---

문제 해결

"First name and last name are required"

보이는 현상: 저장할 때 폼 유효성 검사 오류가 표시됩니다.

해결:

1. First Name과 Last Name을 모두 입력합니다.
2. 앞뒤 공백을 제거합니다.
3. Create Reservation을 다시 클릭합니다.

"Please fill all required fields" (Cloudbeds email missing)

보이는 현상: 이름, 날짜, 객실 유형, 국적을 입력했지만 폼이 계속 저장되지 않습니다.

해결:

1. 게스트 Email을 입력합니다.
2. Create Reservation을 다시 클릭합니다.

"Please fill all required fields" after adding another room

보이는 현상: 두 번째 객실을 추가했지만 폼이 계속 저장되지 않습니다.

해결:

1. 각 객실 카드를 확인합니다.
2. 모든 객실에 대해 Room Type을 선택합니다.
3. Create Reservation을 다시 클릭합니다.

"Check-in and check-out dates are required"

보이는 현상: 날짜가 누락되었다는 폼 유효성 검사 오류가 표시됩니다.

해결:

1. Check-in Date와 Check-out Date를 모두 선택합니다.
2. 체크아웃이 체크인보다 뒤인지 확인합니다.
3. 날짜 선택기를 사용하거나 YYYY-MM-DD 형식으로 입력합니다.

"Nationality/Country is required"

보이는 현상: 국적이 없으면 폼이 저장되지 않습니다.

해결:

1. Nationality/Country 드롭다운을 엽니다.
2. 입력을 시작해 목록을 필터링합니다.
3. 게스트의 국가를 선택합니다.
4. Create Reservation을 다시 클릭합니다.

준수 요구 사항

많은 국가에서 정부 보고를 위해 게스트 국적을 요구합니다(예: 태국 TM30). 이 필드는 건너뛸 수 없습니다.

"eZee rates are missing"

보이는 현상: Rate 필드가 비어 있거나 eZee 예약을 저장할 수 없습니다.

해결:

1. 예약이 올바른 객실 유형을 사용하는지 확인합니다.
2. 요금이 로드될 때까지 몇 초 기다립니다.
3. 요금이 eZee에 게시되어 있는지 확인합니다.
4. 예약 폼을 다시 연 뒤 재시도합니다.

"No countries found"

보이는 현상: Nationality/Country 목록에 "No countries found"가 표시됩니다.

해결:

1. 검색 텍스트를 지웁니다.
2. 국가 이름의 최소 2글자를 입력합니다.
3. 필터링된 목록에서 올바른 국가를 선택합니다.

게스트 제안이 표시되지 않음(AVA)

보이는 현상: 이름/이메일 필드에 입력해도 드롭다운이 나타나지 않습니다.

확인:

• PMS가 AVA인지 확인(기능은 AVA 전용)
• 최소 두 글자를 입력했는지 확인
• 결과가 로드될 때까지 몇 초 기다렸는지 확인

해결:

1. 검색 범위를 좁히도록 글자를 더 입력합니다.
2. 인터넷 연결을 확인합니다.
3. 신규 게스트라면 수동으로 계속 입력합니다.

객실 유형 드롭다운이 비어 있음

보이는 현상: 선택할 수 있는 객실 유형이 없습니다.

해결:

1. Settings → PMS Integration에서 PMS 연결을 확인합니다.
2. Rooms를 열고 Room Types를 클릭합니다.
3. Add Room Type을 클릭해 최소 하나의 객실 유형을 생성합니다.
4. Create Reservation으로 돌아가 폼을 다시 엽니다.
5. 객실 유형이 계속 보이지 않으면 지원팀에 문의합니다.

AVA 알림

PMS가 AVA라면 다음 메시지가 보일 수 있습니다. "No room types found. Please create a room type in the Rooms page first." 이 안내의 Rooms page 링크를 사용하면 빠르게 해결할 수 있습니다.

저장 후 예약이 보이지 않음

보이는 현상: 성공 메시지는 보이지만 목록에서 예약이 보이지 않습니다.

해결:

1. 자동 새로고침이 끝날 때까지 5-10초 기다립니다.
2. 날짜 필터가 예약 날짜와 일치하는지 확인합니다.
3. 게스트 이름 또는 confirmation number로 검색합니다.
4. 그래도 없으면 툴바에서 Refresh를 한 번 클릭합니다.
5. PMS에서 예약을 직접 확인합니다.

"Unable to refresh reservation details"

보이는 현상: "Unable to refresh reservation details. Using the latest available data."라는 경고 메시지가 표시됩니다.

해결:

1. 객실 목록이 열릴 때까지 최대 30초 기다립니다.
2. 모달이 나타나면 객실 배정을 계속합니다.
3. 객실을 배정한 뒤 툴바에서 Refresh를 클릭합니다.

"PMS configuration is inactive"

보이는 현상: PMS 설정에 대한 오류 메시지가 표시됩니다.

해결:

1. Settings → PMS Integration으로 이동합니다.
2. PMS가 연결되어 있고 활성 상태인지 확인합니다.
3. 연결이 만료되었으면 자격 증명을 다시 입력합니다.
4. 문제가 계속되면 지원팀에 문의합니다.

날짜 형식이 올바르지 않음

보이는 현상: 날짜 필드가 입력을 거부합니다.

해결:

• 직접 입력하지 말고 날짜 선택기를 사용합니다.
• 직접 입력해야 한다면 YYYY-MM-DD 형식을 사용합니다(예: 2025-03-15).
• MM/DD/YYYY 또는 DD-MM-YYYY 같은 형식은 사용하지 않습니다.

---

모범 사례

워크인 게스트

1. 예약을 만들기 전에 신분증을 수집하고 게스트 정보를 확인합니다.
2. 가용성에 따라 올바른 객실 유형을 선택합니다.
3. 확인 메일 발송을 위해 이메일과 전화번호를 입력합니다.
4. 생성 후 특별 요청 사항은 예약 노트에 추가합니다.

전화 예약

1. 통화 중에 게스트 이름 철자를 확인합니다.
2. 날짜와 객실 유형을 다시 확인합니다.
3. 확인 메일 발송용 이메일을 확보합니다.
4. 전화를 끊기 전에 세부 정보를 다시 읽어 줍니다.

그룹 예약

같은 게스트 그룹이 두 개 이상의 객실을 필요로 할 때는 여러 객실이 포함된 하나의 예약을 사용합니다.

1. 대표 게스트 정보를 한 번만 입력합니다.
2. 추가 객실마다 Add another room을 클릭합니다.
3. 모든 객실 카드에 객실 유형을 선택합니다.
4. 저장 전에 게스트 수를 다시 확인합니다.
5. 게스트나 숙박 날짜가 다르면 별도의 예약을 사용합니다.

---

아직 막혔나요?

다음에 해당하면 success@vouch-technologies.com으로 문의하세요.

• ❌ Create Reservation 버튼이 없음
• ❌ 예약 저장이 반복적으로 실패함
• ❌ 재연결 후에도 PMS 동기화 오류가 계속됨

함께 보내면 좋은 정보:

• 게스트 이름과 날짜
• 오류 메시지(가능하면 스크린샷)
• PMS 유형(Cloudbeds, Opera, Mews, eZee, AVA)

관련 가이드

• 예약 세부 정보 보기
• 예약 수정 및 메모 추가
• 게스트 프로필 찾기 및 수정
• PMS 연결 설정