Ninja Van Mode B — Bila Merchant Patut Ada Akaun Kurier Sendiri

Dua cara guna Ninja Van dengan ARAS

ARAS integrate dengan Ninja Van dalam dua mod:

Mode A — ARAS handle semua:

• ARAS guna akaun Ninja Van platform sendiri
• Anda tidak nampak credentials, OAuth, atau webhook
• AWB auto-generate, pickup auto-jadual
• ARAS charge RM 1.00 platform fee per shipment (Percuma/Asas)
• Sesuai untuk merchant yang nak operational simplicity

Mode B — Akaun Ninja Van anda sendiri:

• Anda connect akaun NV sendiri melalui OAuth
• ARAS guna credentials anda untuk generate AWB
• Billing terus dari NV ke anda — tiada ARAS markup
• ARAS charge RM 0.80 platform fee per shipment (Peniaga)
• Sesuai untuk merchant yang nak kontrol penuh atas logistics cost

Soalan yang selalu ditanya: "Bila saya patut upgrade ke Mode B?"

Kenapa Mode A adalah titik mula yang betul

Mode A wujud kerana setup logistics bukan perkara yang mudah. Merchant baru yang cuba setup akaun Ninja Van sendiri perlu: apply, tunggu approval, setup webhook, test, pastikan credential production vs sandbox betul.

Semua itu ada learning curve. Dan kalau anda baru mulakan, fokus patut pada operasi — bukan pada logistics infrastructure.

Mode A juga bermakna ARAS absorb risiko jika ada isu teknikal dengan NV API. Anda tidak perlu handle sendiri.

Untuk merchant dengan volume kecil hingga sederhana (bawah 100 shipment sebulan), Mode A adalah pilihan yang betul.

Bila Mode B mula masuk akal

1. Volume mencukupi untuk negotiate rate yang lebih baik

Ninja Van ada tiered pricing berdasarkan volume. Bila anda hantar 200+ shipment sebulan secara konsisten, anda mungkin layak untuk rate yang lebih rendah dari rate standard.

Dengan Mode A, ARAS bayar NV dan charge anda ikut rate platform. Dengan Mode B, anda bayar NV terus dan boleh negotiate sendiri. Perbezaannya boleh jadi RM 0.50–RM 2.00 per shipment — signifikan pada volume tinggi.

Rule of thumb: Kalau anda dah buat calculation dan Mode B jimat lebih dari RM 150 sebulan — masa untuk pertimbang.

2. Anda nak branding pada AWB

Dengan akaun NV sendiri, ada pilihan untuk customize sender details pada AWB. Nama perniagaan anda, logo pada label, pickup dari lokasi spesifik anda.

Ini kelihatan kecil — tapi untuk merchant yang bina brand premium, waybill yang menunjukkan nama bisnes sendiri (bukan ARAS atau platform generik) memberikan impression yang lebih professional kepada pelanggan.

3. Anda nak direct relationship dengan kurier

Bila ada isu dengan shipment — parcel hilang, damaged, late — siapa yang anda hubungi?

Dengan Mode A, ARAS adalah perantara. Ada layer tambahan dalam komunikasi.

Dengan Mode B, anda ada direct relationship dengan NV. Anda boleh escalate terus, ada dedicated support kalau volume cukup, dan dapat visibility yang lebih real-time atas shipment anda.

4. Anda nak control webhook dan status update

Status update tracking (parcel picked up, in transit, delivered) datang melalui webhook dari NV. Mode A, ARAS manage webhook itu.

Mode B, webhook register ke endpoint anda sendiri. ARAS auto-register ini selepas OAuth — anda tidak perlu setup manual. Tapi anda ada visibility penuh atas subscription dan boleh monitor sendiri.

Apa yang berbeza dari sudut teknikal

Bila anda connect Mode B melalui OAuth dalam Settings → Courier:

1. ARAS exchange token dengan NV API guna client credentials anda
2. ARAS auto-register webhook subscription dengan NV — ini berlaku automatik, anda tidak perlu salin URL atau masuk ke portal NV
3. Integration doc disimpan dalam workspace anda (merchants/{merchantId}/integrations/ninjavan)
4. Semua AWB generation dari titik itu guna credentials anda

Satu perkara penting: bila anda disconnect dan reconnect, webhook yang sama digunakan semula (bukan daftar baharu). Ini bermakna status history tidak terganggu.

Yang tidak berubah walau guna Mode B

• ARAS masih yang generate AWB dan coordinate pickup
• Dashboard operations (AWB Manager, order status, delivery notes) sama
• Commission settlement tetap berjalan sama
• Storefront checkout tetap melalui createStorefrontOrder

Mode B hanya tukar: siapa yang bayar NV, dan akaun mana yang generate AWB. Operasi lain — sama.

Ringkasan: Mode A atau Mode B?