Dokumentasi Plugin AgenWebsite Shipping

Sekilas Tentang Plugin AgenWebsite Shipping

Plugin AgenWebsite Shipping adalah solusi lengkap untuk mengintegrasikan berbagai metode pengiriman Indonesia ke dalam toko WooCommerce Anda. Plugin ini mendukung kurir-kurir populer seperti JNE, TIKI, POS Indonesia, J&T Express, SiCepat, dan masih banyak lagi.

License Tab

License: Aktifkan Kode Lisensi AgenWebsite

1. Mendapatkan Kode Lisensi 📝

  • Kunjungi website resmi https://www.agenwebsite.com/account/license/
  • Login ke akun Anda (jika belum punya akun, daftar terlebih dahulu)
  • Setelah login, Anda akan melihat kode lisensi yang tersedia
  • Salin kode lisensi tersebut untuk digunakan pada langkah berikutnya
Tips Penting:
  • Pastikan koneksi internet stabil saat mengakses halaman lisensi
  • Simpan kode lisensi di tempat yang aman untuk referensi di masa depan
  • Jika mengalami masalah saat mengakses, coba refresh browser atau clear cache

2. Memasukkan Kode Lisensi 🔑

  1. Masukkan kode lisensi yang sudah Anda dapatkan ke dalam field "Kode Lisensi"
  2. Klik tombol "Daftar Lisensi Gratis" jika Anda menggunakan versi gratis
  3. Tunggu hingga proses verifikasi selesai
  4. Jika berhasil, akan muncul notifikasi konfirmasi
Troubleshooting:
  • Jika kode tidak valid, periksa kembali apakah sudah disalin dengan benar
  • Pastikan tidak ada spasi tambahan di awal atau akhir kode
  • Hubungi support AgenWebsite jika masalah berlanjut

3. Memilih Kurir Pengiriman 🚚

Untuk Pengguna Free Version:
  • Anda hanya dapat memilih 1 kurir saja
  • Pilih kurir yang paling sering digunakan pelanggan Anda
  • Rekomendasi kurir populer: JNE, TIKI, atau POS Indonesia
Untuk Pengguna Premium/Member:
  • Dapat memilih multiple kurir sekaligus
  • Memberikan lebih banyak pilihan kepada pelanggan
  • Meningkatkan kepuasan dan fleksibilitas pengiriman
Kurir yang Tersedia:
  • JNE (Jalur Nugraha Ekakurir)
  • TIKI (Titipan Kilat)
  • POS Indonesia
  • J&T Express
  • SiCepat
  • AnterAja
  • Lion Parcel
  • Ninja Express
  • Dan kurir lainnya

4. Menentukan Basis Kota 🏙️

Pentingnya Basis Kota:
  • Basis kota adalah titik asal pengiriman barang Anda
  • Mempengaruhi perhitungan ongkos kirim ke berbagai daerah
  • Harus sesuai dengan lokasi fisik toko/gudang Anda
Cara Memilih:
  1. Klik dropdown "Basis Kota"
  2. Pilih kota yang sesuai dengan lokasi bisnis Anda
  3. Contoh: Jika toko Anda di Jakarta, pilih "Jakarta"
  4. Jika kota Anda tidak tersedia, pilih kota terdekat dalam provinsi yang sama
Tips Memilih Basis Kota:
  • Pilih kota yang memiliki coverage kurir terlengkap
  • Pertimbangkan kemudahan akses ke kantor cabang kurir
  • Sesuaikan dengan alamat yang terdaftar di kurir

5. Memasukkan Kode POS 📮

Fungsi Kode POS:
  • Memperjelas lokasi spesifik dalam suatu kota
  • Membantu kurir dalam proses pengiriman
  • Meningkatkan akurasi perhitungan ongkir
Cara Mencari Kode POS:
  • Cek di website resmi Pos Indonesia
  • Tanyakan ke kantor pos terdekat
  • Gunakan layanan online pencari kode pos
  • Biasanya terdiri dari 5 digit angka
Contoh Kode POS Jakarta:
  • Jakarta Pusat: 10110-10750
  • Jakarta Selatan: 12110-12870
  • Jakarta Timur: 13110-13960
  • Jakarta Barat: 11110-11840
  • Jakarta Utara: 14110-14540

6. Aktivasi Lisensi ✅

  1. Setelah semua field diisi dengan benar
  2. Klik tombol "Aktifkan Lisensi"
  3. Tunggu proses verifikasi (biasanya 10-30 detik)
  4. Sistem akan memvalidasi data yang dimasukkan
  5. Jika berhasil, akan muncul notifikasi sukses
General Tab

General: Konfigurasi Dasar AgenWebsite Shipping

Tab General - Pengaturan Dasar Plugin

Setelah berhasil mengaktifkan lisensi AgenWebsite Shipping, langkah selanjutnya adalah mengonfigurasi pengaturan general untuk memastikan plugin berfungsi optimal sesuai kebutuhan toko online Anda.


1. Mengaktifkan AgenWebsite Shipping ✅

  • Centang kotak "Aktifkan AgenWebsite Shipping"
  • Pengaturan ini adalah switch utama untuk mengaktifkan/menonaktifkan seluruh fungsi plugin
  • Jika tidak dicentang, plugin tidak akan berfungsi meskipun sudah terinstall
Status Plugin:
  • Aktif = Plugin berfungsi dan menampilkan opsi kurir di checkout
  • Nonaktif = Plugin terpasang tapi tidak berfungsi

💡 Tips: Gunakan fitur ini untuk maintenance atau troubleshooting tanpa harus uninstall plugin.


2. Pengaturan Berat Default (kg) ⚖️

Berat default digunakan untuk produk yang belum memiliki berat yang ditentukan di pengaturan produk WooCommerce.

Rekomendasi Setting:
  • 0.1 kg - Untuk produk digital atau aksesori ringan
  • 0.5 kg - Untuk produk fashion atau elektronik kecil
  • 1 kg - Untuk produk umum (setting paling aman)
  • 2-5 kg - Untuk produk berat seperti peralatan rumah
Contoh Kasus:
Produk A: Berat tidak diset → Menggunakan berat default (1 kg)
Produk B: Berat diset 2 kg → Menggunakan 2 kg (bukan default)
Produk C: Berat 0 kg → Menggunakan berat default (1 kg)

⚠️ Penting: Setting berat yang terlalu rendah dapat menyebabkan kerugian ongkos kirim, sedangkan terlalu tinggi dapat membuat pelanggan enggan membeli.


3. Aktifkan Total Berat 📊

  • Centang = Menampilkan total berat belanjaan di halaman checkout
  • Tidak centang = Total berat tidak ditampilkan ke pelanggan
Manfaat Menampilkan Total Berat:
  • Transparansi - Pelanggan tahu dasar perhitungan ongkir
  • Kepercayaan - Meningkatkan trust dengan customer
  • Edukasi - Pelanggan memahami mengapa ongkir mahal/murah
  • Reduksi Komplain - Mengurangi pertanyaan tentang ongkir
Tampilan di Checkout:
🛒 Keranjang Belanja:
   Produk A (500g) + Produk B (1.5kg) = Total: 2kg
   💰 Ongkos Kirim JNE REG: Rp 15.000

💡 Rekomendasi: Aktifkan fitur ini untuk meningkatkan transparansi dan kepercayaan pelanggan.


4. Manajemen Kurir dan Layanan 🚚

Cara Menambah Kurir:
  1. Klik area "Aktifkan Kurir"
  2. Pilih kurir yang diinginkan dari dropdown
  3. Kurir terpilih akan muncul dalam bentuk tag
  4. Untuk menghapus, klik X di samping nama kurir
Strategi Pemilihan Kurir:
  • Untuk Toko Kecil/Pemula: JNE REG, POS Reguler, SiCepat Reguler
  • Untuk Toko Menengah: JNE REG + YES, TIKI Regular + ONS, SiCepat Reguler + BEST
  • Untuk Toko Besar: Semua layanan JNE, TIKI, SiCepat, POS Indonesia

5. Pengaturan Layanan Kurir Detail 📋

Tabel Layanan Kurir:
Nama Pengiriman Deskripsi Estimasi Rekomendasi
JNE OKE Ekonomis, volume besar 2-4 hari ✅ Wajib
JNE REG Standard, reliable 1-3 hari ✅ Wajib
JNE YES Express, premium 1-2 hari ✅ Recommended
JNE SPS Same day service Hari sama ⭐ Premium
POS Reguler Murah, ke pelosok 3-7 hari ✅ Wajib
POS Kargo Barang besar/berat 3-5 hari 📦 Situasional
TIKI Regular Standard TIKI 2-4 hari ✅ Alternatif
TIKI ONS Over Night Service 1 hari ⭐ Express
SiCepat Reguler Standard SiCepat 2-3 hari ✅ Recommended
SiCepat BEST Premium service 1-2 hari ⭐ Premium
Pengaturan Tambahan Biaya:
  • Input dalam Rupiah (contoh: 2000 = Rp 2.000)
  • Biaya tambahan akan ditambahkan ke ongkir asli
  • Berguna untuk: Packing fee, Asuransi, Handling premium, Biaya operasional
Contoh Pengaturan:
JNE REG: Tambahan Biaya = 2000 (untuk packing)
JNE YES: Tambahan Biaya = 5000 (untuk handling premium)
POS Reguler: Tambahan Biaya = 1000 (biaya operasional)

6. Mengelola Urutan dan Visibilitas Layanan 🔄

Mengatur Urutan:
  • Drag & Drop ikon ≡ di sebelah kiri nama layanan
  • Tarik ke atas untuk prioritas tinggi, ke bawah untuk prioritas rendah
Strategi Urutan Efektif:
  • Berdasarkan margin: tertinggi di atas, standard di tengah, murah di bawah
  • Berdasarkan popularitas: paling sering dipilih di atas

7. Mengaktifkan/Menonaktifkan Layanan Spesifik ✅❌

Fungsi Checkbox "Aktifkan":
  • ✅ Centang = Layanan ditampilkan di checkout
  • ❌ Tidak centang = Layanan disembunyikan dari customer
Kasus Penggunaan:
  • Sementara nonaktif: maintenance, hari libur, testing, promosi khusus
  • Nonaktif permanen: coverage terbatas, margin rendah, service buruk, duplikasi
Contoh Skenario:
Promo "Gratis Ongkir Express":
✅ JNE YES (aktif untuk promo)
❌ JNE REG (nonaktif sementara)
❌ JNE OKE (nonaktif sementara)

8. Menyimpan Pengaturan 💾

  1. Pastikan semua pengaturan sudah sesuai
  2. Scroll ke bawah hingga menemukan tombol "Save Changes"
  3. Klik tombol biru "Save Changes"
  4. Tunggu notifikasi "Settings saved" muncul
Verifikasi Pengaturan:
  • Test di frontend - Buka halaman checkout dan cek opsi kurir
  • Cek perhitungan - Pastikan ongkir terhitung benar
  • Test responsive - Cek tampilan di mobile device
  • User testing - Minta feedback dari pelanggan

Tips Optimasi Pengaturan General 🚀

  • Monitoring performa: conversion rate, kurir terpopuler, komplain ongkir
  • A/B Testing: urutan kurir, variasi biaya, tampilan total berat
  • Seasonal adjustment: aktif/nonaktif kurir sesuai musim
  • Customer education: FAQ, penjelasan layanan, rekomendasi kurir

Troubleshooting Umum 🔧

  • Kurir tidak muncul di checkout: pastikan "Aktifkan AgenWebsite Shipping" tercentang, cek koneksi API, basis kota, kode POS, clear cache
  • Ongkir tidak akurat: periksa berat default, pengaturan biaya, alamat asal, update tarif
  • Urutan kurir tidak berubah: klik "Save Changes", clear cache, cek konflik plugin, refresh checkout
  • Total berat tidak tampil: centang "Aktifkan total berat", pastikan produk ada berat, cek theme, clear cache

Kesimpulan 🎯

Pengaturan General adalah fondasi utama plugin AgenWebsite Shipping. Konfigurasi yang tepat akan:

  • Meningkatkan konversi dengan pilihan kurir yang sesuai
  • Mengurangi abandoned cart karena ongkir transparan
  • Meningkatkan kepuasan customer dengan estimasi akurat
  • Mengoptimalkan profit dengan margin yang sehat

Ingat untuk selalu test pengaturan sebelum go-live dan lakukan monitoring berkala untuk optimasi yang berkelanjutan.

💡 Pro Tip: Simpan screenshot pengaturan Anda sebagai backup dan dokumentasi untuk referensi di masa depan!

International Shipping Tab

International Shipping: Pengiriman Internasional 🌍

1. Mengaktifkan International Shipping ✅

  1. Centang kotak "Aktifkan international shipping"
  2. Fitur ini mengaktifkan opsi pengiriman internasional di halaman checkout
  3. Hanya akan muncul untuk alamat pengiriman di luar Indonesia
Status Aktivasi:
  • Aktif: Opsi pengiriman internasional tersedia untuk customer
  • Nonaktif: Tidak ada pilihan pengiriman ke luar negeri

Catatan: Fitur ini memerlukan verifikasi dan persetujuan dari POS Indonesia untuk layanan internasional.


2. Memilih Kurir International 📦

Kurir yang Tersedia:
  • POS International (satu-satunya provider pengiriman internasional yang didukung)
    • Terintegrasi langsung dengan sistem POS Indonesia
    • Coverage ke seluruh dunia dengan jaringan Universal Postal Union (UPU)
Cara Menambah Kurir:
  1. Klik field "Aktifkan Kurir International"
  2. Pilih "POS International" dari dropdown
  3. Kurir terpilih akan muncul dalam bentuk tag biru
  4. Untuk menghapus, klik X di samping tag
Kelebihan POS International:
  • ✅ Coverage Global - Mencakup 200+ negara
  • ✅ Tarif Kompetitif - Harga bersaing untuk pengiriman internasional
  • ✅ Tracking System - Lacak paket hingga negara tujuan
  • ✅ Customs Handling - Bantuan proses bea cukai
  • ✅ Insurance Available - Opsi asuransi untuk pengiriman internasional

3. Layanan Kurir International 🚀

Jenis Layanan POS International:
  • POS R LN (Pos Reguler Luar Negeri)
    • Deskripsi: Layanan pengiriman standar ke luar negeri
    • Estimasi: 7-21 hari kerja (tergantung negara tujuan)
    • Berat Maksimal: 30 kg per paket
    • Coverage: Seluruh dunia
    • Cocok untuk: Pengiriman non-urgent, produk umum
  • POS EMS Barang (Express Mail Service)
    • Deskripsi: Layanan express prioritas internasional
    • Estimasi: 3-7 hari kerja
    • Berat Maksimal: 30 kg per paket
    • Coverage: 180+ negara
    • Cocok untuk: Pengiriman urgent, dokumen penting
  • POS Cepat
    • Deskripsi: Layanan cepat dengan prioritas tinggi
    • Estimasi: 5-10 hari kerja
    • Berat Maksimal: 20 kg per paket
    • Coverage: Negara-negara Asia dan Eropa utama
    • Cocok untuk: Produk dengan deadline, e-commerce
  • POS Biasa
    • Deskripsi: Layanan ekonomis untuk pengiriman internasional
    • Estimasi: 14-30 hari kerja
    • Berat Maksimal: 30 kg per paket
    • Coverage: Seluruh dunia
    • Cocok untuk: Pengiriman bulk, produk non-urgent

4. Pengaturan Tambahan Biaya 💰

Kolom "Tambahan Biaya":
  • Input nilai dalam Rupiah (contoh: 50000 = Rp 50.000)
  • Biaya ini akan ditambahkan ke ongkir dasar dari POS
  • Berguna untuk menutup biaya operasional tambahan
Contoh Penggunaan Tambahan Biaya:
  • Handling Fee Internasional:
    POS R LN: Tambahan Rp 25.000
    - Packaging khusus internasional
    - Documentation fee
    - Insurance handling
    
    POS EMS: Tambahan Rp 50.000
    - Premium packaging
    - Express handling
    - Priority processing
  • Custom Documentation:
    POS Cepat: Tambahan Rp 35.000
    - Customs declaration
    - Invoice preparation
    - Export documentation
    
    POS Biasa: Tambahan Rp 15.000
    - Basic documentation
    - Standard customs form
Strategi Pricing:
  • Cost Recovery: Tutup biaya riil operasional
  • Profit Margin: Tambahkan margin 10-20%
  • Competitive: Bandingkan dengan forwarder lain
  • Value-based: Sesuaikan dengan service level

5. Mengaktifkan/Menonaktifkan Layanan 🔄

Checkbox "Aktifkan":
  • Centang: Layanan ditampilkan di checkout internasional
  • Tidak centang: Layanan disembunyikan dari customer
Strategi Aktivasi Layanan:
  • Untuk Pemula (Mulai Sederhana):
    ✅ POS R LN (Ekonomis)
    ✅ POS EMS (Express)
    ❌ POS Cepat (Skip dulu)
    ❌ POS Biasa (Skip dulu)
  • Untuk Bisnis Established:
    ✅ POS R LN (Pilihan utama)
    ✅ POS EMS (Premium service)
    ✅ POS Cepat (Mid-tier)
    ✅ POS Biasa (Budget option)
Pertimbangan Aktivasi:
  • 📊 Volume Order: Sesuaikan dengan demand
  • 💰 Profit Margin: Pastikan menguntungkan
  • 🎯 Target Market: Sesuai preferensi customer
  • 🚚 Operational Capacity: Sanggup handle service level

6. Troubleshooting 🔧

Masalah Umum dan Solusi:
  • Ongkir Tidak Muncul untuk Alamat Internasional:
    • Penyebab:
      • International shipping belum diaktifkan
      • Alamat tidak terdeteksi sebagai internasional
      • API POS International bermasalah
    • Solusi:
      • Centang "Aktifkan international shipping"
      • Pastikan format alamat benar (include country)
      • Cek koneksi API dan refresh
  • Estimasi Pengiriman Tidak Akurat:
    • Penyebab:
      • Database estimasi belum terupdate
      • Negara tujuan tidak dalam coverage
      • Hari libur/customs delay tidak diperhitungkan
    • Solusi:
      • Update plugin ke versi terbaru
      • Tambahkan buffer time dalam komunikasi
      • Set expectation customer tentang customs delay
  • Biaya Tambahan Tidak Terhitung:
    • Penyebab:
      • Input tambahan biaya salah format
      • Conflict dengan plugin lain
      • Cache tidak ter-refresh
    • Solusi:
      • Input angka tanpa separator (50000 bukan 50.000)
      • Disable plugin konflik sementara
      • Clear cache website dan browser
Instant Courier Tab

Instant Courier: Layanan Pengiriman Instan ⚡

1. Mengaktifkan Instant Courier 🚀

  • Centang kotak "Aktifkan instant courier"
  • Fitur ini mengaktifkan opsi pengiriman instan di checkout
  • Khusus untuk pengiriman dalam kota/area terbatas
Manfaat Instant Courier:
  • Same Day Delivery - Barang sampai hari yang sama
  • Competitive Advantage - Unggul dari kompetitor
  • Customer Satisfaction - Pelanggan lebih puas
  • Emergency Orders - Cocok untuk kebutuhan mendesak
  • Premium Service - Dapat dikenakan biaya premium
Target Market:
  • 🍕 Food & Beverage - Makanan, minuman, kue
  • 💊 Farmasi - Obat-obatan, vitamin, kesehatan
  • 📱 Elektronik - Aksesori HP, charger, headset
  • 👗 Fashion - Pakaian untuk acara mendadak
  • 📚 Stationery - Alat tulis, buku untuk pelajar
  • 🎁 Gift Items - Hadiah last minute

2. Memilih Kurir Instant 🏍️

Kurir yang Tersedia:
  • Paxel (GoSend/Gojek):
    • Layanan: GoSend (Gojek)
    • Coverage: Jakarta, Bandung, Surabaya, dan kota besar lainnya
    • Kapasitas: Maksimal 20kg per pengiriman
    • Estimasi: 1-3 jam dalam kota
    • Kelebihan: Terintegrasi dengan ekosistem Gojek, driver banyak dan tersebar, real-time tracking via aplikasi
  • Kurir Instant Lainnya (Future Update):
    • AnterAja - Same day delivery
    • Borzo (ex-WeFast) - On-demand courier
    • Deliveree - Logistics instant
    • Lalamove - Same day delivery
Strategi Pemilihan:
Area Jakarta → Paxel (GoSend) ✅
Area Bandung → Paxel + Local courier
Area Surabaya → Paxel + Regional partner
Area Lainnya → Tunggu ekspansi kurir

3. Google Maps API Key - Setup Lengkap 🗺️

Mengapa Butuh Google Maps API?
  • Kalkulasi Jarak - Menghitung jarak antar lokasi
  • Estimasi Waktu - Prediksi waktu tempuh
  • Validasi Alamat - Memastikan alamat valid
  • Interactive Map - Tampilan peta di admin panel
Langkah Mendapatkan API Key:
  1. Akses Google Cloud Console, login, dan buat project baru atau pilih existing
  2. Enable APIs: Maps JavaScript API, Places API, Geocoding API, Distance Matrix API, Directions API
  3. Buat API Key di Credentials, lalu restrict key untuk keamanan (HTTP referrers, domain website, pilih APIs yang diperlukan)
  4. Setup billing (Google Maps API memerlukan billing, $200 free credit per bulan)
Alternatif Tutorial API Key: Referensi Lengkap
Format API Key:
AIzaSyBH8uYv1gCxTtgJj8hJ2-nZV4XxGxG
Keamanan API Key:
  • Jangan share API key di public repository
  • Set domain restrictions
  • Monitor usage secara berkala
  • Rotate key jika diperlukan

4. Konfigurasi Koordinat Lokasi 📍

Pengisian Latitude dan Longitude:
  • Manual Input:
    Jakarta Pusat:
    Latitude: -6.175407
    Longitude: 106.827153
    
    Bandung:
    Latitude: -6.917464
    Longitude: 107.619123
    
    Surabaya:
    Latitude: -7.257472
    Longitude: 112.752090
  • Drag & Drop di Maps:
    1. Input Google Maps API Key
    2. Klik Save Changes
    3. Google Maps akan muncul di halaman
    4. Drag marker merah ke lokasi yang diinginkan
    5. Koordinat akan update otomatis
Tips Menentukan Koordinat:
  • Lokasi Toko/Gudang - Titik pengambilan barang
  • Area Strategis - Dekat dengan hub kurir
  • Akses Mudah - Lokasi yang mudah dijangkau driver
  • Parking Available - Ada tempat parkir untuk kurir

5. Pengaturan Alamat Detail 🏠

Format Alamat Lengkap:
Contoh Input:
Jl. Jendral Sudirman No. 380, RT.007/RW.005, Menghang,
Kiamet Ujing Kab Belara, Kota Jakarta

Komponen:
✅ Nama Jalan + Nomor
✅ RT/RW (jika ada)
✅ Kelurahan/Desa
✅ Kecamatan
✅ Kota/Kabupaten
✅ Kode Pos (opsional)
Pentingnya Alamat Detail:
  • Akurasi Pengiriman - Driver mudah menemukan lokasi
  • Estimasi Tepat - Kalkulasi waktu tempuh akurat
  • Komunikasi - Referensi jelas untuk driver
  • Geocoding - Google Maps bisa memvalidasi
Auto-Update Feature:
  • Setelah input alamat dan Save Changes: Latitude & Longitude update otomatis, marker di peta pindah ke lokasi baru, validasi alamat oleh Google Maps API

6. Interactive Google Maps Interface 🗺️

Tampilan Setelah Setup API Key:
  • Sebelum API Key:
    [ Google Maps API Key ] [____________________]
    [ Latitude            ] [____________________]
    [ Longitude           ] [____________________]
    [ Alamat              ] [____________________]
    
    Google Maps: "Maps akan tampil disini, harap melakukan
                setup Google Maps API Key terlebih dahulu"
  • Setelah API Key & Save:
    [ Google Maps API Key ] [AIzaSyBH8uYv1gCxTt...]
    [ Latitude            ] [-6.2480500000001]
    [ Longitude           ] [106.99002001]
    [ Alamat              ] [Jl. Jendral Sudirman...]
    
    📍 [Interactive Google Maps dengan marker]
       - Zoom controls
       - Street view
       - Satelit view
       - Draggable marker
Fitur Interactive Maps:
  • Zoom In/Out - Detail area sekitar
  • Map Types - Road, Satellite, Hybrid
  • Draggable Marker - Ubah posisi dengan drag
  • Street View - Lihat kondisi lokasi real
  • Search Box - Cari alamat langsung di map

7. Troubleshooting Common Issues 🔧

API Key Issues:
  • Error: "This API key is not authorized"
    • Cek domain restrictions di Google Cloud Console
    • Pastikan domain website sudah ditambahkan
    • Verifikasi API key tidak expired
  • Error: "Maps failed to load"
    • Cek billing account status
    • Pastikan APIs sudah di-enable
    • Clear browser cache
    • Test dengan API key baru
Coordinate Issues:
  • Marker di lokasi salah:
    • Drag marker ke posisi yang benar
    • Input alamat lebih detail
    • Gunakan landmark terkenal sebagai referensi
    • Cross-check dengan Google Maps manual
  • Koordinat tidak update:
    • Pastikan sudah Save Changes
    • Refresh halaman admin
    • Clear plugin cache
    • Cek JavaScript console untuk error
Integration Issues:
  • Instant courier tidak muncul di checkout:
    • Pastikan checkbox "Aktifkan instant courier" tercentang
    • Cek coverage area vs alamat customer
    • Verifikasi API key valid
    • Test dengan alamat dalam radius coverage
  • Ongkir tidak terhitung:
    • Cek koneksi API kurir instant
    • Pastikan koordinat sudah benar
    • Verifikasi alamat customer valid
    • Monitor API rate limits
Asuransi Tab

Tab Asuransi - Perlindungan Pengiriman Produk 🛡️

1. Mengaktifkan Fitur Asuransi 🔐

  • Centang kotak "Aktifkan ke semua produk"
  • Ketika diaktifkan, semua produk otomatis akan diasuransikan
  • Pengaturan ini akan diabaikan jika metapost diaktifkan secara individual
Manfaat Fitur Asuransi:
  • Untuk Merchant/Penjual:
    • ✅ Perlindungan Finansial - Terhindar dari kerugian barang hilang/rusak
    • ✅ Kepercayaan Customer - Pelanggan merasa lebih aman berbelanja
    • ✅ Competitive Advantage - Differensiasi dari kompetitor
    • ✅ Risk Management - Mengurangi risiko bisnis
    • ✅ Professional Image - Terlihat lebih profesional dan terpercaya
  • Untuk Customer/Pembeli:
    • ✅ Peace of Mind - Tenang saat berbelanja produk mahal
    • ✅ Ganti Rugi - Mendapat kompensasi jika terjadi masalah
    • ✅ Quality Assurance - Yakin produk akan sampai dengan selamat
    • ✅ Trust Building - Percaya terhadap seller
Kapan Mengaktifkan Asuransi:
  • WAJIB Aktifkan untuk:
    • 💎 Produk High Value (>Rp 500.000)
    • 📱 Elektronik (HP, laptop, gadget)
    • 💍 Perhiasan (emas, berlian, jam tangan mewah)
    • 🎨 Karya Seni (lukisan, kerajinan unik)
    • 📸 Kamera & Lensa (peralatan fotografi)
    • 💄 Kosmetik Premium (skincare mahal)
  • OPSIONAL untuk:
    • 👕 Fashion (pakaian, sepatu, tas)
    • 📚 Buku & Stationery (nilai rendah)
    • 🏠 Home & Living (dekorasi, peralatan rumah)
    • 🍔 Food & Beverage (makanan, minuman)

2. Label Asuransi - Customisasi Tampilan 🏷️

Pengaturan Label Asuransi:
Default: "Asuransikan produk ini seharga {harga} ?"
Custom: "Lindungi pembelian Anda dengan asuransi {harga}"
Parameter Wajib:
  • {harga} - TIDAK BOLEH dihapus dari label
  • Parameter ini akan diganti otomatis dengan nilai asuransi yang dihitung
  • Sistem akan error jika parameter ini dihilangkan
Contoh Variasi Label Kreatif:
  • Formal & Professional:
    "Asuransikan produk ini seharga {harga} untuk perlindungan optimal"
    "Tambahkan asuransi {harga} untuk keamanan pengiriman"
    "Proteksi pengiriman dengan asuransi senilai {harga}"
  • Friendly & Personal:
    "Lindungi belanjaan kamu dengan asuransi {harga} yuk!"
    "Amankan produk ini dengan asuransi cuma {harga} aja"
    "Supaya tenang, tambah asuransi {harga} boleh kan?"
  • Benefit-Focused:
    "Dapatkan ganti rugi 100% dengan asuransi {harga}"
    "Jaminan uang kembali dengan asuransi {harga}"
    "Bebas worry dengan proteksi {harga} saja"
Best Practices Label:
  • 📝 Gunakan bahasa yang mudah dipahami
  • 💡 Jelaskan benefit secara singkat
  • 🎯 Target emotional connection
  • ⚡ Call-to-action yang persuasif
  • 🔢 Tetap sertakan parameter {harga}

3. Label Asuransi Wajib - Produk Berisiko Tinggi ⚠️

Konsep Asuransi Wajib:
  • Untuk produk tertentu, asuransi TIDAK OPSIONAL
  • Customer HARUS membeli asuransi
  • Tidak ada pilihan untuk skip asuransi
Pengaturan Label Asuransi Wajib:
Default: "Produk ini di asuransikan seharga {harga}."
Custom: "Asuransi wajib untuk produk ini: {harga}"
Contoh Variasi Label Wajib:
  • Informative:
    "Produk ini dilengkapi asuransi wajib senilai {harga}"
    "Asuransi {harga} sudah termasuk untuk keamanan produk"
    "Perlindungan wajib: Asuransi {harga} otomatis ditambahkan"
  • Reassuring:
    "Tenang! Produk ini sudah diasuransikan {harga} untuk Anda"
    "Sudah terproteksi dengan asuransi {harga} secara otomatis"
    "Dijamin aman dengan asuransi wajib {harga}"
  • Value-Focused:
    "Nikmati proteksi premium dengan asuransi {harga}"
    "Investasi keamanan terbaik: Asuransi {harga}"
    "Proteksi maksimal hanya dengan {harga} tambahan"
Kriteria Produk Asuransi Wajib:
  • Kategori High-Risk:
    • 💎 Perhiasan >Rp 1.000.000
    • 📱 Smartphone >Rp 3.000.000
    • 💻 Laptop >Rp 5.000.000
    • 📸 Kamera >Rp 2.000.000
    • ⌚ Jam Tangan Mewah >Rp 2.000.000
  • Kriteria Berdasarkan:
    • 💰 Nilai Produk (>batas tertentu)
    • 📦 Tingkat Fragility (mudah pecah/rusak)
    • 🎯 Target Pencurian (barang yang sering dicuri)
    • 🚚 Kompleksitas Pengiriman (butuh handling khusus)

4. Formula Asuransi - Perhitungan Biaya 📊

Memahami Formula Asuransi:
Formula: 0.05 = 5% dari harga produk
Contoh: Produk Rp 100.000 → Asuransi = Rp 5.000
Variasi Formula Berdasarkan Nilai Produk:
  • Kategori Low Value (Rp 50.000 - Rp 200.000):
    Formula: 0.02 (2%)
    Rasionale: Risiko rendah, profit margin tetap sehat
    Contoh: Produk Rp 100.000 → Asuransi Rp 2.000
  • Kategori Medium Value (Rp 200.000 - Rp 1.000.000):
    Formula: 0.03 (3%)
    Rasionale: Balanced antara affordability dan protection
    Contoh: Produk Rp 500.000 → Asuransi Rp 15.000
  • Kategori High Value (Rp 1.000.000 - Rp 5.000.000):
    Formula: 0.05 (5%)
    Rasionale: Risiko tinggi, customer willing to pay premium
    Contoh: Produk Rp 2.000.000 → Asuransi Rp 100.000
  • Kategori Ultra High Value (>Rp 5.000.000):
    Formula: 0.08 (8%)
    Rasionale: Risiko sangat tinggi, butuh proteksi maksimal
    Contoh: Produk Rp 10.000.000 → Asuransi Rp 800.000
Pertimbangan dalam Menentukan Formula:
  • Faktor Internal:
    • 💰 Profit Margin - Jangan sampai asuransi makan profit
    • 📊 Historical Loss - Data kerugian sebelumnya
    • 🎯 Target Market - Daya beli customer segment
    • 🏆 Competitive Position - Bandingkan dengan kompetitor
  • Faktor Eksternal:
    • 🚚 Kurir Reliability - Track record kurir
    • 📍 Destination Risk - Area tujuan pengiriman
    • 🌦️ Seasonal Factor - Musim hujan, hari raya
    • 📈 Economic Condition - Kondisi ekonomi makro
Formula Dinamis (Advanced):
// Contoh implementasi formula dinamis
if (productValue < 200000) {
    insuranceRate = 0.02; // 2%
} else if (productValue < 1000000) {
    insuranceRate = 0.03; // 3%
} else if (productValue < 5000000) {
    insuranceRate = 0.05; // 5%
} else {
    insuranceRate = 0.08; // 8%
}

5. Penambahan Formula Asuransi - Biaya Flat 💰

Konsep Penambahan Formula:
  • Biaya FLAT yang ditambahkan ke perhitungan persentase
  • Berguna untuk coverage biaya operasional asuransi
  • Memastikan minimum profit dari layanan asuransi
Contoh Implementasi:
Produk: Rp 100.000
Formula: 0.05 (5%)
Penambahan: Rp 5.000

Perhitungan:
= (Rp 100.000 × 0.05) + Rp 5.000
= Rp 5.000 + Rp 5.000
= Rp 10.000

Total Asuransi: Rp 10.000
Strategi Penambahan Berdasarkan Kategori:
  • Untuk Produk Murah (Penambahan: Rp 2.000-3.000 Tujuan: Minimum coverage administrative cost
  • Untuk Produk Menengah (Rp 100.000-500.000):
    Penambahan: Rp 5.000-8.000
    Tujuan: Operational cost + reasonable profit
  • Untuk Produk Mahal (>Rp 500.000):
    Penambahan: Rp 10.000-15.000
    Tujuan: Premium service fee + handling cost
Use Cases Penambahan Formula:
  • Administrative Fee:
    • 📋 Processing cost untuk klaim asuransi
    • 📞 Customer service cost
    • 📊 Documentation & reporting
  • Operational Cost:
    • 📦 Special packaging untuk produk berasuransi
    • 🏷️ Labeling & marking khusus
    • 📸 Photo documentation
  • Risk Buffer:
    • 📈 Inflation hedge
    • 🎯 Unexpected cost coverage
    • 💼 Profit margin guarantee
Cek Ongkir Tab

Cek Ongkir: Fitur Pengecekan Ongkos Kirim 🔍

Tab Cek Ongkir - Fitur Pengecekan Ongkos Kirim

Fitur Cek Ongkir memungkinkan customer untuk mengecek estimasi biaya pengiriman sebelum melakukan pembelian. Fitur ini akan menampilkan kalkulator ongkir di halaman produk, sehingga customer dapat mengetahui total biaya pengiriman dari toko ke alamat tujuan mereka.


1. Mengaktifkan Fitur Cek Ongkir ✅

  1. Centang kotak "Aktifkan cek ongkir di halaman produk"
  2. Fitur ini akan menambahkan widget cek ongkir di setiap halaman produk
  3. Customer dapat input kode pos tujuan untuk cek estimasi ongkir
Status Aktivasi:
  • Aktif: Widget cek ongkir muncul di halaman produk
  • Nonaktif: Tidak ada fitur cek ongkir di halaman produk
Manfaat Fitur Cek Ongkir:
  • Transparansi Harga - Customer tahu total biaya sebelum checkout
  • Reduce Cart Abandonment - Tidak ada kejutan biaya di checkout
  • Better User Experience - Informasi lengkap di halaman produk
  • Increase Conversion - Customer lebih yakin untuk membeli
  • Competitive Advantage - Fitur yang tidak semua toko punya

2. Konfigurasi Label Cek Ongkir 🏷️

Pengaturan Label:
Default: "Cek Ongkir"
Custom Examples:
- "Estimasi Ongkos Kirim"
- "Cek Biaya Pengiriman"
- "Hitung Ongkir ke Alamat Anda"
- "Estimasi Biaya Kirim"
Fungsi Label:
  • Heading/Title untuk widget cek ongkir
  • Muncul di atas form input kode pos
  • Memberikan instruksi kepada customer
Best Practices Label:
  • 📝 Gunakan bahasa yang jelas dan mudah dipahami
  • 🎯 Buat call-to-action yang menarik
  • 💡 Singkat tapi informatif
  • 🇮🇩 Sesuaikan dengan target audience
Contoh Variasi Label Kreatif:
  • Formal & Professional:
    "Estimasi Biaya Pengiriman"
    "Kalkulasi Ongkos Kirim"
    "Cek Tarif Pengiriman"
  • Friendly & Casual:
    "Cek Ongkir Yuk!"
    "Berapa Ongkir ke Tempat Kamu?"
    "Hitung Ongkir Dulu"
  • Benefit-Focused:
    "Cek Ongkir Gratis Tanpa Daftar"
    "Estimasi Ongkir Real-time"
    "Cek Ongkir Akurat & Cepat"

3. Troubleshooting 🔧

Masalah Umum dan Solusi:
  • Widget Tidak Muncul di Halaman Produk:
    • Penyebab:
      • Fitur belum diaktifkan
      • Theme conflict
      • Plugin conflict
    • Solusi:
      • Centang "Aktifkan cek ongkir di halaman produk"
      • Test dengan theme default
      • Disable plugin lain sementara
  • Hasil Ongkir Tidak Akurat:
    • Penyebab:
      • Cache lama belum ter-refresh
      • API kurir bermasalah
      • Setting berat produk salah
    • Solusi:
      • Clear cache plugin dan website
      • Check API status kurir
      • Verifikasi berat dan dimensi produk
  • Performance Lambat:
    • Penyebab:
      • Terlalu banyak request API
      • Database query tidak optimal
      • Hosting resource terbatas
    • Solusi:
      • Implement caching mechanism
      • Optimize database queries
      • Upgrade hosting package
Tracking Tab

Tracking: Fitur Pelacakan Pengiriman 📦

Tab Tracking - Fitur Pelacakan Pengiriman

Tab Tracking memungkinkan Anda mengkonfigurasi sistem pelacakan pengiriman yang terintegrasi dengan toko online. Fitur ini memberikan kemudahan bagi customer untuk melacak status pengiriman melalui button tracking dan notifikasi otomatis.


1. Button Tracking 🔘

Konfigurasi Button Tracking:
  • Field: Button Tracking
  • Default Value: "Lacak Pesanan"
  • Text pada button tracking di halaman My Account dan detail order customer
  • Button muncul otomatis setelah status order "Processing" atau "Shipped"
  • Customer klik button untuk membuka halaman tracking (redirect ke sistem kurir atau halaman internal)
Contoh Kustomisasi Label:
"Lacak Pesanan"
"Track Pengiriman"
"Cek Status Kiriman"
"Lihat Progress Pengiriman"
"Pantau Pengiriman Anda"

2. Pesan Tracking 📧

Konfigurasi Template Pesan:
  • Field: Pesan Tracking
  • Template default:
    Pesanan Anda dikirimkan melalui: [agenwebsite_tracking_title] 
    Nomor resi untuk pesanan Anda: [agenwebsite_tracking_number]
  • Shortcode tersedia:
    • [agenwebsite_tracking_title]: Nama kurir pengiriman (JNE, TIKI, POS, dll)
    • [agenwebsite_tracking_number]: Nomor resi pengiriman
Template Kustomisasi:
  • Formal:
    Pesanan Anda telah dikirim menggunakan kurir [agenwebsite_tracking_title].
    Nomor resi: [agenwebsite_tracking_number]
    Silakan gunakan nomor tersebut untuk melacak status pengiriman.
  • Friendly:
    Good news! Pesanan kamu sudah dikirim via [agenwebsite_tracking_title] 🚚
    Resi number: [agenwebsite_tracking_number]
    Yuk lacak paketmu dengan nomor di atas!
  • Informatif:
    📦 STATUS UPDATE: Pesanan telah dikirim
    🚚 Kurir: [agenwebsite_tracking_title]
    📋 No. Resi: [agenwebsite_tracking_number]
    ⏰ Estimasi tiba: 2-3 hari kerja
    🔍 Lacak di: www.kurir.com

3. Lokasi Tampilan Pesan 📍

  • My Account Page: Section "Orders" di dashboard customer, tampil saat klik "View" pada order shipped
  • View Order Detail: Halaman detail order individual, menampilkan full tracking info
  • Email Notifications: Email "Order Shipped" otomatis, email tracking update, email delivery confirmation
  • Order Status Page: Halaman khusus tracking dengan order ID, public access, real-time updates

4. Shortcode Implementation 🔧

Cara Kerja Shortcode:
  • Data Source:
    [agenwebsite_tracking_title] → order meta "shipping_method"
    [agenwebsite_tracking_number] → order meta "tracking_number"
  • Fallback Values:
    Jika tracking_title kosong → "Kurir Pengiriman"
    Jika tracking_number kosong → "Belum tersedia"
Advanced Template Example:
<?php if (!empty($tracking_number)): ?>
Pesanan dikirim via <strong>[agenwebsite_tracking_title]</strong><br/>
Resi: <strong>[agenwebsite_tracking_number]</strong>
<?php else: ?>
Pesanan sedang diproses untuk pengiriman.
<?php endif; ?>
Dengan Link Tracking:
Pesanan dikirim melalui: [agenwebsite_tracking_title]
Lacak Resi: [agenwebsite_tracking_number]

5. Troubleshooting 🔧

Masalah Umum dan Solusi:
  • Shortcode Tidak Berfungsi: Shortcode muncul sebagai teks, cek registrasi shortcode, plugin conflict, theme compatibility
  • Tracking Info Tidak Muncul: Data order meta tidak tersimpan, typo shortcode, cek database
  • Email Template Tidak Terkirim: Cek SMTP, email template, spam filter

6. Best Practices 💡

  • Gunakan bahasa yang jelas dan ramah
  • Include semua informasi penting
  • Test template dengan data real
  • Mobile-friendly formatting
  • Include call-to-action
  • Jangan terlalu panjang, hindari jargon teknis, jangan hardcode nama kurir
  • Kirim tracking dalam 24 jam setelah shipped, gunakan multi-channel (Email, SMS, WhatsApp)
  • Berikan customer support untuk masalah tracking

Success Metric: Customer dapat easily track orders dan mendapat informasi tracking yang akurat dan up-to-date.