Selamat bergabung, Bos! 👋 Aplikasi KasirApps ini dibagikan GRATIS. Ikuti langkah di bawah berurutan — jangan ada yang dilewati. Butuh ±15 menit, tanpa bisa coding (semuanya copy-paste). Langkah 2 tentang Google Cloud adalah langkah WAJIB — kalau dilewati, Anda akan kena error "This app is blocked" saat tahap Deploy!
⚠️ PALING SERING GAGAL: Mayoritas orang yang terburu-buru langsung ke Langkah 3 (Deploy) lalu kena error "This app is blocked" / "Access blocked". Solusinya ada di Langkah 2 (Google Cloud Project) — kerjakan dengan benar dan Anda tidak akan tersandung!
1 Persiapan — Yang Perlu Anda Punya
- Akun Google (Gmail) — menjadi rumah database warung Anda
- Perangkat — laptop/PC dengan Chrome/Edge, atau HP Android dengan Chrome
- Printer thermal bluetooth (opsional, untuk cetak struk)
- Mesin scanner barcode (opsional, untuk Kasir Warung)
✅ Penting: Selalu pakai akun Google milik Anda sendiri. Database warung Anda tersimpan di Google Drive Anda — bukan di server siapa pun.
2 WAJIB: Siapkan Google Cloud Project
🔑 Kenapa langkah ini penting? Tanpa ini, saat menyambungkan aplikasi ke Google, akan muncul error "This app is blocked" atau "Access blocked". Dengan menyiapkan Google Cloud Project dan mendaftarkan email Anda sendiri sebagai penguji, Anda diizinkan memakai aplikasi tanpa hambatan.
- Buka console.cloud.google.com → login dengan akun Google yang sama yang akan dipakai untuk aplikasi
- Di bar atas klik dropdown nama proyek → New Project → nama: kasirapps → klik Create
- Setelah jadi, pastikan proyek kasirapps terpilih di bar atas
- Menu ☰ (kiri atas) → APIs & Services → OAuth consent screen
- Kalau ditanya tipe: pilih External → Create
- Isi: App name: KasirApps · User support email: email Anda · Developer contact: email Anda → Save and Continue terus sampai selesai (Scopes boleh dilewati)
- PALING PENTING: di halaman OAuth consent screen, cari bagian Test users → klik + Add users → ketik email Gmail Anda sendiri → Save
Inilah yang mengizinkan DIRI ANDA memakai aplikasi tanpa verifikasi bisnis. - Sekarang ambil Project Number: menu ☰ → IAM & Admin → Settings → cari tulisan Project number → salin angka 12 digit itu (⚠️ yang disalin angka Project NUMBER, bukan Project ID yang berupa huruf!)
💡 Simpan angka 12 digit itu di Notepad — akan dipakai di Langkah 3.
3 Deploy "Mesin" Database (Apps Script)
Salin dulu kode mesin di bawah ini (klik tombolnya):
Memuat kode…
- Buka script.google.com → + New project
- Hapus semua kode di editor → tempel kode mesin yang tadi disalin
- SEBELUM Deploy — tautkan Google Cloud Project Anda:
• Klik ⚙️ Project Settings (menu kiri)
• Scroll ke bagian Google Cloud Platform (GCP) Project
• Tempel angka 12 digit dari Langkah 2 → klik Set project → konfirmasi
Ini mencegah error "This app is blocked" — jangan dilewati! - Klik 💾 Save
- Atur zona waktu: masih di Project Settings → Time zone → Jakarta (GMT+7) → kembali ke editor (ikon <>)
- Klik Deploy → New deployment (kanan atas)
- Roda gigi ⚙️ → pilih Web app → isi: Execute as: Me · Who has access: Anyone (WAJIB) → Deploy
- Saat diminta izin: pilih akun Anda. Akan muncul peringatan "Google hasn't verified this app" → klik Advanced → Go to KasirApps (unsafe) → Allow
Peringatan itu normal — aplikasinya milik Anda sendiri. Berkat Langkah 2, Anda diizinkan masuk, tidak akan kena "blocked". - Muncul Web app URL (akhiran /exec) → Copy → simpan di Notepad
🚨 Kalau tetap muncul "Access blocked / not completed verification": tunggu 2–3 menit setelah mendaftarkan Test users di Langkah 2, pastikan emailnya benar, lalu ulangi Authorize. Solusi cadangan: buka Chrome jendela samaran (Ctrl+Shift+N) → login 1 akun saja → ulangi Authorize.
4 Tautkan Mesin ke Aplikasi Kasir
- Buka halaman Menu → Pengaturan → tab Spreadsheet
- Tempel URL tadi ke kolom paling atas
- Klik Uji Koneksi → harus muncul "Tersambung!"
- Selesai! Spreadsheet bernama "KasirApps - Data Warung" otomatis dibuat di Google Drive Anda saat pertama dipakai
5 Aktifkan Cadangan Data Harian (WAJIB!)
Salin kode kecil ini, tempel di palmost bawah kode mesin Anda (di script.google.com, setelah kode mesin yang tadi):
// Cadangan harian otomatis KasirApps
// Tempel di PALING BAWAH kode mesin, lalu buat Trigger:
// ikon jam (Triggers) > Add Trigger > backupHarian >
// Time-driven > Day timer > jam 2-3 malam > Save
function backupHarian() {
var ss = SpreadsheetApp.getActiveSpreadsheet();
var src = ss.getSheetByName('Transaksi');
if (!src) return;
var d = new Date();
var nama = 'BACKUP ' + Utilities.formatDate(d, 'Asia/Jakarta', 'dd-MM-yyyy');
var sheets = ss.getSheets();
for (var i = 0; i < sheets.length; i++) {
if (sheets[i].getName().indexOf('BACKUP ') === 0) {
var tgl = sheets[i].getName().replace('BACKUP ', '');
var p = tgl.split('-');
var umur = (d - new Date(parseInt(p[2],10), parseInt(p[1],10)-1, parseInt(p[0],10))) / 86400000;
if (umur > 30) ss.deleteSheet(sheets[i]);
}
}
if (ss.getSheetByName(nama)) return;
var salinan = src.copyTo(ss);
salinan.setName(nama);
salinan.hideSheet();
}
- Tempel kode di atas di palmost bawah kode mesin → 💾 Save
- Klik ikon ⏰ Triggers (menu kiri) → + Add Trigger
- Isi: Function: backupHarian · Event source: Time-driven · Type: Day timer · Hour: 2 a.m.–3 a.m. → Save
- Selesai! Tiap malam transaksi dicadangkan ke tab tersembunyi "BACKUP tanggal" — cadangan lama (>30 hari) dibersihkan otomatis
6 Atur Warung & Mulai Gunakan
- Buka Menu → Pengaturan → Warung: isi nama warung, alamat, telepon, upload logo warung Anda (tercetak di struk)
- Jual barang fisik: buka Kasir Warung → Produk & Stok → daftarkan barang (barcode, nama, harga, stok)
- QRIS & e-wallet otomatis: ikuti panduan Menu → Transaksi Otomatis (install MacroDroid gratis di HP)
- Printer struk: ikuti panduan Menu → Printer
- Pengeluaran via HP: buat bot Telegram, panduan di Menu → Bot Telegram
💡 Di HP: buka situs dengan Chrome → menu ⋮ → "Tambahkan ke layar utama" — jadi aplikasi dengan ikon sendiri.
7 Aturan Keamanan (Baca, 1 Menit)
🚫 JANGAN PERNAH:
• Membagikan URL Apps Script Anda (akhiran /exec) ke siapa pun atau menyebarnya di grup/media sosial — itu pintu masuk data warung Anda
• Membagikan Token Bot Telegram Anda
• Menitipkan akun Google Anda ke orang lain untuk "disetupkan"
• Membagikan URL Apps Script Anda (akhiran /exec) ke siapa pun atau menyebarnya di grup/media sosial — itu pintu masuk data warung Anda
• Membagikan Token Bot Telegram Anda
• Menitipkan akun Google Anda ke orang lain untuk "disetupkan"
✅ YANG AMAN:
• Membagikan alamat website ini ke sesama pemilik warung — mereka membuat database sendiri lewat panduan ini
• Menyimpan data di Google Drive Anda — hanya Anda yang punya akses
• Menghapus/mengarsipkan transaksi — selalu ada cadangan di tab ARSIPE & BACKUP
• Membagikan alamat website ini ke sesama pemilik warung — mereka membuat database sendiri lewat panduan ini
• Menyimpan data di Google Drive Anda — hanya Anda yang punya akses
• Menghapus/mengarsipkan transaksi — selalu ada cadangan di tab ARSIPE & BACKUP
✅ Checklist akhir (centang saat selesai):
✓ Selesai! Selamat Berjualan!
Database warung Anda sudah hidup dan milik Anda sepenuhnya.
Semoga lancar porsinya, Bos! 🙏