Mengapa Kurir Instant Tidak Muncul di Response API atau Halaman Checkout?

Kurir Instant (seperti GoSend, GrabExpress, dan Lalamove) adalah layanan pengiriman yang mengandalkan kurir on-demand untuk mengantarkan barang dalam waktu cepat. Namun, dalam beberapa kasus, opsi kurir instant mungkin tidak muncul di response API atau halaman checkout website. Hal ini dapat disebabkan oleh berbagai faktor teknis dan operasional. Artikel ini akan membahas penyebab utama serta solusi untuk mengatasi masalah ini.

1. Lokasi Pengiriman Tidak Didukung oleh Kurir

Penyebab:

Kurir instant hanya tersedia di area tertentu yang didukung oleh masing-masing layanan (misalnya, kota besar seperti Jakarta, Surabaya, dan Bandung). Jika alamat tujuan berada di luar area layanan mereka, opsi kurir instant tidak akan muncul.

Solusi:

• Pastikan alamat asal dan tujuan berada dalam cakupan area layanan kurir.
• Periksa daftar wilayah yang didukung oleh kurir seperti GoSend, GrabExpress, atau Lalamove.
• Gunakan API Check Coverage dari Biteship untuk memverifikasi apakah alamat bisa dijangkau oleh kurir instant.

2. Layanan Kurir Instant Tidak Aktif di Pengaturan API atau Shopify

Penyebab:

Jika layanan kurir instant tidak diaktifkan di pengaturan API Biteship atau tidak dikonfigurasi di Shopify, opsi ini tidak akan muncul dalam response API maupun di halaman checkout.

Solusi:

• Untuk API Biteship:
  • Masuk ke Dashboard Biteship → Pengaturan Kurir.
  • Pastikan layanan kurir instant sudah diaktifkan.
  • Sinkronisasi Alamat Asal, pastikan Anda sudah melakukan sync alamat Shopify Anda dengan Biteship guna untuk kelancaran titik pada lokasi asal.
• Untuk Shopify:
  • Masuk ke Settings → Shipping and Delivery.
  • Pastikan Instant Courier tersedia dalam opsi pengiriman yang terhubung ke Biteship.
• Lakukan sinkronisasi ulang atau refresh halaman checkout setelah perubahan dilakukan.

3. Berat atau Dimensi Paket Tidak Sesuai dengan Ketentuan Kurir

Penyebab:

Kurir instant memiliki batasan berat dan dimensi untuk paket yang bisa mereka antar. Jika barang melebihi batasan, layanan kurir tidak akan tersedia.

Solusi:

• Periksa berat dan dimensi produk di tempat ada
• Jika barang melebihi batasan, pertimbangkan untuk menggunakan kurir reguler atau layanan cargo.
• Untuk detail lebih lengkap mengenai layanan kurir, Anda dapat melihat pada link ini disini

4. API Rate Limit Shopify atau Biteship Terlampaui

Penyebab:

Jika terlalu banyak permintaan API dalam waktu singkat, Biteship dapat membatasi respons API, menyebabkan opsi pengiriman tidak muncul.

Solusi:

• Kurangi polling API secara berlebihan. Gunakan mekanisme caching atau webhook untuk mendapatkan update tarif.
• Tunggu beberapa saat, lalu coba kembali.
• Pastikan Anda tidak melebihi rate limit API Biteship (misalnya, 1000 requests per menit di production).

5. API Response Error atau Kegagalan Sinkronisasi

Penyebab:

Jika ada error dalam komunikasi antara Shopify dan API Biteship, layanan kurir instant mungkin tidak muncul.

Solusi:

• Periksa log API response di Biteship Dashboard atau gunakan Postman untuk menguji response API manual.
• Jika mendapatkan error 500 (Internal Server Error) atau 429 (Too Many Requests), coba ulang setelah beberapa saat.
• Hubungi support@biteship.com jika masalah berlanjut.

6. Batas Jarak Pengiriman Kurir Instant Terlampaui

Penyebab:

Kurir instant memiliki batas maksimal jarak pengiriman. Jika alamat tujuan berada di luar radius yang ditentukan oleh kurir, opsi pengiriman tidak akan tersedia.

Solusi:

• Pastikan jarak antara lokasi penjemputan dan tujuan tidak melebihi batas yang ditentukan.
• Jika perlu, gunakan layanan instant delivery dengan kendaraan yang lebih besar, seperti mobil atau van melalui Lalamove.
• Alternatif lain adalah menggunakan layanan pengiriman same-day atau next-day jika jarak terlalu jauh untuk kurir instant.
• Untuk detail lebih lengkap mengenai layanan kurir, Anda dapat melihat pada link ini disini

7. Layanan Kurir Instant Tidak Tersedia Saat Itu

Penyebab:

Beberapa layanan instant seperti GoSend dan GrabExpress memiliki jumlah kurir yang terbatas. Jika tidak ada kurir yang tersedia di area tertentu, layanan mungkin tidak muncul di API response atau checkout.

Solusi:

• Pastikan ada kurir yang tersedia dengan mencoba langsung dari aplikasi kurir terkait.
• Ulangi permintaan setelah beberapa menit atau coba pada jam operasional yang berbeda.

8. Opsi Pengiriman Tidak Dikaitkan dengan Zona Checkout pada Plugin

Penyebab:

Jika zona pengiriman Shopify tidak dikonfigurasi dengan benar, opsi kurir instant tidak akan muncul di checkout.

Solusi:

• Masuk ke settings plugin Anda, pastikan zona pengiriman sudah diatur dengan benar
• Pastikan Instant Courier termasuk dalam metode pengiriman yang tersedia di zona pengiriman pelanggan.

Kesimpulan

Jika layanan kurir instant tidak muncul di response API atau halaman checkout Shopify, periksa faktor berikut:

✅ Cek cakupan area layanan kurir
✅ Pastikan layanan kurir diaktifkan di API dan Shopify
✅ Periksa batasan berat dan dimensi paket
✅ Pastikan API tidak melebihi rate limit
✅ Pastikan layanan kurir tersedia saat itu
✅ Periksa zona pengiriman di Shopify

Jika masih mengalami kendala, silakan hubungi support@biteship.com untuk mendapatkan bantuan lebih lanjut.