Lompat ke konten utama
StableTerakhir diperbarui: 9 Okt 2026, 09.28

Manajemen Multi-Cabang & Jam Operasional

Bagi perusahaan berskala menengah atau entitas waralaba yang memiliki jaringan distribusi fisik di berbagai wilayah, sistem pusat tunggal seringkali tidak memadai. Fitur Manajemen Multi-Cabang memampukan setiap lokasi untuk memiliki jam operasional spesifik, isolasi persediaan barang, serta pengalokasian kontak interaksi secara independen tanpa campur tangan antarcabang.

Stable

1. Ikhtisar & Nilai Bisnis

  • Lokalisasi Jam Operasional (Zona Waktu): Anda dapat mendefinisikan jadwal buka-tutup berbeda bagi tiap cabang sesuai wilayah operasi (WIB, WITA, WIT), meminimalisasi konflik pemrosesan pesanan pada saat tutup operasional. Entitas komersial dapat merefleksikan dinamika jam buka-tutup unik yang menyesuaikan peraturan lalu-lintas komersial setempat, seperti pelarangan operasional truk pasokan di area perumahan Jakarta dengan fleksibilitas tinggi di pinggiran Makassar.
  • Isolasi Data Persediaan & Analitik: Data stok barang untuk Cabang Jakarta sepenuhnya dipisahkan dari Cabang Surabaya, menjamin sistem bot hanya merujuk pada kuantitas fisik di gudang terdekat. Pengaturan yang demikian memastikan tidak ada insiden salah lapor inventarisasi harian (misal: "barang ada" karena dihitung kumulatif nasional padahal di gudang bersangkutan telah defisit), menghindarkan konsumen dari pengalaman logistik yang menyakitkan.
  • Rute Percakapan Terarah (Branch Selection): Memungkinkan alur percakapan awal untuk menanyakan lokasi terdekat sebelum mengalihkan (route) pengguna ke agent AI atau katalog yang relevan. Mekanisme percakapan (conversation state machine) mengondisikan respons pengguna, menautkan sesi mereka pada penanda khusus yang mengatur sisa komunikasi ke depannya.
  • Manajemen Karyawan Spesifik Lokasi: Karyawan (kasir/staf gudang) yang terdaftar pada sebuah cabang hanya memiliki wewenang untuk memeriksa log aktivitas atau inventori cabangnya, menjaga kerahasiaan performa lintas-wilayah. Praktik pengamanan ini memisahkan hierarki eksekutif dari pengamat operasional lapangan, memberikan wewenang hanya jika otorisasinya selaras.
  • Otomasi Pesan Luar Jam Kerja: Ketika suatu cabang telah melampaui jam operasionalnya, bot beralih ke mode penerimaan tiket otomatis (offline ticketing) untuk dikerjakan keesokan harinya. AI menyerap segala kekecewaan pelanggan dengan kalimat empati yang dirancang khusus dan disuntikkan ke parameter basis pengetahuan (knowledge base), menetralisir situasi tanpa perlu campur tangan fisik segera.
Ruang Lingkup Fungsional

Halaman ini difokuskan pada manajemen keseharian tiap cabang toko. Untuk analisis komparasi (benchmarking) performa antar-lokasi dan perbandingan omset tahunan (seperti mengukur rasio keberhasilan closing rate cabang Denpasar versus cabang Yogyakarta), silakan merujuk pada dokumentasi mendalam di Benchmarking & Analitik Cabang.

Pemisahan data antarcabang merupakan pilar kunci dalam mencegah tumpang tindih alokasi sumber daya. Anda tidak lagi memerlukan lisensi langganan perangkat lunak secara terpisah hanya untuk membuka outlet baru. Pendekatan arsitektur SaaS berskala multi-tenant dan multi-branch ini meringkas pelaporan finansial ke satu dasbor, tanpa mengorbankan partisi data di akar basis data operasional.

Pada akhirnya, kerumitan logistik seperti sinkronisasi stok lintas armada atau perbedaan masa kampanye iklan regional dapat difokuskan pada entitas digital masing-masing. Setiap entitas cabang bertindak selayaknya perpanjangan instansi perusahaan independen yang memiliki "kepribadian" (prompt) serta gudang pengetahuannya sendiri, dibalut antarmuka sentral yang merangkum keseluruhan jejak jejak rekam mereka.

2. Alur Visual & Antarmuka

Antarmuka dasbor memberikan visibilitas penuh bagi administrator utama untuk mengatur penjadwalan dan mengisolasi rute komunikasi di tiap outlet.

Pengaturan jam operasional dan hari libur cabang toko per lokasi wilayah
Panel konfigurasi jam buka mingguan serta zona waktu referensi pada suatu cabang.

Manajemen stok juga menyediakan fasilitas penempatan komoditas pada masing-masing lokasi. Sistem keranjang belanja bot akan mengevaluasi silang data ini secara otomatis.

Pengalokasian stok produk dan kuantitas per lokasi cabang gudang
Formulir alokasi ketersediaan produk spesifik per entitas cabang agar bot tidak menawarkan barang yang kosong di area pembeli.

3. Panduan Langkah-demi-Langkah

Membuat entitas cabang baru menuntut ketelitian konfigurasi agar sistem perpesanan AI berjalan lancar.

  1. 1

    Langkah 1: Registrasi Entitas Cabang Baru

    Navigasikan ke Pengaturan Toko lalu tekan tab Multi-Cabang. Tekan tombol tambah untuk mendefinisikan nama outlet, nomor telepon kontak, serta penanda alamat geografis (Geotagging).

  2. 2

    Langkah 2: Pemilihan Zona Waktu & Jam Kerja

    Terapkan penyesuaian (Timezone) lokal, seperti WIB (Asia/Jakarta), WITA (Asia/Makassar), atau WIT (Asia/Jayapura). Selanjutnya, setel rentang jam operasional harian. Anda dapat menonaktifkan sakelar (toggle) di hari tertentu guna menandainya sebagai hari libur tutup cabang.

    Secara API, pembaruan jadwal operasional (termasuk hari libur temporer) dieksekusi dengan merutekan PUT pada ID cabang. Kalender server menyimpan jadwal menggunakan cron expression berlatar waktu lokal:

    bash
    curl -X PUT "https://dagangbot.web.id/api/v1/branches/8f8c44b0-a548-472d/hours" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "timezone": "Asia/Makassar",
        "schedules": {
          "monday": { "open": "08:00", "close": "21:00", "is_holiday": false },
          "sunday": { "is_holiday": true }
        }
      }'
  3. 3

    Langkah 3: Isolasi Persediaan Barang (Stok)

    Kunjungi menu Katalog Produk. Saat membuat atau memperbarui komoditas, hapus centang opsi Stok Global, lalu isikan jumlah fisik barang pada input cabang yang dituju (misal: "Kopi Gula Aren - Stok Cabang A: 15, Stok Cabang B: 0").

    Integrasi logistik stok dapat pula didorong dari sistem kasir POS pihak ketiga milik Anda melewati API dengan merujuk relasi mutasi branch_id:

    bash
    curl -X POST "https://dagangbot.web.id/api/v1/commerce/products/adjust-stock" \
      -H "Authorization: Bearer $TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
        "product_id": "prod-kopi-01",
        "branch_id": "8f8c44b0-a548-472d",
        "quantity_delta": -2,
        "reason": "penjualan_offline"
      }'
  4. 4

    Langkah 4: Routing Percakapan Awal (Opsional)

    Bila nomor WhatsApp utama dipakai bersamaan (Shared Number), masuk ke pengaturan bot lalu aktifkan Branch Selection Flow. Bot akan meminta pelanggan menekan tombol navigasi interaktif atau mengetik nama kota sebelum meneruskan pembicaraan ke katalog cabang terkait.

  5. 5

    Langkah 5: Penugasan Hak Akses Staf

    Buka tab Tim & Pengguna. Saat menambahkan kasir atau operator CS baru, wajibkan kolom batas wilayah kerja dengan memilih nama cabang bersangkutan. Pengguna ini tidak akan bisa melihat antrean tiket dari cabang lain.

Mekanika Isolasi Data Geografis (Row-Level Security)

DagangBot mengedepankan keamanan batas kepemilikan data melewati pendekatan Row-Level Security (RLS) di lapisan basis data (PostgreSQL). Setiap query yang dikirimkan oleh kasir atau agent AI secara implisit ditambahi filter mandat branch_id. Hal ini menihilkan peluang peretasan kueri (query injection) yang mencoba mengintip prospek pelanggan (leads) atau angka transaksi final dari lokasi outlet yang berbeda.

Dalam ranah komunikasi perpesanan, mesin kecerdasan buatan membaca basis pengetahuan (Knowledge Base) spesifik milik cabang ketika routing pelanggan telah ditetapkan. Pelanggan di Bali hanya akan diberikan promosi dan informasi cuaca dari RAG berlabel cabang Bali.

4. Parameter & Spesifikasi Teknis

Berikut batasan fungsional serta penanda atribut sistem untuk cabang:

Entitas Data / Atribut Limitasi atau Nilai Sistem Deskripsi Teknis
Batas Maksimum Cabang Bergantung pada Paket Langganan Starter (1 Cabang), Growth Pro (3 Cabang), Agency (10 Cabang). Melebihi batas ini mengembalikan error 403.
Konfigurasi Timezone Asia/Jakarta, Asia/Makassar, Asia/Jayapura Disinkronisasi setiap 10 detik terhadap waktu server (Epoch Time) guna memastikan pemotongan jam pesanan persis real-time.
Status Operasi Bot OPEN, CLOSED, HOLIDAY Bot beralih fungsi dari fasilitator belanja menjadi penerima keluhan di luar jam (Offline Ticketing).
Toleransi Sesi Chat 5 Menit (Grace Period) Keranjang belanja yang dibuat sesaat sebelum jam operasional tutup diberikan perpanjangan 5 menit untuk penyesuaian validasi transaksi terakhir.
Format Parameter API branch_id (Tipe UUID) Semua pengambilan data ledger maupun routing pesan mewajibkan header atau parameter kueri cabang.

Setiap tiket pelanggan yang masuk dan keranjang pembelanjaan menyimpan relasi tabel UUID terhadap foreign key branch_id. Isolasi sistem ini sangat kokoh, sehingga kerentanan pembacaan silang direduksi secara signifikan di tingkat arsitektur database (melalui Row-Level Security).

5. Relasi & Integrasi

Seluruh sistem arsitektur bot berpusat pada relasi pemisahan multi-cabang ini:

  • Hak Akses Karyawan: Pembatasan penugasan tim kasir terintegrasi pada modul Manajemen Pengguna & RBAC. Administrator tidak dapat mengubah pengaturan tingkat tenant, melainkan terbatas di tingkat cabang (branch admin).
  • Pembagian Biaya Operasional: Seperti tertuang dalam dokumen Paket, Langganan & Billing, tagihan biaya AI bulanan dapat dipisahkan dompet pemakaiannya agar satu wilayah operasional tidak mengganggu efisiensi anggaran total perusahaan.
  • Rute REST API: Pengambilan data pesanan cabang melalui All-in-One API mewajibkan penyisipan parameter kueri ?branch_id= di endpoint terkait bila kunci API diterbitkan dari pengguna dengan scope terpusat.

6. Pemecahan Masalah (Troubleshooting)

Gejala Penyebab Solusi
Laporan omset akhir harian terputus secara sepihak saat jam 23:00 padahal toko di Bali (WITA) masih beroperasi. Agregasi analitik sistem membaca referensi zona standar WIB tanpa filter khusus di dasbor (Dashboard View). Terapkan penyaringan tambahan pada bilah menu analitik (Dashboard Filter) menjadi WITA agar data rekapitulasi tersinkron pada jam 23:59 waktu lokal Bali.
Pelanggan melaporkan status ketersediaan barang di bot WhatsApp masih "Ada", tetapi aslinya di lokasi kosong. Produk komoditas pada katalog masih diatur menggunakan skema (Global Pool) alih-alih dipecah berdasar cabang bersangkutan. Buka katalog backend, lakukan modifikasi pada persediaan produk, lalu aktifkan centang alokasi multi-gudang (lokasi fisik cabang).
Bot menyela interaksi pelanggan dengan membalas pesan "Toko Tutup", padahal secara fisik toko belum tutup. Validasi rentang jam kerja harian keliru ditetapkan pada baris pengaturan kalender lokal (misalnya setel waktu AM ke PM). Revisi rentang parameter jam tutup melalui menu Multi-Cabang menjadi mode waktu militer (24-jam format: 21:00 alih-alih 09:00).
Tim kasir di cabang luar kota tak sanggup melihat tiket percakapan (Live Inbox) pelanggan setempat. Tenant owner lupa menautkan relasi entitas profil kasir terhadap penugasan spesifik lokasi (Scope Authorization). Buka modul pengaturan RBAC Tim, lalu tambahkan modifikasi penugasan cabang terotorisasi ke kotak wilayah kerja staf terkait.
Modul Katalog Cabang merespons harga yang tidak konsisten dengan harga terpusat. Pihak administrator menginisiasi pembaruan harga pokok melalui API produk, namun terjadi race condition antara singgahan (cache) harga lama dan kueri pemuatan ulang dari antarmuka perpesanan pada cabang bersangkutan. Pastikan eksekusi pengosongan singgahan sistem dilakukan seusai update stok atau harga, serta tinjau kembali nilai product_id untuk menghindari duplikasi pelaporan data harga.
Bot gagal menawarkan promosi diskon (voucher) spesifik wilayah operasi. Parameter batas teritorial promosi (Geofencing) belum dipasangkan secara utuh terhadap kode voucher sehingga keranjang belanja menolak pendaftaran diskon dari identitas UUID cabang. Modifikasi skema basis data promosi lewat menu Voucher dan pastikan kolom pembatas applicable_branch memuat ID wilayah operasi spesifik dengan keutuhan referensi data (referential integrity).

7. Referensi Terkait

content/docs/features/branch-operations.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot