본문으로 건너뛰기

SiteMinder Channel Manager 통합 설정

빠른 설정

대부분의 호텔은 이 설정을 약 10분 안에 완료할 수 있습니다. Publisher ID, Hotel Code, Environment, REST API Bearer Token이 필요합니다. 또한 SiteMinder 객실 유형 매핑을 위한 AVA 객실 유형도 필요합니다.

이 가이드는 AVA가 예약 업데이트를 자동으로 수신하도록 SiteMinder를 연결하는 방법을 안내합니다. 이 통합은 PMS를 대체하지 않고 PMS와 함께 작동합니다. 여기에서 SiteMinder 객실 유형을 AVA 객실 유형에 매핑할 수도 있습니다. 이제 실제 SiteMinder 객실 ID는 Rooms 페이지에서 매핑합니다. SiteMinder 요금제 코드는 이제 Rates & Availability → Rate Plans에서 매핑합니다. 객실 매핑 작업 영역에는 요약 수치, 검색, 필터, 제안, 드로어 편집 기능이 계속 표시됩니다. Room Access 매핑 제안과 동일한 유사도 규칙을 사용합니다.

이동: Settings → Essentials → Channel Manager Integration

빠른 참조​

| 설정 | 제어 내용 | 입력할 내용 | | --- | --- | | Channel Manager | 공급업체를 선택합니다 | SiteMinder 선택 | | Environment | 테스트 또는 운영 SiteMinder에 연결합니다 | Pre-production (Sandbox) 또는 Production | | Publisher ID | SiteMinder 계정을 연결합니다 | SiteMinder publisher ID | | Hotel Code | SiteMinder의 숙소와 일치시킵니다 | 호텔 코드 | | REST API Bearer Token | AVA가 REST API를 호출하도록 합니다 | SiteMinder의 bearer token | | Room Type Mappings | SiteMinder 객실 유형과 AVA 객실 유형을 일치시킵니다 | Settings → Essentials에서 확인된 각 코드에 AVA 객실 유형 선택 | | Physical Room Mappings | 확인된 SiteMinder 객실 ID와 AVA 객실을 일치시킵니다 | Rooms의 작업 영역 사용 | | Rate Plan Mappings | SiteMinder 요금 코드와 AVA 요금제를 일치시킵니다 | Rates & Availability → Rate Plans 사용 | | Enable SiteMinder integration | 동기화를 시작합니다 | 모두 준비되면 켜기 | | SiteMinder reservations missing from the PMS | 검토가 필요한 OTA 예약을 표시합니다 | SiteMinder를 활성화한 후 검토 | | Overbooked stays needing a room | 객실이 배정되지 않은 승인된 OTA 투숙을 표시합니다 | 배정, 업그레이드, 여유 용량 확보 또는 워크 절차 진행 |

SOAP 자격 증명

여기에는 SOAP 사용자 이름이나 비밀번호를 입력하지 않습니다. AVA가 해당 자격 증명을 전역으로 관리합니다.

객실 유형 탐색

SiteMinder가 예약을 보낸 후 SiteMinder 객실 유형이 나타납니다. 그때까지 모든 코드가 표시되지 않을 수 있습니다.

객실 매핑 위치

SiteMinder 객실 유형 매핑에는 Settings → Essentials → Channel Manager Integration을 사용합니다. 실제 SiteMinder 객실 ID 매핑에는 Rooms를 사용합니다.

더 빠른 객실 검토

먼저 Unmapped부터 시작합니다. 그다음 Suggestions와 Conflicts를 확인합니다. 객실이 많은 숙소에서는 이 방법이 더 빠릅니다.

시작하기 전에​

먼저 다음 항목을 확인하세요.

  • 숙소의 SiteMinder 접근 권한이 있습니다
  • 올바른 Publisher ID와 Hotel Code를 가지고 있습니다
  • 테스트 중인지 운영을 시작하는지 알고 있습니다
  • SOAP endpoint URL을 SiteMinder에 등록했습니다
이것이 중요한 이유

AVA는 SiteMinder를 활성화하지 않고도 설정을 저장할 수 있습니다. 통합을 켜기 전에 필드를 모두 작성해야 합니다.

경고

SiteMinder에 올바른 SOAP endpoint URL이 등록될 때까지 통합을 켜지 마세요. endpoint가 없으면 업데이트가 AVA에 도달하지 않습니다.

SiteMinder 설정​

  1. Settings → Essentials로 이동합니다
  2. Channel Manager Integration까지 스크롤합니다
  3. Channel Manager 드롭다운을 엽니다
  4. SiteMinder를 선택합니다
  5. Environment를 엽니다
  6. 테스트에는 **Pre-production (Sandbox)**를 선택합니다
  7. 운영 트래픽에는 Production을 선택합니다
  8. Publisher ID를 입력합니다
  9. Hotel Code를 입력합니다
  10. REST API Bearer Token을 붙여넣습니다
  11. Enable SiteMinder integration을 켭니다
  12. Save를 클릭합니다

✓ Connected가 표시되어야 합니다.

저장 후 동작​

변경 사항결과
SiteMinder 설정 저장AVA가 로컬 설정을 즉시 저장합니다.
설정 동기화 실행AVA가 백그라운드에서 구성을 web-be-channel-manager로 보냅니다.
나중에 다시 방문비밀 필드는 페이지에서 마스킹된 상태로 유지됩니다.
None으로 전환AVA가 SiteMinder 필드를 지웁니다.
비밀 필드

새로고침 후 비밀 필드가 마스킹되어 보이면 정상입니다. 저장된 값을 바꾸려는 경우에만 수정하세요.

SiteMinder 예약 결과 검토​

예약 결과 패널에서 AVA가 PMS에서 확인하지 않은 SiteMinder 예약을 찾습니다. SiteMinder는 PMS가 수락하기 전에 게스트에게 예약을 확인할 수 있습니다. PMS가 매진 상태에서 수락한 OTA 투숙에는 별도의 초과 예약 패널을 사용합니다.

  1. Settings → Essentials로 이동합니다

  2. Channel Manager Integration을 엽니다

  3. SiteMinder가 선택되어 있고 활성화되어 있는지 확인합니다

  4. SiteMinder reservations missing from the PMS를 검토합니다

  5. 각 항목을 열고 게스트, 확인 번호, 투숙, 객실 유형, 사유를 확인합니다

  6. PMS에 예약을 직접 생성하거나 게스트에게 연락합니다

    ✓ SiteMinder를 선택하고 활성화하면 패널이 자동으로 열립니다. ✓ 기본적으로 확인이 필요한 항목이 표시됩니다.

객실이 필요한 초과 예약 투숙 검토​

SiteMinder를 활성화하면 Overbooked stays needing a room 패널이 나타납니다. 객실 유형이 매진된 상태에서 PMS가 수락한 OTA 투숙이 표시됩니다. 각 행에는 게스트, 예약 또는 OTA 번호, 날짜, 객실 유형, 매진된 숙박일이 표시됩니다.

  1. 투숙과 매진된 숙박일을 검토합니다

  2. AVA 또는 PMS에서 적절한 객실을 배정합니다

  3. 필요하면 게스트를 업그레이드하거나, 여유 용량을 확보하거나, 워크 절차를 따릅니다

  4. Refresh를 클릭합니다

    ✓ 객실이 배정되거나, 초과 판매된 숙박일이 해결되거나, 투숙이 취소되면 투숙이 사라집니다.

이 패널은 초과 예약 투숙 확인을 지원하는 PMS 연결에서만 나타날 수 있습니다. 지원되지 않는 PMS 연결에서는 초과 예약 투숙이 표시되지 않으며 이 확인을 건너뜁니다.

예약 결과 상태 이해하기​

| 상태 | 의미 | 해야 할 일 | | --- | --- | | Rejected by the PMS | PMS가 예약을 거부했습니다. | 사유를 확인한 다음 수동으로 생성하거나 게스트에게 연락합니다. | | Delivery failed, retrying | AVA가 아직 예약을 전달하지 못했습니다. | 사유를 확인하고 나중에 새로고침합니다. | | Not confirmed by the PMS | 15분이 지나도 PMS가 예약을 확인하지 않았습니다. | 중복 예약을 만들기 전에 PMS를 확인합니다. | | Rejected, sent back to SiteMinder | 예약이 거부되어 SiteMinder로 반환되었습니다. | 게스트 또는 SiteMinder에 후속 조치를 합니다. | | Accepted as overbooking | 재고가 없는 상태에서도 예약이 수락되었습니다. | 객실을 배정하거나 초과 예약 절차를 따릅니다. | | Resolved by a later update | 이후 SiteMinder 업데이트에서 이전 문제가 해결되었습니다. | 일반적으로 조치가 필요하지 않습니다. | | Applied | 예약이 PMS에 성공적으로 도달했습니다. | 조치가 필요하지 않습니다. |

객실이 필요한 승인된 초과 예약 해결​

초과 예약 패널은 객실 필요가 해결될 때까지 승인된 초과 예약을 계속 표시합니다. 투숙 상세 정보에서 게스트, 날짜, 객실 유형 및 영향을 받는 숙박일을 확인합니다.

  1. Overbooked stays needing a room에서 승인된 초과 예약을 검토합니다

  2. 투숙과 아직 객실이 필요한 숙박일을 검토합니다

  3. AVA 또는 PMS에서 적절한 객실을 배정합니다

  4. 초과 예약 패널에서 Refresh를 클릭합니다

    ✓ 객실 배정이 성공하면 해당 투숙이 미해결 초과 예약 목록에서 사라집니다.

여유 용량이 생기면 패널을 새로고침하여 목록을 업데이트합니다. 취소 또는 이후 예약 업데이트로도 투숙이 삭제될 수 있습니다. 이 화면은 연결된 PMS가 미해결 초과 예약 투숙을 지원하는 경우에만 표시됩니다.

모든 SiteMinder 예약 표시​

패널은 기본적으로 성공한 예약을 숨깁니다.

  1. Show every SiteMinder reservation, not only problems를 선택합니다
  2. 성공, 대기 중, 문제 결과를 함께 검토합니다
  3. 확인이 필요한 항목만 다시 표시하려면 체크박스를 해제합니다

PMS에서 예약을 생성하거나 업데이트한 후 Refresh를 사용합니다. 이전 결과를 검토하려면 Load older를 선택합니다.

객실 매핑 작업 영역 사용​

Rooms에 SiteMinder 객실 매핑 작업 영역이 나타난 후 이 섹션을 사용합니다.

  1. Rooms로 이동합니다
  2. Channel Manager Room Mappings를 찾습니다
  3. Mapped, Unmapped, Conflicts, Disabled의 요약 수치를 검토합니다
  4. 검색 또는 필터를 사용해 목록을 좁힙니다
  5. 객실 행 또는 제안을 엽니다
  6. 일치하는 AVA room을 선택합니다
  7. 드로어에서 Map, Change, Unmap을 사용합니다
  8. Save를 클릭합니다
제안 동작

AVA는 새 제안을 만들 때 이미 매핑된 AVA 객실을 건너뜁니다. Apply all을 사용하면 현재 제안을 하나씩 실행합니다. 제안 하나가 실패해도 AVA는 나머지 제안을 계속 적용합니다.

✓ SiteMinder 객실 ID 또는 객실 이름이 비슷하면 추천 일치 항목이 나타납니다. ✓ 제안은 Room Access 매핑과 동일한 유사도 규칙을 사용합니다. ✓ 선택한 AVA 객실이 다른 곳에서 이미 사용 중이면 드로어에서 경고합니다. ✓ 이후 예약에는 선택한 AVA 객실이 사용됩니다.

문제 해결​

SiteMinder를 활성화할 수 없음​

보이는 현상: 통합을 활성화하기 전에 SiteMinder 구성을 완료해야 한다는 메시지가 표시됩니다.

해결 방법:

  1. Channel Manager가 SiteMinder로 설정되어 있는지 확인합니다
  2. SiteMinder 필드를 모두 입력합니다
  3. Environment 선택을 확인합니다
  4. Enable SiteMinder integration을 켭니다
  5. 다시 Save를 클릭합니다

Connected가 표시되지 않음​

보이는 현상: 페이지는 저장되지만 Connected가 표시되지 않습니다.

해결 방법:

  1. Enable SiteMinder integration이 켜져 있는지 확인합니다
  2. Settings → Essentials를 새로고침합니다
  3. 모든 SiteMinder 필드에 값이 계속 있는지 확인합니다
  4. 다시 저장합니다

업데이트가 SiteMinder에 도달하지 않음​

보이는 현상: AVA는 설정을 저장하지만 SiteMinder가 업데이트를 수신하지 않습니다.

해결 방법:

  1. SOAP endpoint URL이 SiteMinder에 등록되어 있는지 확인합니다
  2. Environment가 SiteMinder 계정과 일치하는지 확인합니다
  3. Publisher ID와 Hotel Code를 다시 확인합니다
  4. 설정을 다시 저장합니다

SiteMinder 필드가 사라짐​

보이는 현상: None을 선택한 후 SiteMinder 필드가 지워집니다.

해결 방법:

  1. SiteMinder를 다시 선택합니다
  2. 값을 다시 입력합니다
  3. Save를 클릭합니다

객실 유형이 표시되지 않음​

보이는 현상: SiteMinder 객실 유형 목록이 비어 있습니다.

해결 방법:

  1. SiteMinder가 해당 숙소의 예약을 보낼 때까지 기다립니다
  2. Settings → Essentials를 새로고침합니다
  3. 새 객실 유형 코드가 표시되는지 다시 확인합니다
  4. 코드가 표시되면 매핑을 저장합니다

객실 매핑이 표시되지 않음​

보이는 현상: Rooms에 Channel Manager Room Mappings 패널이 없습니다.

해결 방법:

  1. 활성 PMS가 AVA인지 확인합니다
  2. Settings → Essentials → Channel Manager Integration에서 SiteMinder가 선택되고 활성화되어 있는지 확인합니다
  3. Hotel Code가 저장되어 있는지 확인합니다
  4. SiteMinder가 예약 또는 객실 이벤트를 보낼 때까지 기다립니다
  5. Rooms를 새로고침합니다

중복 매핑 경고​

보이는 현상: 선택한 AVA room이 이미 매핑되어 있다고 드로어에서 경고합니다.

해결 방법:

  1. 다른 AVA room을 선택합니다
  2. 또는 먼저 다른 행의 매핑을 해제합니다
  3. 다시 저장합니다

드로어에서 저장 실패​

보이는 현상: 저장 작업이 실패하거나 드로어에 이전 값이 계속 표시됩니다.

해결 방법:

  1. 같은 행을 다시 엽니다
  2. 선택한 AVA room을 확인합니다
  3. 다시 Save를 클릭합니다

예약 결과 패널이 없음​

보이는 현상: SiteMinder reservations missing from the PMS를 찾을 수 없습니다.

해결 방법:

  1. Channel Manager Integration에서 SiteMinder가 선택되어 있는지 확인합니다
  2. Enable SiteMinder integration이 켜져 있는지 확인합니다
  3. 설정을 저장합니다
  4. Settings → Essentials를 새로고침합니다

예약 결과 패널에 로드 오류가 표시됨​

보이는 현상: 패널에 SiteMinder 예약을 로드하지 못했다는 메시지가 표시됩니다.

해결 방법:

  1. Refresh를 클릭합니다
  2. SiteMinder가 연결되어 있는지 확인합니다
  3. 다른 SiteMinder 설정은 정상적으로 로드되는지 확인합니다
  4. 오류가 계속되면 지원팀에 문의합니다

SiteMinder 예약이 목록에 없음​

보이는 현상: 게스트에게 SiteMinder 확인 번호가 있지만 예약을 찾을 수 없습니다.

해결 방법:

  1. Refresh를 클릭합니다
  2. Show every SiteMinder reservation, not only problems를 선택합니다
  3. 예약이 최근 것이 아니면 Load older를 선택합니다
  4. 확인 번호로 PMS를 검색합니다
  5. 예약이 계속 누락되면 지원팀에 문의합니다

PMS를 확인하기 전에는 중복 예약을 생성하지 마세요.

승인된 초과 예약이 목록에 없음​

보이는 현상: 매진 상태에서 예약이 수락되었지만 객실이 필요한 예약으로 표시되지 않습니다.

해결 방법:

  1. 예약이 PMS에 성공적으로 도달했는지 확인합니다
  2. 초과 예약 패널에서 Refresh를 클릭합니다
  3. 예약에 아직 배정되지 않은 객실이 있는지 확인합니다
  4. PMS가 미해결 초과 예약 투숙을 지원하는지 확인합니다

일부 PMS 연결은 이 목록을 제공하지 않습니다. 이 경우 로드 오류를 표시하는 대신 확인을 건너뜁니다.

아직 해결되지 않나요?​

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

  • ❌ SiteMinder 섹션을 계속 활성화할 수 없음
  • ❌ 저장한 SiteMinder 값이 계속 사라짐
  • ❌ endpoint를 등록한 후에도 업데이트가 SiteMinder에 도달하지 않음

함께 보내면 좋은 정보:

  • SiteMinder 섹션 스크린샷
  • 정확한 오류 메시지
  • 문제가 시작된 시각