Lewati ke konten utama

Panduan Mengaktifkan Asuransi Pengiriman Melalui API Biteship

Biteship

Biteship menyediakan layanan asuransi pengiriman yang dapat diaktifkan melalui API untuk memberikan perlindungan terhadap kehilangan atau kerusakan barang selama pengiriman. Dengan menggunakan fitur ini, bisnis dapat secara otomatis menambahkan asuransi ke dalam setiap pesanan tanpa harus mengaktifkannya secara manual melalui dashboard.

Artikel ini akan menjelaskan bagaimana cara mengaktifkan asuransi pengiriman menggunakan API Biteship, termasuk parameter yang digunakan, contoh request, dan cara mengecek status asuransi dalam response API.

 

1. Mengapa Mengaktifkan Asuransi Melalui API Biteship?

✅ Otomasi Penuh – Tidak perlu mengaktifkan asuransi secara manual di dashboard.
✅ Perlindungan Maksimal – Mengurangi risiko kerugian akibat kehilangan atau kerusakan barang.
✅ Meningkatkan Kepercayaan Pelanggan – Memberikan jaminan keamanan barang yang dikirim.
✅ Mudah Dikelola – Bisa diatur melalui request API dengan parameter sederhana.

 

2. Cara Mengaktifkan Asuransi dalam API Biteship

Untuk mengaktifkan asuransi dalam Biteship API, Anda perlu menambahkan parameter insurance dalam request API saat membuat order pengiriman.

📌 Parameter yang Digunakan dalam API

Berikut adalah parameter utama yang digunakan untuk mengaktifkan asuransi:

Parameter Tipe Data Deskripsi
courier_insuracnce Integer Nilai barang yang akan diasuransikan (dalam Rupiah)

 

3. Contoh Request API untuk Mengaktifkan Asuransi

Gunakan endpoint order creation (POST /orders) dengan parameter insurance seperti berikut:

{
  "courier_insurance": 50000
}

📌 Penjelasan:

  • courier_insurance: 15000000 → Nilai barang yang diasuransikan sebesar Rp15.000.000.

 

4. Response API dengan Asuransi Aktif

Jika order berhasil dibuat, response API akan mencantumkan detail asuransi:

{
  "id": "ORDER12345",
  ...,
  "courier": {
    "tracking_id": "6de509ebdefgh4158ij3451c",
    "waybill_id": null,
    "company": "anteraja",
    "driver_name": null,
    "driver_phone": null,
    "driver_photo_url": null,
    "driver_plate_number": null,
    "type": "reg",
    "link": null,
    "insurance": {
        "amount": 500000,
        "fee": 2500,
        "note": ""
    },
  },
  ...,
}

📌 Penjelasan Response:

  • Nilai barang yang diasuransikan (amount: 15000000)
  • Biaya asuransi (fee: 45000), dihitung sesuai persentase yang berlaku
  • Total biaya pengiriman mencakup biaya asuransi

 

5. Cara Mengecek Status Asuransi pada Order

Jika Anda ingin mengecek apakah pesanan tertentu sudah memiliki asuransi, gunakan GET /orders/{order_id} untuk mengambil detail order:

GET https://api.biteship.com/v1/orders/:order_id

📌 Jika asuransi aktif, response akan menampilkan informasi seperti ini:

{
  "id": "ORDER67890",
  "courier": {
    "tracking_id": "6de509ebdefgh4158ij3451c",
    "waybill_id": null,
    "company": "anteraja",
    "driver_name": null,
    "driver_phone": null,
    "driver_photo_url": null,
    "driver_plate_number": null,
    "type": "reg",
    "link": null,
    "insurance": {
        "amount": 500000,
        "fee": 2500,
        "note": ""
    },
}

 

6. Berapa Biaya Asuransi dalam API Biteship?

Biaya asuransi dihitung berdasarkan persentase dari nilai barang, biasanya berkisar 0,5% tergantung kebijakan kurir.

Nilai Barang (Rp) Tarif Asuransi (0,3%) Total Biaya Asuransi (Rp)
500.000 0,5% x 500.000 2.500
1.000.000 0,5% x 1.000.000 5.000
5.000.000 0,5% x 5.000.000 25.000

📌 Biaya ini akan otomatis dihitung oleh API berdasarkan nilai barang yang dimasukkan dalam request.

 

7. Pertanyaan Umum (FAQ)

❓ Apakah asuransi bisa diaktifkan setelah pesanan dibuat?

Tidak, asuransi harus diaktifkan saat pertama kali pesanan dibuat. Jika pesanan sudah diproses tanpa asuransi, tidak bisa ditambahkan kemudian.

❓ Bagaimana jika barang hilang atau rusak meskipun sudah diasuransikan?

Anda bisa mengajukan klaim ke Biteship dengan menyertakan dokumen pendukung. Hubungi support@biteship.com untuk proses klaim lebih lanjut. Cara pembuatan tiket disini.

❓ Apakah semua barang bisa diasuransikan?

Tidak, barang seperti makanan segar, bahan kimia, uang tunai, dan barang ilegal tidak dapat diasuransikan. Pastikan barang Anda memenuhi syarat sebelum mengaktifkan asuransi. Lihat list barang yang bisa diasuransikan disini

❓ Apakah bisa mengatur nilai asuransi berbeda dari nilai barang?

Tidak, nilai asuransi harus sesuai dengan nilai barang yang dimasukkan dalam order.

 

8. Kesimpulan

Mengaktifkan asuransi pengiriman melalui API Biteship sangat mudah dan memberikan perlindungan tambahan terhadap barang yang dikirim.

🔹 Langkah utama untuk mengaktifkan asuransi melalui API:

✅ Masukkan courier_insurance sesuai dengan nilai barang yang ingin diasuransikan.
✅ Cek response API untuk memastikan biaya asuransi telah dihitung dengan benar.
✅ Gunakan GET /v1/orders/{order_id} untuk mengecek status asuransi setelah order dibuat.

💡 Gunakan fitur ini untuk memastikan pengiriman lebih aman dan bisnis Anda lebih terlindungi!

📌 Jika Anda mengalami kendala dalam mengaktifkan asuransi via API, silakan hubungi support@biteship.com. 🚀

Terkait dengan

Artikel terkait