Dalam bisnis retail pada umumnya, saat memproses transaksi penjualan dan pelanggan membayar secara tunai, kasir biasanya menerima uang tersebut dan memasukkannya ke dalam cash drawer. Proses ini dapat menyebabkan kesalahan kasir, karena jumlah uang tunai yang diterima mungkin tidak sesuai dengan jumlah yang seharusnya dibayarkan oleh pelanggan.
Untuk mengatasi masalah tersebut, Innovative Technology menyediakan self-checkout cash machine yang dapat membantu menyederhanakan proses transaksi penjualan. Dengan menggunakan cash machine, sistem dapat secara otomatis menentukan jumlah yang harus dibayarkan pelanggan dan menghitung total uang tunai yang diterima secara akurat.
DealPOS dapat terhubung dengan cash machine Innovative Technology, sehingga transaksi penjualan dapat diproses dengan lebih cepat dan akurat. Untuk menghubungkan DealPOS dengan cash machine Glory, ikuti panduan berikut.
I. Instalasi ASP.NET Core
Langkah 1. Install ASP.NET Core pada perangkat komputer Anda
Install ASP.NET Core berdasarkan versi Windows Anda.
Untuk Windows x64:
Download ASP.NET Core 10.0 Runtime (v10.0.11) - Windows x64 Installer
Untuk Windows Arm64:
Langkah 2. Buka CMD (command prompt) dan lakukan eksekusi perintah
Setelah Anda sukses menginstall ASP.NET Core, Anda harus mengeksekusi perintah berikut ini pada CMD:
dotnet dev-certs https --trust
II. Instalasi Aplikasi Middleware
Langkah 1. Unduh Aplikasi Middleware
Unduh aplikasi middleware pada file tertaut berikut ini: File Tautan
Langkah 2. Cash Machine Requirements
Sebelum menjalankan middleware:
Pastikan mesin cash dalam kondisi menyala.
Pastikan mesin terhubung ke komputer melalui USB atau interface lain yang didukung.
Pastikan tidak ada error hardware pada mesin.
Langkah 3. Jalankan Aplikasi Middleware
Jalankan file BAT dari folder hasil extract.
Middleware terbuka.
Jangan tutup window ini selama sistem sedang berjalan.
Langkah 4. Validasi status Runtime
Periksa window CMD dan pastikan:
Tidak ada error yang ditampilkan
Tidak ada peringatan file yang hilang
Tidak ada kegagalan inisialisasi
III. Gambaran Umum Dashboard Middleware
Langkah 1. Buka tampilan dashboard
Buka browser dan akses URL berikut:
https://localhost:7065/
Setelah dimuat, aplikasi secara otomatis akan mengarahkan ke halaman Home.
Langkah 2. Struktur Dashboard
Dashboard memiliki dua menu utama:
Home
All Money in Machine
Withdraw Money
Setup
Pengaturan komunikasi & konfigurasi mesin
IV. Konfigurasi Middleware
Langkah 1. COM Port Configuration
Buka tab Setup.
Periksa field "ComPORT" (default: COM3).
Validasi ini dengan sistem Anda:
Buka Device Manager
Expand Ports (COM & LPT)
Identifikasi COM port yang ditetapkan untuk mesin cash
Jika mesin menggunakan port lain (misalnya, COM4), perbarui nilai tersebut pada dashboard sesuai kebutuhan.
Langkah 2. Edit appsettings.json (CORS Configuration)
Buka dari folder middleware:
appsettings.json
Temukan array allowCORS dan tambahkan domain DealPOS Anda, misalnya:
Masukkan entri ini sebagai item terakhir dalam daftar, dipisahkan dengan koma.
Langkah 3. Konfigurasi Routes dan Inhibits
Di dalam tab Setup, tersedia dua tabel:
Routes:
Menentukan denominasi mata uang yang diterima oleh mesin.
Inhibits:
Menentukan denominasi yang dapat dikeluarkan oleh mesin.
Sistem menyediakan denominasi IDR secara default.
Jika Anda memerlukan mata uang kustom, Anda dapat mengedit tabel ini dengan mengedit setiap baris atau dengan mengklik tombol "Tambah Nominal" untuk membuat yang baru atau menggunakan konfigurasi massal melalui:
/middleware/json/banknotes.json
V. Kustomisasi banknotes.json
Buka file:
banknotes.json
File ini berisi dua array konfigurasi dan metadata mata uang.
Langkah 1. InhibitsConfig
Digunakan untuk denominasi withdrawal.
Properti yang dapat diedit:
Nominal
Currency
Penting:
Nilai nominal harus menyertakan dua nol tambahan di akhir.
Contoh:
1,000 IDR → input sebagai 100000
Set:
"Inhibit": false
Langkah 2. RouteConfig
Digunakan untuk denominasi yang diterima.
Properti:
Nominal
Currency
Route → harus selalu bernilai "1"
Langkah 3. Mata uang Utama dan Kedua (Primary dan Secondary)
Di bawah array:
PrimaryCurrency: Mata uang utama operasional POS
SecondaryCurrency: Mata uang sekunder yang didukung mesin
ExchangeRate: Nilai konversi dari primary → secondary
Calculate:
false jika nilai mata uang primary > nilai mata uang secondary
Mengontrol logika perhitungan konversi
Contoh:
1 USD = 10,000 IDR
Dengan demikian:
"ExchangeRate": 10000"PrimaryCurrency": "USD""SecondaryCurrency": "IDR"
Langkah 4. Terapkan Konfigurasi
Setelah mengedit, simpan file.
Restart Required:
Setiap perubahan konfigurasi memerlukan:
Menutup semua 3 window CMD runtime
Menjalankan ulang file BAT
Reload dashboard
VI. Aktifkan Middleware App
Langkah 1. Nyalakan Koneksi
Masuk ke Setup → klik Open Connection.
Notifikasi sukses berwarna hijau akan mengonfirmasi koneksi.
Langkah 2. Klik Start Devices
Klik Start Devices (tombol hijau).
Tunggu hingga pesan sukses berwarna hijau muncul.
Konfigurasi middleware sekarang telah selesai.
VII. Pengaturan POS untuk Metode Pembayaran
Langkah 1. Buka menu Setup
Buka menu Setup → tab Payment.
Langkah 2. Tambahkan Metode Pembayaran Baru
Klik Add.
Isi properti metode pembayaran dan klik tombol save:
Payment Method Name
Type: Cash
Subtype: Machine
Catatan: Metode pembayaran kedua dengan type dan subtype yang sama tidak diperbolehkan.
VIII. Pengaturan POS untuk Mata Uang
Langkah 1. Buka menu Currency
Masuk ke Setup → Currency.
Langkah 2. Buat atau atur USD sebagai mata uang utama
Jika USD belum tersedia:
Klik Add
Masukkan dan setelah itu save:
Currency Name: USD
Symbol: $
Exchange Rate: 1
Centang Primary Currency
Mata uang USD sudah berhasil dibuat:
IX. Pengaturan POS untuk Menghubungkan POS dengan Middleware
Langkah 1. Masuk ke menu sell, klik more action, cash machine, dan klik connect
Langkah 2. Toaster berwarna hijau mengonfirmasi keberhasilan
Catatan: Jika terjadi error, tinjau kembali langkah konfigurasi sebelumnya atau hubungi customer support.
X. Prosedur Simulasi
Langkah 1. Simulasi mesin melalui Middleware
All Money in Machine
Menampilkan:
Country Code (tipe mata uang)
Value (denominasi dalam sistem)
Stored (jumlah per denominasi)
Withdraw Money
Memungkinkan simulasi penarikan dengan memasukkan:
Amount (jumlah yang akan ditarik)
CountryCode (tipe mata uang)
Contoh:
IDR 50,000 × 2 + IDR 20,000 × 1 = 120,000 IDR
Untuk melakukan penarikan:
Currency: IDR
Amount: 120000
Klik Get Money
XI. Simulasi Transaksi POS (Mata Uang Utama - IDR)
Langkah 1. Buat transaksi Sell
Langkah 2. Pilih metode pembayaran cash machine
Langkah 3. Masukkan uang tunai ke dalam Cash Machine
Langkah 4. Pembayaran Diterima dan Selesai
Catatan: Jika denominasi kembalian yang dibutuhkan tersedia di Cash Machine, maka kembalian akan diberikan secara otomatis. Namun, jika denominasi tidak tersedia, akan muncul notifikasi seperti yang ditunjukkan pada screenshot di atas.
XII. Simulasi Transaksi POS (Mata Uang Sekunder - USD)
Langkah 1. Buat Contoh Transaksi
Buat transaksi sebesar USD 20
(≈ IDR 200,000 pada 1 USD = 10,000 IDR).
Langkah 2. Proses Pembayaran
Klik Pay → pilih Cash Machine.
Langkah 3. Masukkan Uang Tunai
Masukkan IDR 100,000.
Sistem mencatat 10 USD diterima.
Masukkan IDR 100,000 lagi untuk menyelesaikan pembayaran.
Langkah 4. Penanganan Kembalian Otomatis
Jika denominasi kembalian tersedia → mesin akan otomatis mengeluarkan kembalian.
Jika tidak tersedia → POS akan menampilkan peringatan untuk memberikan kembalian secara manual.
Catatan: Kembalian otomatis sepenuhnya didukung hanya ketika menggunakan satu mata uang yang terpadu.
XIII. Penyelesaian
Integrasi Cash Machine Middleware dan POS Anda kini telah sepenuhnya terpasang, dikonfigurasi, dan siap digunakan untuk produksi. Semua simulasi memastikan bahwa konversi mata uang, routing denominasi, dan perilaku mesin berfungsi sesuai dengan yang dirancang.
Artikel Terkait
DealPOS adalah online point-of-sale yang dirancang khusus untuk bisnis retail yang berkategori Fashion, Minimarkets, Electronics Fresh Food dan Building Material.
Dengan DealPOS, kamu dapat manage both online and offline store inventory toko online dan offline secara realtime dalam satu platform. Kamu juga bisa berjualan secara omnichannel (offline dan online), karena DealPOS terintegrasi dengan Marketplace (Shopee, Tokopedia, Tiktok Shop, Lazada) dan Webstore Instant (Shopify dan WooCommerce).
Untuk kebutuhan pencatatan keuangan yang lebih detail, tersedia Books App sebagai aplikasi pembukuan terpisah. Selain itu, proses perhitungan stok juga menjadi lebih mudah dengan DealPOS Scanner App yang mendukung fitur scanning barcode dan RFID.
File Tautan