แก้ไขปัญหาเครื่องเข้ารหัสคีย์การ์ด

แก้เร็ว

ตรวจไฟและเครือข่ายก่อน จากนั้นลองเข้ารหัสการ์ดทีละใบอีกครั้ง ใช้เวลาประมาณ 2 นาที

คู่มือนี้ช่วยให้คุณแก้ปัญหาเครื่องเข้ารหัสคีย์การ์ดที่พบบ่อย

ข้อมูลอ้างอิงด่วน

สิ่งที่เห็น	สาเหตุ	วิธีทำ
เครื่องไม่ตอบสนอง	ปัญหาไฟหรือเครือข่าย	ตรวจการเชื่อมต่อ
การ์ดไม่เข้ารหัส	ปัญหาการ์ดหรืออุปกรณ์	ตรวจสอบการ์ดและอุปกรณ์
"UserCredentialsNotProvided.NotApplicable"	ข้อมูลรับรอง Saflok หายหรือไม่ครบ	เพิ่มข้อมูลรับรอง Saflok
Saflok/Ambiance เข้ารหัสไม่สำเร็จหรือหมดเวลา	Windows Agent, Ambiance encoder service หรือ device ออฟไลน์	รีสตาร์ท Saflok/Ambiance encoder
"Please create a new keycard first, then use Duplicate for any extra cards."	Saflok หา active registration สำหรับ reservation นี้ไม่พบ	แก้ปัญหาคีย์การ์ดใบแรกหาย
การ์ดหลายห้องของ Saflok/Ambiance ต้องมี room-level ID	ห้องที่เลือกยังไม่มี sub-reservation ของตัวเอง	ตรวจห้องที่เลือก
การเปลี่ยนประเภท encoder ไม่ค้าง	การบันทึกก่อนหน้าทำให้สถานะ encoder ปนกัน	บันทึกชนิด encoder ใหม่
"Test Connection" ล้มเหลว (Be-Tech)	Base URL หรือบริการมีปัญหา	แก้การเชื่อมต่อ Be-Tech
"Test Connection" ล้มเหลว (GreatLocks)	รายละเอียดเซิร์ฟเวอร์ GreatLocks ที่บันทึกไว้หายหรือล้าสมัย	แก้การเชื่อมต่อ GreatLocks
"Service URL is required" (LockSDK)	โหมด direct ต้องมี Service URL ต่อ encoder	เพิ่ม LockSDK service URL
LockSDK agent แสดง Not registered	ยังไม่มี device agent สำหรับแต่ละ encoder	ลงทะเบียน LockSDK agent
Heartbeat Monitor ปิดหลังบันทึก	บันทึกไม่ติดใน session โรงแรมปัจจุบัน	บันทึก Heartbeat Monitor ใหม่
Heartbeat แสดง unreachable	agent ออฟไลน์หรือ tunnel มีปัญหา	ตรวจความล้มเหลวของ Heartbeat
Encoder ยังไม่พร้อมใช้งาน	รายการแบบไดนามิกยังมองว่า agent ถูกตัดการเชื่อมต่อ	ตรวจสถานะ encoder แบบสดไม่ตรงกัน
Windows Agent แสดง Not connected	agent ไม่รันหรือ install ไม่สมบูรณ์	เชื่อมต่อ agent ใหม่

เครื่องไม่ตอบสนอง

สิ่งที่เห็น: encoder แสดงออฟไลน์หรือไม่ตอบสนองใน AVA

วิธีแก้:

1. ตรวจไฟและสายของ encoder
2. ตรวจสอบการเชื่อมต่อเครือข่ายระหว่างคีออสก์กับ encoder สำหรับ Direct Connection เท่านั้น
3. ยืนยันว่า IP และ port ของ server ถูกต้อง
4. รีสตาร์ทซอฟต์แวร์ของ encoder

การ์ดไม่เข้ารหัส

สิ่งที่เห็น: การเขียนคีย์การ์ดล้มเหลว หรือได้การ์ดเปล่า

วิธีแก้:

1. ยืนยันว่าชนิดการ์ดตรงกับ encoder
2. ใส่การ์ดใหม่แล้วลองอีกครั้ง
3. ทดสอบด้วยการ์ดเปล่าใบใหม่
4. หาก Enable guest selection ปิดอยู่ ให้ยืนยันว่าคีออสก์ถูกส่งไปยัง encoder ที่ถูกต้อง
5. หาก Enable guest selection เปิดอยู่ ให้ยืนยันว่าผู้เข้าพักเลือก encoder ที่ออนไลน์อยู่ที่คีออสก์

Saflok/Ambiance เข้ารหัสไม่สำเร็จหรือหมดเวลา

สิ่งที่เห็น: การเข้ารหัสคีย์การ์ดล้มเหลว หมดเวลา หรือคีออสก์แจ้งว่าไม่ได้รับการตอบกลับจาก Saflok/Ambiance encoder

วิธีแก้: ทำตามการตรวจ 3 ข้อนี้ตามลำดับ แต่ละข้อจะตัดสาเหตุที่พบบ่อยออกไปก่อนขยับไปข้อถัดไป

การกู้คืน Saflok แบบอัตโนมัติ

หาก Saflok PMSI เริ่มช้าหรือรีสตาร์ทในภายหลัง AVA จะตรวจสอบความพร้อมทุก 10 วินาที รอสักครู่ แล้วรีเฟรชก่อนติดตั้ง agent ใหม่

1. ตรวจว่า Windows Agent เชื่อมต่ออยู่ใน AVA

1. ไปที่ Settings → Room Access → Keycard Encoding

2. หา card Windows Agent ของ encoder นี้

3. ยืนยันว่าสถานะแสดง Connected และเวลา Last Seen เป็นเวลาล่าสุด

   

4. หาก agent เป็น Not connected ให้ทำตาม Windows Agent not connected ก่อนดำเนินการต่อ หาก Saflok PMSI ยังเริ่มทำงานอยู่ ให้รอ 10 วินาทีแล้วรีเฟรชก่อนติดตั้งใหม่

2. ตรวจว่า encoder ออนไลน์ใน Ambiance

หาก agent เชื่อมต่ออยู่แต่การเข้ารหัสยังล้มเหลว ให้เข้าสู่ระบบ Ambiance server และตรวจอุปกรณ์ encoder

1. เปิด Ambiance แล้วไปที่ Device Management → Encoders

2. หา encoder ของคีออสก์นี้ เช่น encoder Vouch

3. ยืนยันว่า Status แสดง Online

   

4. หาก encoder แสดง Offline ให้ไปขั้นตอนที่ 3 เพื่อรีสตาร์ทบริการ encoder

3. รีสตาร์ท Ambiance Encoder Service

หาก encoder ออฟไลน์ใน Ambiance ให้รีสตาร์ทบริการ encoder บนเครื่องที่ติดตั้ง Ambiance server

1. ที่เครื่องที่รัน Ambiance server ให้กดปุ่ม Windows หรือคลิกเมนู Start

2. พิมพ์ services manager แล้วเปิด Ambiance Services Manager จากผลลัพธ์

3. ในรายการบริการ ให้เลือก Ambiance Encoder Service

   

4. คลิกปุ่ม Stop (สี่เหลี่ยมสีแดง)

5. รอสักครู่จนสถานะบริการเปลี่ยนเป็น Stopped

6. คลิกปุ่ม Start (ปุ่มเล่นสีแดง)

7. ยืนยันว่า State กลับเป็น Running

8. กลับไปที่ Ambiance Device Management → Encoders และยืนยันว่า encoder เป็น Online

9. ลองเข้ารหัสการ์ดทดสอบจากคีออสก์

ทำไมการรีสตาร์ทจึงช่วยได้

บริการ encoder อาจหลุดการเชื่อมต่อกับ encoder จริงหลังจากเครือข่ายกระตุกหรือปล่อยทิ้งไว้นาน การหยุดแล้วเริ่มใหม่จะบังคับให้เชื่อมต่ออีกครั้ง

Saflok duplicate keycard ต้องมีคีย์การ์ดใบแรกก่อน

สิ่งที่เห็น: AVA แสดงข้อความ "Please create a new keycard first, then use Duplicate for any extra cards."

สาเหตุ: Saflok หา active registration หรือ keycard record สำหรับ reservation นี้ไม่พบ การ์ดแบบ duplicate ต้องมีคีย์การ์ดใบแรกที่สร้างสำเร็จก่อน AVA จะเพิ่มใบอื่นได้

วิธีแก้:

1. สร้างคีย์การ์ดใบแรกสำหรับ reservation
2. รอให้การเข้ารหัสใบแรกเสร็จสมบูรณ์
3. เลือก Duplicate เฉพาะหลังจากมีคีย์การ์ดใบแรกแล้ว
4. หากเกิดข้อผิดพลาดอีกครั้ง ให้ยืนยันว่า reservation ยังมี active registration ใน Ambiance
5. ลองส่งคำขอ duplicate อีกครั้ง

สิ่งที่ไม่ควรเห็น

คุณไม่ควรเห็นรายละเอียดดิบอย่าง ReservationNotFound หรือ SOAP fault ในข้อความ

Saflok/Ambiance การ์ดหลายห้องต้องมี room-level reservation ID

สิ่งที่เห็น: คุณพยายามเข้ารหัสบัตรสำหรับห้องหนึ่งใน booking หลายห้อง แล้ว AVA หยุดขั้นตอนนั้น

สาเหตุ: การ์ด duplicate ของ Saflok/Ambiance ใช้ sub-reservation ID ของห้องที่เลือก หากห้องนั้นยังไม่มี ID ของตัวเอง คุณจะเห็นข้อผิดพลาดแบบ fail-fast

วิธีแก้:

1. เปิด reservation แล้วเลือกแถวของห้องที่ต้องการอย่างตรงตัว
2. รอ PMS ซิงก์ หากห้องเพิ่งถูกแยกหรือย้าย
3. ยืนยันว่าห้องนั้นมีอยู่เป็น sub-reservation ของตัวเองใน PMS
4. ลอง Encode Keycard อีกครั้ง

ไม่ได้ใส่ข้อมูลรับรอง Saflok

สิ่งที่เห็น: "UserCredentialsNotProvided.NotApplicable" ปรากฏระหว่างการเข้ารหัสคีย์การ์ด

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. ตั้ง Encoder Type เป็น Saflok
3. กรอก Username และ Password ใน Encoder Credentials
4. หากเปิด direct communication ให้กรอก PMSI Server URL
5. คลิก Save
6. คลิก Test Connection แล้วเข้ารหัสการ์ดทดสอบ 1 ใบ

การเปลี่ยนประเภท encoder ไม่ค้าง

สิ่งที่เห็น: คุณเลือกประเภท encoder หนึ่ง แต่ยังมีอีกประเภทที่กำลังใช้งานอยู่

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. ใน Keycard Encoder Settings เลือกประเภท encoder ที่ต้องการ
3. คลิก Save เพียงครั้งเดียวแล้วรอข้อความสำเร็จ
4. รีเฟรชหน้าและยืนยันว่ากำลังใช้งานอยู่แค่ประเภท encoder นั้น
5. หากปัญหาเกิดซ้ำ ให้สลับประเภท บันทึก แล้วสลับกลับและบันทึกอีกครั้ง

ทดสอบการเชื่อมต่อ Be-Tech ล้มเหลว

สิ่งที่เห็น: "Test Connection" ล้มเหลว หรือปุ่มยังปิดใช้งานอยู่

วิธีแก้:

1. ยืนยันว่า Base URL เริ่มด้วย http:// หรือ https://
2. ตรวจสอบว่าบริการ Be-Tech กำลังทำงานอยู่บนเครื่อง workstation ของ encoder
3. ตรวจว่า workstation กับคีออสก์อยู่ในเครือข่ายเดียวกัน
4. กรอก Hotel Name, Chain No, Workstation และ Reader No ใหม่
5. คลิก Test Connection อีกครั้ง

การเชื่อมต่อ GreatLocks ล้มเหลว

สิ่งที่เห็น: Test Connection ล้มเหลวหลังจากคุณแก้รายละเอียดเซิร์ฟเวอร์ GreatLocks

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. ยืนยันว่าเซิร์ฟเวอร์ GreatLocks มี XHLSI Server IP Address และ TCP Port
3. คลิก Save อีกครั้ง
4. หากคุณอัปเดตการตั้งค่าเก่า ให้คงระเบียนเซิร์ฟเวอร์เดิมไว้
5. คลิก Test Connection อีกครั้ง

ต้องใช้ LockSDK service URL

สิ่งที่เห็น: การบันทึกถูกบล็อก หรือฟอร์ม encoder แสดง "Service URL is required."

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. เลือก LockSDK
3. เปิด Physical Encoder Devices แล้วแก้ไข encoder
4. กรอก Service URL ที่ถูกต้อง เช่น http://127.0.0.1:8092
5. คลิก Save แล้วรัน Test Connection

LockSDK agent ยังไม่ลงทะเบียน

สิ่งที่เห็น: การ์ด encoder ของ LockSDK แสดง Not registered ใน Windows Agent

วิธีแก้:

1. ยืนยันว่ามี LockSDK encoder อยู่ใน Physical Encoder Devices
2. ไปที่ Windows Agent แล้วหาการ์ดของ encoder
3. คลิก Download Windows Agent หากการ์ดยังใหม่ หรือ Reinstall หากมีอยู่แล้ว
4. แตกไฟล์แพ็กเกจแล้วรันไฟล์ .bat บนเครื่อง Windows ที่เชื่อมต่ออยู่
5. รีเฟรชสถานะและยืนยันว่าการ์ดเปลี่ยนจาก Not registered เป็น Connected หรือ Not connected
6. ใช้ Advanced options เฉพาะสำหรับ View Logs, Rotate Secret หรือ Delete
7. สถานะเวอร์ชันเดียวกันนี้ใช้กับการ์ด agent ของ LockSDK ด้วย

Heartbeat Monitor ปิดหลังบันทึก

สิ่งที่เห็น: คุณเปิด Heartbeat Monitor, คลิก Save, แล้วมันปิดกลับเอง

วิธีแก้:

1. ไปที่ Settings → Room Access → Keycard Encoding
2. เปิด Encoding Options → Advanced options
3. เปิด Heartbeat Monitor
4. คลิก Save เพียงครั้งเดียวแล้วรอข้อความสำเร็จ
5. รีเฟรชหน้าและยืนยันว่า Heartbeat Monitor ยังเปิดอยู่
6. หากยังปิดอยู่ ให้ทำตาม Settings Not Saving After Switching Hotels

ความล้มเหลวของ Heartbeat

สิ่งที่เห็น: Heartbeat Monitor แสดง unreachable

วิธีแก้:

1. ยืนยันว่า agent กำลังทำงานอยู่บนคีออสก์หรือพีซี
2. ตรวจ Registered Agents ว่ามีสถานะออนไลน์และ tunnel เข้าถึงได้
3. ตรวจ log ของ agent เพื่อหาข้อผิดพลาด
4. ติดตั้ง agent ใหม่หากจำเป็น

สถานะ encoder แบบสดไม่ตรงกัน

สิ่งที่เห็น: encoder ดูเหมือนตั้งค่าแล้ว แต่ AVA ยังระบุว่าไม่พร้อมใช้งานในหน้าต่าง reservation

สาเหตุ: AVA จะแสดง online ก็ต่อเมื่อ agent เชื่อมต่ออยู่และ tunnel เข้าถึงได้ สถานะเดียวกันนี้ใช้ควบคุมการเลือก encoder แบบไดนามิกด้วย

วิธีแก้:

1. ตรวจ Registered Agents สำหรับการ์ดของ encoder
2. ยืนยันว่าอุปกรณ์เชื่อมต่ออยู่และ tunnel เข้าถึงได้
3. แก้ปัญหา agent หรือเครือข่ายก่อน
4. รีเฟรช Settings → Room Access
5. ลองเข้ารหัสอีกครั้ง
6. ตรวจบรรทัด Status: บนหน้าการตั้งค่าอีกครั้ง

Windows Agent ไม่เชื่อมต่อ

สิ่งที่เห็น: สถานะแสดง Not connected หรือ "Never online."

วิธีแก้:

1. เปิด zip ที่ดาวน์โหลดแล้วรัน download-installer.bat
2. ให้ไฟล์ดาวน์โหลดตัวติดตั้ง .exe แล้วรันไฟล์นั้น
3. ยืนยันว่าเครื่อง Windows เชื่อมต่ออินเทอร์เน็ตได้
4. คลิก Reinstall บนการ์ด agent ใน Windows Agent หากจำเป็น
5. รีเฟรชสถานะ Registered Agents
6. กลับไปที่ Settings → Room Access และยืนยันว่า Status: เปลี่ยนเป็น online

รายการ encoder แบบไดนามิก

เมื่อ agent เชื่อมต่ออยู่และ tunnel เข้าถึงได้ รายการ encoder แบบไดนามิกควรแสดง Online หากการ์ด encoder ย่อยยังดูออฟไลน์อยู่ ให้รีเฟรชหน้าและตรวจ agent ก่อน

ไม่เห็นกฎการกำหนดเส้นทางของคีออสก์

สิ่งที่เห็น: คุณไม่พบกฎการกำหนดเส้นทางใต้ Kiosk to Encoder Routing

วิธีแก้:

1. ตรวจว่า Enable guest selection เปิดอยู่หรือไม่
2. ปิดตัวเลือกนี้เพื่อแสดงกฎการกำหนดเส้นทางแบบทำมือ
3. เพิ่มอุปกรณ์อย่างน้อยหนึ่งรายการใน Physical Encoder Devices

ยังติดอยู่?

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

• ❌ encoder ยังออฟไลน์แม้ตรวจไฟและเครือข่ายแล้ว
• ❌ การเข้ารหัสการ์ดล้มเหลวบนหลายคีออสก์
• ❌ Heartbeat ยังไม่ปกตินานเกิน 30 นาที

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

• ประเภทและรุ่นของ encoder
• ภาพหน้าจอ Registered Agents และ Heartbeat Monitor
• เวลาที่เริ่มเกิดปัญหา

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

• ภาพรวมเครื่องเข้ารหัสคีย์การ์ด
• ตั้งค่าเครื่องเข้ารหัสคีย์การ์ด
• คำแนะนำคีย์การ์ดสำหรับผู้เข้าพัก