QRLOCK 디지털 키 설정

빠른 설정

QR Master 정보를 준비하고 객실을 매핑한 다음 게스트 링크 하나를 테스트하세요. 약 15분 정도 소요됩니다.

이 가이드는 QRLOCK을 연결하고 AVA를 통해 호스팅된 디지털 객실 키를 발급하는 방법을 설명합니다.

빠른 참고

작업	필요한 항목	작업 위치
QRLOCK 연결	QR Master SID, Auth Token, Community Number	Settings → Room Access
객실 매핑	정확한 PMS 객실 ID와 QRLOCK 객실	QRLOCK Room Mapping
출입 테스트	테스트 예약과 연결 가능한 QRLOCK 리더	체크인 또는 예약 세부 정보
출입 관리	현재 키, 게스트 이메일 또는 직원 작업	예약 또는 Access Codes

시작하기 전에

다음 요구 사항을 확인하세요.

• QRLOCK 계정에 QR Master SID가 제공됩니다.
• 이에 대응하는 Auth Token이 있습니다.
• QRLOCK Community Number를 알고 있습니다.
• 벤더 시스템에 QRLOCK 객실이 생성되어 있고 사용할 수 있습니다.
• PMS 객실 ID가 안정적이고 고유한 문자열입니다.
• 프로덕션에서 AVA가 공용 HTTPS 게스트 키 origin을 사용합니다.

자격 증명을 안전하게 보관하세요

AVA는 QRLOCK 자격 증명과 게스트 링크를 암호화합니다. 토큰을 스크린샷, 지원 메시지 또는 공유 메모에 붙여 넣지 마세요.

게스트 키 서비스 URL 확인

배포 관리자는 게스트 링크에 기존 Room Access Service URL을 사용해야 합니다. Room Access URL이 구성되지 않은 경우에만 AVA가 애플리케이션 URL을 사용합니다.

설정	용도
Room Access Service URL (ROOM_ACCESS_BASE_URL)	/guest-key 및 /guest-key/client.js의 기본 origin
Application URL (APP_BASE_URL)	Room Access URL이 설정되지 않았을 때 사용하는 대체 origin

선택한 URL은 프로덕션에서 공용 HTTPS origin이어야 합니다. 경로, 쿼리, fragment 또는 로그인 자격 증명을 포함하면 안 됩니다. 별도의 게스트 origin 설정을 추가하지 마세요.

테스트하기 전에 배포 관리자에게 두 게스트 경로가 모두 로드되는지 확인해 달라고 요청하세요.

QRLOCK 연결

1. Settings → Room Access로 이동합니다.

2. QR 디지털 키 연결 옵션을 선택합니다.

3. 공급자로 QRLOCK을 선택합니다.

4. QR Master SID, Auth Token, Community Number를 입력합니다.

5. Test Connection을 선택합니다.

6. 테스트가 성공하면 연결을 저장합니다.

   ✓ AVA에 Connected가 표시되고 저장된 토큰이 마스킹되며 QRLOCK 객실 인벤토리가 로드됩니다.

지원되는 QR 리더

AVA는 이 디지털 키 흐름을 통해 QRALOCK 및 QRLOCK 리더 객실을 지원합니다. 다른 QR 모델 제품군은 계속 사용할 수 없습니다.

PMS 객실을 QRLOCK 객실에 매핑

1. QR 디지털 키 설정에서 QRLOCK Room Mapping을 엽니다.

2. PMS 객실을 선택합니다.

3. 인벤토리에서 일치하는 QRLOCK 객실을 선택합니다.

4. 보류 중인 매핑을 저장합니다.

5. QR 키를 받아야 하는 모든 객실에 대해 반복합니다.

   ✓ AVA에 객실이 매핑되었고 발급할 준비가 된 것으로 표시됩니다.

QRLOCK은 PMS 객실을 공유할 수 있습니다

같은 PMS 객실에 PIN 벤더 매핑을 유지할 수 있습니다. QRLOCK은 QRLOCK 매핑만 저장하고 변경합니다. 다른 벤더 매핑은 각자의 출입 흐름에서 계속 사용할 수 있습니다.

모든 객실을 명시적으로 매핑하세요

AVA는 비슷한 이름을 기준으로 QRLOCK 객실을 추측하지 않습니다. 매핑되지 않았거나 모호한 객실에는 QR 키를 발급할 수 없습니다.

게스트 QR 키 전달

QRLOCK 객실 할당이 가능한 경우 AVA는 객실 할당 후 키 하나를 발급합니다. AVA는 이메일 전송을 시작하기 전에 키를 저장합니다.

1. 게스트 체크인을 완료합니다.

2. 체크인된 객실의 Room Information을 엽니다.

3. QR 키 전달 상태를 확인합니다.

4. 필요한 경우 게스트 링크 작업을 사용하여 링크를 복사합니다.

   ✓ 게스트가 QR 안내가 포함된 객실 정보 이메일을 받습니다.

자동 발급 또는 직원 발급 후 동일한 키가 출입 기록에 표시되는지 확인합니다. 그런 다음 게스트 링크를 열고 호스팅된 QR 페이지가 로드되는지 확인합니다.

이메일 재시도에서는 같은 키를 다시 사용합니다. 다른 벤더 카드를 생성하지 않습니다.

객실 카드에는 Pending, Sent 또는 Staff assistance required가 표시될 수 있습니다. 이메일 수신 여부만으로 게스트가 문을 열었다고 판단할 수는 없습니다.

링크에는 예약 유효 기간이 적용됩니다. AVA는 게스트 링크를 PIN 액세스 코드와 별도로 관리합니다.

객실 정보 다시 보내기

게스트에게 현재 세부 정보를 다시 보내야 할 때 Email room information을 사용합니다.

1. 체크인된 예약 또는 객실 카드를 엽니다.

2. Email room information을 선택합니다.

3. 개인 게스트 이메일을 확인합니다.

   ✓ AVA가 기존 QR 키와 객실 세부 정보를 다시 보냅니다.

이메일 작업은 새 키를 발급하지 않습니다. OTA 프록시 주소가 아닌 개인 이메일 주소를 사용하세요.

전달을 일시적으로 사용할 수 없는 경우 AVA는 같은 전달 의도를 다시 시도합니다.

직원으로 출입 발급 또는 재발급

자동 발급이 이루어지지 않았거나 교체가 필요한 경우 직원 제어 기능을 사용합니다.

1. Reservations 또는 Access Codes에서 예약을 엽니다.
2. Manage digital key를 엽니다.
3. 현재 키가 없을 때만 Issue를 선택합니다.
4. 키가 준비되면 Send를 선택합니다.
5. Copy guest link를 선택하여 현재 게스트 링크를 직접 공유합니다.

직원 발급과 이메일 전달은 별도의 작업입니다. AVA는 발급 전에 현재 객실, 날짜, 전화번호 및 객실 매핑을 확인합니다.

여러 객실 예약의 경우 AVA는 선택한 객실을 확인합니다. 종료 상태인 객실은 선택하거나 발급, 재발급 또는 전송할 수 없습니다. 예약 기록과 철회 제어 기능은 계속 사용할 수 있습니다.

QR 키 철회 또는 재발급

게스트가 일찍 체크아웃하거나 출입 권한을 잃은 경우 출입을 철회합니다.

1. 예약의 객실 출입 세부 정보를 엽니다.

2. 현재 QR 키에서 Withdraw를 선택합니다.

3. 철회를 확인합니다.

4. 취소가 아직 처리 중이면 재시도가 가능해진 후 Retry cancellation을 선택합니다.

5. 벤더 취소 확인을 기다립니다.

6. 상태를 새로 고치고 Reissue를 선택합니다.

7. 새 생성을 확인합니다.

   ✓ AVA가 새 벤더 카드와 게스트 링크를 생성합니다.

확실하지 않은 발급을 무작정 다시 시도하지 마세요

AVA에 해결되지 않았거나 철회된 키가 표시되면 직원 복구를 기다리세요. 명시적인 작업 없이는 자동 전달이 해당 키를 대체하지 않습니다.

재발급 후에도 이전 AVA 링크는 철회된 상태로 유지됩니다. 가장 최근의 게스트 링크만 사용하세요.

체크아웃 동작

체크아웃에서도 기존 QR 키 동작은 유지됩니다. 조기 출발 시 직원이 출입을 철회해야 합니다. 저장된 유효 기간이 일반적인 만료를 계속 제어합니다.

게스트를 다른 객실로 이동

AVA는 QR 키 생성을 객실 할당과 연결된 상태로 유지합니다.

1. PMS 객실 이동을 완료합니다.
2. AVA에서 예약을 새로 고칩니다.
3. AVA가 목적지 객실을 확인할 때까지 기다립니다.
4. 기존 키의 취소 상태를 검토합니다.
5. 취소가 성공한 후에만 목적지 객실에 대한 출입을 발급합니다.

게스트가 원래 객실로 돌아오면 수정 사항이 확인된 Reissue 작업을 사용합니다. 취소에 실패한 후 PMS 이동을 반복하지 마세요.

표시되는 내용 → 해결 방법

QRLOCK 연결 테스트 실패

표시되는 내용: Test Connection이 실패하거나 QRLOCK 인벤토리가 로드되지 않습니다.

해결 방법:

1. QR Master SID와 Community Number를 확인합니다.
2. 여분의 공백 없이 Auth Token을 다시 붙여 넣습니다.
3. QRLOCK 계정에서 커뮤니티와 객실을 볼 수 있는지 확인합니다.
4. 자격 증명을 저장한 다음 Test Connection을 다시 실행합니다.

객실에 QR 키를 발급할 수 없음

표시되는 내용: 예약에서 QR 디지털 키 작업을 사용할 수 없습니다.

해결 방법:

1. 예약에 객실이 할당되어 있는지 확인합니다.
2. QRLOCK Room Mapping을 엽니다.
3. 정확한 PMS 객실을 하나의 QRLOCK 객실에 매핑합니다.
4. 예약을 새로 고친 다음 다시 시도합니다.

게스트 링크가 철회되었거나 사용할 수 없음

표시되는 내용: 이전 링크에 출입할 수 없다고 표시되거나 교체 링크가 없습니다.

해결 방법:

1. 예약에서 최신 QR 키 상태를 확인합니다.
2. 철회 또는 재발급 후에는 이전 링크를 다시 사용하지 마세요.
3. 취소가 확인되면 Reissue를 선택합니다.
4. 새로 생성된 링크만 공유합니다.

QR 키 이메일이 도착하지 않음

표시되는 내용: 객실 카드에 보류 중이거나 실패한 이메일 상태가 표시됩니다.

해결 방법:

1. 게스트에게 개인 이메일 주소가 있는지 확인합니다.

2. 해당 주소가 OTA 프록시 주소가 아닌지 확인합니다.

3. 전달 재시도가 완료될 때까지 기다립니다.

4. 상태가 새로 고쳐진 후 Email room information을 선택합니다.

5. 게스트가 즉시 출입해야 하면 Copy guest link를 사용합니다.

   ✓ 이메일 전달이 재시도되는 동안 현재 QR 키는 변경되지 않습니다.

QR 키 발급에서 서비스 오류가 반환됨

표시되는 내용: 자동 또는 직원 발급에서 503이 반환되고 기록 행이나 이메일 링크가 표시되지 않습니다.

해결 방법:

1. 배포 관리자에게 Room Access Service URL이 구성되어 있는지 확인해 달라고 요청합니다.

2. 공용 URL에서 /guest-key 및 /guest-key/client.js가 로드되는지 확인합니다.

3. URL에 경로, 쿼리, fragment 또는 자격 증명이 없는지 확인합니다.

4. Room Access Service 릴리스가 정상 상태가 된 후 발급을 다시 시도합니다.

5. 새 출입 기록 행, 게스트 링크 및 이메일 전달을 확인합니다.

   ✓ AVA는 벤더 키를 생성하기 전에 게스트 경로를 검증합니다.

QRLOCK 매핑이 다른 벤더와 충돌함

표시되는 내용: 이전 스마트 락 벤더가 이미 같은 PMS 객실을 사용하고 있습니다.

해결 방법:

1. QR 디지털 키 설정에서 QRLOCK Room Mapping을 엽니다.

2. 정확한 PMS 객실과 QRLOCK 객실을 선택합니다.

3. PIN 벤더 매핑을 삭제하지 않고 QRLOCK 매핑을 저장합니다.

4. 각 설정 영역에서 두 벤더 매핑이 모두 계속 표시되는지 확인합니다.

   ✓ QRLOCK은 자체 매핑을 사용하고 PIN 벤더는 자체 매핑을 유지합니다.

저장에 계속 실패하면 페이지를 새로 고치고 한 번 다시 시도합니다. QRLOCK 충돌을 해결하기 위해 PIN 벤더의 매핑을 재설정하지 마세요.

객실 이동으로 교체 키가 차단됨

표시되는 내용: AVA에서 키를 발급하기 전에 직원 복구가 필요하다고 표시합니다.

해결 방법:

1. PMS에서 목적지를 확인한 후 예약을 새로 고칩니다.

2. 이전 객실의 QR 키 상태를 엽니다.

3. 벤더 취소가 성공했는지 확인합니다.

4. 목적지 객실 매핑을 확인합니다.

5. AVA에서 활성화된 경우에만 Reissue를 선택합니다.

   ✓ AVA가 확인된 목적지 상태에 대해 교체 키 하나를 생성합니다.

선택한 객실에서 디지털 키 작업을 사용할 수 없음

표시되는 내용: 한 객실에서 Issue, Reissue 또는 Send를 사용할 수 없습니다.

해결 방법:

1. 선택한 객실이 PMS에서 종료 상태가 아닌지 확인합니다.
2. 필요한 경우 예약에서 활성 객실을 선택합니다.
3. 종료 객실의 기존 상태와 기록을 검토합니다.
4. 게스트가 더 이상 들어가면 안 될 때만 출입을 철회합니다.

QR은 스캔되지만 문이 열리지 않음

표시되는 내용: 호스팅된 페이지에 QR 코드가 표시되지만 리더가 이를 거부합니다.

해결 방법:

1. 게스트가 최신 링크를 사용하고 있는지 확인합니다.
2. 예약 유효 기간과 현재 시간을 확인합니다.
3. QRLOCK 객실 매핑이 실제 객실과 일치하는지 확인합니다.
4. QRLOCK 앱 또는 벤더 도구로 리더를 테스트합니다.
5. 조사하는 동안 호텔의 백업 출입 방법을 사용합니다.

아직 해결되지 않았나요?

다음과 같은 경우 success@vouch-technologies.com으로 문의하세요.

• ❌ 확인을 마쳤는데도 자격 증명이 실패합니다
• ❌ 매핑된 객실에서 QR 키를 발급할 수 없습니다
• ❌ 취소 또는 재발급 문제가 계속 해결되지 않습니다

다음 정보를 함께 보내면 도움이 됩니다:

• 호텔 이름과 객실 번호
• QRLOCK 모델과 커뮤니티 번호
• 자격 증명이 보이지 않는 상태 스크린샷
• 예약 ID와 문제가 시작된 시간

관련 가이드

• 스마트 락 개요
• 스마트 락 할당 설정
• 스마트 락 문제 해결