๐Ÿš€ Panduan Setup Awal โ€” Pengguna Baru Pesan POS

Daftar Isi

  1. Alur Setup Garis Besar
  2. Tahap 1: Onboarding Wizard (9 Langkah)
  3. Tahap 2: Setelah Onboarding โ€” Item Wajib dari Dashboard
  4. Tahap 3: Setup Opsional yang Direkomendasikan
  5. Referensi Halaman Settings

1. Alur Setup Garis Besar

flowchart TD
    A([Daftar Akun]) --> B[Onboarding Wizard 9 Langkah]
    B --> C[Dashboard]
    C --> D{Ada Warning di Dashboard?}
    D -->|Ya| E[Lengkapi item yang kurang]
    D -->|Tidak| F[Tambah Produk wajib ada]
    E --> F
    F --> G[Tambah Karyawan untuk login POS]
    G --> H[Siap Jualan! Login ke /pos]

    style H fill:#388e3c,color:#fff
    style B fill:#1565c0,color:#fff

2. Tahap 1: Onboarding Wizard

Saat pertama kali login setelah mendaftar, sistem akan menampilkan Onboarding Wizard yang terdiri dari 9 langkah. Wizard ini wajib diselesaikan sebelum bisa mengakses dashboard.

Catatan: Progress wizard disimpan otomatis. Jika keluar di tengah jalan, wizard akan melanjutkan dari langkah terakhir.


Langkah 1 โ€” Informasi Bisnis โญ Wajib

Mengisi data dasar tenant/restoran Anda.

Field Keterangan Status
Kode Tenant (tenant_code) ID unik bisnis Anda (digunakan di URL QR ordering) Wajib
Nama Bisnis (business_name) Nama restoran/usaha (muncul di struk) Wajib
Jenis Bisnis (business_type) Jenis usaha (mis. Restoran, Kafe, dll.) Wajib
Alamat Alamat bisnis (muncul di struk) Opsional
Nomor Telepon Telepon bisnis (muncul di struk) Opsional
Email Email bisnis Opsional
NPWP Nomor NPWP (muncul di struk jika diisi) Opsional

Langkah 2 โ€” Pengaturan Pajak

Mengatur pajak yang diterapkan pada produk. Sistem sudah menyediakan dua preset default yang bisa diubah:

Preset Default Rate Tipe
PPN (Pajak Pertambahan Nilai) 11% Inklusif (sudah termasuk dalam harga)
PB1 (Pajak Restoran) 10% Inklusif

Pilihan Tipe Pajak:

  • Inklusif โ€” Pajak sudah termasuk dalam harga jual produk (harga tidak berubah, pajak dihitung dari dalam)
  • Eksklusif โ€” Pajak ditambahkan di atas harga produk (harga tertera + pajak)

Pajak bisa diterapkan per produk di halaman Products. Satu produk bisa memiliki tax setting berbeda.


Langkah 3 โ€” Service Charge (Opsional)

Mengatur biaya layanan (service charge) yang otomatis ditambahkan ke total transaksi.

Field Keterangan
Nama Nama biaya layanan (mis. "Service Charge")
Tipe Persentase (%) atau nominal tetap (Fixed Amount)
Nilai Besar persentase atau nominal
Aktif? Toggle untuk mengaktifkan/menonaktifkan

Jika tidak ingin menggunakan service charge, kosongkan nama dan lanjutkan ke langkah berikutnya.


Langkah 4 โ€” Metode Pembayaran

Memilih metode pembayaran yang tersedia di POS. Sistem sudah menyediakan tiga default:

Default Tipe Status Default
Cash Tunai โœ… Aktif
Card Kartu Debit/Kredit โœ… Aktif
QRIS Dompet Digital / QR โœ… Aktif

Metode pembayaran dapat ditambah atau diubah nanti di menu Payment Methods.


Langkah 5 โ€” Kategori Produk

Membuat kategori untuk mengelompokkan produk di POS. Sistem menyediakan dua default:

Default
Beverages (Minuman)
Food (Makanan)

Anda bisa mengubah nama atau menambah kategori baru. Kategori akan terlihat sebagai filter produk di layar POS kasir.


Langkah 6 โ€” Pilih Paket Langganan

Memilih pricing plan yang sesuai dan melakukan pembayaran invoice.

Elemen Keterangan
Pricing Plan Pilih paket berlangganan yang tersedia
Kode Voucher Opsional โ€” masukkan kode voucher untuk diskon
Invoice Setelah memilih plan, invoice akan digenerate
Pembayaran Selesaikan pembayaran invoice untuk melanjutkan

โš ๏ธ Langkah ini memblokir progres โ€” wizard tidak bisa dilanjutkan ke langkah berikutnya sampai invoice lunas.


Langkah 7 โ€” Preferensi Table Tracking

Memilih apakah bisnis Anda menggunakan sistem pelacakan meja (table tracking).

Pilihan Dampak
Aktif Kasir wajib memilih meja sebelum transaksi; ada halaman overview meja
Tidak Aktif Kasir langsung ke halaman transaksi tanpa pilih meja; Kitchen Tracking otomatis dinonaktifkan

Baca lebih lanjut di Alur Kasir untuk mengetahui dampak penuh terhadap alur kasir.


Langkah 8 โ€” Preferensi Kitchen Tracking

(Hanya muncul jika Table Tracking diaktifkan)

Memilih apakah order dikirim ke dapur untuk diproses dahulu sebelum bisa dibayar.

Pilihan Dampak
Aktif Order dikirim ke kitchen board; ada status confirmed โ†’ preparing โ†’ ready
Tidak Aktif Order langsung ready; pembayaran dapat diproses segera

Langkah 9 โ€” Buat Meja

(Hanya muncul jika Table Tracking diaktifkan)

Membuat meja-meja restoran secara massal.

Field Keterangan
Jumlah Meja Masukkan angka, sistem akan membuat meja 1 s/d N secara otomatis
Kapasitas Default 4 kursi per meja (bisa diubah nanti)

Meja dapat ditambah, diubah, atau dihapus nanti di menu Tables.


Ringkasan Alur Onboarding

flowchart LR
    S1[1 Info Bisnis] --> S2[2 Pajak] --> S3[3 Service Charge] --> S4[4 Metode Bayar] --> S5[5 Kategori]
    S5 --> S6[6 Pricing Plan]
    S6 --> S7[7 Table Tracking?]

    S7 -->|"Table Tracking = OFF"| DONE(Selesai ke Dashboard)
    S7 -->|"Table Tracking = ON"| S8[8 Kitchen Tracking?]

    S8 -->|"Kitchen = OFF"| DONE
    S8 -->|"Kitchen = ON"| S9[9 Buat Meja]
    S9 --> DONE

    style DONE fill:#388e3c,color:#fff
    style S6 fill:#f9a825,color:#000

3. Tahap 2: Setelah Onboarding โ€” Item Wajib dari Dashboard

Setelah wizard selesai, Anda akan diarahkan ke Dashboard. Dashboard menampilkan panel peringatan (berwarna kuning) yang berisi daftar hal yang belum diisi. Sistem tidak akan bisa digunakan secara optimal jika item ini kosong.

Warning yang Muncul di Dashboard

# Peringatan Halaman untuk Set Up Prioritas
1 โŒ No categories yet /categories/create ๐Ÿ”ด Kritis
2 โŒ No products yet /products/create ๐Ÿ”ด Kritis
3 โŒ No payment methods yet /payment-methods/create ๐Ÿ”ด Kritis
4 โŒ No tax settings yet /tax-settings/create ๐Ÿ”ด Kritis
5 โŒ No tables yet (hanya jika table tracking ON) /tables/create ๐Ÿ”ด Kritis
6 โš ๏ธ No service charges yet /service-charges/create ๐ŸŸก Disarankan
7 โš ๏ธ No discounts yet /discounts/create ๐ŸŸก Disarankan
8 โš ๏ธ No customers yet /customers/create ๐ŸŸก Disarankan
9 โš ๏ธ No employees yet /employees/create ๐Ÿ”ด Kritis
10 โš ๏ธ No addons yet /addons/create ๐ŸŸข Opsional

Penting: Item no. 2 (Produk) dan no. 9 (Karyawan) adalah yang paling kritis โ€” tanpa produk POS tidak ada yang bisa dijual, dan tanpa karyawan tidak ada yang bisa login ke halaman /pos.


Detail Item Wajib

๐Ÿท๏ธ Kategori Produk

  • Lokasi: Menu โ†’ Kategori (Categories)
  • Kategori digunakan untuk mengelompokkan produk di layar POS
  • Kasir bisa filter menu berdasarkan kategori

๐Ÿ“ฆ Produk

  • Lokasi: Menu โ†’ Produk (Products)
  • Field penting per produk:
Field Keterangan
Nama Nama produk yang muncul di POS
Kategori Harus memilih dari kategori yang ada
Harga Harga jual
Stok Jumlah stok (POS akan reject jika stok = 0)
Tax Setting Pajak yang diterapkan (opsional)
Tersedia? Toggle on/off ketersediaan produk

๐Ÿ’ณ Metode Pembayaran

  • Lokasi: Menu โ†’ Payment Methods
  • Minimal 1 metode pembayaran aktif diperlukan
  • Tipe: cash, card, digital_wallet

๐Ÿงพ Pengaturan Pajak

  • Lokasi: Menu โ†’ Tax Settings
  • Minimal 1 tax setting jika ingin menggunakan pajak
  • Dapat dikosongkan jika bisnis tidak menggunakan pajak

๐Ÿช‘ Meja (jika Table Tracking aktif)

  • Lokasi: Menu โ†’ Tables
  • Setiap meja memiliki nomor meja dan kapasitas
  • Bisa QR code per meja untuk self-ordering pelanggan

๐Ÿ‘ค Karyawan (Employee) โ€” SANGAT PENTING

  • Lokasi: Menu โ†’ Employees
  • Karyawan adalah akun yang digunakan untuk login ke halaman POS (/pos/login)
  • Akun admin/owner tidak bisa login ke POS โ€” harus melalui akun karyawan
  • Field penting:
Field Keterangan
Nama Nama karyawan
Email Digunakan untuk login POS
Password Password login POS
Status Harus active untuk bisa login

4. Tahap 3: Setup Opsional yang Direkomendasikan

Ini bukan wajib untuk mulai berjualan, tapi sangat direkomendasikan untuk pengalaman yang lebih baik:

๐ŸŽฏ Diskon

  • Lokasi: Menu โ†’ Discounts
  • Buat promo/diskon yang bisa diaplikasikan saat transaksi
  • Bisa berupa persentase atau nominal tetap
  • Bisa set tanggal mulai dan berakhir, minimum order, dan stackable

๐Ÿ‘ฅ Pelanggan (Customer)

  • Lokasi: Menu โ†’ Customers
  • Daftar pelanggan untuk tracking purchase history
  • Bisa dipilih saat transaksi di POS

โž• Addon/Topping

  • Lokasi: Menu โ†’ Addons
  • Modifier produk (mis. extra shot, less sugar, dll.)
  • Addon terkait ke produk tertentu; muncul sebagai popup saat produk dipilih di POS

๐Ÿ’ฐ Service Charge

  • Lokasi: Menu โ†’ Service Charges
  • Biaya layanan yang otomatis ditambahkan
  • Bisa dikonfigurasi hanya untuk dine-in, takeaway, atau semua

5. Referensi Halaman Settings

Setelah setup awal, Anda bisa mengubah berbagai pengaturan melalui menu Settings:

Halaman Settings URL Yang Bisa Diubah
Profile /settings/profile Nama dan email akun owner
Password /settings/password Password akun owner
Tenant /settings/tenant Info bisnis, table/kitchen tracking, footer struk, tampilkan nomor order di struk
POS /settings/pos Tema Customer Board (dark/light), URL Customer Board
Printer /settings/printer Lebar kertas printer (58/72/80mm), kitchen print enabled, API Token printer
Tenant Plan /settings/tenant-plan Upgrade/downgrade paket langganan

Detail Settings yang Sering Perlu Diubah Setelah Onboarding

๐Ÿ–จ๏ธ Settings โ†’ Printer

Sangat penting jika menggunakan printer thermal:

Field Default Keterangan
printer_paper_width 58mm Sesuaikan dengan lebar kertas printer Anda (58/72/80mm)
printer_kitchen_print_enabled true Aktifkan untuk mengirim print job ke printer dapur
Printer API Token Auto-generate Digunakan oleh aplikasi PesanPOS Printer Bridge untuk terhubung

๐Ÿ“‹ Settings โ†’ Tenant

Bagian footer struk yang sering lupa diisi:

Field Keterangan
receipt_footer_line1 Baris 1 footer struk (mis. "Terima kasih!")
receipt_footer_line2 Baris 2 footer struk (mis. "Kunjungi kami lagi")
receipt_footer_line3 Baris 3 footer struk (mis. Instagram/sosmed)
receipt_show_order_number Toggle tampilkan nomor order di struk

๐Ÿ’ก Tips: Setelah semua checklist terpenuhi dan warning di dashboard sudah hilang, sistem siap digunakan untuk operasional sehari-hari. Untuk panduan lebih lanjut tentang alur kasir, lihat dokumentasi Alur Kasir