호텔 기본 세부 정보 설정
대부분의 호텔은 Hotel Name, Country, Timezone, Property currency 네 가지만 설정하면 됩니다. 약 2분이면 완료됩니다.
호텔의 기본 세부 정보는 AVA 전반과 고객용 문서에 표시됩니다. 이를 정확하게 설정하면 시간 표시, 지역 형식 및 숙소 브랜딩을 올바르게 일관되게 유지할 수 있습니다. Streamliner에서 숙소 통화를 관리하는 곳은 여기뿐입니다. 결제 설정은 이 값을 읽으며 별도의 통화 필드를 관리하지 않습니다. AVA PMS가 지원되는 숙소의 경우 Streamliner가 PMS에서 관리하는 통화를 읽고 업데이트할 수 있습니다.
이동: Settings → Essentials → Hotel Basic Details
구성할 항목
| 설정 | 제어 내용 | 고객에게 표시되는 위치 |
|---|---|---|
| Hotel Name | AVA 전반의 숙소명 | 체크인 화면, 이메일, 영수증 |
| Country | 지역 기능 및 규정 준수 | 고객 양식, 국적 목록 |
| Timezone | 모든 날짜/시간 표시 | 확인 시간, 일정 |
| Property currency | 보증금 및 예약 결제 표시에 사용하는 단일 기준 통화 | 예약 카드, 결제 요약, 보증금 흐름 |
단계별 설정
1. 호텔 이름 입력
Hotel Name 필드에 호텔의 공식 상호를 입력하세요.
| ✓ 좋은 예 | ✗ 피해야 할 예 |
|---|---|
| Sunset Beach Resort & Spa | sunset beach (소문자) |
| The Grand Hotel Bangkok | Test Hotel 1 |
| Lub D Silom | My Property |
이 이름은 등록 카드, 도착 전 이메일 및 영수증에 표시됩니다. 공식 등록 상호와 일치해야 합니다.
2. 국가 선택
- Country 드롭다운을 클릭합니다.
- 국가 이름을 입력해 검색을 시작합니다.
- 목록에서 선택합니다.
국가를 선택하면 Timezone이 자동으로 채워질 수 있습니다. Property currency는 PMS가 기준 시스템이 아닐 때만 자동으로 채워집니다. 쓰기 가능한 PMS에 통화가 없으면 국가를 기준으로 한 통화가 제안으로 표시됩니다. 이를 채택하기 전에는 저장되지 않습니다.
Country로 활성화되는 항목:
- 지역별 고객 양식 필드(예: 태국의 TM30)
- 적절한 국적 및 직업 목록
- 예약 및 고객 프로필에서 사용하는 공통 국가 검색
- 현지 규정 준수 워크플로
AVA는 각 국가를 TH처럼 표준 두 글자 ISO 코드로 저장합니다.
국가가 이전에 소문자로 저장된 기존 숙소도 계속 호환됩니다.
국가명으로 선택하면 되며 코드를 변환할 필요는 없습니다.
국가를 찾을 수 없나요?
다음과 같이 바꿔서 시도해 보세요.
- "USA" 대신 "United States"
- "UK" 대신 "United Kingdom"
- 영어로 된 공식 국가 또는 영토 이름
AVA는 설정, 예약 및 고객 프로필에서 하나의 공통 국가 목록을 사용합니다. 일부 영토도 이제 검색 결과에 표시됩니다.
여전히 찾을 수 없다면 국가명을 적어 success@vouch-technologies.com으로 이메일을 보내 주세요.
3. 시간대 선택
숙소 현지 시간과 일치하는 시간대를 선택하세요.
| 현재 위치 | 선택 |
|---|---|
| 태국 | Asia/Bangkok |
| 싱가포르 | Asia/Singapore |
| 미국 동부 | America/New_York |
| 미국 서부 | America/Los_Angeles |
| 영국 | Europe/London |
| 중부 유럽 | Europe/Paris |
| 일본 | Asia/Tokyo |
| 호주(시드니) | Australia/Sydney |
시간대 변경은 모든 예약 작업, 예약 시간 및 보고서에 영향을 줍니다. 운영 중인 숙소에서 변경하기 전에 팀과 조율하세요.
4. 숙소 통화 검토
- Property currency 필드를 찾습니다.
- 국가에서 통화를 제안하면 표시된 코드를 검토합니다.
- 제안을 채택하려면 Use the displayed currency as property currency를 클릭합니다.
- PMS에 통화가 없으면 필요에 따라 다른 값을 선택합니다.
- PMS에서 관리하는 통화를 저장하기 전에 확인 경고를 검토합니다.
- Change currency를 클릭해 확인하거나, 통화를 변경하지 않으려면 취소합니다.
- 예약 결제 표시에 동일한 통화가 나타나는지 확인합니다.
- Payment 설정이 이 값을 자동으로 사용한다는 점을 기억합니다.
제안된 통화를 채택한 후에는 Country를 변경해도 통화가 바뀌지 않습니다. 새 국가의 통화를 사용하려면 다시 선택하고 채택하세요.
AVA는 금액을 환산하지 않고 가격에 표시되는 통화만 변경합니다. 기존 예약은 현재 통화를 유지합니다. 확인하기 전에 보증금 금액과 체크아웃 반올림 기준을 검토하세요.
PMS가 통화를 소유하지만 쓰기를 지원하지 않으면 필드가 잠긴 상태로 유지됩니다. 대신 해당 PMS에서 통화를 업데이트하세요.
페이지가 아직 로드 중이면 통화에 임시 기본값이 표시될 수 있습니다. 숙소 통화를 선택하거나 채택하기 전에 페이지 로드가 완료될 때까지 기다리세요. AVA는 해당 임시 값을 호텔의 통화로 저장하지 않습니다.
5. 변경 사항 저장
-
Save를 클릭합니다.
-
초록색 확인 메시지가 나타날 때까지 기다립니다.
✓ "Settings saved successfully"
저장 후 변경 사항
| 변경 | 영향 |
|---|---|
| Hotel Name 업데이트 | 이후 생성되는 모든 고객 문서에 새 이름이 표시됨 |
| Country 변경 | 국가별 기능이 즉시 활성화됨 |
| Timezone 변경 | AVA는 표시, Activity 및 새 객실 접근 유효 기간에 저장된 숙소 시간대를 사용함 |
| AVA에서 Property currency 변경 | AVA가 PMS 가격의 통화 표기를 변경하고 기존 예약은 현재 통화로 유지함 |
| Property currency 변경(Essentials에서 관리) | 동기화 후 보증금 금액 라벨과 예약 결제 표시에 새 기본값이 사용됨 |
| Property currency 잠금(PMS에서 관리) | AVA는 보증금, 객실 및 결제 표시에서 PMS 통화를 기준으로 유지함 |
즉시 확인 가능한 항목:
- ✓ 내비게이션 바의 호텔 이름
- ✓ 지역 날짜 형식(MM/DD 또는 DD/MM)
- ✓ 현지 시간대 기준 시간
빠른 키오스크 설정(선택 사항)
새 숙소나 테스트 환경을 설정할 때는 Quick Kiosk Setup을 사용해 Country와 Timezone에 기반한 적절한 기본값을 적용할 수 있습니다.
- 최소 고객 연령
- 자동 체크인 시간
- 기본 언어
이렇게 하면 모든 설정을 수동으로 구성하지 않아도 직원이 바로 고객 흐름을 테스트할 수 있습니다.
문제 해결
시간이 잘못 표시됨
보이는 현상: 예약 시간, 체크인 시간 또는 보고서에 잘못된 시간이 표시됩니다.
해결:
- Settings → Essentials → Hotel Basic Details로 이동합니다.
- Timezone 선택이 숙소의 실제 시간대와 일치하는지 확인합니다.
- Save를 클릭합니다.
- 로그아웃했다가 다시 로그인합니다.
- 여전히 올바르지 않으면 브라우저 캐시를 지우고 새로고침합니다.
객실 접근 자격 증명을 생성할 수 없음
보이는 현상: 시간대를 변경한 후 스마트 잠금장치 PIN, 보관함 코드 또는 키카드 요청이 실패합니다.
해결:
- Timezone이 선택되어 있고 숙소의 현지 시간대와 일치하는지 확인합니다.
- Save를 클릭하고 성공 메시지가 나타날 때까지 기다립니다.
- 예약을 새로고침하거나 객실 접근 흐름을 다시 엽니다.
- PIN, 보관함 코드 또는 키카드를 다시 생성합니다.
AVA는 새 객실 접근 요청에 가장 최근에 저장된 시간대를 사용합니다. 설정이 올바르지 않을 때 UTC나 싱가포르 시간을 조용히 사용하지 않습니다.
변경 사항이 저장되지 않음
보이는 현상: Save를 눌러도 설정이 되돌아가거나 아무 일도 일어나지 않습니다.
확인:
- Hotel Name 필드가 비어 있지 않음
- 드롭다운에서 국가가 선택됨
- 유효성 검사 오류(빨간 텍스트)가 없음
모든 필드가 유효한 경우:
- 페이지를 새로고침합니다.
- 변경 사항을 다시 입력합니다.
- Save를 다시 클릭합니다.
"Hotel context mismatch" 또는 "Merchant ID mismatch"가 보이면:
- 페이지를 새로고침합니다.
- 상단 바에서 올바른 호텔이 선택되어 있는지 확인합니다.
- 다시 변경한 뒤 Save를 클릭합니다.
- 여전히 실패하면 로그아웃 후 다시 로그인합니다.
추가 도움말: 호텔 전환 후 설정이 저장되지 않음
변경 사항이 적용된 후 저장 오류가 표시됨
보이는 현상: AVA에 오류가 표시되지만 다른 설정 서비스에서는 변경 사항을 적용했을 수 있습니다.
해결:
- Save를 반복해서 클릭하지 마세요.
- Settings → Essentials를 새로고침합니다.
- 새 값이 계속 저장되어 있는지 확인합니다.
- 설정이 PMS 또는 결제에 영향을 주는 경우 관련 서비스를 확인합니다.
- 값이 여전히 없을 때만 다시 저장합니다.
오류가 발생했다고 해서 모든 설정 저장이 항상 실패한 것은 아닙니다. AVA는 실패한 단계를 보고하지만, 서비스에서 승인된 저장 작업을 자동으로 롤백하지는 않습니다.
국가 선택 후 시간대가 변경됨
보이는 현상: Country를 업데이트한 뒤 Timezone 필드가 바뀝니다.
해결:
- 자동으로 채워진 Timezone이 숙소에 맞는지 확인합니다.
- 필요하면 드롭다운에서 올바른 시간대를 선택합니다.
- Save를 클릭합니다.
국가 선택 후 통화가 변경됨
보이는 현상: Country를 업데이트한 뒤 Property currency 필드가 바뀝니다.
해결:
- 필드가 편집 가능한지, PMS 관리인지 확인합니다.
- 편집 가능하면 원하는 통화를 선택하고 Save를 클릭합니다.
- PMS 관리라면 PMS에서 통화를 업데이트하고 동기화를 기다립니다.
- Settings → Essentials를 새로고침하고 값을 확인합니다.
국가 통화 제안이 저장되지 않음
보이는 현상: 국가를 선택한 후 통화가 표시되지만 저장해도 해당 통화로 설정되지 않습니다.
해결:
- PMS가 숙소 통화 쓰기를 지원하는지 확인합니다.
- Use the displayed currency as property currency를 클릭합니다.
- Save를 클릭합니다.
- 가격에 표시되는 통화가 변경된다는 경고를 검토합니다.
- Change currency를 클릭해 확인합니다.
- 성공 메시지가 나타날 때까지 기다린 다음 페이지를 새로고침합니다.
통화는 Use를 클릭하기 전까지 국가에서 제안한 값일 뿐입니다. 경고를 취소하면 PMS 통화는 변경되지 않습니다.
숙소 통화에 임시 기본값이 표시됨
보이는 현상: Settings → Essentials가 로드되는 동안 Property currency 필드에 기본값이 표시됩니다.
해결:
- 페이지 로드가 완료될 때까지 기다립니다.
- 실제 통화가 표시되지 않으면 Settings → Essentials를 새로고침합니다.
- 통화가 PMS 또는 호텔 기록과 일치하는지 확인합니다.
- 통화를 설정하거나 변경하려는 경우에만 통화를 선택합니다.
- 전체 양식을 검토한 후 Save를 클릭합니다.
AVA는 로드되지 않은 통화를 임시 값으로 처리합니다. 해당 값을 채택하도록 제안하지 않으며 국가를 변경한 후 해당 값으로 통화를 바꾸지도 않습니다.
숙소 통화가 잠겨 있음
보이는 현상: Hotel Basic Details에서 Property currency를 수정할 수 없습니다.
해결:
- Settings → Essentials → PMS Integration을 엽니다.
- PMS가 연결되어 있고 숙소 통화를 전송하는지 확인합니다.
- AVA가 아니라 PMS에서 통화를 업데이트합니다.
- PMS 동기화 후 Settings → Essentials를 새로고침합니다.
- Settings → Payment를 확인해 보증금 금액이 이제 업데이트된 통화를 사용하는지 확인합니다.
AVA 통화 변경을 확인할 수 없음
보이는 현상: AVA가 PMS에서 통화 변경을 확인할 수 없습니다.
해결:
- PMS 연결이 온라인 상태인지 확인합니다.
- 호텔이 올바른 PMS 연결을 사용하는지 확인합니다.
- 잠시 기다린 다음 Settings → Essentials → Hotel Basic Details를 다시 불러옵니다.
- 통화를 다시 선택하고 변경을 확인합니다.
AVA는 확인되지 않은 통화를 미러에 적용하지 않습니다. AVA가 저장을 확인할 때까지 새 통화를 사용하지 마세요.
PMS에서 선택한 통화를 거부함
보이는 현상: AVA에서 PMS가 통화를 거부했거나 이미 다른 통화를 사용하고 있다고 보고합니다.
해결:
- PMS에서 숙소의 통화를 직접 확인합니다.
- Settings → Essentials에서 PMS 통화를 사용합니다.
- PMS가 원하는 통화를 승인한 후에만 다시 저장합니다.
PMS가 변경을 거부하면 AVA는 미러를 업데이트하지 않습니다.
계속 막히나요?
다음 경우 success@vouch-technologies.com으로 문의하세요.
- ❌ PMS 동기화 후에도 숙소 통화가 비어 있음
- ❌ 통화는 잠겨 있는데 PMS에는 다른 값이 표시됨
- ❌ 예약 결제 통화가 30분 이상 계속 잘못됨
- ❌ 다시 시도한 후에도 AVA에서 통화 변경을 확인할 수 없음
관련 가이드
- Payment Gateway — 보증금 및 결제 수금 규칙 설정
- PMS Integration — 숙소 관리 시스템 연결
- Thailand Immigration Reports — TM30 및 RR4 설정(해당하는 경우)