API JNE untuk WooCommerce bisa dipakai membuat resi langsung dari daftar pesanan lewat AgenWebsite JNE Integration, ekstensi untuk AgenWebsite Shipping yang memakai kredensial akun JNE milik toko Anda sendiri: JNE Username, API Key, Kode Cabang, dan Kode Pelanggan. Resi yang terbit tercatat di akun JNE Anda, ongkirnya ditagih JNE ke akun itu, dan AgenWebsite tidak memotong biaya per resi.

Skenario yang biasanya membawa orang ke halaman ini: toko sudah punya kontrak dengan cabang JNE, sudah dapat kode pelanggan, kiriman 30 sampai 50 paket sehari, dan setiap sore ada satu orang yang kerjanya menyalin nama, alamat, dan nomor HP dari WooCommerce ke portal JNE, lalu menempel nomor resinya kembali ke pesanan. Satu paket dua menit. Lima puluh paket hampir dua jam, setiap hari, untuk pekerjaan yang tidak menambah apa pun.

πŸ’‘ Jawaban Singkat: Untuk membuat resi JNE dari WooCommerce dengan akun JNE sendiri, Anda butuh tiga hal: akun pelanggan JNE yang sudah diberi akses API (JNE Username, API Key, Kode Cabang, Kode Pelanggan), plugin AgenWebsite Shipping Lite atau PRO yang aktif, dan ekstensi AgenWebsite JNE Integration. Setelah kredensial diisi, tombol Create Shipment muncul di WooCommerce β†’ Orders, dan resi terbit dengan data pembeli yang sudah terisi.

Apa yang dibutuhkan dari JNE sebelum integrasi?

Ekstensi ini tidak punya akun JNE sendiri. Semua yang terjadi di dalamnya berjalan atas nama akun JNE Anda, jadi akun itulah yang harus ada lebih dulu.

Yang ditanyakan di halaman pengaturan plugin ada empat kolom, dan keempatnya diterbitkan oleh JNE, bukan oleh kami:

  • JNE Username dan API Key: identitas akses API akun Anda.
  • Kode Cabang (Branch Code), contohnya berformat seperti CGK000: cabang JNE tempat akun Anda terdaftar.
  • Kode Pelanggan (Customer Code): nomor pelanggan bisnis Anda di JNE. Inilah yang membuat kiriman tercatat sebagai milik toko Anda dan ditagihkan ke akun Anda.
  • Merchant ID: hanya kalau Anda ingin JNE menjemput paket (mode Pickup). Untuk mode Drop Off, kolom ini tidak muncul.

Cara mendapatkannya: hubungi kantor cabang atau account manager JNE yang menangani akun Anda, dan minta akses API untuk integrasi toko online. JNE menyediakan halaman Solusi Bisnis untuk pelanggan korporat. Soal berapa lama prosesnya dan syarat volume minimum, itu kebijakan JNE per cabang, dan saya tidak akan menebak di sini. Tanyakan langsung.

Yang sering terlewat: punya akun JNE reguler (yang dipakai kirim paket di counter) tidak sama dengan punya akses API. Keduanya memang akun pelanggan, tetapi API Key hanya diberikan setelah Anda memintanya. Kalau Anda belum tahu Kode Pelanggan Anda sendiri, hampir pasti akses API-nya juga belum ada.

Bedanya resi JNE dari akun sendiri vs Generate Resi bawaan

AgenWebsite Shipping sudah bisa membuat resi JNE tanpa ekstensi apa pun lewat fitur Generate Resi, memakai akun AgenWebsite dan saldo yang Anda isi. Jadi pertanyaan yang wajar: kalau sudah bisa, untuk apa ekstensi ini?

Jawabannya ada di siapa pemilik resinya. Generate Resi bawaan membuat resi atas nama akun AgenWebsite, ongkir dipotong dari saldo Anda di plugin, dan 14 kurir tersedia tanpa kontrak apa pun. JNE Integration membuat resi atas nama akun JNE Anda, ongkir ditagih JNE langsung sesuai kesepakatan Anda dengan cabang, dan hanya untuk JNE.

Hal Generate Resi bawaan Shipping Dengan JNE Integration
Akun pengirim Akun AgenWebsite Akun JNE milik Anda (Kode Pelanggan Anda)
Pembayaran ongkir Dipotong dari saldo di plugin Ditagih JNE ke akun Anda
Kurir 14 kurir dalam satu wallet Khusus JNE
Kontrak kurir Tidak perlu Perlu akun pelanggan JNE + akses API
Resi COD Tersedia untuk kurir tertentu Belum (non-COD saja)
Biaya dari AgenWebsite Mengikuti paket Shipping Lisensi ekstensi, 0% per resi
Cocok untuk Toko yang ingin langsung jalan Toko yang sudah punya kontrak JNE

Pilih Generate Resi bawaan kalau Anda belum punya kontrak JNE, kirim lewat beberapa kurir sekaligus, atau volumenya belum cukup untuk dinegosiasikan dengan cabang. Panduannya ada di artikel cara generate resi dari website.

Pilih JNE Integration kalau tarif kontrak Anda di JNE sudah lebih baik daripada tarif umum, bagian keuangan ingin satu tagihan JNE yang bisa direkonsiliasi, atau kebijakan perusahaan mengharuskan kiriman tercatat di akun sendiri. Untuk toko dengan 30 paket JNE sehari dan kontrak yang sudah berjalan bertahun-tahun, biasanya ini pilihan yang tidak perlu dipikir lama.

Dua-duanya bisa hidup berdampingan. Ekstensi ini hanya menangani pesanan JNE; pesanan SiCepat atau J&T di toko yang sama tetap memakai Generate Resi bawaan.

Cara menghubungkan akun JNE di WooCommerce

Prasyaratnya satu: AgenWebsite Shipping Lite atau PRO sudah aktif dan kurir JNE sudah tampil di checkout. Ekstensi ini membaca layanan JNE yang dipilih pembeli saat checkout, jadi tanpa Shipping ia tidak tahu pesanan mana yang JNE dan layanan apa yang dijanjikan ke pembeli.

  1. Pasang ekstensi. Unduh file plugin dari Akun Saya di agenwebsite.com, upload lewat Plugins β†’ Add New β†’ Upload Plugin, aktifkan, lalu masukkan kode lisensi di menu AgenWebsite JNE Integration. Satu lisensi untuk satu domain.
  2. Pilih environment Sandbox dulu. Di pengaturan ada pilihan API Environment: Sandbox atau Production. Mulai dari Sandbox untuk memastikan kredensial dibaca dengan benar, baru pindah ke Production saat siap kirim sungguhan.
  3. Isi kredensial JNE. JNE Username, API Key, Branch Code, dan Customer Code dari langkah sebelumnya. Lalu lengkapi data pengirim: nama toko, alamat, dan nomor telepon yang akan tercetak di resi.
  4. Tentukan Shipment Type. Drop Off kalau Anda mengantar paket sendiri ke agen JNE. Pickup Service kalau JNE menjemput; di mode ini kolom Merchant ID, alamat penjemputan, dan PIC (nama dan nomor telepon orang yang bisa dihubungi kurir) ikut muncul.
  5. Simpan, lalu buka WooCommerce β†’ Orders. Ada kolom baru bernama JNE Shipment. Pada pesanan yang pembelinya memilih JNE, tombol Create Shipment tersedia di kolom itu.

Dari sini alur hariannya pendek. Klik Create Shipment, jendela Review Order terbuka dengan penerima, pengirim, isi paket, SKU, dan berat yang sudah terisi dari pesanan. Layanan yang dipilih pembeli di checkout (OKE, REG, YES, atau JTR) sudah ditandai Customer Selected; layanan lain untuk rute itu tetap bisa dipilih, diurutkan dari yang termurah. Periksa, pilih jadwal pickup bila mode Pickup, lalu tekan Create Shipment. Nomor resi tersimpan di pesanan, status pesanan berganti otomatis (bawaan: Shipped), dan nomor itu tampil di halaman pelacakan pembeli lewat AgenWebsite Shipping.

Dua detail teknis yang dikerjakan plugin tanpa Anda sadari, dan bagus kalau Anda tahu. Berat produk dikonversi ke kilogram sesuai format JNE walau toko Anda memakai gram di WooCommerce. Nomor telepon pembeli yang ditulis +62812… atau 62812… diformat ulang ke 0812… karena sistem JNE memintanya begitu. Kalau resi gagal terbit, dua hal ini bukan penyebabnya; cek kembali kredensial dan alamat.

Soal tarif: daftar layanan di jendela Create Shipment menampilkan tarif umum JNE untuk rute tersebut, sebagai acuan memilih layanan. Itu bukan tarif kontrak Anda. Tagihan yang sesungguhnya mengikuti kesepakatan akun Anda dengan JNE, dan muncul di tagihan JNE, bukan di WooCommerce. Pertanyaan ini cukup sering masuk ke support kami dari toko yang kaget melihat angka di jendela lebih tinggi dari tarif kontraknya, jadi saya tulis di sini supaya tidak kaget.

Pickup terjadwal, lacak, dan batal

Dalam mode Pickup Service, jadwal penjemputan dipilih per pesanan saat membuat resi: hari ini, besok, atau lusa, dengan slot per jam dari pukul 07.00 sampai 21.00 WIB (15 slot). Jam yang sudah lewat otomatis dinonaktifkan, dan slot pertama yang masih tersedia terpilih sendiri. Sebelum pukul 20.00, tanggal hari ini yang terpilih; lewat jam itu, pilihan bergeser ke besok. Alamat dan PIC penjemputan diambil dari pengaturan, jadi tidak perlu diketik ulang setiap pesanan.

Dalam mode Drop Off, bagian jadwal tidak muncul sama sekali. Buat resi, cetak, antar ke agen JNE. Untuk mode ini ada juga bulk action Create JNE Shipments di daftar pesanan: centang banyak pesanan JNE, jalankan, dan resi dibuat satu per satu dengan layanan REG bila tersedia. Catatan: bulk action tidak mengirim jadwal pickup dan tidak mengubah status pesanan, jadi memang hanya masuk akal untuk toko yang mengantar sendiri.

Tombol Track di kolom JNE Shipment membuka jendela Tracking Information: nomor resi, status terakhir dari JNE, kode layanan, berat, kota asal dan tujuan, plus riwayat perjalanan paket dari yang terbaru. Data ini ditarik dari API pelacakan JNE dengan kredensial Anda, jadi pertanyaan “paket saya sudah sampai mana, Kak?” bisa dijawab tanpa membuka tab lain.

Pembeli batal setelah resi terbit, atau alamatnya salah? Tombol Cancel membatalkan airwaybill tersebut, dan pesanan menyimpan jejaknya: nomor AWB yang dibatalkan, siapa yang membatalkan, dan kapan. Badge di kolom berubah dari Active menjadi Cancelled. Kalau sudah dibatalkan dan ternyata pembeli jadi lagi, buat resi baru; resi yang sudah dibatalkan tidak bisa dihidupkan kembali.

Yang belum ada, supaya Anda tidak mencarinya: resi COD dan asuransi. JNE Integration saat ini membuat resi non-COD tanpa asuransi. Toko yang menerima COD lebih cocok memakai alur COD lewat Everpro Integration, yang memang dibangun untuk itu.

Pertanyaan yang Sering Diajukan

Apakah harus punya akun JNE bisnis?

Ya. Ekstensi ini membuat resi dengan Kode Pelanggan dan API Key akun JNE Anda, jadi tanpa akun pelanggan yang sudah diberi akses API tidak ada yang bisa dibuat. Kalau Anda belum punya, Generate Resi bawaan AgenWebsite Shipping tetap bisa membuat resi JNE memakai akun AgenWebsite dan saldo.

Apakah ada biaya per resi dari AgenWebsite?

Tidak ada. Biaya dari AgenWebsite untuk ekstensi ini hanya lisensinya; detail harga dan ketentuan lisensi ada di halaman produk. Ongkir setiap kiriman ditagih JNE ke akun Anda sesuai kesepakatan dengan cabang, tidak dipotong dari saldo AgenWebsite.

Bisa pickup terjadwal?

Bisa, dengan mode Pickup Service dan Merchant ID dari JNE. Jadwal dipilih per pesanan: hari ini, besok, atau lusa, slot per jam pukul 07.00 sampai 21.00 WIB. Tanpa Merchant ID, gunakan mode Drop Off dan antar paket ke agen JNE.

Apakah perlu AgenWebsite Shipping?

Ya, Lite atau PRO yang aktif. JNE Integration adalah ekstensi, bukan plugin yang berdiri sendiri: ia membaca layanan JNE yang dipilih pembeli di checkout AgenWebsite Shipping dan menampilkan nomor resi di halaman pelacakan pembeli lewat Shipping. Cara mengaktifkan JNE bersama kurir lain ada di panduan setup multi kurir.

Apakah tarif di jendela Create Shipment adalah tarif kontrak saya?

Tidak selalu. Jendela itu menampilkan tarif umum JNE untuk rute tersebut sebagai acuan memilih layanan. Tagihan akhir mengikuti kesepakatan akun JNE Anda dan tercantum di tagihan dari JNE.

Bisa dipakai di beberapa website?

Satu lisensi untuk satu website (domain). Toko kedua memerlukan lisensi terpisah, dan masing-masing bisa memakai akun JNE yang sama atau berbeda, tergantung pengaturan kredensialnya.

Urutan yang saya sarankan

Kalau akun JNE bisnis Anda belum punya akses API, mulailah dari sana, karena itu satu-satunya bagian yang tidak bisa dipercepat dari sisi kami. Sambil menunggu, pastikan AgenWebsite Shipping sudah aktif dan JNE sudah tampil di checkout, karena pembeli yang memilih JNE hari ini adalah pesanan yang nanti bisa Anda buat resinya dalam satu klik.

Begitu kredensial di tangan, isi di Sandbox, buat satu resi percobaan, lalu pindah ke Production. Dari pengalaman kami, pemasangan sampai resi pertama biasanya selesai dalam satu sesi kerja, dan yang paling lama justru menunggu balasan cabang JNE.

Detail fitur, harga lisensi, dan tombol beli ada di halaman AgenWebsite JNE Integration.