Siapkan Encoding Keycard ACSHotel

Pengaturan Cepat

Sebagian besar hotel dapat menyelesaikan ini dalam sekitar 15 menit. Anda memerlukan hotel ID ACSHotel dan detail encoder.

Panduan ini membantu Anda menyiapkan encoding keycard ACSHotel di AVA. Panduan ini mencakup record encoder, routing kiosk, Windows Agent, dan kartu uji. ACSHotel sekarang memakai routing Windows Agent bersama seperti Be-Tech. Anda tidak membuat satu kartu agent untuk tiap encoder.

Nomor lock ACSHotel

Gunakan nomor lock yang persis dari room mapping atau ACSHotel SDK. AVA menerima nomor lock alfanumerik 6 hingga 8 karakter dan mengirimkannya tanpa perubahan. Jangan menambahkan padding atau menghapus nol di depan.

Hanya Windows Agent

ACSHotel menggunakan paket Windows Agent dalam mode dinamis. Gunakan direct communication hanya jika installer ACSHotel Anda memerlukan local service URL.

Referensi Cepat

Pengaturan	Yang dikontrol	Di mana Anda mengaturnya
Hotel ID	Menghubungkan AVA ke properti ACSHotel Anda	ACSHotel Configuration
USB / proUSB	Memilih mode reader	ACSHotel Configuration
Default kartu	Mengatur nomor kartu, DAI, buzzer, dan perilaku unlock	ACSHotel Configuration
Record encoder	Mendaftarkan encoder ACSHotel yang berbagi satu Windows Agent	Physical Encoder Devices
Service URL	Hanya digunakan dalam mode direct communication	Encoder details
Enable guest selection	Memungkinkan tamu memilih encoder di kiosk	Kiosk to Encoder Routing
Kiosk routing	Memetakan kiosk ke encoder tertentu	Kiosk to Encoder Routing
Windows Agent	Mengunduh dan mendaftarkan paket agent lokal	Windows Agent
Test Connection	Memeriksa encoder pertama yang dikonfigurasi	ACSHotel Configuration

Di Mana Menemukannya

Settings → Room Access → Keycard Encoding

Langkah 1: Pilih ACSHotel

1. Buka Settings → Room Access.

2. Pilih Keycard Encoding.

3. Pilih ACSHotel sebagai jenis encoder.

4. Klik Save.

   ✓ AVA menampilkan ACSHotel sebagai jenis encoder yang dipilih.

Langkah 2: Atur detail ACSHotel Anda

1. Buka ACSHotel Configuration.

2. Masukkan Hotel ID Anda.

3. Set USB atau proUSB agar cocok dengan reader Anda.

4. Masukkan default kartu yang diberikan tim ACSHotel Anda.

5. Pertahankan pengaturan unlock dan buzzer agar sesuai dengan perangkat keras Anda.

6. Klik Save.

   ✓ AVA memeriksa hotel ID sebelum menyimpan.

Mode USB

Jika ACSHotel meminta mode USB, gunakan 0 untuk USB dan 1 untuk proUSB.

Langkah 3: Tambahkan setiap device encoder

1. Buka Physical Encoder Devices.

2. Tambahkan satu record encoder untuk setiap device ACSHotel.

3. Beri setiap device Name yang jelas.

4. Tambahkan Location jika staf memerlukan label yang lebih jelas.

5. Tambahkan Service URL jika Anda menggunakan direct communication.

6. Klik Save.

   ✓ Setiap device ACSHotel dapat menyertakan beberapa encoder ID ketika satu Windows Agent melayani lebih dari satu encoder.

LockSDK tetap satu banding satu

LockSDK masih memerlukan tepat satu encoder ID per device. Pertahankan setiap encoder LockSDK pada registrasi Windows Agent miliknya sendiri.

Routing ACSHotel bersama

Satu Windows Agent dapat menangani beberapa encoder ACSHotel.

Direct communication

Gunakan Service URL lokal hanya ketika ACSHotel memerlukan direct communication. URL harus dapat dijangkau dari komputer yang terhubung ke encoder.

Langkah 4: Pilih perilaku routing

1. Buka Kiosk to Encoder Routing.

2. Aktifkan Enable guest selection jika tamu harus memilih encoder di kiosk.

3. Biarkan mati jika Anda ingin staf menetapkan kiosk secara manual.

4. Tambahkan kiosk ID dari Kiosk Management saat routing dilakukan secara manual.

5. Klik Save.

   ✓ Saat guest selection aktif, AVA menyembunyikan tabel routing. ✓ Saat guest selection mati, tabel routing mengontrol perilaku kiosk.

Langkah 5: Siapkan Windows Agent

1. Buka Windows Agent.

2. Klik Download Windows Agent untuk membuat registrasi agent.

3. Instal paket pada PC Windows yang terhubung ke encoder.

4. Jika agent sudah ada, gunakan Reinstall.

5. Buka Advanced options untuk log, rotasi secret, atau delete.

   ✓ Saat agent terdaftar, AVA menampilkan satu kartu Windows Agent untuk setup ACSHotel yang aktif. ✓ Direct communication melewati bagian Windows Agent.

Langkah 6: Uji koneksi dan kartu

1. Kembali ke ACSHotel Configuration.

2. Klik Test Connection.

3. Buka reservasi uji dan encode satu kartu.

4. Coba kartu tersebut pada pintu.

   ✓ AVA menguji encoder pertama yang dikonfigurasi. ✓ Pintu seharusnya terbuka untuk kamar yang benar.

Pemecahan Masalah

Hotel ID ditolak

Yang Anda lihat: AVA tidak menyimpan hotel ID, atau tes langsung gagal.

Perbaikan:

1. Pastikan hotel ID cocok dengan properti ACSHotel Anda.
2. Hapus spasi tambahan.
3. Simpan pengaturan lagi.
4. Jalankan Test Connection sekali lagi.

Encoder tidak muncul

Yang Anda lihat: Encoder hilang dari Physical Encoder Devices, atau routing tetap kosong.

Perbaikan:

1. Tambahkan setidaknya satu record encoder terlebih dahulu.
2. Tambahkan Service URL jika Anda menggunakan direct communication.
3. Simpan encoder lagi.
4. Refresh Settings → Room Access.

Windows Agent tetap offline

Yang Anda lihat: Agent menampilkan not connected, atau tombol unduh terus kembali.

Perbaikan:

1. Pastikan PC Windows dapat menjangkau layanan ACSHotel.
2. Instal ulang paket Windows Agent.
3. Periksa apakah agent berjalan di komputer encoder.
4. Refresh Settings → Room Access.

Test card gagal

Yang Anda lihat: Kartu berhasil ditulis, tetapi pintu tidak terbuka.

Perbaikan:

1. Pastikan USB atau proUSB cocok dengan reader.
2. Periksa default kartu dari ACSHotel.
3. Pastikan room mapping cocok dengan nomor lock ACSHotel.
4. Coba blank card lain.

Tidak ada kartu valid terdeteksi

Yang Anda lihat: AVA mengembalikan -3 dengan "No valid card detected on reader."

Mengapa ini terjadi: Reader tidak mendeteksi marker kartu ACSHotel yang valid sebelum encoding dimulai.

Perbaikan:

1. Letakkan kartu sepenuhnya di atas reader sebelum Anda mulai encoding.
2. Biarkan kartu tetap diam sampai AVA menyelesaikan penulisan.
3. Coba kartu lain jika pesan yang sama muncul lagi.
4. Pastikan reader berada pada mode USB atau proUSB yang benar.

Nomor lock ditolak

Yang Anda lihat: AVA atau Windows Agent menolak nomor lock dari room mapping.

Perbaikan:

1. Pastikan nomor lock panjangnya 6 sampai 8 karakter.
2. Gunakan hanya huruf dan angka.
3. Pakai nilai ACSHotel SDK yang persis, termasuk nol di depan.
4. Hapus padding manual sebelum Anda menyimpan mapping.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Encoder ACSHotel tidak pernah tersambung
• ❌ Test card gagal setelah Anda memverifikasi pengaturan
• ❌ AVA melaporkan DLL ACSHotel yang hilang

Informasi yang sebaiknya disertakan:

• Hotel ID ACSHotel
• Screenshot ACSHotel Configuration
• Waktu masalah mulai terjadi

Panduan Terkait

• Keycard Encoders Overview
• Keycard Room Mapping
• Keycard Encoder Troubleshooting