นำเข้าการจองจากไฟล์
การนำเข้าส่วนใหญ่ใช้เวลา 3-5 นาทีหลังจากไฟล์ของคุณพร้อมแล้ว
ใช้ขั้นตอนนี้เพื่อสร้างการจองจำนวนมากจากไฟล์ .xlsx, .csv หรือ .json
อีเมลผู้เข้าพักเป็นฟิลด์ไม่บังคับในการนำเข้าแบบกลุ่ม ดังนั้นอีเมลที่หายไปจะไม่บล็อกขั้นตอนนี้
ไปที่: Operations View
ก่อนเริ่มต้น
| ข้อกำหนด | เหตุผล | สิ่งที่ต้องตรวจ |
|---|---|---|
| PMS เป็น Cloudbeds หรือ AVA | ปุ่มนำเข้าแบบกลุ่มจะแสดงเฉพาะ PMS ที่รองรับ | ยืนยัน Settings → Essentials → PMS Integration |
| ไฟล์เป็น .xlsx, .csv หรือ .json | รูปแบบอื่นจะถูกบล็อก | บันทึกหรือส่งออกไฟล์ให้อยู่ในหนึ่งในรูปแบบเหล่านี้ |
| ขนาดไฟล์ไม่เกิน 10 MB | ไฟล์ที่ใหญ่กว่าจะถูกปฏิเสธ | ตรวจคุณสมบัติไฟล์ก่อนอัปโหลด |
| มีข้อมูลจำนวนผู้เข้าพัก | AVA นำเข้าผู้ใหญ่ เด็ก และทารกได้ | ใส่คอลัมน์จำนวนแยกกัน หรือใช้คอลัมน์ HGuru Persons หนึ่งคอลัมน์ |
| มี room types ใน AVA | การจับคู่ room type จะล้มเหลวหากไม่มี room types | ยืนยันว่ามี room types พร้อมใช้งาน |
สิ่งที่การนำเข้า JSON ทำ
| โครงสร้าง JSON | ตัวอย่าง | สิ่งที่ AVA ทำ |
|---|---|---|
| วัตถุซ้อนกัน | guest.email | แปลงเป็นเส้นทางแหล่งข้อมูลแบบมีจุด |
| อาร์เรย์แบบเรียบ | roomNumbers: [101, 102] | รวมค่าด้วยตัวคั่นแบบ pipe |
| อาร์เรย์ของวัตถุ | guests: [{...}] | ข้ามและแสดงบันทึกการดึงข้อมูล |
หาก JSON ของคุณมีหลายชุดข้อมูลการจอง AVA จะเลือกชุดที่ตรงที่สุด และจะมีคำเตือนเมื่อเกิดกรณีนั้น
นำเข้าการจอง
- ไปที่ Operations View
- คลิก Bulk Import ในชุดคำสั่งมุมขวาบน
- ในขั้น Upload ให้ลากไฟล์มาวาง หรือคลิกเพื่อเลือกไฟล์
- ตั้งค่า Date format:
- คง Auto-detect ไว้สำหรับไฟล์ส่วนใหญ่
- เลือกรูปแบบตายตัวหากวันกับเดือนอาจสลับกันได้
- คลิก Analyze file
- ในขั้น 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) - หากยังมีฟิลด์ที่จำเป็นหายไป รายการตรวจการจับคู่จะแสดงตัวขัดขวางก่อนให้คุณไปต่อ
- ฟิลด์ที่ยังไม่ได้จับคู่จะมองเห็นได้ง่าย จึงควรแก้จุดเหล่านั้นก่อน
- ฟิลด์ต้นทางจาก JSON อาจแสดงเป็นเส้นทางแบบมีจุด เช่น
guest.email
- คลิก Generate preview
- ในขั้น Preview ตรวจสถานะของแต่ละแถว:
- Ready: สร้างได้
- Invalid: มีข้อผิดพลาดที่บล็อกการนำเข้า
- Duplicate: มีอยู่แล้วในไฟล์ของคุณหรือใน PMS
- ใช้ตัวกรอง (All, Ready, Invalid, Duplicate) เพื่อตรวจแถวที่มีปัญหาอย่างรวดเร็ว
- แก้ไฟล์ของคุณและอัปโหลดใหม่หากจำเป็น
- คลิก Create reservations เมื่อเหลือเฉพาะแถวที่ถูกต้อง
✓ AVA จะแสดงสรุปผลว่ามีแถวที่สร้างแล้ว ข้ามเพราะซ้ำ และล้มเหลวกี่รายการ
จับคู่จำนวนผู้เข้าพัก
AVA รองรับรูปแบบจำนวนผู้เข้าพัก 2 แบบในการนำเข้า
| รูปแบบไฟล์ | ตัวอย่าง | ผลใน AVA |
|---|---|---|
| คอลัมน์แยก | Adults=2, Children=1, Infants=1 | สร้างการจองด้วยผู้ใหญ่ 2 คน เด็ก 1 คน และทารก 1 คน |
| คอลัมน์ HGuru Persons | ADT:2,CHD:1,INF:1 | แยกค่าแล้วจับคู่ไปยังผู้ใหญ่ เด็ก และทารก |
หากมีทั้งสองรูปแบบ คอลัมน์จำนวนที่จับคู่แล้วจะมีลำดับความสำคัญในตัวอย่างก่อนยืนยัน กฎเดียวกันนี้ใช้กับไฟล์ JSON หลังจาก AVA แปลงฟิลด์ให้เป็นแบบแบน
ทำความเข้าใจพฤติกรรมของผลลัพธ์
| ผลลัพธ์ | ความหมาย | การดำเนินการ |
|---|---|---|
| Created | เพิ่มการจองสำเร็จแล้ว | ไม่ต้องทำอะไร |
| Skipped duplicate | แถวนั้นตรงกับข้อมูล PMS ที่มีอยู่หรือกับแถวอื่นในไฟล์ | ตรวจรายละเอียดต้นทางของ duplicate |
| Failed | การนำเข้าหยุดที่แถวนั้น | แก้ปัญหาแล้วนำเข้าแถวที่เหลือใหม่ |
การนำเข้าทำงานตามลำดับ หากหนึ่งแถวล้มเหลว AVA จะหยุดที่แถวนั้น แถวก่อนหน้านั้นยังคงถูกสร้างได้
การแก้ปัญหา
ไม่มีปุ่ม Bulk Import
สิ่งที่เห็น: คุณหา Bulk Import ไม่เจอใน Operations View
วิธีแก้:
- ยืนยันว่า PMS ของคุณเป็น Cloudbeds หรือ AVA
- ยืนยันว่าบัญชีของคุณมีสิทธิ์เขียนข้อมูลการจอง
- ขอผู้ดูแลตรวจสอบว่าโรงแรมมีการตั้งค่า merchant ที่ถูกต้อง
"Only XLSX, CSV, and JSON files are supported"
สิ่งที่เห็น: การอัปโหลดไฟล์ถูกปฏิเสธทันที
วิธีแก้:
- ส่งออกไฟล์ใหม่เป็น
.xlsx,.csvหรือ.json - ลบรูปแบบที่ไม่รองรับ เช่น
.xls,.numbersหรือ.ods - อัปโหลดไฟล์ใหม่
มีบันทึกการดึงข้อมูลจาก JSON
สิ่งที่เห็น: ขั้นการจับคู่แสดงคำเตือนการดึงข้อมูลสำหรับไฟล์ JSON ของคุณ
วิธีแก้:
- ตรวจเส้นทางต้นทางแบบมีจุดใน JSON extraction notes
- ตรวจว่า JSON ของคุณใช้หลายชุดข้อมูลหรือไม่
- หากทำได้ ให้เอา nested arrays of objects ที่ไม่รองรับออก
- สร้างตัวอย่างใหม่อีกครั้ง
ฟิลด์ JSON ไม่ map ตามที่คาด
สิ่งที่เห็น: มีค่าที่อยู่ในไฟล์ แต่ AVA จับคู่ไม่ถูกต้อง
วิธีแก้:
- ยืนยันว่าฟิลด์ต้นทางแสดงเป็นเส้นทางแบบมีจุด
- จับคู่เส้นทางนั้นไปยังฟิลด์การจองที่ถูกต้อง
- รัน Analyze file ใหม่ หากคุณเปลี่ยนโครงสร้างต้นทาง
"Spreadsheet files must be 10 MB or smaller"
สิ่งที่เห็น: เกิดข้อผิดพลาดเรื่องขนาดไฟล์ตอนอัปโหลด
วิธีแก้:
- ลบชีตและคอลัมน์ที่ไม่ได้ใช้
- แบ่งไฟล์เป็นชุดที่เล็กลง
- อัปโหลดแต่ละชุดใหม่
"Date format is auto-detected or low confidence"
สิ่งที่เห็น: มีคำเตือนในขั้นการจับคู่หรือการแสดงตัวอย่าง
วิธีแก้:
- ตั้ง Date format แบบ manual
- สร้างตัวอย่างใหม่
- ยืนยันว่า date ที่แยกได้ถูกต้องก่อนยืนยัน
มีข้อผิดพลาดเรื่อง room type ในตัวอย่างก่อนยืนยัน
สิ่งที่เห็น: แสดงข้อความ room type ไม่ถูกต้องในบางแถว
วิธีแก้:
- จับคู่ค่า room type กับชื่อหรือ ID ของ room type ที่มีอยู่
- สร้าง room type ที่ขาดก่อน หากจำเป็น
- อัปโหลดใหม่และสร้างตัวอย่างอีกครั้ง
ขั้นการจับคู่ยังแสดงตัวขัดขวาง
สิ่งที่เห็น: ขั้นการจับคู่ไม่ให้ไปต่อ และ checklist ยังแสดงฟิลด์ที่ขาดอยู่
วิธีแก้:
- จับคู่ทุกฟิลด์ที่จำเป็นซึ่งแสดงใน checklist
- ตรวจฟิลด์ที่ยังไม่ได้จับคู่ซึ่งถูกไฮไลต์ไว้
- สร้างตัวอย่างใหม่หลังแก้แต่ละครั้ง
ค่า HGuru Persons ไม่ถูกแยก
สิ่งที่เห็น: จำนวนผู้เข้าพักยังเป็นค่าเริ่มต้นหลังการแสดงตัวอย่าง
วิธีแก้:
- ตรวจว่า Persons ใช้ token ที่ถูกต้อง:
ADT,CHD,INF - ใช้เฉพาะค่าตัวเลข เช่น
ADT:2,CHD:1,INF:1 - ยืนยันว่าได้จับคู่ฟิลด์ Persons แล้วก่อนสร้างตัวอย่าง
"Bulk import stopped at row X"
สิ่งที่เห็น: ผลการยืนยันแสดงแถวที่หยุดและข้อความล้มเหลว
วิธีแก้:
- เปิดรายละเอียดแถวที่ล้มเหลวในผลลัพธ์
- แก้แถวนั้นในไฟล์ของคุณ
- นำเข้าใหม่เฉพาะแถวที่ยังไม่ได้สร้าง
ยังติดปัญหาอยู่?
ติดต่อ success@vouch-technologies.com หาก:
- ❌ การนำเข้ายังล้มเหลวหลังจากจับคู่ฟิลด์และวันที่ใหม่
- ❌ ทุกแถวกลายเป็น invalid โดยไม่คาดคิด
- ❌ ระบบ flag duplicate ผิดสำหรับการจองใหม่ที่ถูกต้อง
ข้อมูลที่ควรแนบ:
- ภาพหน้าจอของ error หรือหน้าผลลัพธ์
- ตัวอย่างแถวในไฟล์ที่ได้รับผลกระทบ
- ประเภท PMS และชื่อโรงแรมของคุณ