จัดการรหัสเข้าถึง

ค้นหาอย่างรวดเร็ว

ทีมส่วนใหญ่ค้นหารหัสได้ภายในไม่ถึงหนึ่งนาทีโดยใช้ Reservation ID, Guest Name หรือ Room

คู่มือนี้ช่วยให้คุณตรวจสอบ PIN, QR key, keycard และการเข้าถึง locker นอกจากนี้ยังช่วยให้คุณอ่านประวัติเหตุการณ์ของ keycard และประวัติ QR key ได้ด้วย

ไปที่: Access Codes

---

ข้อมูลอ้างอิงอย่างรวดเร็ว

งาน	จุดที่คลิก	ผลลัพธ์
ค้นหารหัส	Reservation ID, Guest Name หรือ Room	แสดงรหัสที่ตรงกัน
กรองตามสถานะหรือวิธี	More Filters	รายการอัปเดตตามตัวกรอง
แสดง PIN	Eye icon	แสดง PIN
ดู lock ID	Key icon	แสดง Lock ID ใน tooltip
คัดลอกรหัส	Copy icon	คัดลอกรหัสและแสดง Copied
เลื่อนไปมาระหว่างหน้า	Previous หรือ Next	โหลดหน้าอื่น
เปลี่ยนขนาดหน้า	10 per page	รีเฟรชรายการด้วยขนาดใหม่
ตรวจวันที่มีผล	คอลัมน์ Valid Period	แสดงเวลาเริ่มต้นและสิ้นสุด
ตรวจเวลาที่เหลือ	badge Status	แสดงเวลาที่เหลือสำหรับรหัสที่ใช้งานอยู่
ตรวจความคืบหน้าของงาน	badge Operation Status	แสดงว่า PIN ของ smart lock แต่ละรายการกำลังรอ ดำเนินการบางส่วน สำเร็จ ล้มเหลว หรือหมดเวลา
ตรวจรายละเอียดความล้มเหลว	Access Details	แสดงข้อผิดพลาดของ keycard เป็นภาษาที่อ่านง่าย พร้อม userMessage, errorCode, retriable, vendor และรายละเอียด upstream ที่ปลอดภัยเมื่อมี
ตรวจประวัติ keycard	มุมมอง Events	แสดงหนึ่งแถวต่อความพยายามเข้ารหัส keycard
ล้างตัวกรอง	Clear All หรือ Reset All	กลับสู่มุมมองเริ่มต้น

ค้นหารหัสเข้าถึง

1. ไปที่ Access Codes

2. กรอก Reservation ID, Guest Name หรือ Room

3. รอสักครู่ให้รายการอัปเดต

   ✓ รหัสที่ตรงกันจะปรากฏในรายการ

กรองรายการ

1. คลิก More Filters

2. เลือกตัวกรองอย่างน้อยหนึ่งรายการ:

   • Status: Active, Expired, Generation Pending, Partial Success, Generation Failed, Revoked, Superseded
   • Access Method: Smart Lock, Digital Key, Keycard, Locker, ACI
   • Date Range: วันที่เริ่มต้นและวันที่สิ้นสุด

3. คลิก Reset All เพื่อล้างทุกอย่างในแผงนี้

   ✓ รายการจะรีเฟรชตามตัวเลือกของคุณ

เลื่อนไปมาระหว่างหน้า

1. เลื่อนไปด้านล่างของรายการ

2. คลิก Previous หรือ Next

3. เปิด 10 per page แล้วเลือก 10, 25, 50 หรือ 100

   ✓ รายการจะรีเฟรชด้วยขนาดหน้าใหม่

จัดการ QR digital key

1. ค้นหาแถว QRLOCK

2. เปิด Manage digital key

3. เลือก Issue, Copy guest link, Send หรือ Withdraw

4. ใช้ Retry cancellation เมื่อการถอนยังอยู่ระหว่างดำเนินการ

5. เลือก Reissue หลังจากยืนยันการถอนแล้วเท่านั้น

   ✓ Modal จะแสดงสถานะ key ปัจจุบันและประวัติที่กรองตาม reservation

สำหรับ reservation ที่มีหลายห้อง AVA จะตรวจสอบห้องที่เลือก การออกใหม่และการส่งจะยังใช้ไม่ได้สำหรับห้องที่เลือกซึ่งอยู่ในสถานะสิ้นสุด ประวัติห้องและตัวควบคุมการถอนยังใช้งานได้

หากไม่มีหมายเลขโทรศัพท์ของผู้เข้าพัก หรือหมายเลขล้าสมัย AVA สามารถจับคู่ QR key ที่มีอยู่ อีกครั้งโดยใช้ผู้ถือที่บันทึกไว้ ระบบจะตรวจสอบห้องที่เลือก การเข้าพัก การแมป วันหมดอายุ และสถานะการถอนก่อนส่งคืน key นั้น

การกู้คืนนี้จะนำ key เดิมกลับมาใช้ซ้ำ ไม่ได้สร้างการ์ด QRLOCK ใบใหม่ หรืออัปเดตหมายเลขโทรศัพท์ของผู้เข้าพักใน PMS

เปิดเผยและคัดลอก PIN

1. ค้นหาแถวที่ต้องการ

2. คลิก eye icon เพื่อเปิดเผย PIN

3. คลิก copy icon

   ✓ ไอคอนจะเปลี่ยนเป็น Copied ชั่วครู่

ดู Lock ID

1. ค้นหาแถว smart lock ที่ต้องการ

2. เลือก key icon

   ✓ Lock ID จะปรากฏใน tooltip

ทำความเข้าใจป้ายสถานะ

สถานะ	ความหมาย	ต้องทำอะไร
Active	รหัสใช้ได้ในขณะนี้	แชร์ให้ผู้เข้าพัก
Expired	ช่วงเวลาที่มีผลสิ้นสุดแล้ว	ออกรหัสใหม่หากจำเป็น
pending	งาน smart-lock ยังอยู่ระหว่างประมวลผล	รอและรีเฟรชก่อนแชร์
partial	ขั้นตอนของ smart-lock บางส่วนเสร็จแล้ว แต่งานยังไม่สมบูรณ์	รอและรีเฟรชก่อนแชร์
Failed	ผู้ให้บริการสร้างรหัสไม่สำเร็จ	ตรวจสอบการตั้งค่าล็อกแล้วลองอีกครั้ง
Revoked	รหัสถูกปิดใช้งานก่อนกำหนด	ยืนยันกับผู้จัดการก่อนออกใหม่
Superseded	รหัสใหม่กว่าเข้ามาแทนที่รหัสนี้	ใช้รหัสล่าสุด

ใช้ More Filters → Status เพื่อค้นหาแถวเหล่านี้ในชื่อ Generation Pending และ Partial Success

ตรวจ PIN ใหม่ก่อน

AVA จะตรวจงาน smart-lock ที่ใหม่กว่ารายการค้างเก่าก่อน PIN ใหม่ของผู้เข้าพักควรเสร็จเร็วกว่ารายการ pending เก่า AVA จะข้ามแถว Active ในประวัติที่หมดอายุแล้ว แม้จะยังมีฟิลด์ bridge เก่าอยู่ แถว Active ปัจจุบันยังมีสิทธิ์ถูกตรวจตราบใดที่ช่วงเวลาการเข้าถึงยังเปิดอยู่ ระหว่างการเช็กอินและการรีเฟรชการค้นหา AVA จะตรวจงาน smart-lock ที่ pending อีกครั้งก่อนส่งผลลัพธ์ AVA ยังเว้นระยะอย่างน้อย 2 วินาทีระหว่างการตรวจผู้ให้บริการ ดังนั้นอาจต้องรีเฟรชอีกครั้ง

ข้อมูลรับรองที่ออกก่อนเช็กอินขั้นสุดท้าย

AVA สามารถออก PIN, QR key หรือข้อมูลรับรอง locker ระหว่างการจัดสรรห้องได้ หลังเช็กอินขั้นสุดท้าย ข้อมูลรับรองที่สำเร็จจะยังผูกอยู่กับผู้เข้าพักที่มาถึงและยืนยันแล้ว รีเฟรช reservation ก่อนออกข้อมูลรับรองอีกครั้ง

ทำความเข้าใจสถานะการทำงานของ Smart Lock

แถว PIN ของ smart-lock แต่ละแถวจะแสดงชิปการทำงานของตัวเองในตารางและการ์ดบนมือถือ ใช้สถานะนี้เมื่อรหัส smart-lock ยังอยู่ระหว่างส่งผ่าน bridge ของผู้ให้บริการ

รอสถานะพร้อมใช้งาน

อย่าแชร์ PIN ของ smart-lock จนกว่า Operation Status จะแสดง Successful pending และ partial ยังหมายความว่าการเข้าถึงไม่พร้อมอย่างสมบูรณ์

สถานะ	ความหมาย	ต้องทำอะไร
Pending	AVA ยังรอให้งานของผู้ให้บริการเสร็จ	รอสักครู่แล้วรีเฟรชหน้า
Successful	AVA ยืนยันแล้วว่างานล็อกเสร็จ	แชร์ PIN ให้ผู้เข้าพัก
Failed	งานของผู้ให้บริการล้มเหลว	ตรวจการเชื่อมต่อล็อกแล้วลองอีกครั้ง
Timed out	AVA ตรวจสอบต่อเนื่อง แต่งานไม่เสร็จภายในเวลา	ลองสร้าง PIN ใหม่และตรวจสอบ bridge

ตรวจสอบรายละเอียดเวลา

ใช้ตารางเพื่อยืนยันว่ารหัสเริ่มต้น สิ้นสุด และถูกสร้างขึ้นเมื่อใด

รายการ	ดูที่ไหน	ความหมาย
Time remaining	ใต้ badge Active	เวลาที่เหลือก่อนรหัสหมดอายุ
Valid Period	คอลัมน์ Valid Period	วันและเวลาเริ่มต้นกับสิ้นสุด
Created	คอลัมน์ Created	เวลาที่สร้างรหัส

คอลัมน์ Valid Period

หากรายการแสดงเฉพาะรหัส locker คอลัมน์ Valid Period จะถูกซ่อน

วันที่ตามปฏิทินของที่พัก

สำหรับ reservation ของ PMS AVA จะเก็บวันที่เข้าพักและวันออกจากที่พักเป็นวันที่ตามปฏิทินของที่พัก ระบบจะใช้เขตเวลาของโรงแรมเมื่อสร้างช่วงเวลาที่มีผลแต่ละช่วง วิธีนี้ทำให้ Valid Period สอดคล้องกับวันที่ท้องถิ่นของ reservation

ตรวจสอบประวัติเหตุการณ์ของ keycard

ใช้มุมมอง Events เมื่อต้องการ audit trail ของความพยายามเข้ารหัส keycard

สถานะที่แสดง	สิ่งที่เห็น	ความหมาย
Encoded	แถวบัตรที่สำเร็จ	AVA เขียนบัตรสำหรับความพยายามนั้นแล้ว
Failed	รายละเอียดข้อผิดพลาดในแถว	เข้ารหัสบัตรไม่สำเร็จ
Expired	บัตรที่พ้นช่วงเวลาที่มีผล	บัตรใช้ไม่ได้อีกต่อไป
Revoked	แถวบัตรที่ถูกเพิกถอน	บัตรถูกปิดใช้งานก่อนกำหนด
Superseded	แถวบัตรที่มาแทนที่	บัตรใหม่กว่าเข้ามาแทนที่บัตรนี้
Created	เวลาเข้ารหัสในคอลัมน์ Created	เวลาที่ AVA บันทึกความพยายามนั้น

เฉพาะแถว keycard

รายการเริ่มต้นยังจัดกลุ่มรหัสเข้าถึงตาม reservation ในมุมมอง Events แถว keycard จะแยกเป็นหนึ่งแถวต่อความพยายาม แถว smart lock และ locker ยังคงแสดงหนึ่งระเบียนต่อรหัสเข้าถึง

ประทับเวลาของ keycard ใน Opera

สำหรับ keycard ของ Opera เวลา Created จะใช้ keyCreationTime ของ PMS ที่ยืนยันแล้ว เวลาประทับดังกล่าวตรงกับการยืนยัน key จริงที่สำเร็จ หาก Opera ส่งเวลาประทับที่มีผลตามเวลาท้องถิ่นของโรงแรม AVA จะเก็บไว้ใช้วินิจฉัยการยืนยัน

รายละเอียดความล้มเหลวที่ปรับให้เป็นมาตรฐาน

แถว keycard ที่ล้มเหลวจะเก็บข้อความแบบมีโครงสร้างไว้ก่อน หาก encoder ส่งคืน false AVA จะบันทึก KEYCARD_ENCODE_FAILED เป็นความล้มเหลวที่มีชนิด คุณอาจเห็น userMessage, errorCode, retriable, vendor และรายละเอียด upstream ที่ปลอดภัยสำหรับทีมสนับสนุน ใช้ retriable เพื่อตัดสินว่าการลองใหม่มีแนวโน้มช่วยได้หรือไม่ timeout HTTP 504 ของ room-access ยังคงอยู่ในเส้นทางนี้พร้อม KEYCARD_VENDOR_TIMEOUT เมื่อเปรียบเทียบ timeout ให้ตรวจสอบห้อง จำนวน key และช่วงเวลาที่มีผลก่อน วิธีนี้ช่วยแยกความไม่ตรงกันจริงออกจากปัญหาการยืนยันที่เกิดจาก timezone เพียงอย่างเดียว

รหัสข้อผิดพลาดยังคงแสดงอยู่

AVA จะเก็บค่า room-access faultcode:<value> ไว้ในข้อความเหตุการณ์ การปกปิด PII ยังคงใช้กับหมายเลขโทรศัพท์ อีเมล บัตร และ token ใช้ faultcode เมื่อเปรียบเทียบเหตุการณ์ของผู้ให้บริการ

digital key ใช้ตัวควบคุมแยกต่างหาก

ใช้ Manage digital key สำหรับแถว QRLOCK ใช้ Manage PIN สำหรับ smart lock หรือ Manage Locker Code สำหรับ locker

Access Codes เป็นแบบดูอย่างเดียวสำหรับแถว PIN, keycard และ locker แถว QRLOCK จะเปิด modal สำหรับการจัดการโดยเฉพาะ

เคล็ดลับ

• รายการ locker จะแสดง Locker # และ Code แทน PIN
• ตัวกรอง ACI ใช้กรองระเบียนรหัสเข้าถึงสำหรับ assisted check-in
• เวลาทั้งหมดใช้เขตเวลาที่แสดงด้านล่างของหน้า
• แถว keycard ใช้คอลัมน์ Created เป็นเวลาเข้ารหัส
• สำหรับ keycard ของ Opera คอลัมน์ Created ใช้เวลาประทับจาก PMS ที่ยืนยันแล้ว
• หากชื่อห้องดูไม่ถูกต้อง ให้ยืนยันการแมปห้องใน Rooms
• อ่าน Access Details โดยตรงในตารางเมื่อต้องการข้อความที่อ่านเข้าใจง่าย

การแก้ปัญหา

มีหลายแถว keycard

สิ่งที่เห็น: reservation เดียวกันปรากฏหลายครั้งใน Events

วิธีแก้:

1. ตรวจสอบคอลัมน์ Display status
2. ใช้เวลา Created ที่ใหม่ที่สุด
3. เก็บแถวเก่าไว้เฉพาะเมื่อต้องการ audit trail

ไม่พบรหัสเข้าถึง

สิ่งที่เห็น: แสดงข้อความ "No access codes found" หรือรายการว่าง

วิธีแก้:

1. ล้างตัวกรองทั้งหมด
2. ค้นหาด้วย Reservation ID หรือ Room
3. รีเฟรชหน้า

ไอคอนคัดลอกไม่ทำงาน

สิ่งที่เห็น: ไอคอนคัดลอกไม่เปลี่ยนเป็น Copied

วิธีแก้:

1. เปิดเผย PIN ก่อน
2. ลองอีกครั้งหลังอนุญาตให้เบราว์เซอร์เข้าถึง clipboard

สถานะแสดง Failed

สิ่งที่เห็น: สถานะเป็น Failed พร้อมข้อความผิดพลาด

วิธีแก้:

1. ยืนยันว่าการเชื่อมต่อ smart lock ทำงานอยู่
2. ลองสร้าง PIN ใหม่จาก reservation

สถานะการทำงานค้างอยู่ที่ pending หรือ partial

สิ่งที่เห็น: รหัส smart-lock แสดง pending หรือ partial หลังจากสร้าง

วิธีแก้:

1. รอไม่เกิน 1 นาที แล้วรีเฟรช reservation หรือหน้า Access Codes
2. ระบบจะตรวจ PIN ใหม่ก่อนแถว backlog เก่า ดังนั้นรหัสของผู้เข้าพักใหม่ควรเสร็จก่อน
3. หากกำลังค้นหาเพื่อเช็กอิน AVA จะตรวจงานที่ pending อีกครั้งก่อนแสดงผลลัพธ์
4. หากแถวนั้นหมดอายุแล้ว AVA จะข้ามโดยตั้งใจ
5. หากสถานะเปลี่ยนเป็น Successful ให้แชร์ PIN
6. หากยังเป็น pending หรือ partial เกิน 1 นาทีระหว่างการเข้าพักปัจจุบัน ให้ลองสร้าง PIN ใหม่จาก reservation
7. หากเปลี่ยนเป็น Timed out หรือ Failed ให้ตรวจการเชื่อมต่อผู้ให้บริการและสถานะ bridge ก่อนลองอีกครั้ง

ข้อความความล้มเหลวของ keycard เป็นภาษาที่อ่านง่าย

สิ่งที่เห็น: แถว keycard แสดงข้อความสั้นแทนข้อความดิบจากผู้ให้บริการ คุณอาจเห็น userMessage, errorCode, retriable, vendor หรือรายละเอียด upstream ที่ปลอดภัยด้วย

วิธีแก้:

1. อ่านข้อความสั้นก่อน
2. ใช้รหัสข้อผิดพลาด แฟล็ก retriable และรายละเอียดผู้ให้บริการเมื่อติดต่อทีมสนับสนุน
3. ยืนยันว่า Reservation ID ห้อง และวันที่เข้าพักถูกต้อง
4. หากการแมปห้องหรือเซสชัน encoder ไม่ถูกต้อง ให้แก้ไขก่อน
5. ลองดำเนินการกับ keycard อีกครั้งหลังบันทึกการเปลี่ยนแปลง

ไม่พบคอลัมน์ Valid Period

สิ่งที่เห็น: ไม่แสดงคอลัมน์ Valid Period

วิธีแก้:

1. ล้างตัวกรองทั้งหมด
2. ยืนยันว่าคุณไม่ได้กำลังดูเฉพาะรหัส locker

การดำเนินการกับ QR key ใช้งานไม่ได้

สิ่งที่เห็น: Issue, Reissue หรือ Send ใช้งานไม่ได้

วิธีแก้:

1. เปิดประวัติ QR key ที่กรองตาม reservation
2. ยืนยันว่าห้องที่เลือกไม่ได้อยู่ในสถานะสิ้นสุดใน PMS
3. ตรวจสอบว่าห้องใน PMS มีการแมป QRLOCK ที่บันทึกไว้
4. ใช้ Retry cancellation หากการถอนก่อนหน้านี้ยังอยู่ระหว่างดำเนินการ

QR key ที่บันทึกไว้หายไปหลังหมายเลขโทรศัพท์ผู้เข้าพักเปลี่ยน

สิ่งที่เห็น: หมายเลขโทรศัพท์ของผู้เข้าพักว่างเปล่าหรือเปลี่ยนไป แต่ก่อนหน้านี้เคยออก QR key ไว้แล้ว

วิธีแก้:

1. รีเฟรช reservation หลังจากข้อมูลล่าสุดจาก PMS มาถึง

2. ยืนยันว่าห้องที่เลือกและวันที่เข้าพักตรงกับประวัติ QR key

3. เปิด Manage digital key อีกครั้ง

4. ใช้ Copy guest link หรือ Send หากพบ key เดิม

5. อย่าออก key ซ้ำหลายครั้งขณะที่สถานะยังอยู่ระหว่างโหลด

   ✓ AVA สามารถนำ key ที่บันทึกไว้กลับมาใช้ซ้ำได้ หากการเข้าพักและการแมปห้องยังตรงกัน

ติดต่อทีมสนับสนุนก่อนออกใหม่ หากยังไม่พบ key การเปลี่ยนห้อง การเข้าพัก การแมป วันหมดอายุ หรือสถานะการถอน อาจทำให้ต้องกู้คืนโดยเจ้าหน้าที่

ยังแก้ไม่ได้ใช่ไหม

ติดต่อ success@vouch-technologies.com หาก:

• ❌ รหัสไม่ปรากฏหลังเช็กอิน
• ❌ สถานะยังเป็น Failed หลังลองใหม่
• ❌ คุณเปิดหน้า Access Codes ไม่ได้

ข้อมูลที่ควรแนบ:

• Reservation ID
• หมายเลขห้อง
• ภาพหน้าจอของแถวสถานะ

คู่มือที่เกี่ยวข้อง

• การจัดการข้อมูลเมทาดาทาของห้อง
• ตั้งค่า QRLOCK Digital Keys
• ปัญหา Smart Lock
• Command Center