본문으로 건너뛰기

태국 이민국 보고서

빠른 설정

대부분의 호텔은 약 10분 안에 설정을 완료합니다. 먼저 Schedule Time, Email Recipients, Guest Source Mode를 설정하세요.

이 가이드는 TM30 및 RR4 보고서를 구성하고 자정 전후의 체크인을 처리하는 방법을 안내합니다.

AVA는 호텔의 Country 설정을 사용해 태국 보고서 작업을 식별합니다. 기존의 소문자 국가 레코드도 TM30 일정 새로 고침과 호환됩니다.

이동: Government Compliance → Thailand

기존 Reports → Thailand Immigration Reports 링크는 이 페이지로 리디렉션됩니다.

플랜 이용 권한​

  • 태국 이민국 보고서를 사용하려면 유료 플랜이 필요합니다.
  • 무료 요금제 계정에는 보고서 페이지 대신 업그레이드 안내가 표시됩니다.

업그레이드하려면 Settings → Billing & Subscription으로 이동하세요.

빠른 참조​

설정제어하는 내용권장 기본값
Enable Automatic Daily Reports활성화된 각 보고서를 매일 전송합니다켬
Schedule Time일일 보고서가 생성되는 시각(호텔 현지 시간)05:00
Use separate email recipientsTM30과 RR4를 서로 다른 받은편지함으로 보낼지 여부끔(팀이 다르면 켬)
TM30 Guest Source ModeTM30에 포함할 게스트AVA를 통해 체크인하지 않은 게스트 포함
RR4 Guest Source ModeRR4에 포함할 게스트AVA를 통해 체크인하지 않은 게스트 포함
RR4 Thai Hotel NameRR4에 인쇄되는 태국어 이름태국어로 입력
Include Stayover Guests (RR4)신규 체크인뿐 아니라 숙박 중인 게스트도 포함할지 여부끔(필요한 경우에만 켬)
RR4 Stayover RemarkRR4 숙박 중 행에 작성하는 선택 메모신고 흐름에 필요하지 않으면 비워 둠
Required Guest Information필수 필드의 RR4 규정 준수 상태모두 설정됨
Manual report actions활성화된 각 보고서에 작업을 표시합니다생성하기 전에 보고서를 활성화
백그라운드 처리

TM30/RR4 보고서는 AVA가 이메일로 보내기 전에 백그라운드 처리를 사용합니다. 이는 자동 일정과 수동 보고서 요청에 모두 적용됩니다. 수동 요청을 대기열에 넣을 수 없으면 AVA가 대신 오류를 표시합니다.

자동 보고서 설정​

  1. Government Compliance → Thailand로 이동합니다.
  2. Enable Automatic Daily Reports를 켭니다.
  3. Schedule Time을 설정합니다(호텔 현지 시간).
  4. Email Recipients를 추가하거나 Use separate email recipients를 켭니다.
  5. Save Configuration을 클릭합니다.

✓ 저장 후 성공 메시지가 표시되어야 합니다. ✓ AVA가 일일 보고서 일정을 활성화하거나 업데이트합니다.

일정 시간과 이메일 수신자를 보여주는 Thailand Immigration Reports 구성 화면 TODO: Automatic Daily Reports 카드가 표시되는 업데이트된 레이아웃으로 교체하세요.

통합 또는 개별 이메일 목록 사용​

옵션사용할 때
Combined recipientsTM30과 RR4가 같은 팀으로 전송될 때
Separate recipientsTM30과 RR4가 서로 다른 팀으로 전송될 때

개별 목록을 사용하려면:

  1. Use separate email recipients를 켭니다.
  2. TM30 Email Recipients를 추가합니다.
  3. RR4 Email Recipients를 추가합니다.

게스트 소스 모드 선택(TM30 및 RR4)​

각 보고서에 AVA가 게스트를 포함하는 방식을 선택합니다.

TM30 게스트 소스 모드​

옵션AVA가 수행하는 동작가장 적합한 경우
Include guests who didn't check in through AVAAVA 체크인 시간이 있으면 이를 사용합니다. 없으면 PMS에 예약이 이미 체크인된 것으로 표시된 경우에만 게스트를 포함합니다.AVA 외부에서 체크인하는 경우가 있는 호텔
Don't include guests who didn't check in through AVA유효한 AVA 체크인 시간이 있는 게스트만 포함합니다.AVA를 통한 체크인 증빙만 사용하려는 호텔

RR4 게스트 소스 모드​

TM30과 동일한 옵션을 사용합니다. 이 설정은 별도이므로 RR4 작업 흐름과 일치하는지 확인하세요.

타임스탬프 규칙
  • AVA 체크인 시간이 있으면 AVA는 해당 타임스탬프를 사용해 보고서 날짜를 결정합니다.
  • AVA 체크인 시간이 없으면 Include 모드는 PMS에 예약이 이미 체크인된 것으로 표시된 경우에만 대체 방식으로 처리합니다.
  • AVA 체크인 시간을 읽을 수 없으면 AVA는 해당 항목을 제외합니다.
  • Don't include 모드에서는 유효한 AVA 체크인 타임스탬프가 있는 게스트만 포함됩니다.

자정 예시(Include 모드)​

예약: 2월 9일~13일. 보고서 생성 시각: 2월 10일 00:10.

보고서 시점의 상황결과
AVA 체크인 시간이 2월 10일 00:01게스트는 2월 9일 보고서에서 제외되고 2월 10일 보고서에 표시됩니다
AVA 체크인 시간이 아직 없고 PMS 상태가 이미 checked inPMS 대체 방식을 사용해 게스트가 2월 9일 보고서에 포함됩니다
AVA 체크인 시간이 아직 없고 PMS 상태가 not checked in아직 게스트가 포함되지 않습니다

RR4 보고서 설정​

RR4 게스트 소스 모드​

RR4 Settings 카드의 맨 위에 RR4 Guest Source Mode가 표시됩니다. Thai Hotel Name과 Include Stayover Guests보다 먼저 설정하세요.

TM30과 동일한 옵션을 사용합니다.

  • Include guests who didn't check in through AVA
  • Don't include guests who didn't check in through AVA

필수 게스트 정보​

정확한 RR4 보고서를 위해 다음 항목을 필수 등록 필드로 설정하세요.

  • Nationality
  • Place of Departure
  • Next Destination

하나라도 선택 사항이면 Required Guest Information 카드에 Action required가 표시됩니다. Configure Registration Fields를 클릭하거나 Settings → Check-In으로 이동하세요.

태국어 호텔명​

호텔 이름을 태국어 문자로 입력하세요. 예: โรงแรมว้าว รีสอร์ต.

RR4는 이 값을 보고서 헤더에 사용합니다. 비워 두면 기본 호텔 이름이 사용됩니다.

숙박 중인 게스트 포함​

신규 체크인뿐 아니라 숙박을 계속하는 게스트도 포함하려면 이 옵션을 켭니다.

예시:

  • 끔: 게스트가 10월 20일에 체크인하고 10월 25일에 체크아웃합니다. 10월 20일 보고서에만 표시됩니다.
  • 켬: 같은 게스트가 10월 20일, 21일, 22일, 23일, 24일 보고서에 표시됩니다.

RR4 숙박 중 메모 설정​

RR4 Stayover Remark를 사용해 숙박 중인 행에 짧은 메모를 추가합니다.

예: ไม่มีการเปลี่ยนแปลง

숙박 중 메모가 필요하지 않으면 이 필드를 비워 둡니다.

이 필드를 사용할 수 있는 시점

이 필드는 Include Stayover Guests가 켜져 있을 때만 활성화됩니다. 숙박 중 보고가 꺼져 있으면 AVA가 메모 필드를 비활성화합니다.

TM30과 RR4 시간이 달라질 수 있는 이유

TM30과 RR4는 같은 게스트에 대해 서로 다른 타임스탬프를 표시할 수 있습니다. 각 보고서에 자체 시간 규칙이 적용되므로 이는 정상입니다.

게스트 소스 모드, 태국어 호텔명, 숙박 중인 게스트 설정을 보여주는 RR4 설정 TODO: Guest Source Mode가 Thai Hotel Name 위에 표시되는 업데이트된 RR4 Settings 카드로 교체하세요.

등록 카드 아카이브​

AVA는 이제 이 내보내기를 Registration Card Archive로 표시합니다. 이전 화면에서는 호환성 영역에 여전히 RR3로 표시될 수 있습니다.

아카이브는 예약된 보고서가 아닙니다. 전체 동기화, 비동기 및 재개 흐름은 등록 카드 아카이브 다운로드를 참고하세요. AVA는 이러한 내보내기를 임시 저장소에 준비합니다. 파일이 준비되면 직원에게 7일 동안 사용할 수 있다는 안내가 표시됩니다. 만료되기 전에 다운로드하거나 나중에 새 아카이브를 만들 수 있습니다.

등록 카드가 포함되는 시점​

  • Self check-in: 키오스크 서명 제출 직후
  • Assisted check-in: 직원이 게스트 서명을 제출할 때

직원이 확인해야 할 사항​

  • RR3 Required로 표시된 필수 필드가 모두 입력되었는지 확인합니다.
  • 서명 전에 게스트 신원과 예약 세부 정보가 올바른지 확인합니다.

보고서 수동 생성​

수동 TM30 및 RR4 보고서는 숙소에 저장된 타임존을 사용합니다. 숙소 타임존이 저장되어 있지 않으면 AVA가 요청의 타임존을 사용할 수 있습니다. 기기 또는 브라우저 타임존의 차이를 피하려면 숙소 타임존을 설정하세요.

숙소 타임존 확인

Hotel Basic Details에서 올바른 타임존을 설정하세요. 그러면 보고서 날짜가 숙소의 현지 달력과 일치합니다.

  1. 태국 보고서 구성이 저장되었는지 확인합니다.
  2. Manual Report Generation까지 스크롤합니다.
  3. 필요한 활성 보고서에서 Generate TM30 또는 Generate RR4를 클릭합니다.
  4. 확인 메시지를 기다립니다.

AVA는 해당 보고서가 활성화된 경우에만 그 보고서에 해당하는 수동 작업을 표시합니다. 예를 들어 Generate RR4는 표시되면서 Generate TM30은 숨겨질 수 있습니다.

성공 메시지 이해하기​

AVA는 다음과 같은 현지화된 성공 메시지 중 하나를 표시합니다.

메시지의미수행할 작업
Report queued successfullyAVA가 백그라운드 처리를 위해 요청을 접수했습니다보고서 이메일을 기다립니다. 즉시 다시 생성하지 마세요.
"TM30 report could not be queued. Please try again later." 또는 "RR4 report could not be queued. Please try again later."AVA가 요청을 접수하지 못했습니다기다린 후 한 번 다시 시도합니다. 반복되면 지원팀에 문의하세요.

수동 보고서 생성은 항상 백그라운드 처리를 사용합니다. 대기열 등록 메시지는 즉시 이메일이 발송된다는 뜻이 아니라 접수가 완료되었다는 뜻입니다. AVA가 요청을 대기열에 넣을 수 없으면 작업을 중지하고 오류를 표시합니다. 보고서를 즉시 생성하지는 않습니다.

문제 해결​

전날 보고서에서 게스트가 누락됨​

보이는 현상: 게스트가 자정 무렵 체크인했지만 어제 보고서에 없습니다.

해결 방법:

  1. 게스트 체크인 기록을 엽니다.
  2. AVA 체크인 타임스탬프를 확인합니다.
  3. 타임스탬프가 자정 이후라면 해당 게스트는 오늘 보고서에서 확인합니다.

자정 도착 후 게스트가 전날 보고서에 표시됨​

보이는 현상: 게스트가 자정 이후에 도착했는데도 전날 보고서에 표시됩니다.

해결 방법:

  1. Guest Source Mode를 확인합니다.
  2. Include 모드에서는 AVA 타임스탬프가 없을 때 PMS가 이미 예약을 체크인된 것으로 표시한 경우에만 PMS 대체 방식을 사용합니다.
  3. 유효한 AVA 타임스탬프만 사용하려면 Don't include guests who didn't check in through AVA로 전환합니다.

AVA 외부에서 체크인한 게스트가 Include 모드에서 누락됨​

보이는 현상: 게스트가 수동으로 체크인했지만 아직 포함되지 않았습니다.

해결 방법:

  1. PMS에서 예약 상태를 확인합니다.
  2. PMS가 예약을 이미 체크인된 것으로 표시하는지 확인합니다.
  3. 상태가 업데이트된 후 보고서를 다시 실행합니다.

수동 보고서에 잘못된 날짜가 사용됨​

보이는 현상: 수동 보고서가 숙소 현지 날짜보다 이전 또는 이후 날짜를 포함합니다.

해결 방법:

  1. Settings → Essentials → Hotel Basic Details를 엽니다.
  2. Timezone이 숙소의 현지 타임존과 일치하는지 확인합니다.
  3. 설정을 변경했다면 Save를 클릭합니다.
  4. Government Compliance → Thailand에서 보고서를 다시 생성합니다.

직원이 다른 타임존에서 시작하더라도 수동 보고서는 저장된 숙소 타임존을 사용합니다.

TM30과 RR4 시간이 다르게 표시됨​

보이는 현상: 같은 게스트의 타임스탬프가 TM30과 RR4에서 다릅니다.

해결 방법:

  1. 이 차이가 신고 작업 흐름을 막지 않는지 확인합니다.
  2. 게스트 데이터와 체크인 완료 세부 정보를 확인합니다.
  3. 불일치가 규정 준수 신고에 영향을 주면 지원팀에 문의합니다.

숙박 중 메모가 없음​

보이는 현상: RR4 숙박 중 행에 설정한 메모가 표시되지 않습니다.

해결 방법:

  1. Include Stayover Guests가 켜져 있는지 확인합니다.
  2. RR4 Stayover Remark가 비어 있지 않은지 확인합니다.
  3. 구성을 다시 저장합니다.
  4. 영향을 받는 날짜의 RR4를 다시 생성합니다.

PMS 변경 후 TM30 일정이 없음​

보이는 현상: PMS가 변경된 후 태국 호텔의 TM30 일정이 사라졌습니다.

해결 방법:

  1. Settings → Essentials → Hotel Basic Details를 엽니다.
  2. Country가 Thailand로 설정되어 있는지 확인합니다.
  3. Government Compliance → Thailand를 엽니다.
  4. Enable Automatic Daily Reports와 TM30 설정이 활성화되어 있는지 확인합니다.
  5. 일정이 계속 없으면 지원팀에 문의합니다.

기존의 소문자 국가 레코드는 PMS 변경 후 올바르게 새로 고쳐져야 합니다.

Government 설정 저장 시간이 초과됨​

보이는 현상: 태국 설정을 저장할 때 Service timeout: TM30ProxyService - PUT exceeded 7000ms가 표시됩니다.

발생 이유: AVA가 보고서 일정 업데이트를 완료하기 전에 저장이 완료될 수 있습니다. 타임아웃으로 인해 저장 성공이 표시되지 않을 수 있습니다.

해결 방법:

  1. Save Configuration을 반복해서 클릭하지 마세요.

  2. Government Compliance → Thailand를 새로 고칩니다.

  3. 이메일, 일정 및 보고서 설정이 여전히 있는지 확인합니다.

  4. 값이 있으면 추가 작업이 필요하지 않습니다.

  5. 값이 없으면 한 번 더 저장합니다.

  6. 타임아웃이 다시 발생하면 지원팀에 문의합니다.

    ✓ 이제 성공적으로 저장하면 7초 타임아웃 없이 반환되어야 합니다.

보고서 이메일을 받지 못함​

보이는 현상: 예약된 시각에 보고서 이메일이 오지 않습니다.

해결 방법:

  1. 보고서가 활성화되어 있는지 확인합니다.
  2. 수신자 이메일이 올바른지 확인합니다.
  3. 스팸 또는 정크 폴더를 확인합니다.
  4. Report queued successfully가 표시되었다면 백그라운드 처리를 기다립니다.
  5. 첫 번째 요청이 완료될 때까지 다른 수동 요청을 제출하지 마세요.

보고서가 계속 대기열에 있음​

보이는 현상: 보고서 확인 메시지에 Report queued successfully가 표시되지만 이메일이 도착하지 않습니다.

해결 방법:

  1. 설정된 수신자 주소를 확인합니다.
  2. 스팸 또는 정크 폴더를 확인합니다.
  3. 다시 시도하기 전에 대기열 처리가 완료될 때까지 기다립니다.
  4. 정상 처리 시간이 지난 후에도 보고서가 없으면 지원팀에 문의합니다.

수동 보고서를 대기열에 넣을 수 없음​

보이는 현상: "TM30 report could not be queued. Please try again later." 또는 RR4 버전의 메시지가 표시됩니다.

해결 방법:

  1. 몇 분 기다린 후 다시 시도합니다.
  2. 보고서를 한 번 제출합니다.
  3. 요청이 다시 실패하면 지원팀에 문의합니다.

시도한 보고서 유형과 시각을 함께 알려 주세요.

보고서 서비스를 사용할 수 없음​

보이는 현상: "Report generation is temporarily unavailable because the report service rejected its credential. Please contact support."가 표시됩니다.

해결 방법:

  1. 로그아웃하거나 비밀번호를 재설정하지 마세요.
  2. 이 오류는 AVA 세션이 아니라 보고서 처리와 관련된 문제입니다.
  3. 보고서 유형과 시도 시각을 적어 success@vouch-technologies.com으로 문의합니다.

TM30과 RR4 설정이 일치하지 않는다는 경고가 표시됨​

보이는 현상: 노란색 배너가 TM30과 RR4 설정이 서로 다르다고 경고합니다.

해결 방법:

  1. Schedule Time과 수신자 설정을 검토합니다.
  2. 목록을 분리하려면 Use separate email recipients를 켭니다.
  3. Save Configuration을 클릭해 설정을 동기화합니다.

개별 수신자 안내가 표시됨​

보이는 현상: 파란색 배너에 개별 수신자 모드가 활성화되었다고 표시됩니다.

해결 방법:

  1. TM30 Email Recipients와 RR4 Email Recipients를 검토합니다.
  2. 하나의 목록을 사용하려면 Use separate email recipients를 끕니다.
  3. Save Configuration을 클릭합니다.

Required Guest Information에 "Action required"가 표시됨​

보이는 현상: Required Guest Information 카드에 Action required가 표시됩니다.

해결 방법:

  1. Configure Registration Fields를 클릭합니다.
  2. Nationality, Place of Departure, Next Destination을 필수로 설정합니다.
  3. 보고서 페이지로 돌아가 새로 고침합니다.

수동 보고서 버튼이 없음​

보이는 현상: 수동 보고서 버튼 중 하나 또는 모두가 표시되지 않습니다.

해결 방법:

  1. 어떤 보고서 버튼이 없는지 확인합니다.
  2. 태국 보고서 설정에서 해당 보고서를 활성화합니다.
  3. 구성을 저장합니다.
  4. 페이지를 새로 고칩니다.

AVA는 해당 보고서가 비활성화되면 그 보고서에 해당하는 버튼을 숨깁니다.

등록 카드 아카이브 버튼이 없음​

보이는 현상: Download Registration Card Archive가 보이지 않습니다.

해결 방법:

  1. 관리자에게 report:export 권한을 부여해 달라고 요청합니다.
  2. 접근 권한이 업데이트된 후 페이지를 새로 고칩니다.

등록 카드를 찾지 못함​

보이는 현상: 선택한 날짜 범위에 등록 카드가 없다고 AVA가 표시합니다.

해결 방법:

  1. 날짜 범위를 넓힙니다.
  2. 해당 기간에 등록 카드 서명이 제출되었는지 확인합니다.
  3. 내보내기를 다시 시도합니다.

계속 해결되지 않나요?​

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

  • ❌ 예상한 보고서 날짜에서 게스트가 반복적으로 누락됨
  • ❌ 보고서 타임스탬프 때문에 규정 준수 제출이 막힘
  • ❌ 자동 보고서가 한 주기 이상 실패함

함께 전달하면 좋은 정보:

  • 숙소 이름
  • 게스트 이름과 예약 번호
  • 예상 보고서 날짜와 실제 결과
  • 보고서 설정 및 게스트 체크인 세부 정보 스크린샷