Gagal Generate Resi di WooCommerce? 7 Penyebab dan Cara Mengatasinya

Generate resi yang gagal di WooCommerce hampir selalu berasal dari tujuh hal: saldo tidak mencukupi, berat paket melebihi batas layanan kurir, alamat penerima tidak lengkap, alamat asal belum terdaftar untuk kurir tersebut, gangguan di sisi kurir, pesanan yang sudah punya resi, atau layanan yang tidak melayani rute tujuan. Pesan error yang muncul biasanya sudah menunjuk penyebabnya — asal tahu cara membacanya.

Berbeda dengan ongkir yang tidak muncul, kegagalan generate resi terjadi setelah uang masuk. Pesanan sudah dibayar, pembeli sudah menunggu, dan Anda tidak bisa mengirim paket sampai nomor resi terbit. Setiap jam yang lewat menambah kemungkinan pembeli menanyakan statusnya — atau membatalkan.

Baca pesan errornya dulu

Ini langkah yang paling sering dilewati. Saat generate resi gagal, sistem mengembalikan pesan dari kurir, dan pesan itu biasanya spesifik. Menyalin pesannya lalu mencocokkan dengan daftar di bawah jauh lebih cepat daripada mengubah setting satu per satu.

Kalau pesan yang muncul hanya berupa kode atau tulisan umum, buka detail pesanan dan lihat catatan pesanan (order notes). Percobaan generate resi biasanya meninggalkan jejak di sana lengkap dengan respons dari kurir.

Penyebab 1: Saldo tidak mencukupi

Generate resi memotong saldo untuk membayar ongkos kirim ke kurir. Kalau saldo kurang dari tarif paket tersebut, proses berhenti sebelum resi terbit.

Cara memperbaiki: isi ulang saldo, tunggu sampai statusnya tercatat, lalu ulangi generate resi. Perlu diingat bahwa saldo dipotong sebesar tarif kurir sesungguhnya, yang bisa berbeda dari ongkir yang dibayar pembeli kalau Anda menerapkan subsidi atau biaya admin.

Untuk toko dengan volume harian, biasakan menjaga saldo di atas kebutuhan dua sampai tiga hari. Saldo yang habis di tengah hari akan menahan seluruh antrean pengiriman sekaligus.

Penyebab 2: Berat melebihi batas layanan kurir

Setiap layanan punya batas berat dan dimensi. Layanan reguler umumnya berhenti di kisaran tertentu, dan di atas itu paket harus masuk layanan kargo.

Gejalanya: resi gagal hanya untuk pesanan besar, sementara pesanan kecil lancar.

Cara memperbaiki: ada dua pilihan. Pindahkan pesanan ke layanan kargo yang memang dirancang untuk barang berat, atau pecah menjadi beberapa paket dengan resi terpisah. Untuk barang besar tapi ringan, perhatikan juga berat volumetrik — kurir menghitung berdasarkan dimensi, sehingga bantal atau barang berongga bisa dihitung jauh lebih berat daripada timbangannya.

Penyebab 3: Alamat penerima tidak lengkap

Kurir membutuhkan alamat sampai tingkat kecamatan untuk menerbitkan resi. Alamat yang hanya sampai kota akan ditolak, meski pesanannya sudah berhasil dibuat.

Ini sering terjadi pada pesanan yang dibuat manual dari dashboard, atau pesanan yang masuk lewat jalur lain di luar checkout normal.

Cara memperbaiki: buka detail pesanan, lengkapi alamat penerima termasuk kecamatan dan kode pos, pastikan nomor telepon terisi dengan format yang benar, lalu ulangi generate resi. Nomor telepon yang kosong atau salah format juga bisa menggagalkan penerbitan resi pada sebagian kurir.

Penyebab 4: Alamat asal belum terdaftar untuk kurir tersebut

Alamat asal tidak cukup hanya diisi di pengaturan umum. Setiap kurir perlu mengenali titik asal Anda, dan alamat yang belum terdaftar untuk satu kurir akan menggagalkan resi khusus di kurir itu.

Gejalanya: resi berhasil di satu kurir tapi gagal di kurir lain untuk pesanan yang sama.

Cara memperbaiki: buka pengaturan plugin dan periksa daftar alamat asal. Pastikan alamat yang dipakai memang tersedia untuk kurir yang Anda pilih. Kalau Anda baru menambah gudang atau baru mengaktifkan kurir baru, pendaftaran origin perlu dilakukan sekali sebelum pengiriman pertama.

Penyebab 5: Gangguan di sisi kurir

Sistem kurir kadang mengalami gangguan atau pemeliharaan. Dalam kondisi ini permintaan resi ditolak meski semua data Anda sudah benar.

Gejalanya: kegagalan terjadi tiba-tiba pada semua pesanan di satu kurir, padahal sebelumnya lancar, dan biasanya disertai pesan error dengan kode server.

Cara memperbaiki: tunggu beberapa saat lalu coba lagi. Kalau pengiriman tidak bisa ditunda, alihkan pesanan ke kurir lain. Ini salah satu alasan mengaktifkan lebih dari satu kurir bukan sekadar soal pilihan harga bagi pembeli — kurir kedua adalah jalur cadangan operasional Anda.

Penyebab 6: Pesanan sudah punya resi

Satu pesanan hanya boleh punya satu resi aktif. Percobaan generate kedua akan ditolak, dan pesan errornya kadang terbaca seolah proses gagal total padahal resinya sudah ada.

Cara memperbaiki: periksa detail pesanan dan lihat apakah nomor resi sudah tercatat. Kalau sudah ada, tidak perlu generate ulang — cukup gunakan nomor yang ada. Kalau resi lama memang perlu dibatalkan, batalkan lebih dulu lewat menu yang tersedia sebelum menerbitkan yang baru.

Penyebab 7: Layanan tidak melayani rute tujuan

Layanan kilat, same-day, dan kurir instan punya cakupan wilayah yang jauh lebih sempit daripada layanan reguler. Ongkir bisa saja muncul di checkout, tapi penerbitan resi ditolak karena rutenya di luar jangkauan.

Cara memperbaiki: ganti ke layanan reguler untuk tujuan tersebut. Untuk mencegah terulang, batasi layanan kilat hanya pada zona pengiriman yang memang tercakup, sehingga pembeli di luar wilayah itu tidak bisa memilihnya sejak awal.

Kapan sebaiknya menghubungi support

Kalau tujuh penyebab di atas sudah diperiksa dan resi tetap gagal, siapkan tiga hal ini sebelum menghubungi support:

• Nomor pesanan yang gagal, bukan tangkapan layar daftar pesanan
• Pesan error persis yang muncul, disalin apa adanya
• Kurir dan layanan yang dipilih, beserta berat paketnya

Tiga informasi ini biasanya cukup untuk menelusuri log pengiriman dan menemukan penyebabnya tanpa perlu bolak-balik bertanya.

FAQ: Pertanyaan yang Sering Ditanyakan

Apakah saldo terpotong kalau generate resi gagal?

Tidak. Saldo hanya terpotong ketika resi benar-benar terbit. Kalau Anda melihat saldo berkurang tanpa resi yang muncul, itu kasus terpisah yang perlu diperiksa di riwayat saldo.

Kenapa resi berhasil di JNE tapi gagal di kurir lain?

Biasanya karena alamat asal belum terdaftar untuk kurir tersebut, atau karena layanan yang dipilih tidak melayani rute tujuan. Periksa daftar origin di pengaturan plugin dan coba layanan reguler sebagai pembanding.

Bisakah generate resi diulang setelah gagal?

Bisa. Perbaiki dulu penyebabnya — isi saldo, lengkapi alamat, atau ganti layanan — lalu ulangi dari detail pesanan. Percobaan yang gagal tidak meninggalkan resi menggantung.

Apakah ada mode uji coba untuk generate resi?

Tidak ada. Setiap generate resi langsung diteruskan ke sistem kurir dan saldo terpotong begitu resi terbit. Kalau ingin menguji alur, gunakan pesanan nyata bernilai kecil dengan tujuan terdekat.

Berat paket dihitung dari timbangan atau dimensi?

Kurir memakai mana yang lebih besar antara berat timbangan dan berat volumetrik yang dihitung dari dimensi. Untuk barang besar tapi ringan, berat volumetrik hampir selalu yang dipakai.

Kesimpulan

Kegagalan generate resi jarang berarti ada yang rusak. Sebagian besar kasus berhenti di data yang kurang lengkap atau batas layanan yang terlampaui, dan pesan error biasanya sudah menunjuk ke arah yang benar.

Mulai dari membaca pesannya, lalu periksa saldo, berat, dan kelengkapan alamat. Kalau kegagalan terjadi serempak di satu kurir, kemungkinan besar itu gangguan sementara — alihkan ke kurir cadangan dan lanjutkan pengiriman.

AgenWebsite Shipping mendukung 13 kurir Indonesia dengan generate resi satu klik langsung dari dashboard WordPress, memakai API pengiriman sendiri tanpa akun pihak ketiga. Sudah dipakai 900+ toko aktif dengan rating 4,6★ di WordPress.org. Coba gratis di sini.