Setup Awal โ†’ Instalasi & Setup Awal

Instalasi & Setup Awal

Install aplikasi, aktivasi device, setup owner, toko, bisnis, dan printer.

โš™๏ธInstalasi & Setup Awal

๐Ÿ“‹ Urutan Setup Awal:

  1. Install aplikasi (APK)
  2. Aktivasi Device dengan Kode Lisensi 10 karakter
  3. Setup Owner (akun pemilik) โ€” wizard wajib, 1 langkah saja
  4. Setelah selesai โ†’ langsung masuk Home

Konfigurasi lain (Pengaturan Toko, Pengaturan Bisnis, Setup Printer, Tambah Meja, Tambah Produk) bersifat opsional dan dilakukan kapan saja dari menu Pengaturan.

1. Install Aplikasi

  1. Buka email dari KASGO yang Anda terima setelah pembelian lisensi
  2. Di email tersebut, tap tombol Download Kasgo F&B (atau salin link download-nya lalu buka di Chrome)
  3. File .apk akan terunduh ke HP
  4. Buka file APK yang sudah terdownload
  5. Izinkan "Install dari sumber tidak dikenal" jika diminta
  6. Tap Install dan tunggu selesai
  7. Buka aplikasi (nama: Kasgo F&B)

๐Ÿ“ง Isi Email dari KASGO:

  • Kode Lisensi โ€” 10 karakter untuk aktivasi (langkah berikutnya)
  • Link Download APK โ€” tombol download langsung
  • Link Panduan Penggunaan โ€” halaman ini
  • Kontak WhatsApp Support โ€” jika butuh bantuan

Tips: Tandai/bookmark email ini supaya mudah ditemukan lagi nanti (untuk kode lisensi, link update, dll).

Kebutuhan Minimum:

  • Android 8.0 (API 26) atau lebih baru
  • RAM minimal 2 GB (rekomendasi 3 GB+ untuk resto ramai)
  • Ruang storage kosong minimal 300 MB
  • Koneksi internet (untuk aktivasi awal saja)
  • Bluetooth (jika pakai printer thermal)

2. Aktivasi Device โญ

โš ๏ธ Langkah wajib pertama!

Setelah buka aplikasi pertama kali, Anda diarahkan ke halaman Aktivasi Device. Tanpa aktivasi, aplikasi tidak bisa dipakai.

Halaman Aktivasi Device:

  • Logo Kasgo + judul "Aktivasi Device"
  • Subtitle: "Masukkan kode lisensi untuk mengaktifkan aplikasi di device ini"
  • Field ๐Ÿ”‘ Kode Lisensi dengan ikon mata untuk show/hide
  • Hint: "Kode lisensi 10 karakter yang dikirim ke email Anda"
  • Tombol Aktivasi (disabled saat field kosong)
  • Section bawah "Punya HP lama dengan data Kasgo?" โ€” tombol Import Data dari HP Lama (WiFi)
  • Footer: "Belum punya lisensi?" + link Hubungi Kami via WhatsApp
Halaman Aktivasi Device kosong dengan logo Kasgo, judul Aktivasi Device, subtitle Masukkan kode lisensi untuk mengaktifkan aplikasi di device ini, field Kode Lisensi dengan ikon kunci dan eye icon, tombol Aktivasi disabled, section Punya HP lama dengan data Kasgo dan tombol Import Data dari HP Lama (WiFi), link Hubungi Kami via WhatsApp
Halaman Aktivasi Device โ€” empty state

Persiapan:

  • Kode Lisensi 10 karakter (contoh: L3KLLB3STX) yang dikirim ke email Anda setelah pembelian
  • HP terhubung ke internet (WiFi atau data seluler) untuk validasi awal ke server

Langkah Aktivasi:

  1. Tap field Kode Lisensi, masukkan kode 10 karakter (otomatis huruf besar, alphanumerik). Default ter-mask sebagai bullet (โ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ขโ€ข)
  2. Tap ikon mata ๐Ÿ‘๏ธ untuk show/hide kode (verifikasi tidak typo)
  3. Setelah field terisi, tombol Aktivasi aktif (navy)
  4. Tap Aktivasi โ†’ tunggu validasi ke server
  5. Jika sukses โ†’ otomatis diarahkan ke Setup Owner
Halaman Aktivasi Device dengan field terisi tapi ter-masked dengan dots, tombol Aktivasi aktif navy
Field terisi (masked) โ€” tombol Aktivasi aktif
Halaman Aktivasi dengan kode TESTCODE12 visible setelah eye icon di-tap
Tap mata ๐Ÿ‘๏ธ untuk show kode

Pesan error umum & cara atasi:

Halaman Aktivasi dengan error: field outline merah, error text Kode lisensi tidak valid
Error state โ€” field merah + pesan error di bawah
  • "Kode lisensi tidak valid" โ€” kode salah atau typo. Tap eye icon untuk verifikasi, copy-paste dari email kalau perlu
  • "Device Sudah Terdaftar" โ€” kode sudah dipakai di device lain. Kalau ini HP baru, deaktivasi HP lama dulu (Pengaturan โ†’ Pindah ke Device Baru) atau hubungi support
  • "Lisensi Sudah Aktif" โ€” lisensi sedang aktif di device lain. Lihat di atas
  • "Tidak dapat terhubung ke server" โ€” cek WiFi/data, coba buka kasgo.id di browser. Mungkin server maintenance โ€” tunggu 5-10 menit
  • Tombol Aktivasi disabled โ€” kode kurang dari 10 karakter

๐Ÿ“ฒ Alternative: Import Data dari HP Lama (WiFi) โญ

Kalau Anda pindah HP dan punya data di HP lama, ada shortcut tanpa perlu aktivasi terpisah:

  1. Pastikan HP lama dan HP baru terhubung ke WiFi yang SAMA
  2. HP lama: Pengaturan โ†’ Pindah ke Device Baru โ†’ muncul QR code
  3. HP baru (di halaman Aktivasi): tap Import Data dari HP Lama (WiFi)
  4. Halaman Import dari HP Lama terbuka โ†’ tap Scan QR dari HP Lama
  5. Arahkan kamera ke QR di HP lama โ†’ data + license auto-transfer via WiFi
  6. Setelah selesai, HP baru langsung aktif dengan data lengkap (tidak perlu input kode lisensi)

Lebih cepat dari backup/restore โ€” tidak perlu file .kasgo.

Halaman Import dari HP Lama dengan banner Import Data dari HP Lama Pastikan HP lama dan HP ini terhubung ke WiFi yang SAMA, lalu buka menu Pindah ke HP Baru di HP lama dan scan QR-nya di sini, tombol Scan QR dari HP Lama
Halaman Import dari HP Lama (WiFi)

๐Ÿ’ก Butuh bantuan?

Di halaman Aktivasi Device, footer ada link Hubungi Kami via WhatsApp โ€” tap untuk chat langsung dengan Customer Support.

3. Setup Owner (Akun Pemilik)

Setelah aktivasi sukses, otomatis muncul halaman Selamat Datang di Kasgo! dengan subtitle "Buat akun Owner untuk memulai". Ini satu-satunya wizard wajib โ€” setelah selesai langsung masuk Home.

Halaman Selamat Datang di Kasgo dengan icon toko, subtitle Buat akun Owner untuk memulai, form: Nama Owner (required, red border), Username (default owner), Nomor WhatsApp (opsional), PIN (required), Konfirmasi PIN (required), Tampilkan PIN checkbox, tombol Mulai Menggunakan Aplikasi, footer Akun Owner memiliki akses penuh ke semua fitur aplikasi
Halaman Setup Owner โ€” empty state

Field-field di form:

  1. Nama Owner * โ€” nama lengkap pemilik bisnis (wajib, ditandai red border)
  2. Username * โ€” username untuk login. Default: owner. Bisa diganti
  3. Nomor WhatsApp โ€” opsional, tapi sangat disarankan untuk recovery & kontak support
  4. PIN * โ€” 4-6 digit angka (number-only keyboard akan muncul)
  5. Konfirmasi PIN * โ€” masukkan ulang PIN yang sama
  6. Centang Tampilkan PIN kalau ingin lihat PIN yang diketik (default ter-mask)
Form Setup Owner terisi: Nama Owner AyuOwner, Username owner, PIN 1234, Konfirmasi PIN 1234, checkbox Tampilkan PIN dicentang sehingga PIN visible 1234, tombol Mulai Menggunakan Aplikasi navy aktif
Form terisi โ€” PIN visible setelah Tampilkan PIN dicentang

Submit:

  1. Tap tombol Mulai Menggunakan Aplikasi (navy)
  2. Akun Owner auto-create & auto-login
  3. Langsung diarahkan ke Home (tidak ada wizard step lainnya)

โš ๏ธ PENTING tentang PIN:

  • PIN ini wajib untuk login setiap kali โ€” JANGAN LUPA!
  • Kalau lupa, ada link Lupa PIN? di halaman pilih akun โ€” butuh Kode Lisensi untuk reset
  • Setelah beberapa kali PIN salah, login bisa di-lock sementara
  • Nomor WhatsApp berguna kalau Anda butuh dihubungi tim support (recovery, info update)

4. Setelah Setup: Home Pertama Kali

Setelah tap Mulai Menggunakan Aplikasi, langsung masuk Home dalam kondisi fresh:

Home Kasgo FnB fresh setelah setup owner: header gradient hijau dengan jam dan logout icon, card Nama Toko / Alamat Toko (default placeholder belum diisi), AyuOwner OWNER badge, banner kuning Anda belum pernah backup data Tap untuk backup sekarang, card ungu Tap untuk mulai shift / Buka Kasir, Ringkasan Hari Ini 5 card (Penjualan / Transaksi / Stok Menipis / Pengeluaran / Bahan Menipis), Menu Utama 15 sub-menu
Home pertama kali โ€” belum ada data, ada banner reminder backup

Yang perlu Anda perhatikan:

  • Card Toko menampilkan placeholder "Nama Toko / Alamat Toko" โ€” belum diisi, perlu setup di langkah 5
  • Banner kuning "Anda belum pernah backup data" โ€” reminder untuk segera backup setelah ada data
  • Card ungu "Tap untuk mulai shift" โ€” kasir wajib buka shift dulu sebelum transaksi (Owner tidak wajib)
  • Ringkasan Hari Ini: 5 card (Penjualan, Transaksi, Stok Menipis, Pengeluaran, Bahan Menipis) โ€” semua Rp0/0 (belum ada transaksi)
  • Menu Utama sudah aktif semua โ€” Anda bisa langsung explore

Tidak ada wizard wajib lagi setelah Setup Owner. Konfigurasi Pengaturan Toko (logo, nama, alamat), Pengaturan Bisnis (Mode Variant, PPN, dll), Setup Printer, dan Tambah Meja semuanya opsional dan dilakukan kapan saja dari menu Pengaturan.

5. Pengaturan Toko (Opsional, Disarankan)

Lokasi: Pengaturan โ†’ bagian atas halaman, section Pengaturan Toko (inline, tidak perlu tap sub-menu).

3 field utama:

  1. Logo Toko:
    • Tap ikon kamera di tengah area placeholder logo
    • Pilih sumber: Galeri atau Kamera
    • Crop ke aspek 1:1 (max 1080ร—1080)
    • Logo disimpan 2 versi: berwarna (display) + monokrom (otomatis untuk thermal printer)
  2. Nama Toko โ€” nama restoran/cafe yang akan tampil di struk & KOT
  3. Alamat Toko โ€” alamat lengkap, juga muncul di struk

Setelah isi, tap tombol navy Simpan Pengaturan.

Disarankan diisi sebelum mulai jualan โ€” supaya struk & KOT yang tercetak ke customer sudah ada brand toko Anda. Bisa diubah kapan saja.

6. Pengaturan Bisnis (Opsional)

Lokasi: Pengaturan โ†’ Pengaturan Bisnis (sub-menu di kolom kiri grid).

Halaman ini berisi 5 section konfigurasi bisnis. Detail lengkap di section Pengaturan. Ringkasan singkat:

A. Mode Variant Produk

Toggle ON/OFF. Aktifkan kalau menu punya varian (S/M/L, Hot/Ice).

B. Tipe Pesanan

Default Dine-in / Take Away / Delivery. Bisa tambah custom (GoFood, GrabFood) dengan komisi % per platform.

C. Manajemen Meja & Reservasi

Toggle. Aktifkan kalau punya meja fisik. Sub-fitur: CRUD meja + reservasi + tracking status.

D. Pengaturan PPN

Tarif PPN (default 11%) + toggle "PPN Default Aktif" untuk auto-apply ke transaksi baru.

E. Metode Update Harga Beli

Manual (default) atau Otomatis โ€” apakah harga beli auto-update saat Penerimaan Barang.

๐Ÿฝ๏ธ Mode F&B sudah otomatis aktif. Tipe Pesanan (Dine-in/Take Away/Delivery) selalu muncul di kasir. Modifier, KOT, Pesanan Terbuka semuanya tersedia dari awal.

7. Setup Printer (Opsional)

Lokasi: Pengaturan โ†’ Printer Bluetooth. Detail lengkap di section Pengaturan โ†’ E. Printer Bluetooth.

Kasgo F&B mendukung 3 jenis printer bersamaan:

1. Printer Thermal (Struk)

Thermal 58mm/80mm (ESC/POS) untuk cetak struk pembayaran ke customer.

2. Printer KOT (Dapur)

Thermal terpisah di dapur untuk cetak Kitchen Order Ticket. Kalau tidak diatur, otomatis fallback ke Printer Thermal Struk.

3. Printer Label (Stiker)

Untuk cetak barcode produk / label takeaway. Mode ESC/POS atau TSPL/CPCL. Ukuran 33mm ร— 15mm, 2 kolom.

Pair & Connect:

  1. Pair printer di Setting Android โ†’ Bluetooth dulu
  2. Buka Pengaturan โ†’ Printer Bluetooth di Kasgo F&B
  3. Grant izin Bluetooth kalau diminta
  4. Tap + Pilih Printer sesuai jenis (Thermal / KOT / Label)
  5. Pilih dari daftar paired devices โ†’ Hubungkan
  6. Test Print untuk verifikasi

Printer yang didukung:

  • Thermal Bluetooth 58mm / 80mm dengan protocol ESC/POS
  • Label Bluetooth dengan protocol TSPL / CPCL atau ESC/POS
  • Brand umum: Zjiang, Gowell, iWare, BlueBamboo, TSC, Gainscha, dll