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

ค้นหาเร็ว

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

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

ไปที่: Access Codes

---

ข้อมูลอ้างอิงแบบย่อ

งาน	จุดที่คลิก	ผลลัพธ์
ค้นหารหัส	Reservation ID, Guest Name, หรือ Room	แสดงรหัสที่ตรงกัน
กรองตามสถานะหรือวิธี	More Filters	รายการอัปเดตตามตัวกรอง
แสดง PIN	ไอคอน eye	PIN ถูกเปิดเผย
ดู Lock ID	ไอคอน key	Lock ID แสดงใน tooltip
คัดลอกรหัส	ไอคอน Copy	คัดลอกรหัสและแสดง 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	แสดงหนึ่งแถวต่อหนึ่งความพยายาม encode
ล้างตัวกรอง	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, Keycard, Locker, ACI
   • Date Range: วันที่เริ่มและสิ้นสุด

3. คลิก Reset All เพื่อล้างค่าทั้งหมดในแผงนี้

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

เลื่อนดูหน้า

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

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

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

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

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

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

2. คลิกไอคอน eye เพื่อเปิด PIN

3. คลิกไอคอน copy

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

ดู Lock ID

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

2. เลือกไอคอน key

   ✓ 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 ใหม่ของผู้เข้าพักควรหายค้างเร็วกว่าแถวเก่า AVA จะข้ามแถว Active ที่หมดอายุในอดีต แม้ฟิลด์ bridge เก่ายังอยู่ แถว Active ปัจจุบันยังใช้งานได้ตราบใดที่หน้าต่างการเข้าถึงยังเปิดอยู่ ระหว่างการเช็กอินและการรีเฟรช lookup AVA จะตรวจงาน smart lock ที่รออยู่ก่อนแสดงผลลัพธ์ AVA ยังเว้นช่วงอย่างน้อย 2 วินาทีระหว่างการตรวจผู้ให้บริการ จึงอาจต้องรีเฟรชอีกครั้ง

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

แต่ละแถว PIN ของ smart lock จะมี chip สถานะของตัวเองในตารางและการ์ดบนมือถือ ใช้สถานะนี้เมื่อรหัส 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 code คอลัมน์ Valid Period จะถูกซ่อน

ตรวจประวัติ keycard

ใช้มุมมอง Events เมื่อคุณต้องการ audit trail ของการ encode keycard

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

เฉพาะแถว keycard

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

เวลา keycard ของ Opera

สำหรับ keycard ของ Opera เวลาในคอลัมน์ Created จะใช้ keyCreationTime ของ PMS ที่ยืนยันแล้ว timestamp นี้ตรงกับการยืนยัน key ภาพจริงที่สำเร็จ ถ้า Opera ส่ง timestamp ความถูกต้องแบบ local ของโรงแรม AVA จะเก็บไว้ใช้ใน diagnostics

รายละเอียดความล้มเหลวแบบมาตรฐาน

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

รหัส fault ยังมองเห็นได้

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

Access Codes เป็นแบบดูอย่างเดียว

ถ้าต้องการตั้งค่าหรือเปลี่ยน access ให้ใช้ Manage PIN (smart locks) หรือ Manage Locker Code (lockers) ใน reservation

เคล็ดลับ

• รายการ locker จะแสดง Locker # และ Code แทน PIN
• ตัวกรอง ACI ใช้กับ access code ของการเช็กอินแบบมีพนักงานช่วย
• เวลาในหน้าทั้งหมดใช้ timezone ที่แสดงอยู่ด้านล่างของหน้า
• แถว keycard ใช้คอลัมน์ Created เป็นเวลา encode
• สำหรับ keycard ของ Opera คอลัมน์ Created ใช้ timestamp ที่ยืนยันจาก PMS
• ถ้าชื่อห้องดูไม่ถูกต้อง ให้ตรวจ mapping ห้องใน Rooms
• อ่าน Access Details จากตารางโดยตรงเมื่อคุณต้องการข้อความแบบภาษาอ่านง่าย

การแก้ปัญหา

มีหลายแถว keycard

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

วิธีแก้:

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

ไม่พบ access code

สิ่งที่เห็น: ขึ้นว่า "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. AVA จะตรวจงาน smart lock ใหม่ก่อนรายการ backlog เก่า ดังนั้น PIN ใหม่ควรหายค้างก่อน
3. ระหว่างรีเฟรชการค้นหาเช็กอิน AVA จะตรวจงานที่รออยู่ก่อนแสดงผลลัพธ์
4. AVA จะข้ามแถว Active ที่หมดอายุในอดีต แม้ฟิลด์ bridge เก่าอาจยังมีอยู่
5. AVA จะตรวจงานของผู้ให้บริการต่อเบื้องหลัง ดังนั้น stay ปัจจุบันอาจกลายเป็น Successful ได้โดยไม่ต้องทำอะไรเพิ่ม
6. ระหว่างรอเช็กอิน AVA จะรีเฟรชงาน smart lock ที่รออยู่ด้วย ซึ่งอาจทำให้ PIN ที่พร้อมใช้งานแสดงเร็วขึ้น
7. ถ้าเห็น partial ให้รอจนสถานะเสร็จแล้วค่อยแชร์ PIN
8. ถ้าสถานะค้าง pending เกิน 1 นาทีใน stay ปัจจุบัน ให้ลองสร้าง PIN ใหม่จาก reservation
9. ถ้ากลายเป็น Timed out หรือ Failed ให้ตรวจ bridge และเชื่อมผู้ให้บริการใหม่ถ้าจำเป็น

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

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

วิธีแก้:

1. อ่านข้อความสั้นก่อน
2. ใช้ error code, retriable flag, และรายละเอียดผู้ให้บริการเมื่อติดต่อซัพพอร์ต
3. ยืนยันว่า reservation ID ห้อง และวันที่เข้าพักถูกต้อง
4. ถ้า mapping ห้องหรือ session ของ encoder ผิด ให้แก้ตรงนั้นก่อน
5. ลองทำ keycard อีกครั้งหลังบันทึกการเปลี่ยนแปลง

คอลัมน์ Valid Period หายไป

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

วิธีแก้:

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

ยังติดอยู่?

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

• ❌ รหัสไม่แสดงหลังเช็กอิน
• ❌ สถานะยังเป็น Failed หลังลองใหม่