Pengaturan Toko

Menu Pengaturan adalah pusat konfigurasi AzoPos. Hanya pengguna dengan peran Admin yang dapat mengakses seluruh bagian ini. Perubahan pada nama toko, logo, atau alamat akan langsung tercermin di struk dan laporan.

Navigasi: Dasbor → ikon ⚙ Pengaturan di sudut kanan atas

1. Profil Toko

Bagian paling atas Pengaturan menampilkan kartu hero profil toko yang berisi logo, nama, dan alamat toko saat ini. Tap tombol Ganti Logo untuk mengunggah foto dari galeri perangkat.

Di bawah kartu hero, terdapat tiga field input yang bisa langsung diedit:

  • Nama Toko — Nama bisnis Anda. Muncul di bagian atas setiap struk dan di laporan sebagai identitas toko.
  • Alamat Toko — Alamat lengkap toko yang dicetak di bawah nama toko pada struk. Mendukung multi-baris.
  • Pesan Footer — Kalimat ucapan terima kasih atau pesan promosi yang muncul di bagian paling bawah struk (contoh: "Terima kasih, selamat datang kembali!").

Setelah mengisi semua field, tap tombol Simpan Perubahan di bagian bawah layar (sticky bottom bar) untuk menyimpan seluruh pengaturan.

2. Operasional

Seksi Operasional berisi konfigurasi inti yang memengaruhi cara kerja transaksi dan perangkat keras pendukung.

Kalkulasi Laba

Tap item ini untuk membuka dialog pilihan metode kalkulasi laba. Terdapat dua opsi:

Metode Formula Cocok untuk
Laba Kotor Omzet − Modal Hanya menghitung selisih harga jual vs HPP produk
Laba Bersih Omzet − Modal − Pengeluaran Sudah memotong semua biaya operasional yang dicatat

Metode yang dipilih akan langsung ditampilkan sebagai subjudul item Kalkulasi Laba di layar Pengaturan.

Template Struk

Tap item ini untuk membuka layar Template Struk — lihat Seksi 6 di bawah untuk dokumentasi lengkapnya.

Setup Printer

Tap item ini untuk membuka layar Setup Printer Bluetooth — lihat Seksi 5 di bawah. Di bawah item ini juga terdapat dua tombol shortcut:

  • Cetak Test — Langsung mengirim halaman uji ke printer yang sudah terhubung
  • Buka Laci Kas — Mengirim perintah buka cash drawer via Bluetooth

Kedua tombol memerlukan izin Bluetooth di Android 12+. Jika izin belum diberikan, sistem akan meminta izin terlebih dahulu.

3. Preferensi

Seksi Preferensi berisi toggle on/off untuk mengatur perilaku otomatis AzoPos:

Preferensi Efek saat Aktif
Auto Buka Laci Kas Cash drawer otomatis terbuka setiap kali transaksi tunai berhasil diproses
Auto Cut Printer Printer thermal otomatis memotong kertas di akhir setiap cetak struk
Suara Aplikasi Efek suara diputar saat scan barcode berhasil, transaksi selesai, dll.

4. Sinkronisasi Cloud

Seksi Sinkronisasi Cloud menghubungkan AzoPos Anda ke platform SaaS Ofis.id. Setelah aktif, data toko, transaksi, produk, dan karyawan disinkronkan secara otomatis ke cloud, memungkinkan akses dashboard web dan laporan multi-cabang.

Status Cloud

Di bagian atas seksi ini ditampilkan status aktivasi cloud:

  • Tidak Aktif — Cloud belum diaktifkan; fitur terbatas hanya lokal
  • Aktif — Terhubung ke Ofis.id; menampilkan Tenant ID, Paket Langganan, dan Device ID

Informasi sinkronisasi terakhir juga ditampilkan:

  • Waktu Sync Terakhir — Timestamp sinkronisasi terakhir yang berhasil
  • Status Sync Terakhir — Berhasil / Gagal
  • Error Terakhir — Pesan error ditampilkan dengan warna merah jika ada kegagalan

Aktivasi Cloud

  1. Masukkan License Key yang Anda dapatkan dari portal Ofis.id ke dalam field yang tersedia
  2. Tap tombol Aktifkan Cloud — proses aktivasi berjalan dan indikator loading ditampilkan
  3. Setelah berhasil, status berubah menjadi Aktif dan Tenant ID + Device ID muncul di layar
  4. Tap tombol Sinkronisasi Sekarang untuk memulai sync manual pertama kali

💡 Tips: Tombol Sinkronisasi Sekarang hanya aktif jika cloud sudah dalam status Aktif. Sync otomatis berjalan di latar belakang setiap beberapa menit sekali tanpa perlu tindakan manual.

5. Setup Printer Bluetooth

Layar Setup Printer diakses dari menu Operasional. Di sini Anda dapat memilih dan menghubungkan printer thermal Bluetooth untuk mencetak struk pelanggan.

Kartu Printer Terhubung

Bagian atas layar menampilkan kartu Printer Terhubung Saat Ini. Jika belum ada printer yang dipilih, kartu ini menampilkan teks "Belum terhubung". Apabila sudah terhubung, nama dan alamat MAC Bluetooth printer ditampilkan.

Memilih Printer

  1. Pastikan printer thermal sudah dinyalakan dan dipasangkan (paired) dengan perangkat Android via menu Bluetooth di Pengaturan sistem
  2. Tap tombol Refresh untuk memuat daftar perangkat Bluetooth yang sudah terpasang
  3. Pada daftar perangkat yang muncul, tap tombol Hubungkan di samping nama printer Anda
  4. Printer yang aktif ditandai dengan chip "Terhubung" (✓) berwarna hijau
  5. Tap tombol Simpan Preferensi Printer untuk menyimpan pilihan

Uji Printer

Setelah memilih printer, gunakan dua tombol pengujian di bagian bawah:

  • Cetak Test — Mencetak halaman uji berisi teks "AzoPos Test Print" ke printer yang dipilih. Indikator loading muncul selama proses cetak berlangsung.
  • Buka Laci Kas — Mengirim perintah ESC/POS untuk membuka cash drawer yang terhubung ke printer.

Di bawah tombol uji, terdapat dua toggle preferensi printer:

  • Auto Buka Laci Kas — Sama seperti di seksi Preferensi, laci kas terbuka otomatis setiap transaksi tunai
  • Auto Cut Printer — Kertas otomatis dipotong setelah cetak struk

⚠️ Android 12+: AzoPos memerlukan izin BLUETOOTH_CONNECT dan BLUETOOTH_SCAN. Jika izin belum diberikan, sistem akan meminta izin secara otomatis saat Anda mencoba memuat daftar printer atau menguji printer.

6. Template Struk

Layar Template Struk memungkinkan Anda memilih tampilan struk yang akan digunakan, disesuaikan dengan ukuran kertas printer thermal yang dimiliki.

Ukuran Kertas

Template tersedia untuk dua ukuran kertas thermal yang umum digunakan:

  • 58mm — Printer kasir berukuran kecil (lebar cetak ±32 karakter)
  • 80mm — Printer kasir standar (lebar cetak ±48 karakter)

Pilihan Template

Setiap ukuran kertas memiliki tiga pilihan template yang ditampilkan sebagai kartu mini:

Template Deskripsi Kustomisasi
Default Struk standar lengkap dengan nama toko, alamat, item, total, nomor antrian, dan footer Tidak ada
Tanpa Antrian Sama seperti Default tetapi tanpa nomor antrian — cocok untuk toko yang tidak menggunakan sistem antrian Tidak ada
Custom Struk Struk yang bisa dikonfigurasi; pilih elemen mana saja yang ditampilkan Ya — via ikon ⚙ di kartu

Template yang sedang aktif ditandai dengan badge "Di Pakai" (✓) berwarna hijau di sudut kiri atas kartu, serta border hijau pembatas. Tap kartu untuk mengaktifkan template tersebut.

Untuk template Default dan Tanpa Antrian, tersedia tombol:

  • Preview — Membuka dialog tampilan preview struk dalam format monospace, menampilkan contoh isi struk dengan data dummy
  • Cetak Template — Langsung mencetak template ke printer Bluetooth yang terhubung untuk uji tampilan fisik

Pengaturan Antrian

Tap ikon ⚙ di sudut kanan atas layar Template Struk untuk membuka dialog Pengaturan Antrian:

  • Aktifkan Nomor Antrian — Toggle on/off nomor antrian pada setiap struk
  • Nomor Mulai — Tentukan angka awal nomor antrian (harus lebih dari 0)
  • Nomor Saat Ini — Menampilkan nomor antrian berikutnya secara real-time
  • Tombol Reset — Mereset nomor antrian ke nomor mulai yang dikonfigurasi

7. Custom Struk

Layar Custom Struk diakses dengan tap ikon ⚙ pada kartu Custom Struk di layar Template. Di sini Anda dapat mengatur elemen apa saja yang ditampilkan dalam struk secara granular.

Opsi Tampilan (Display Options)

Setiap opsi berupa toggle on/off:

Opsi Tampil di Struk
🖼 Logo Toko Logo toko di header struk (diambil dari Profil Toko)
🏢 Nama Perusahaan Nama toko dalam huruf kapital di bawah logo
📍 Alamat Toko Alamat toko yang diambil dari Profil Toko
🎟 Nomor Antrian Nomor antrian di tengah struk di bawah tanggal
💳 Metode Pembayaran Label metode pembayaran seperti "Tunai" atau "QRIS"
💬 Pesan Footer Teks footer dari Profil Toko, ditampilkan di ujung bawah struk (subtitle menampilkan isi pesan footer saat aktif)

Preview Live

Di bagian bawah layar terdapat Preview Struk Live yang diperbarui secara real-time setiap kali Anda mengubah toggle. Preview menampilkan kartu putih yang mereplikasi tampilan struk fisik — termasuk logo, nama toko, alamat, garis pemisah, item contoh, total, metode pembayaran, dan footer.

Setelah puas dengan konfigurasi, tap tombol Simpan Template di bagian bawah layar.

8. Metode Pembayaran (Lanjutan)

Seksi Lanjutan di layar Pengaturan berisi tautan ke halaman Manajemen Metode Pembayaran. Halaman ini mengelola daftar metode pembayaran yang tersedia di layar kasir saat proses checkout.

Menambah Metode Pembayaran

Secara default, AzoPos sudah menyediakan metode Tunai (bawaan, tidak dapat dihapus). Untuk menambah metode lain (contoh: QRIS, Transfer Bank, GoPay):

  1. Tap tombol (+) di sudut kanan bawah layar
  2. Masukkan nama metode pembayaran di dialog yang muncul
  3. Tap Tambah untuk menyimpan

Mengedit atau Menghapus

  • Tap ikon ✏ Edit pada kartu metode untuk mengubah nama
  • Tap ikon 🗑 Hapus untuk menghapus metode dari daftar
  • Metode Tunai (bawaan) tidak dapat dihapus — tombol hapus dinonaktifkan

⚠️ Menghapus metode pembayaran tidak mempengaruhi transaksi yang sudah ada. Data historis transaksi tetap aman.

9. Backup & Restore Data

Seksi Backup Data melindungi seluruh data toko Anda dari risiko hilang akibat kerusakan perangkat atau penghapusan tidak sengaja. Data disimpan dalam format file .zip.

Membuat Backup

  1. Tap tombol Backup
  2. Sistem akan membuka dialog pemilih lokasi penyimpanan file
  3. Nama file otomatis dibuat dengan format azopos_backup_YYYYMMDD_HHmm.zip
  4. Pilih folder tujuan dan konfirmasi — proses backup berjalan di latar belakang dengan indikator loading
  5. Setelah selesai, muncul dialog konfirmasi dengan opsi Bagikan — Anda dapat langsung mengirim file backup ke WhatsApp, email, atau cloud storage

Riwayat Backup

Tap item Backup Data (bukan tombol Backup) untuk membuka dialog Riwayat Backup, yang menampilkan daftar semua backup yang pernah dibuat beserta nama file dan waktu pembuatannya.

Restore Data

  1. Tap tombol Restore
  2. Sistem membuka dialog pemilih file — pilih file .zip backup yang ingin dipulihkan
  3. Dialog konfirmasi akan muncul: "Proses ini akan menggantikan semua data yang ada. Lanjutkan?"
  4. Tap Restore untuk mengonfirmasi
  5. Setelah restore selesai, aplikasi otomatis restart untuk menerapkan data yang dipulihkan
🚨

Peringatan Kritis

Restore data akan menghapus dan menggantikan SELURUH data saat ini — termasuk produk, transaksi, karyawan, dan pengaturan — dengan isi file backup. Tindakan ini tidak dapat dibatalkan. Pastikan Anda memilih file backup yang benar sebelum melanjutkan.

10. Keluar (Logout)

Di bagian paling bawah layar Pengaturan terdapat tombol Keluar berwarna merah. Tap tombol ini akan menampilkan dialog konfirmasi sebelum Anda benar-benar keluar dari akun. Setelah logout, Anda akan diarahkan kembali ke layar PIN atau layar login awal.

ℹ️ Data lokal tidak dihapus saat logout. Hanya sesi login yang diakhiri. Data tetap tersimpan di perangkat dan akan tersedia kembali setelah login ulang.