본문으로 건너뛰기

파일에서 예약 불러오기

빠른 설정

대부분의 가져오기는 파일이 준비된 뒤 3~5분이면 끝납니다.

.xlsx, .csv, 또는 .json 파일에서 한 번에 많은 예약을 만들 때 이 흐름을 사용하세요.

대량 가져오기에서는 게스트 이메일이 선택 사항이므로, 이메일이 없어도 흐름이 막히지 않습니다. AVA는 ="2/0/0" 같은 Excel 텍스트 강제 래퍼도 일반 텍스트로 읽습니다. 시트가 Contact Name 같은 레이블을 사용하면 전체 이름 1열을 자동으로 매핑할 수 있습니다.

이동 경로: Operations View

시작하기 전에​

요구 사항중요한 이유확인할 내용
PMS가 Cloudbeds 또는 AVA지원되는 PMS에서만 대량 가져오기 버튼이 보입니다Settings → Essentials → PMS Integration을 확인합니다
파일이 .xlsx, .csv, 또는 .json다른 형식은 차단됩니다파일을 해당 형식 중 하나로 저장하거나 내보냅니다
파일 크기가 10 MB 이하더 큰 파일은 거부됩니다업로드 전에 파일 속성을 확인합니다
게스트 수 데이터가 있음AVA가 성인, 어린이, 유아를 가져올 수 있습니다인원 수를 별도 열로 넣거나 HGuru Persons 열 하나를 넣습니다
객실 유형이 AVA에 있음객실 유형이 없으면 매칭에 실패합니다객실 유형이 사용 가능한지 확인합니다
일부 값이 Excel 텍스트 강제를 사용함PMS 내보내기가 리터럴 텍스트 값을 감쌀 수 있습니다AVA가 ="2/0/0" 같은 래퍼를 자동으로 제거합니다
전체 이름이 한 열에 있음AVA가 한 게스트 이름을 이름/성으로 나눌 수 있습니다Contact Name, Guest Name, Primary Guest 같은 명확한 레이블을 사용합니다

JSON 가져오기가 하는 일​

JSON 구조예시AVA 동작
중첩 객체guest.email점(.) 경로로 펼칩니다
단순 배열roomNumbers: [101, 102]값을 파이프 구분자로 합칩니다
객체 배열guests: [{...}]건너뛰고 추출 참고 메시지를 표시합니다

JSON에 여러 예약 컬렉션이 있으면 AVA가 가장 적절한 항목을 선택합니다. 이 경우에도 경고를 표시합니다.

예약 가져오기​

  1. Operations View로 이동합니다.
  2. 오른쪽 위 작업에서 Bulk Import를 클릭합니다.
  3. Upload에서 파일을 드래그 앤 드롭하거나 클릭해서 선택합니다.
  4. Date format을 설정합니다.
    • 대부분의 파일은 Auto-detect를 유지합니다.
    • 일과 월이 뒤바뀔 수 있으면 고정 형식을 선택합니다.
  5. Analyze file을 클릭합니다.
  6. Review Mapping에서 필요한 각 필드가 올바른 소스 필드에 매핑되었는지 확인합니다.
    • First Name과 Last Name, 또는 하나의 Guest Name 열
    • Check-in Date
    • Check-out Date
    • Room Type
    • Nationality
    • 선택 인원 수: Adults, Children, Infants, 또는 HGuru Persons 열 하나(ADT, CHD, INF)
    • Contact Name 같은 전체 이름 1열은 값이 실제 이름처럼 보이면 이름과 성으로 자동 감지되어 분리됩니다.
    • ="2/1/1"처럼 감싸진 값은 이제 수동 정리 없이 2/1/1로 가져옵니다.
    • 필수 필드가 아직 빠져 있으면 계속하기 전에 매핑 체크리스트에 막는 항목이 표시됩니다.
    • 매핑되지 않은 필드는 눈에 잘 띄므로 먼저 그 부분부터 수정하세요.
    • JSON 소스 필드는 guest.email 같은 점(.) 경로로 표시될 수 있습니다.
  7. Generate preview를 클릭합니다.
  8. Preview에서 행 상태를 검토합니다.
    • Ready: 생성할 수 있음
    • Invalid: 가져오기를 막는 오류가 있음
    • Duplicate: 파일 안이나 PMS에 이미 존재함
  9. 문제 행을 빠르게 확인하려면 필터(All, Ready, Invalid, Duplicate)를 사용합니다.
  10. 필요하면 파일을 수정한 뒤 다시 업로드합니다.
  11. 유효한 행만 남으면 Create reservations를 클릭합니다.

✓ AVA는 생성됨, 중복 건너뜀, 실패 행을 포함한 결과 요약을 표시합니다.

게스트 수 매핑​

AVA는 가져오기 중 두 가지 게스트 수 형식을 지원합니다.

파일 형식예시AVA 결과
분리된 열Adults=2, Children=1, Infants=1성인 2명, 어린이 1명, 유아 1명으로 예약 생성
HGuru Persons 열ADT:2,CHD:1,INF:1값을 파싱해 성인, 어린이, 유아에 매핑

두 형식이 모두 있으면 미리보기에서 매핑된 수량 열이 우선됩니다. 같은 규칙은 AVA가 필드를 펼친 뒤 JSON 파일에도 적용됩니다. CSV 행에 ="2/0/0" 같은 텍스트 강제 값이 있어도 올바르게 파싱됩니다.

결과 동작 이해​

결과의미조치
Created예약이 성공적으로 추가됨조치 불필요
Skipped duplicate행이 기존 PMS 데이터 또는 다른 파일 행과 일치함중복 원인 세부 정보를 확인
Failed해당 행에서 가져오기가 중단됨문제를 수정하고 남은 행을 다시 가져오기
부분 성공

가져오기는 순차적으로 실행됩니다. 한 행에서 실패하면 AVA는 그 행에서 멈춥니다. 그 이전 행은 이미 생성됐을 수 있습니다.

문제 해결​

Bulk Import 버튼이 없음​

보이는 현상: Operations View에서 Bulk Import를 찾을 수 없습니다.

해결:

  1. PMS가 Cloudbeds 또는 AVA인지 확인합니다.
  2. 계정에 예약 쓰기 권한이 있는지 확인합니다.
  3. 관리자가 호텔의 merchant 구성이 유효한지 확인해 달라고 요청합니다.

"Only XLSX, CSV, and JSON files are supported"​

보이는 현상: 파일 업로드가 즉시 거부됩니다.

해결:

  1. 파일을 다시 .xlsx, .csv, 또는 .json으로 내보냅니다.
  2. .xls, .numbers, .ods 같은 지원되지 않는 형식을 제거합니다.
  3. 새 파일을 업로드합니다.

JSON 추출 참고가 표시됨​

보이는 현상: 매핑 단계에서 JSON 파일에 대한 추출 경고가 보입니다.

해결:

  1. JSON extraction notes에서 점(.) 경로를 검토합니다.
  2. JSON이 여러 컬렉션을 사용하는지 확인합니다.
  3. 가능하면 지원되지 않는 객체 중첩 배열을 제거합니다.
  4. 미리보기를 다시 생성합니다.

JSON 필드가 예상대로 매핑되지 않음​

보이는 현상: 파일에 값은 있지만 AVA가 올바르게 매핑하지 못합니다.

해결:

  1. 소스 필드가 점(.) 경로로 표시되는지 확인합니다.
  2. 해당 점(.) 경로를 올바른 예약 필드에 매핑합니다.
  3. 소스 구조를 바꿨다면 Analyze file을 다시 실행합니다.

"Spreadsheet files must be 10 MB or smaller"​

보이는 현상: 파일 크기 관련 업로드 오류가 표시됩니다.

해결:

  1. 사용하지 않는 시트와 열을 제거합니다.
  2. 파일을 더 작은 배치로 나눕니다.
  3. 각 배치를 다시 업로드합니다.

"Date format is auto-detected or low confidence"​

보이는 현상: 매핑 또는 미리보기에서 경고가 보입니다.

해결:

  1. Date format을 수동으로 설정합니다.
  2. 미리보기를 다시 생성합니다.
  3. 커밋하기 전에 파싱된 날짜가 올바른지 확인합니다.

미리보기에서 객실 유형 오류가 보임​

보이는 현상: 행에 잘못된 객실 유형 메시지가 표시됩니다.

해결:

  1. 스프레드시트의 객실 유형을 기존 객실 유형 이름 또는 ID와 맞춥니다.
  2. 필요하면 누락된 객실 유형을 먼저 만듭니다.
  3. 다시 업로드하고 미리보기를 다시 생성합니다.

매핑에 막힘 상태가 계속 표시됨​

보이는 현상: 매핑 단계에서 계속 진행할 수 없고, 체크리스트에 빠진 필드가 남아 있습니다.

해결:

  1. 체크리스트에 표시된 모든 필드를 매핑합니다.
  2. 강조 표시된 매핑되지 않은 열이 있는지 확인합니다.
  3. 각 수정 후 미리보기를 다시 생성합니다.

HGuru Persons 값이 파싱되지 않음​

보이는 현상: 미리보기 후에도 게스트 수가 기본값으로 남아 있습니다.

해결:

  1. Persons가 올바른 토큰 ADT, CHD, INF를 사용하는지 확인합니다.
  2. 숫자 값만 사용합니다. 예: ADT:2,CHD:1,INF:1
  3. 미리보기를 생성하기 전에 Persons 열이 매핑되었는지 확인합니다.

"Bulk import stopped at row X"​

보이는 현상: 커밋 결과에 중단된 행과 실패 메시지가 표시됩니다.

해결:

  1. 결과에서 실패한 행의 세부 정보를 엽니다.
  2. 스프레드시트에서 해당 행을 수정합니다.
  3. 아직 생성되지 않은 나머지 행만 다시 가져옵니다.

계속 해결되지 않나요?​

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

  • ❌ 필드와 날짜를 다시 매핑한 뒤에도 계속 가져오기가 실패함
  • ❌ 모든 행이 예상치 않게 Invalid가 됨
  • ❌ 유효한 새 예약인데 Duplicate로 잘못 표시됨

함께 보내면 좋은 정보:

  • 오류 또는 결과 화면 스크린샷
  • 영향을 받는 스프레드시트 행 샘플
  • PMS 유형과 호텔 이름