Artikel ini menjelaskan prosedur lengkap untuk menginstal aplikasi Middleware, menyiapkan mesin penerima uang tunai (cash machine), mengonfigurasi pengaturan komunikasi, mengintegrasikan middleware dengan sistem POS, serta melakukan simulasi alur operasional.
Setiap bagian harus diselesaikan secara berurutan untuk memastikan pengaturan dan fungsi sistem berjalan dengan baik.
I. Menyiapkan Perangkat dan Tools yang Dibutuhkan
Langkah 1. Install .NET 8 Runtime
Middleware memerlukan .NET 8 untuk beroperasi.
Tautan Download:
https://dotnet.microsoft.com/en-us/download/dotnet/8.0
Install .NET 8 dengan mengikuti instruksi di layar.
Langkah 2. Install .NET 9 Runtime
Middleware memerlukan .NET 9 untuk beroperasi.
Tautan Download:
https://dotnet.microsoft.com/en-us/download/dotnet/9.0
Install .NET 9 dengan mengikuti instruksi di layar.
Langkah 3. Trust Development HTTPS Certificate
Buka Command Prompt (CMD) dan jalankan:
dotnet dev-certs https --trust
Pastikan proses selesai dengan sukses, kemudian tutup CMD.
Langkah 4. Download the Middleware Package
Unduh installer middleware dari link yang disediakan:
Extract paket yang telah diunduh.
II. Siapkan Mesin dan Jalankan Middleware
Langkah 1. 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 2. Launch Middleware Application
Jalankan file BAT dari folder hasil extract.
Middleware terbuka.
Jangan tutup window ini selama sistem sedang berjalan.
Langkah 3. Validate Runtime Status
Periksa window CMD dan pastikan:
Tidak ada error yang ditampilkan
Tidak ada peringatan file yang hilang
Tidak ada kegagalan inisialisasi
Langkah 4. POS Account Requirement
Pastikan Anda memiliki akun DealPOS yang aktif dan berlangganan sebelum melanjutkan.
III. Gambaran Umum Dashboard Middleware
Langkah 1. Accessing the Dashboard
Buka browser dan akses URL berikut:
https://localhost:7065/
Setelah dimuat, aplikasi secara otomatis akan mengarahkan ke halaman Home.
Langkah 2. Dashboard Structure
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. Routes & Inhibits Configuration
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. Primary & Secondary Currency
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. Apply Configuration
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. Establish Connection
Masuk ke Setup → klik Open Connection.
Notifikasi sukses berwarna hijau akan mengonfirmasi koneksi.
Langkah 2. Start Devices
Klik Start Devices (tombol hijau).
Tunggu hingga pesan sukses berwarna hijau muncul.
Konfigurasi middleware sekarang telah selesai.
VII. Pengaturan POS — Metode Pembayaran
Langkah 1. Open Setup Menu
Buka menu Setup → tab Payment.
Langkah 2. Tambahkan Metode Pembayaran Baru
Klik Add.
Isi:
Payment Method Name
Type: Cash
Subtype: Machine
Catatan:
Metode pembayaran kedua dengan type dan subtype yang sama tidak diperbolehkan.
Klik Save.
VIII. POS Setup — Currency
Langkah 1. Open Currency Menu
Masuk ke Setup → Currency.
Langkah 2. Buat atau Atur USD sebagai Mata Uang Utama
Jika USD belum tersedia:
Klik Add
Masukkan:
Currency Name: USD
Symbol: $
Exchange Rate: 1
Centang Primary Currency
Click Save.
IX. POS Setup — Menghubungkan POS dengan Middleware
Langkah 1. Establish Connection
Masuk ke Sell → More Action → Cash Machine.
Klik Connect.
Toaster berwarna hijau mengonfirmasi keberhasilan.
Jika terjadi error, tinjau kembali langkah konfigurasi sebelumnya atau hubungi customer support.
X. Simulation Procedures
Langkah 1. Machine Simulation via 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 penting: 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.