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

Order & Commerce

Dari interaksi percakapan menuju konversi transaksi yang tercatat — DagangBot menyediakan mesin pesanan (Order Engine) yang menjembatani chat pelanggan dengan pembuatan invoice, verifikasi pembayaran real-time, pencatatan di dashboard, serta orkestrasi pemenuhan pesanan dalam satu saluran terintegrasi.

1. Ikhtisar & Nilai Bisnis

Manajemen pesanan e-commerce tradisional memisahkan platform obrolan dari keranjang belanja. DagangBot meniadakan jeda ini dengan mendigitalkan transaksi langsung saat intensi beli terbentuk.

  • Konversi Chat ke Pesanan Otomatis: Deteksi maksud pembeli memungkinkan sistem mengekstrak detail barang, jumlah, dan alamat, lalu membangun draf tagihan tanpa menunggu intervensi admin. Proses ini secara dramatis mengurangi beban kerja tim penjualan.
  • Orkestrasi Lifecycle Tanpa Jeda: Peralihan mulus dari status menunggu pembayaran ke lunas terjadi berkat sinkronisasi webhook payment gateway (Midtrans/Xendit) dengan waktu kurang dari dua detik. Ini menghindari pembatalan akibat pelanggan menunggu konfirmasi pembayaran.
  • Pengawasan Visual Vision AI: Pelanggan yang lebih memilih transfer bank manual tak perlu tertunda oleh audit manusia. AI memindai bukti struk atau tangkapan layar e-wallet dan memberikan skor kecocokan dalam sekejap. Tingkat akurasi pemindaian yang mencapai standar perbankan menjamin setiap transaksi terekam presisi.
  • Validasi Kalkulasi Kupon & Pengiriman: Setiap tagihan menghitung harga eceran, ongkos logistik kurir, serta persentase diskon dari voucher yang diterapkan dengan presisi tingkat akuntan.
  • Transparansi Log Audit: Setiap pembaruan status pesanan direkam permanen, mencegah penyangkalan ganda saat terjadi pembatalan atau keluhan pelanggan. Kesalahan pemrosesan staf dapat ditelusuri riwayatnya detik demi detik.
Pentingnya Manajemen Katalog

Agar pembuatan draf pesanan dari chat berjalan akurat, pastikan katalog barang selalu diperbarui, termasuk penandaan varian (warna, ukuran) dan harga dasar pada modul inventaris. Sistem akan merujuk ke data master untuk mencegah kalkulasi subtotal yang menyimpang. Kesalahan pada penentuan berat produk juga akan berimplikasi langsung pada perhitungan tarif kurir logistik pihak ketiga, yang berujung pada defisit nilai transaksi bilamana terjadi selisih kekurangan pembayaran dari nilai ongkos kirim aktual di lapangan.

Penting untuk dicatat bahwa di Konfigurasi Bot → Order, disarankan untuk mengaktifkan fitur "Konfirmasi Pesanan Otomatis". Pengaturan ini memungkinkan bot langsung menerbitkan faktur invoice sesaat setelah keranjang (draf) terbentuk sempurna — sangat direkomendasikan untuk toko dengan arus pesanan (volume) tinggi yang tidak lagi bergantung pada peninjauan staf manusia secara satu per satu (mode Human-in-the-Loop).

2. Alur Visual & Antarmuka

Antarmuka pengelolaan order memberikan pandangan terpusat terhadap transaksi, status pembayaran, dan inventaris produk. Operator dapat langsung memperbarui status pesanan, mencetak draf, hingga memantau katalog produk:

Tabel sentral daftar pesanan live di konsol admin DagangBot
Tabel sentral daftar pesanan live dengan filter status, rincian pelanggan, dan total transaksi.
Katalog produk dan stok inventaris barang
Katalog produk terstruktur live sebagai referensi harga dan stok inventaris toko.
Formulir modal penambahan produk baru ke katalog toko
Formulir modal penambahan produk baru dengan input harga, stok, dan spesifikasi varian.

3. Panduan Langkah-demi-Langkah

Proses penyelesaian order melibatkan koordinasi antara niat pelanggan, kemampuan pengenalan mesin, dan integrasi finansial yang ketat.

  1. 1

    Langkah 1: Ekstraksi Maksud & Keranjang Belanja

    Pembeli mengirim pesan ketertarikan di WhatsApp. Mesin NLP DagangBot memetakan kata kunci produk yang ditanyakan dengan pangkalan data inventaris. Bot menanyakan kuantitas barang, spesifikasi varian (seperti warna/ukuran), serta alamat tujuan pengiriman (kecamatan/kota). Jika pembeli menggunakan mode manual, draf yang dihasilkan bot tidak akan langsung diteruskan ke pembeli, melainkan dikirim ke dasbor notifikasi agar CS (Customer Service) dapat meninjau, mengubah, lalu menekan konfirmasi.

  2. 2

    Langkah 2: Penerbitan Draf Invoice

    Setelah elemen kunci terpenuhi (seperti produk, kuantitas, dan alamat), sistem mengkompilasi ID produk, perhitungan Subtotal, diskon, dan ShippingCost. Draf tagihan (Order) dibuat dengan status awal pending (atau draft pada tampilan UI draf) di server. Invoice resmi lantas diteruskan kepada pengguna melalui WhatsApp. Pesan tagihan mencakup rincian barang, ongkos kirim, dan link tautan pembayaran mandiri atau QRIS gambar.

  3. 3

    Langkah 3: Eksekusi Pembayaran Pelanggan

    Pelanggan melakukan transaksi (contoh: pemindaian QRIS via m-banking/e-wallet). Sistem menunggu dalam jendela batas waktu pembayaran yang dibekukan saat order dibuat: payment_deadline_at = created_at + cart.auto_cancel_hours (default 48 jam, dapat diubah per merchant). Selama fase ini status berdiam pada kondisi waiting_payment, dan CartWorker (cron cart:scan tiap 15 menit) mengirim pengingat sekali pada H-cart.payment_deadline_reminder_lead_hours (default 6 jam) sebelum tenggat. Jika pelanggan lebih memilih metode transfer manual, mereka cukup mengirimkan foto bukti transfer (struk) ke chat WhatsApp untuk dibaca mesin Vision AI.

  4. 4

    Langkah 4: Validasi & Konfirmasi Pembayaran

    Pada metode otomatis, payment gateway menembakkan webhook invoice.paid ke server API DagangBot. Sistem mencatat waktu absolut di atribut PaidAt dan PaymentNotifiedAt, kemudian menggeser status mesin seketika ke paid. Bot merespons di chat WhatsApp, memverifikasi pelunasan seraya meneruskan tiket pesanan (nomor order) ke divisi pemenuhan pesanan (gudang). Seluruh webhook yang masuk divalidasi keabsahan kriptografinya (signature key) untuk menghindari pemalsuan tiket pembayaran.

  5. 5

    Langkah 5: Pengiriman & Penyelesaian (Fulfillment)

    Pesanan yang sukses dibayar berpindah ke fase pemrosesan. Staf logistik gudang membungkus pesanan dan memasukkan nomor pelacakan kurir (resi) ke sistem. Status pesanan dinaikkan ke shipped. Pelanggan secara otomatis akan menerima notifikasi status pengiriman dari bot WhatsApp. Saat barang terkonfirmasi mendarat di alamat yang dituju dan pelanggan mengonfirmasi penerimaan, status ditutup menjadi delivered (atau completed).

4. Parameter & Spesifikasi Teknis

Mesin siklus hidup pesanan dibangun dengan struktur data deterministik, memastikan tidak ada paket yang tenggelam di antara fase tunggu bayar dan fase logistik.

Properti / Atribut Spektrum Nilai Kode Keterangan
Status Pemesanan pending, waiting_payment, paid, shipped, delivered, cancelled Transisi linier searah (state machine). pending untuk draf awal, waiting_payment menanti webhook gateway.
Gerbang Finansial midtrans, xendit Provider yang menyuplai VA, link QRIS, dan e-money. Keduanya mewajibkan signature key saat konfirmasi payload.
Batas Kedaluwarsa Default 48 jam (cart.auto_cancel_hours) Dibekukan pada payment_deadline_at saat order dibuat. NULL berarti tanpa tenggat: order COD/pickup, atau order yang sudah lunas/dibatalkan. Pengingat dikirim sekali per order.
Tipe Item Baris Array dari OrderItem Mencakup ID Item, jumlah, harga satuan, dan diskon individual agar pelacakan stok tidak tumpang tindih.
Alasan Tinjauan Manual proof_review_reason ∈ media_fetch_failed, vision_error, not_valid_receipt Diisi saat vision AI gagal membaca bukti bayar; dikosongkan kembali (NULL) setelah admin menyelesaikan pengecekan.

Transisi Siklus Mesin Pesanan (State Machine)

Arsitektur pesanan pada platform tunduk pada pergerakan graf status deterministik searah (Directed Acyclic Graph). Status pesanan dilarang melompat liar; semuanya harus melewati palang gerbang logika yang telah disematkan di kode backend.

  1. draft (Inisiasi Obrolan): Pelanggan memilih barang tapi belum memberikan alamat. Reservasi stok belum terjadi. Keranjang bebas dimodifikasi, ditambah, atau dikurangi lewat percakapan NLP.
  2. pending_payment (Tagihan Dilepas): Alamat dan jasa logistik sudah ditunjuk. Sistem mengambil jumlah barang dari gudang ke dalam kolom penahanan sementara (stock_locked). Invoice dilemparkan ke kanal payment gateway (Midtrans/Xendit). Pembeli tidak lagi bisa mengubah komposisi produk kecuali meminta bot untuk meruntuhkan draf ini dan merakit dari awal.
  3. paid (Dana Mengendap): Webhook callback atau validasi Vision AI (untuk transfer konvensional) membunyikan sirene kesuksesan ke pangkalan data. Kolom PaymentNotifiedAt direkam dengan stempel waktu GMT+7 absolut. Di tahap inilah potongan stok stock_locked divalidasi mutlak dan barang dinyatakan sah terjual (depresiasi aset inventaris tuntas).
  4. processing / shipped (Gudang Bekerja): Tim operasional (Admin) menginput deretan kode Resi (Airway Bill). Notifikasi pemicu terkirim secara push ke klien bahwa bungkus telah berpindah ke tangan ekspedisi.
  5. delivered / cancelled (Posisi Terminal): Jika tenggat payment_deadline_at terlewati (default 48 jam setelah order dibuat) dan saklar cart.auto_cancel_enabled menyala, CartWorker membatalkan order (cancelled) serta memulangkan stok ke dalam sirkulasi dagang. Sebaliknya, bila pesanan diselesaikan sukses terkirim, status mencapai titik delivered.

Kasus Tepi Pembayaran & Rekonsiliasi (Edge Cases)

Sistem finansial otomatis tak lepas dari perilaku eksentrik pembeli yang perlu dimitigasi oleh infrastruktur rekonsiliasi:

  • Transfer Terpotong (Underpayment): Bila nominal hasil ekstraksi berada di bawah total tagihan melewati toleransi paymentProofAmountToleranceRp (Rp 1.000), handler menulis catatan audit [Vision AI ...] pada field notes pesanan dan pesanan tetap di jalur verifikasi manual (waiting_verification) — tidak ada transisi otomatis ke paid. Operator memverifikasi bukti secara manual sebelum melanjutkan pemenuhan pesanan.
  • Kelebihan Bayar (Overpayment): Selisih lebih juga tidak mengubah status otomatis. Handler menuliskan catatan [Vision AI CATATAN: NOMINAL LEBIH] berisi nilai dibayar, total tagihan, dan selisihnya, sehingga admin dapat memutuskan pengembalian dana atau penyesuaian invoice saat meninjau pesanan.

5. Relasi & Integrasi

Order Commerce merupakan episentrum fungsional yang menyedot sumber daya dari beberapa subsistem utama DagangBot:

  • Modul Integrasi Pembayaran: Menerima aliran konfirmasi dana (webhook) dan mengirimkan parameter pembuatan tagihan dinamis lewat REST. Tanpanya, semua pesanan akan mandek pada status waiting_payment. Tidak ada validasi pelunasan instan tanpa campur tangan staf tanpa modul ini.
  • Modul Inventaris & Produk: Memverifikasi parameter kecukupan gudang (Stock) saat invoice terbentuk. Menurunkan stok ketika beralih ke state paid dan mereversi kembali saat pemesanan berstatus cancelled. Jika stok kosong, AI tidak akan melanjutkan proses penjualan (mencegah overselling).
  • Mesin Chat Omnichannel: Antarmuka pengiriman konfirmasi transaksi, meneruskan link Snap Midtrans atau QRIS dalam pesan kaya media kepada pengguna yang mengakses melalui WhatsApp. Memastikan pemberitahuan pengiriman berjalan mulus via jalur yang sama.

6. Pemecahan Masalah (Troubleshooting)

Berbagai kelainan bisa terjadi jika alur informasi tersendat di tengah perjalanan pesanan.

Gejala Masalah Penyebab Utama Solusi Penanganan
Pesanan tertahan pada state waiting_payment padahal pelanggan mengaku sudah bayar Kunci signature webhook tidak selaras, atau URL callback API webhook tidak didaftarkan di dashboard payment gateway. Periksa kredensial rahasia di menu pengaturan integrasi pembayaran. Pastikan endpoint webhook diisi dengan alamat server API DagangBot dengan parameter yang presisi.
Bot gagal membangun draf invoice meskipun pembeli sudah menyebut spesifikasi detail Sinkronisasi antara inventaris dan pemahaman mesin NLP terputus, atau barang ditandai is_active: false. Buka tabel produk, verifikasi ejaan barang sesuai dengan apa yang dimengerti katalog. Aktifkan ulang parameter visibilitas.
Struk transfer manual (foto) tidak mengubah status pesanan Vision AI gagal membaca bukti (media tak terunduh, error model, atau gambar bukan struk), sehingga pesanan disimpan sebagai waiting_verification dengan proof_review_reason dan bukan paid. Tinjau bukti dari dasbor (endpoint POST /api/v1/platform/manual-payments/{id}/verify), lalu setujui bila bukti sahih menurut pemeriksaan operator.
Tagihan ongkos logistik muncul 0 Rupiah di invoice final Atribut berat gramasi pada entitas produk terlewatkan (kalkulator memakai bawaan 1.000 gram bila weight_grams kosong atau tujuan tidak terpetakan). Lengkapi profil setiap produk dengan berat (gram/kg) dan pastikan kota/kabupaten tujuan disebut eksplisit sebelum kalkulator tarif dipanggil.
Pesanan selalu dibatalkan bot secara tiba-tiba meskipun klien bersiap membayar cart.auto_cancel_hours diatur terlalu sempit, sehingga payment_deadline_at (dibekukan saat order dibuat) jatuh terlalu cepat. Naikkan nilai cart.auto_cancel_hours (default 48 jam) dan/atau sesuaikan cart.payment_deadline_reminder_lead_hours (default 6 jam) agar pengingat datang lebih awal.

7. Referensi Terkait

content/docs/features/order-commerce.mdx
Terakhir diperbarui: 9 Okt 2026, 09.28

Dokumentasi teknis DagangBot