본문으로 건너뛰기

Furama iPMS 연결

빠른 설정

시작하기 전에 Furama 담당자에게 필수 연결 정보를 모두 요청하세요. 설정에는 약 10분이 걸립니다.

이 가이드는 호텔을 Furama iPMS에 연결하고 연결 상태를 확인하는 방법을 설명합니다.

이동 경로: Settings → Essentials → PMS Integration

빠른 참조​

설정필수기능
iPMS Base URL예AVA를 iPMS API 및 서비스 경로로 연결
Organisation Unit예iPMS에서 호텔 식별
Control Unit아니요카탈로그 조회에 사용할 단위 선택
User Code예iPMS 보안 토큰 획득
Business User Code아니요비즈니스 요청의 사용자 식별
API Key예iPMS 연결 승인
선택 항목 기본값

Control Unit의 기본값은 Organisation Unit입니다. Business User Code의 기본값은 User Code이며 대소문자를 유지합니다.

시작하기 전에​

  • 호텔에 Furama iPMS가 활성화되어 있음
  • Settings → Essentials를 수정할 수 있음
  • 서비스 경로를 포함한 전체 iPMS API URL이 있음
  • Organisation Unit, User Code, API Key가 있음
  • 호텔에 선택 항목이 필요한지 알고 있음
API Key 보호

스크린샷이나 지원 요청에 API Key를 포함하지 마세요. AVA는 저장된 값을 설정 후 마스킹합니다.

호텔 연결​

  1. Settings → Essentials로 이동합니다.
  2. PMS Integration을 엽니다.
  3. PMS 제공업체로 Furama iPMS를 선택합니다.
  4. iPMS Base URL을 입력합니다.
  5. Organisation Unit을 입력합니다.
  6. User Code를 입력합니다.
  7. API Key를 입력합니다.
  8. Furama가 별도 값을 제공한 경우 Control Unit을 추가합니다.
  9. 값이 다르면 Business User Code를 추가합니다.
  10. Save PMS Settings를 선택합니다.

✓ "Furama Integration Configured."가 표시됩니다. ✓ 페이지를 다시 열어도 API Key가 마스킹됩니다.

게시된 iPMS 연결 사용

AVA는 현재 Furama 어댑터를 자동으로 선택합니다. 어댑터 버전을 선택할 필요가 없습니다.

일상 업무 확인​

저장 후 안전한 테스트 예약으로 호텔을 확인하세요.

  1. Reservations를 엽니다.

  2. 확인된 Furama 예약을 검색합니다.

  3. 고객, 객실, 투숙일, 상태를 확인합니다.

  4. Rates & Availability에서 예상 요금제를 확인합니다.

  5. Housekeeping에서 객실 상태를 확인합니다.

  6. 승인된 테스트 체크인 및 체크아웃을 완료합니다.

    ✓ AVA는 연결된 호텔이 지원하는 작업만 표시합니다.

기능 기반 제어

일부 AVA 작업은 활성 PMS 연결에 따라 달라집니다. 지원되지 않는 제어는 안전하지 않은 요청을 보내는 대신 숨겨지거나 비활성화됩니다.

연결 정보 변경​

  1. Settings → Essentials → PMS Integration으로 돌아갑니다.

  2. 필요한 비밀 값이 아닌 필드를 변경합니다.

  3. API Key를 교체할 때만 Edit Secret을 선택합니다.

  4. 새 API Key를 입력합니다.

  5. Save PMS Settings를 선택합니다.

    ✓ 마스킹된 API Key를 변경하지 않으면 기존 비밀 값이 유지됩니다.

문제 해결​

Furama iPMS가 목록에 없음​

표시 내용: 제공업체 목록에 Furama iPMS가 없습니다.

해결 방법:

  1. Settings → Essentials를 새로고침합니다.
  2. PMS 설정 수정 권한을 확인합니다.
  3. AVA 관리자에게 호텔 배포 상태를 확인합니다.

설정이 저장되지 않음​

표시 내용: "Failed to save PMS Integration"이 표시됩니다.

해결 방법:

  1. 필수 필드를 모두 입력합니다.
  2. Base URL에 iPMS 서비스 경로가 포함되었는지 확인합니다.
  3. Organisation Unit과 User Code를 정확히 확인합니다.
  4. API Key를 다시 입력하고 저장합니다.

카탈로그 데이터가 없음​

표시 내용: 요금제, 예약 출처 또는 결제 유형이 나타나지 않습니다.

해결 방법:

  1. Furama 담당자에게 Control Unit을 확인합니다.
  2. Organisation Unit과 다르면 입력합니다.
  3. Save PMS Settings를 선택합니다.
  4. 해당 AVA 페이지를 다시 불러옵니다.

비즈니스 요청이 거부됨​

표시 내용: 조회는 되지만 예약 변경이 실패합니다.

해결 방법:

  1. Business User Code를 확인합니다.
  2. 정확한 대소문자를 유지합니다.
  3. 연결을 다시 저장합니다.
  4. 승인된 테스트 예약으로 다시 시도합니다.

예약이 나타나지 않음​

표시 내용: 확인된 Furama 예약이 Reservations에 없습니다.

해결 방법:

  1. 투숙일이 현재 검색과 일치하는지 확인합니다.
  2. 필터를 지우고 다시 검색합니다.
  3. iPMS에서 예약을 확인합니다.
  4. PMS 연결 오류를 확인합니다.

문제가 계속되나요?​

다음 상황에서는 success@vouch-technologies.com으로 문의하세요.

  • ❌ 다시 연결해도 Furama 투숙 정보가 계속 없음
  • ❌ 필수 필드가 정확하지만 저장이 계속 실패함
  • ❌ 지원되는 체크인 또는 체크아웃 작업을 사용할 수 없음

함께 보내면 유용한 정보:

  • 호텔 이름
  • Organisation Unit
  • 테스트 실패 시간
  • 정확한 오류 메시지
  • API Key를 숨긴 스크린샷