Otomasi n8n

Nota Jadi Pembukuan

Foto nota ke bot Telegram atau WhatsApp, buku kas Google Sheets terisi sendiri

Versi 1.0.0Diperbarui 26 September 202614 screenshot

Struk membuka jadi buku kasStruk 3D yang tadinya kusut sudah rata; potongan baris toko dan tanggal meluncur ke kolom buku kas di kanan saat halaman digulir.1 / 14
Struk membuka jadi buku kas1 / 14
Nota Jadi Pembukuan — Struk membuka jadi buku kas

Struk 3D yang tadinya kusut sudah rata; potongan baris toko dan tanggal meluncur ke kolom buku kas di kanan saat halaman digulir.

Ringkasan

Lima workflow n8n untuk UMKM: foto struk dibaca model vision, dicek buram dan duplikat, ditebak kategorinya, lalu dicatat ke Google Sheets setelah pemilik menekan Simpan di chat. Rekap laba-rugi tiap Minggu malam dan laporan PDF tiap tanggal 1.

Masalah yang diselesaikan

Nota belanja numpuk di laci atau dompet, baru direkap akhir bulan, dan separuhnya sudah luntur atau hilang. Akibatnya Anda tidak tahu minggu ini untung atau rugi sampai terlambat, belanja bahan baku yang membengkak baru ketahuan setelah bulan tutup, dan nota yang sama kadang dicatat dua kali. Aplikasi kasir dan akuntansi terasa terlalu ribet untuk usaha yang belanjanya masih pakai nota kertas dari pasar dan toko grosir.

Cocok untuk
  • Katering rumahan & warung makan
  • Kedai kopi dan usaha F&B kecil
  • Toko kelontong, toko bangunan, bengkel
  • Agensi atau freelancer n8n yang memasang otomasi untuk klien UMKM
Hasil yang kamu dapat
  • Potret nota, kirim ke bot, tekan Simpan: satu baris masuk Google Sheet milik Anda
  • Foto buram tidak dicatat, foto ulang nota yang sama ditolak sebagai duplikat
  • Kategori ditebak dari toko dan isi nota, bisa diganti dengan satu tombol di chat
  • Pemasukan tunai cukup diketik: + 850rb jualan nasi kotak
  • Rekap laba-rugi Senin sampai Minggu datang tiap Minggu 19.00 WIB
  • Laporan PDF A4 bulanan untuk arsip atau akuntan, dicetak Gotenberg di server Anda
Bahasa desain
DM Serif Display + Source Serif 4 · buku kas cetak, rapi, jujur

Fitur

Bot pencatat

  • Bot Telegram (gratis) dan bot WhatsApp Cloud API resmi, menulis ke buku yang sama
  • Tombol Simpan, Ganti kategori, Ubah total, Hapus; pesan yang sama diedit supaya chat rapi
  • Hanya chat terdaftar (IZIN_CHAT_ID) yang boleh menulis; chat lain dibalas dengan ID-nya
  • Perintah teks: + pemasukan, - pengeluaran, gaji, /rekap, hapus N-2609-022

Pembacaan nota

  • Model vision OpenAI-compatible (bawaan FlatKey, gemini-2.5-flash), model bisa diganti lewat .env
  • Angka format Indonesia: 125.000, 125rb, 1,2 jt, tanggal 26/09/26
  • PPN 11% dicatat terpisah, tarif tidak wajar dan item yang tidak cocok dengan subtotal ditandai
  • Foto dengan keyakinan di bawah 0,6 ditolak dengan tips foto ulang

Buku kas

  • 16 kolom Google Sheets: nomor urut per bulan, kategori, subtotal, PPN, total, isi, sumber, status
  • Deteksi duplikat dua lapis: file foto sama atau toko+tanggal+total sama
  • Status menunggu, tersimpan, dihapus; baris dihapus tidak dihitung
  • 10 kategori pengeluaran bawaan (bahan baku, kemasan, operasional, listrik/air/internet, transport, gaji, sewa, promosi, peralatan, lain-lain)

Laporan

  • Rekap mingguan: pemasukan, pengeluaran, laba/rugi, 3 pengeluaran terbesar, dibanding minggu lalu
  • PDF bulanan: ringkasan, porsi per kategori, seluruh buku kas
  • Jadwal zona waktu Asia/Jakarta

Untuk yang memasang

  • Workflow uji mandiri tanpa akun, gagal keras kalau logika berubah
  • Logika satu sumber (core/nota.js) disalin otomatis ke node Code, 26 uji vitest
  • docker-compose n8n 1.109.1 + Gotenberg, tanpa community node
  • Situs Cara kerja dengan simulasi bot untuk presentasi ke klien

Animasi 3D

Konsep

Struk thermal yang kusut membuka lipatannya saat halaman digulir (morph target kusut ke rata), lalu empat potongan barisnya (toko, tanggal, isi, total) terlepas dan meluncur ke kolom buku kas di sebelahnya, yang terisi sel demi sel dan diberi stempel merah. Itulah yang dikerjakan workflow: nota kertas yang berantakan jadi satu baris rapi di buku kas.

Tanpa WebGL / gerak dikurangi

Tanpa WebGL tampil gambar struk 2D yang sama dengan lipatan CSS dan buku kas tetap terisi mengikuti gulir. Dengan prefers-reduced-motion panggung tidak lekat, struk tampil rata dalam satu bingkai diam, dan baris sudah tercatat.

Screenshot

  1. 01Struk membuka jadi buku kasStruk 3D yang tadinya kusut sudah rata; potongan baris toko dan tanggal meluncur ke kolom buku kas di kanan saat halaman digulir.desktop
  2. 02Tercatat dan distempelBaris UD Sumber Pangan 26 Sep lengkap di buku kas Dapur Kenari, dengan stempel merah jam pencatatan.desktop
  3. 03Simulasi botPilih nota di meja, bot membalas dengan tombol, dan jejak node n8n yang dijalankan tampil di kanan. Kodenya sama dengan node Proses.desktop
  4. 04Kartu nota dibalikKetuk baris buku kas untuk membalik kartunya: foto nota asli, PPN, jam catat, dan status.desktop
  5. 05Rekap Minggu malamPesan laba-rugi yang diterima pemilik tiap Minggu 19.00 WIB, dengan pengeluaran per kategori.desktop
  6. 06Foto buram dan duplikatBalasan asli bot untuk foto buram, foto ulang nota lama, PPN, dan total yang salah baca.desktop
  7. 07Laporan laba-rugi bulananHTML A4 yang dicetak Gotenberg jadi PDF tiap tanggal 1: ringkasan, porsi kategori, buku kas lengkap.desktop
  8. 08Workflow bot TelegramEksekusi dengan data contoh di n8n 1.109: semua node hijau, dari foto masuk sampai balasan terkirim.desktop
  9. 09Keluaran node ProsesBaris N-2609-022 berstatus menunggu dan panggilan sendMessage berisi ringkasan nota serta tombol.desktop
  10. 10Uji mandiri tanpa akunEnam foto contoh: 4 tercatat, 1 buram ditolak, 1 duplikat, lalu rekap dan laporan disusun.desktop
  11. 11Beranda di ponselStruk kusut 3D di atas, tahap kerja di bawahnya, lalu judul dan buku kas.mobile
  12. 12Chat bot di ponselFoto nota terkirim, bot membalas, pemilik menekan Simpan: tercatat sebagai Bahan baku Rp 518.500.mobile
  13. 13Buku kas di ponselBaris ringkas dengan tanda +/-, kartu dibalik menampilkan foto nota dan rinciannya.mobile
  14. 14Rekap di ponselPilih minggu, baca pesan rekap, lihat ke mana uangnya pergi.mobile

Contoh hasil

  • PDFBuka PDF ↗
    Laporan laba-rugi September 2026PDF A4 dari buku kas contoh Dapur Kenari (usaha rekaan): pemasukan Rp 17.510.000, pengeluaran Rp 8.349.912.

Cara Pasang

  1. Isi .env

    Salin contoh, lalu isi token bot, ID sheet, kunci AI, dan alamat HTTPS n8n. Cara mendapat tiap nilai ada di docs/CREDENTIALS.md.

    cp .env.example .env
  2. Nyalakan n8n + Gotenberg

    n8n mendengar di 127.0.0.1:5678; pasang nginx atau Caddy di depannya (contoh di docs/INSTALL.md).

    docker compose up -d
  3. Impor lima workflow

    Setelah membuat akun pemilik n8n.

    docker compose exec n8n n8n import:workflow --separate --input=/workflows
  4. Uji tanpa akun, lalu aktifkan

    Jalankan 0 Uji mandiri sampai delapan node hijau. Sambungkan kredensial Telegram dan Google Sheets, aktifkan workflow 1, 3, 4, kirim satu foto nota.

Butuh kredensial

  • Token bot TelegramGratis

    Chat @BotFather, kirim /newbot, salin token. Dipakai di kredensial n8n dan TELEGRAM_BOT_TOKEN.

  • Google Sheets OAuth2Gratis

    Proyek Google Cloud dengan Sheets API + Drive API aktif, OAuth client tipe Web dengan redirect ke n8n Anda.

  • Kunci API model visionBerbayar

    Dasbor FlatKey (atau penyedia OpenAI-compatible lain yang menerima gambar). Bayar per pemakaian.

  • WhatsApp Cloud API (opsional)Gratis

    Meta for Developers: aplikasi Business + produk WhatsApp, Phone number ID, token permanen dari System User.

  • GotenbergGratis

    Sudah ada di docker-compose.yml, tanpa kunci.

Isi Paket

  • workflows/: 5 workflow n8n siap impor dengan catatan tempel Indonesia dan data contoh
  • core/: logika pencatatan (nota.js) dan data contoh (contoh.js)
  • docker-compose.yml, .env.example, config/buku-kas-template.csv
  • docs/: INSTALL, CREDENTIALS, CUSTOMIZE, CARA-KERJA bergambar, TROUBLESHOOT
  • src/, index.html, laporan.html, panduan.html: situs Cara kerja + demo
  • tests/: 26 uji logika, gerbang n8n, e2e, skrip tangkapan layar
  • marketplace/samples/laba-rugi-2026-09.pdf: contoh laporan

Kustomisasi

  • Kategori dan kata kuncinya (misalnya suku cadang untuk bengkel) di satu fungsi
  • Teks balasan bot, ambang foto buram, aturan duplikat
  • Model dan penyedia AI lewat tiga variabel .env
  • Jadwal rekap dan laporan, nama usaha di kepala PDF
  • Warna dan teks situs demo lewat token CSS

AI in the loop

Yang dikerjakan AI

Model vision membaca foto nota menjadi JSON (toko, tanggal, item, subtotal, PPN, total, keyakinan). Kategori ditebak oleh aturan kata kunci, bukan oleh model.

Kendali manusia

Hasil bacaan tidak pernah langsung final: setiap nota masuk sebagai baris berstatus menunggu dan bot menampilkan ringkasannya dengan tombol Simpan, Ganti kategori, Ubah total, dan Hapus. Foto dengan keyakinan rendah atau tanpa total ditolak, angka tidak ditebak, dan nilai lama disimpan di kolom catatan saat total diubah.

Penyedia model

Endpoint OpenAI-compatible dari .env (bawaan FlatKey https://router.flatkey.ai/v1, model gemini-2.5-flash). Kunci hanya di server n8n.

Hasil AI selalu berupa draf. Tidak ada yang terkirim atau tersimpan sebelum kamu menyetujuinya.

FAQ

Apakah foto nota saya disimpan di server AWAN?

Tidak. Semua berjalan di n8n milik Anda. Foto dikirim sekali ke penyedia model vision pilihan Anda untuk dibaca; yang disimpan hanya baris teks di Google Sheet Anda dan ID file untuk cek duplikat.

Bisa pakai WhatsApp pribadi?

Tidak. Bot WhatsApp memakai WhatsApp Cloud API resmi yang butuh nomor WhatsApp Business. Untuk mulai cepat dan gratis, pakai bot Telegram; keduanya bisa jalan bersamaan.

Karyawan boleh ikut kirim nota?

Boleh. Tambahkan ID chat mereka ke IZIN_CHAT_ID. Setiap baris mencatat chat pengirimnya.

Bagaimana kalau model salah baca?

Nota tetap berstatus menunggu sampai Anda tekan Simpan. Kategori dan total bisa diganti dari chat, dan foto yang tidak yakin terbaca ditolak dengan permintaan foto ulang.

Perlu keahlian n8n?

Cukup bisa menjalankan docker compose dan mengikuti docs/INSTALL.md. Workflow uji mandiri memastikan semuanya jalan sebelum akun disambung. Dukungan instalasi 30 hari termasuk.

Apakah ini laporan pajak?

Bukan. Ini buku kas sederhana dari nota yang Anda konfirmasi. PPN di nota dicatat sebagai informasi, dan PDF bulanan memudahkan akuntan Anda.

Changelog

  1. v1.0.0
    26 September 2026
    • Rilis pertama: 5 workflow n8n, situs Cara kerja dengan simulasi bot dan struk 3D, dokumentasi lengkap
Nota Jadi Pembukuan
Rp 299.000
Demo ↗