B2B Partner Portal

B2B Partner Portal adalah storefront khusus yang memberikan akses terpisah antara tampilan admin dan tampilan partner bisnis. Portal ini membedakan jenis customer (distributor, modern market, reseller, retail) dan menyajikan harga, katalog, serta alur pemesanan yang disesuaikan dengan masing-masing segmen. Setiap partner melihat katalog yang sama namun dengan harga berbeda tergantung tipe customer mereka. Sistem ini menghilangkan kebutuhan komunikasi manual melalui WhatsApp atau email untuk proses order B2B — partner bisa langsung browse, order, dan tracking pengiriman dari satu portal. Portal ini juga dilengkapi growth analytics yang memungkinkan admin memantau performa penjualan B2B secara visual.

Arsitektur Komponen

Entity & Model

Customer (B2B)

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`name`	String	Nama partner/customer
`customer_type`	Enum	`distributor`, `modern_market`, `reseller`, `retail`
`email`	String	Email kontak partner
`phone`	String	Nomor telepon/WhatsApp
`address`	Text	Alamat pengiriman utama
`company_id`	UUID	Multi-tenant scoping
`created_at`	Timestamp	Waktu registrasi
`credit_limit`	Number	Batas kredit (opsional)
`payment_terms`	Number	Tempo pembayaran dalam hari

Pricing Logic

Parameter	Nilai	Deskripsi
Base price	`product.price`	Harga retail dari CompanyPOSProduct
B2B multiplier	`0.85` (default)	85% dari harga retail
Minimum order	`12` bottles	Batas minimum pemesanan per order
Idempotency key	UUID per order	Mencegah duplikasi order

B2B Channel Pricing

Customer Type	Default Multiplier	Min Order	Notes
Distributor	85%	12 bottles	Harga terendah, volume terbesar
Modern Market	85%	12 bottles	Supermarket/minimarket
Reseller	85%	12 bottles	Reseller skala menengah
Retail	100%	12 bottles	Harga retail, bisa disesuaikan

Order Entity

Field	Tipe	Deskripsi
`id`	UUID	Primary key
`order_number`	String	Nomor order unik (auto-generated)
`customer_id`	FK → Customer	Partner yang order
`items`	Array	Daftar produk + qty + harga
`subtotal`	Number	Total sebelum diskon
`discount`	Number	Potongan harga
`total`	Number	Total akhir
`status`	Enum	`pending`, `confirmed`, `processing`, `shipped`, `delivered`, `cancelled`
`payment_status`	Enum	`unpaid`, `partial`, `paid`
`shipping_address`	Text	Alamat pengiriman
`notes`	Text	Catatan order
`idempotency_key`	UUID	Key untuk cegah duplikasi
`company_id`	UUID	Multi-tenant scoping
`created_at`	Timestamp	Waktu order

Fitur Utama

Portal menggunakan 3 tab utama untuk memisahkan konteks operasional:

Tab	Fungsi	Konten
Orders	Buat order baru	Katalog produk, cart, checkout
Shipments	Tracking pengiriman	Status pengiriman aktif
History	Riwayat transaksi	Order selesai, return, invoice

2. B2B Growth Chart

Komponen B2BGrowthChart.jsx (362 baris) menggunakan Recharts untuk menampilkan performa penjualan B2B secara visual: Chart Type: Stacked AreaChart Data Source: Aggregasi order B2B per retailer per bulan Metrics yang Ditampilkan:

Metric	Deskripsi
Monthly Revenue	Total revenue per retailer per bulan
MoM Growth	Month-over-month growth percentage
Total Revenue	Akumulasi revenue keseluruhan
Top Retailer	Retailer dengan revenue tertinggi

Visual Stack: Setiap retailer di-stack sebagai area terpisah dengan warna berbeda, memungkinkan admin melihat komposisi revenue dan tren pertumbuhan.

3. Product Catalog & Ordering

Katalog produk B2B mengambil data dari 2 sumber:

Source Entity	Konten
`CompanyPOSProduct`	Produk fisik (saos, bumbu, dll)
`DigitalProduct`	Produk digital (voucher, e-catalog)

Stock Resolution:

4. Return & Refund Management

Portal mendukung pengelolaan return dengan 6 alasan yang terdefinisi:

Return Reason	Deskripsi
Damaged product	Produk rusak saat pengiriman
Wrong item	Barang yang dikirim tidak sesuai
Quality issue	Masalah kualitas (kadaluarsa, cacat)
Late delivery	Pengiriman terlambat dari SLA
Changed mind	Partner berubah pikiran (jika diizinkan)
Other	Alasan lain dengan penjelasan manual

Return Flow:

5. Idempotency & Data Integrity

Setiap order B2B dikirim dengan idempotency key (UUID) untuk mencegah:

Duplikasi order akibat network retry
Double-submit dari user yang tidak sabar klik
Race condition saat order diproses bersamaan

Implementation:

const idempotencyKey = crypto.randomUUID();
await base44.entities.B2BOrder.create({
  customer_id: customerId,
  items: cartItems,
  total: orderTotal,
  idempotency_key: idempotencyKey,
  // ... other fields
});

Integrasi Cross-Module

Cara Akses

Dari sidebar, klik menu B2B > Partner Portal.

Flow Penggunaan

Untuk Admin (Setup & Monitoring)

Buka halaman Partner Portal dari sidebar
Kelola daftar partner dan tentukan customer_type masing-masing
Atur harga khusus atau multiplier untuk setiap tipe customer
Monitor performa penjualan B2B melalui B2BGrowthChart
Review order yang masuk dari 3 tab (Orders, Shipments, History)
Handle return request berdasarkan 6 kategori alasan

Untuk Partner (Order & Tracking)

Login ke portal partner dengan kredensial yang diberikan
Browse katalog produk dengan harga B2B sesuai tipe customer
Tambahkan produk ke cart (minimum 12 bottles per order)
Checkout dan pilih alamat pengiriman
Track status pengiriman dari tab Shipments
Lihat riwayat order dari tab History

Tips

Set multiplier B2B yang kompetitif namun tetap margin-positive — 85% adalah default, tapi bisa disesuaikan per customer type
Monitor B2BGrowthChart secara bulanan untuk identifikasi retailer yang tumbuh atau stagnan
Gunakan data return reason untuk memperbaiki proses packing dan pemilihan logistik partner
Onboarding partner baru dengan walkthrough 3 tab agar mereka familiar dengan alur order → shipment → history
Berikan akses training kepada partner tentang cara menggunakan portal agar order masuk dengan benar
Review credit limit secara berkala untuk partner dengan volume tinggi

Mulai

Dashboard & Core

POS & Kasir

Inventori

Manufaktur

Keuangan

SDM & Kehadiran

CRM & Pelanggan

AI & Analitik

Analytics & Reporting

Produktivitas

Komunikasi

Marketing & B2B

Toko Online

Admin & Pengaturan

B2B Partner Portal

B2B Partner Portal

Arsitektur Komponen

Entity & Model

Customer (B2B)

Pricing Logic

B2B Channel Pricing

Order Entity

Fitur Utama

1. Multi-Tab Navigation

2. B2B Growth Chart

3. Product Catalog & Ordering

4. Return & Refund Management

5. Idempotency & Data Integrity

Integrasi Cross-Module

Cara Akses

Flow Penggunaan

Untuk Admin (Setup & Monitoring)

Untuk Partner (Order & Tracking)

Tips

​B2B Partner Portal

​Arsitektur Komponen

​Entity & Model

​Customer (B2B)

​Pricing Logic

​B2B Channel Pricing

​Order Entity

​Fitur Utama

​1. Multi-Tab Navigation

​2. B2B Growth Chart

​3. Product Catalog & Ordering

​4. Return & Refund Management

​5. Idempotency & Data Integrity

​Integrasi Cross-Module

​Cara Akses

​Flow Penggunaan

​Untuk Admin (Setup & Monitoring)

​Untuk Partner (Order & Tracking)

​Tips

B2B Partner Portal

Arsitektur Komponen

Entity & Model

Customer (B2B)

Pricing Logic

B2B Channel Pricing

Order Entity

Fitur Utama

1. Multi-Tab Navigation

2. B2B Growth Chart

3. Product Catalog & Ordering

4. Return & Refund Management

5. Idempotency & Data Integrity

Integrasi Cross-Module

Cara Akses

Flow Penggunaan

Untuk Admin (Setup & Monitoring)

Untuk Partner (Order & Tracking)

Tips