Panduan Mengaktifkan Asuransi Pengiriman Melalui API Biteship – Pusat Bantuan

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 menjelaskan cara mengaktifkan asuransi pengiriman menggunakan API Biteship, termasuk parameter yang digunakan, contoh request, cara mengecek status asuransi, dan informasi biaya 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, tambahkan parameter courier_insurance saat membuat order pengiriman.

Parameter yang Digunakan dalam API

Parameter	Tipe Data	Deskripsi
`courier_insurance`	Integer	Nilai barang yang akan diasuransikan dalam Rupiah.

3. Contoh Request API untuk Mengaktifkan Asuransi

Gunakan endpoint order creation POST /orders dengan parameter courier_insurance seperti berikut:

{
  "courier_insurance": 15000000
}

📌 Penjelasan:

courier_insurance: 15000000 berarti nilai barang yang diasuransikan adalah Rp15.000.000.

4. Response API dengan Asuransi Aktif

Jika order berhasil dibuat, response API akan mencantumkan detail asuransi pada objek courier.insurance.

{
  "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:

amount menunjukkan nilai barang yang diasuransikan.
fee menunjukkan biaya asuransi yang dihitung sesuai tarif yang berlaku.
Total biaya pengiriman akan mencakup biaya asuransi.

5. Cara Mengecek Status Asuransi pada Order

Untuk mengecek apakah pesanan sudah memiliki asuransi, gunakan endpoint GET /orders/{order_id} untuk mengambil detail order.

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

Jika asuransi aktif, response akan menampilkan informasi asuransi seperti berikut:

{
  "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 sekitar 0,5% tergantung kebijakan kurir.

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

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

7. Pertanyaan Umum tentang Asuransi API Biteship

Apakah asuransi bisa diaktifkan setelah pesanan dibuat?

Tidak, asuransi harus diaktifkan saat pertama kali pesanan dibuat. Jika pesanan sudah diproses tanpa asuransi, 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 membantu bisnis menambahkan perlindungan barang secara otomatis dalam proses pembuatan order.

Langkah utama untuk mengaktifkan asuransi melalui API:

Masukkan parameter courier_insurance sesuai 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.