Dokumentasi AgenWebsite Everpro Integration

Panduan lengkap instalasi, konfigurasi, dan penggunaan plugin untuk integrasi 10+ ekspedisi Indonesia

Versi 1.5.0 Update terakhir: 15 November 2025 Waktu baca: ~30 menit

Pendahuluan

Selamat datang di dokumentasi AgenWebsite Everpro Integration! Plugin ini dirancang untuk membantu Anda mengelola pengiriman dari 10+ ekspedisi Indonesia dalam satu dashboard WooCommerce.

Apa yang Akan Anda Pelajari
  • Cara install dan aktivasi plugin dengan benar
  • Setup API Everpro dan konfigurasi credentials
  • Mengatur data pengirim dan memilih ekspedisi
  • Membuat resi pengiriman otomatis dari WooCommerce orders
  • Tracking paket dan menggunakan fitur bulk operations
  • Troubleshooting masalah umum yang mungkin terjadi

Tentang Plugin Ini

AgenWebsite Everpro Integration adalah plugin WooCommerce yang terintegrasi dengan Everpro API untuk memberikan akses ke berbagai ekspedisi pengiriman Indonesia seperti JNE, TIKI, J&T Express, SiCepat, AnterAja, Paxel, dan lainnya.

10+ Ekspedisi Terintegrasi

Akses semua kurir populer dalam satu plugin

Otomasi Penuh

Buat resi dan tracking otomatis

Perbandingan Tarif

Bandingkan ongkir semua kurir sekaligus

HPOS Compatible

Mendukung WooCommerce HPOS

Everpro Dashboard Overview

Gambar 1: Tampilan dashboard plugin Everpro Integration

Persyaratan Sistem

Sebelum menginstall plugin, pastikan website Anda memenuhi persyaratan teknis berikut:

WordPress

Versi 5.0 atau lebih baru

Required
WooCommerce

Versi 9.0 atau lebih baru

Required
PHP

Versi 7.4 atau lebih tinggi (PHP 8.0+ recommended)

Required
MySQL

Versi 5.6 atau MariaDB 10.0+

Required
HTTPS/SSL

Untuk keamanan API calls

Recommended
Everpro API Key

Credentials dari Everpro

Required
Perhatian!

Pastikan hosting Anda mendukung wp_remote_post() untuk API calls. Beberapa shared hosting membatasi fungsi ini. Hubungi provider hosting Anda jika tidak yakin.

Pengecekan Persyaratan

Anda dapat mengecek versi PHP dan WordPress dari dashboard admin:

WordPress Site Health Check

Gambar 2: Pengecekan di WordPress Site Health (Tools � Site Health)

Instalasi Plugin

Proses instalasi plugin sangat mudah dan hanya membutuhkan waktu sekitar 5-10 menit.

Step 1 Download Plugin

Setelah pembelian, Anda akan menerima email berisi link download dan license key.

  1. Login ke Member Area di agenwebsite.com
  2. Buka menu Downloads
  3. Cari AgenWebsite Everpro Integration
  4. Klik tombol Download untuk mendapatkan file .zip
Member Area Download

Gambar 3: Halaman download di Member Area

Tips: Simpan file .zip di lokasi yang mudah diingat. Anda akan menguploadnya ke WordPress di langkah berikutnya.

Step 2 Upload & Aktivasi Plugin

Upload file plugin ke WordPress dan aktivasi melalui dashboard admin.

  1. Login ke WordPress Admin Dashboard
  2. Buka menu Plugins � Add New
  3. Klik tombol Upload Plugin di bagian atas
  4. Klik Choose File dan pilih file .zip yang sudah didownload
  5. Klik Install Now dan tunggu proses upload selesai
  6. Setelah selesai, klik tombol Activate Plugin
Upload Plugin Screen

Gambar 4: Upload plugin melalui WordPress admin

Plugin Activation

Gambar 5: Plugin berhasil diaktifkan

Step 3 Aktivasi License Key

Aktivasi license key untuk mendapatkan update otomatis dan support.

  1. Setelah plugin aktif, buka menu WooCommerce � Everpro Settings
  2. Klik tab License
  3. Masukkan License Key yang Anda terima via email
  4. Klik tombol Activate License
  5. Tunggu hingga muncul notifikasi "License activated successfully"
License Activation Form

Gambar 6: Form aktivasi license key

Plugin Berhasil Terinstall!

Sekarang Anda siap untuk melakukan konfigurasi API dan pengaturan plugin. Lanjut ke bagian Setup API Everpro.

Setup API Everpro

Untuk menggunakan plugin, Anda perlu mendaftar di Everpro dan mendapatkan API credentials.

Step 1 Registrasi Akun Everpro

Daftar akun baru di platform Everpro untuk mendapatkan akses API.

  1. Buka website https://everpro.id
  2. Klik tombol Daftar atau Sign Up
  3. Isi form registrasi dengan data lengkap:
    • Nama Perusahaan/Toko
    • Email aktif
    • Nomor telepon
    • Password
  4. Verifikasi email Anda dengan klik link yang dikirim ke inbox
  5. Login ke dashboard Everpro
Everpro Registration

Gambar 7: Form registrasi akun Everpro

Step 2 Mendapatkan API Credentials

Setelah login, dapatkan API Key dan API Secret dari dashboard Everpro.

  1. Login ke Dashboard Everpro
  2. Buka menu Settings � API Credentials
  3. Pilih environment:
    • Sandbox - untuk testing (gratis)
    • Production - untuk live website (berbayar)
  4. Copy API Key dan API Secret
  5. Simpan credentials di tempat aman
Everpro API Credentials

Gambar 8: Halaman API credentials di dashboard Everpro

Keamanan API Credentials
  • Jangan bagikan API Secret kepada siapapun
  • Gunakan Sandbox untuk testing sebelum go live
  • Simpan credentials di tempat yang aman (password manager)

Step 3 Konfigurasi API di Plugin

Masukkan API credentials ke plugin agar dapat berkomunikasi dengan Everpro.

  1. Di WordPress admin, buka WooCommerce � Everpro Settings
  2. Klik tab API Configuration
  3. Pilih Environment:
    • Pilih Sandbox untuk testing
    • Pilih Production untuk website live
  4. Paste API Key yang sudah dicopy
  5. Paste API Secret
  6. Klik tombol Test Connection untuk memverifikasi
  7. Jika berhasil, klik Save Changes
Plugin API Configuration

Gambar 9: Form konfigurasi API di plugin settings

API Connection Success

Gambar 10: Notifikasi koneksi API berhasil

API Berhasil Terhubung!

Selamat! Plugin sekarang sudah terhubung dengan Everpro API. Anda bisa melanjutkan ke konfigurasi plugin.

Konfigurasi Plugin

Atur plugin sesuai kebutuhan bisnis Anda dengan berbagai opsi konfigurasi.

Step 1 Pengaturan Umum

Konfigurasi pengaturan dasar plugin seperti logging, debug mode, dan status automation.

Enable Debug Mode

Aktifkan untuk melihat log detail API requests dan responses. Berguna untuk troubleshooting.

Default: OFF
API Request Timeout

Waktu maksimal menunggu response dari API (dalam detik).

Default: 30 detik
Log Retention Period

Berapa lama menyimpan log API di database sebelum dihapus otomatis.

Default: 7 hari
General Settings

Gambar 11: Halaman pengaturan umum plugin

Step 2 Data Pengirim (Shipper)

Isi data alamat pengirim yang akan digunakan sebagai default untuk semua pengiriman.

  1. Buka tab Sender Settings
  2. Isi form dengan data lengkap:
    • Nama Pengirim: Nama toko/perusahaan
    • Nomor Telepon: Nomor aktif yang bisa dihubungi
    • Alamat Lengkap: Alamat gudang/toko
    • Kecamatan: Pilih dari dropdown
    • Kota/Kabupaten: Pilih dari dropdown
    • Provinsi: Pilih dari dropdown
    • Kode Pos: Kode pos alamat pengirim
  3. Klik Save Sender Data
Sender Data Form

Gambar 12: Form data pengirim

Tips: Pastikan data yang diisi akurat karena akan digunakan untuk semua pengiriman. Data ini juga akan muncul di label resi.

Step 3 Pilih Ekspedisi Aktif

Aktifkan ekspedisi yang ingin Anda gunakan untuk toko online Anda.

  1. Buka tab Active Expeditions
  2. Anda akan melihat daftar semua ekspedisi yang tersedia
  3. Centang checkbox untuk ekspedisi yang ingin diaktifkan:
    • JNE (REG, OKE, YES, JTR, SPS)
    • TIKI (SDS, ONS, REG, ECO, TRC)
    • J&T Express (EZ, Next Day)
    • SiCepat (BBM, GOKIL, REG, SIUNT)
    • Dan lainnya...
  4. Untuk setiap ekspedisi, Anda bisa mengatur:
    • Service Type: Layanan yang ingin ditampilkan
    • Markup/Discount: Tambahan atau potongan ongkir (%)
  5. Klik Save Expedition Settings
Active Expeditions

Gambar 13: Pengaturan ekspedisi aktif

Step 4 Otomasi & Workflow

Atur workflow otomatis untuk memudahkan pengelolaan order.

Auto Update Order Status

Otomatis ubah status order setelah resi berhasil dibuat.

Contoh: Order status otomatis berubah dari "Processing" ke "Shipped" setelah airwaybill tergenerate.
Email Notification

Kirim email otomatis ke customer dengan nomor resi.

Template: Bisa dikustomisasi dengan shortcode {tracking_number}, {expedition}, dll.
WhatsApp Integration

Integrasi dengan plugin WhatsApp Notification untuk kirim tracking info.

Note: Membutuhkan plugin AgenWebsite WhatsApp Notification.
Automation Settings

Gambar 14: Pengaturan otomasi dan workflow

Konfigurasi Selesai!

Plugin sudah siap digunakan! Sekarang Anda bisa mulai membuat pengiriman dari WooCommerce orders.

Cara Penggunaan

Panduan lengkap menggunakan fitur-fitur plugin untuk operasional harian.

Membuat Pengiriman Baru

Cara membuat resi pengiriman dari halaman WooCommerce Orders.

  1. Buka WooCommerce � Orders
  2. Pilih order yang ingin dibuatkan pengiriman
  3. Di kolom Everpro Shipment, klik tombol Create Shipment
  4. Modal akan terbuka menampilkan:
    • Data penerima (otomatis terisi dari order)
    • Berat dan dimensi paket
    • Daftar tarif dari semua ekspedisi
  5. Pilih layanan ekspedisi yang diinginkan dari tabel tarif
  6. Atur waktu pickup (jika tersedia)
  7. Klik tombol Create Shipment
  8. Tunggu proses (2-5 detik) hingga resi tergenerate
  9. Nomor resi akan otomatis tersimpan di order notes
Orders Page

Gambar 15: Halaman Orders dengan kolom Everpro Shipment

Create Shipment Modal

Gambar 16: Modal create shipment dengan rate comparison

Shipment Success

Gambar 17: Notifikasi resi berhasil dibuat

Cek Tarif Ongkir

Bandingkan tarif dari semua ekspedisi sebelum membuat pengiriman.

  1. Di halaman create shipment, sistem otomatis menampilkan tarif
  2. Tarif ditampilkan dalam tabel dengan kolom:
    • Ekspedisi & Layanan: Nama kurir dan tipe layanan
    • Tarif: Harga pengiriman
    • Estimasi: Waktu pengiriman
    • Cashback: Jika ada (opsional)
  3. Gunakan fitur Sort by untuk mengurutkan:
    • Tercepat (fastest)
    • Termurah (cheapest)
    • Recommended (balanced)
Rate Comparison

Gambar 18: Tabel perbandingan tarif dari berbagai ekspedisi

Tracking Paket

Cek status pengiriman langsung dari dashboard WooCommerce.

  1. Di halaman WooCommerce � Orders
  2. Pada order yang sudah ada resinya, klik tombol Track
  3. Modal tracking akan terbuka menampilkan:
    • Nomor resi dan ekspedisi
    • Status terkini paket
    • History perjalanan lengkap dengan timestamp
    • Estimasi pengiriman
  4. Klik Refresh untuk update data tracking
Tracking Modal

Gambar 19: Modal tracking dengan history perjalanan paket

Bulk Operations

Proses banyak order sekaligus dengan bulk actions.

  1. Di halaman Orders, centang beberapa order yang ingin diproses
  2. Pilih Bulk Actions � Create Everpro Shipments
  3. Klik tombol Apply
  4. Modal bulk create akan terbuka menampilkan:
    • Daftar semua order yang dipilih
    • Opsi pilih ekspedisi default untuk semua order
    • Preview total biaya pengiriman
  5. Pilih layanan ekspedisi untuk batch
  6. Klik Process All Shipments
  7. Sistem akan memproses satu per satu dan menampilkan progress bar
  8. Setelah selesai, akan muncul summary:
    • Berhasil: X orders
    • Gagal: Y orders (dengan alasan error)
Bulk Actions

Gambar 20: Bulk actions di halaman Orders

Bulk Create Modal

Gambar 21: Modal bulk create shipments dengan progress

Batalkan Pengiriman

Cara membatalkan pengiriman yang belum di-pickup oleh kurir.

  1. Di halaman Orders, cari order dengan pengiriman yang ingin dibatalkan
  2. Klik tombol Cancel Shipment di kolom Everpro
  3. Modal konfirmasi akan muncul
  4. Pilih Alasan Pembatalan dari dropdown:
    • Customer request
    • Wrong destination
    • Stock unavailable
    • Other (dengan catatan)
  5. Klik Confirm Cancellation
  6. Sistem akan mengirim request ke API dan update status
Cancel Shipment

Gambar 22: Modal konfirmasi pembatalan pengiriman

Catatan: Pengiriman yang sudah di-pickup tidak bisa dibatalkan melalui sistem. Hubungi ekspedisi langsung.

Fitur Lanjutan

API Logging & Monitoring

Plugin mencatat semua API request dan response untuk keperluan monitoring dan troubleshooting.

  1. Buka WooCommerce � Everpro � API Logs
  2. Anda akan melihat tabel log dengan kolom:
    • Timestamp
    • Order ID
    • API Endpoint
    • Status (Success/Failed)
    • Response Time
  3. Klik baris untuk melihat detail request & response JSON
  4. Gunakan filter untuk mencari log tertentu:
    • Filter by date range
    • Filter by order ID
    • Filter by status
  5. Export log ke CSV untuk analisis lebih lanjut
API Logs

Gambar 23: Halaman API logs dengan filter

Webhook Integration

Setup webhook untuk menerima update status pengiriman secara real-time dari Everpro.

  1. Buka Settings � Webhook
  2. Copy Webhook URL yang tersedia
  3. Login ke dashboard Everpro
  4. Buka menu Settings � Webhook
  5. Paste webhook URL dari plugin
  6. Pilih events yang ingin diterima:
    • Shipment picked up
    • In transit
    • Delivered
    • Failed delivery
  7. Save webhook settings di Everpro
  8. Test webhook dengan klik Send Test Event
Webhook Settings

Gambar 24: Pengaturan webhook untuk update otomatis

Custom Fields & Metadata

Tambahkan custom fields untuk data tambahan pada pengiriman.

  1. Buka Settings � Custom Fields
  2. Klik Add New Field
  3. Isi detail field:
    • Field Name
    • Field Type (text, number, dropdown, checkbox)
    • Default Value
    • Required (yes/no)
  4. Custom field akan muncul di form create shipment
  5. Data akan tersimpan di shipment metadata
Custom Fields

Gambar 25: Manager untuk menambah custom fields

Troubleshooting

Solusi untuk masalah-masalah yang sering terjadi.

Error Umum & Solusinya

ERROR

"License key is invalid or expired"

Penyebab: License key salah atau sudah kadaluarsa.

Solusi:

  • Cek kembali license key yang dimasukkan
  • Pastikan tidak ada spasi di awal atau akhir
  • Cek status license di Member Area
  • Perpanjang license jika sudah expired
ERROR

"API connection failed"

Penyebab: Tidak bisa terhubung ke Everpro API.

Solusi:

  • Cek koneksi internet server
  • Pastikan hosting tidak memblokir wp_remote_post()
  • Cek firewall atau security plugin
  • Verifikasi API credentials benar
  • Test dengan environment Sandbox dulu
ERROR

"Sender address is invalid"

Penyebab: Data alamat pengirim tidak lengkap atau salah.

Solusi:

  • Buka Settings � Sender Settings
  • Pastikan semua field required terisi
  • Cek kode pos benar sesuai wilayah
  • Pilih kecamatan/kota dari dropdown (bukan ketik manual)
ERROR

"Weight exceeds maximum limit"

Penyebab: Berat paket melebihi limit ekspedisi.

Solusi:

  • Cek berat di WooCommerce product settings
  • Sesuaikan dengan limit ekspedisi (biasanya 30kg untuk reguler)
  • Untuk paket berat, gunakan layanan cargo
  • Atau bagi menjadi beberapa paket terpisah
Error Example

Gambar 26: Contoh tampilan error message di plugin

Masalah Terkait API

WARNING

API Response Lambat / Timeout

Solusi:

  • Tingkatkan timeout di Settings � General (misal dari 30 ke 60 detik)
  • Cek status Everpro API di https://status.everpro.id
  • Jika sedang maintenance, tunggu hingga selesai
  • Upgrade plan hosting jika server resource terbatas
WARNING

Rate Limit Exceeded

Penyebab: Terlalu banyak request API dalam waktu singkat.

Solusi:

  • Everpro membatasi 100 request per menit
  • Gunakan bulk operations untuk proses banyak order
  • Aktifkan caching di plugin settings
  • Upgrade plan Everpro untuk limit lebih tinggi

Mengaktifkan Debug Mode

Debug mode membantu troubleshooting dengan menampilkan log detail.

  1. Buka Settings � General
  2. Aktifkan Enable Debug Mode
  3. Save settings
  4. Coba lakukan operasi yang bermasalah
  5. Buka API Logs untuk melihat detail error
  6. Perhatikan:
    • Request payload yang dikirim
    • Response dari API
    • Error code dan message
  7. Screenshot error dan kirim ke support@agenwebsite.com
Debug Logs

Gambar 27: Log detail di debug mode

Masih Menemui Masalah?

Jika masalah belum teratasi, hubungi tim support kami:

  • Email: support@agenwebsite.com
  • Live Chat: Tersedia di Member Area
  • WhatsApp: +62 xxx-xxxx-xxxx (jam kerja)

Frequently Asked Questions (FAQ)

Setup lengkap membutuhkan sekitar 20-30 menit, termasuk:
  • Instalasi plugin: 5 menit
  • Aktivasi license: 2 menit
  • Registrasi Everpro & setup API: 10-15 menit
  • Konfigurasi plugin: 5 menit
Jika sudah punya akun Everpro, waktu bisa lebih cepat.

Ya. Plugin ini adalah connector ke Everpro API. Anda perlu:
  1. Beli license plugin dari AgenWebsite
  2. Langganan Everpro untuk akses API (harga bervariasi tergantung paket)
Everpro menawarkan paket Sandbox gratis untuk testing.

Plugin tidak mengenakan biaya per transaksi. Anda bayar:
  • License plugin (sekali bayar atau annual)
  • Subscription Everpro (monthly/annual)
  • Ongkir ekspedisi (sesuai tarif normal)
Tidak ada markup atau hidden fee dari plugin.

Ya! Di Settings � Active Expeditions, Anda bisa:
  • Aktifkan/nonaktifkan ekspedisi tertentu
  • Pilih service type yang ditampilkan
  • Set markup/discount per ekspedisi
  • Hide/show di frontend checkout

Jika pengiriman direject oleh ekspedisi:
  1. Anda akan menerima notifikasi error saat create shipment
  2. Cek alasan reject (biasanya alamat incomplete, berat exceed, dll)
  3. Perbaiki data dan coba ekspedisi lain
  4. Jika sudah terlanjur dibuat, gunakan fitur Cancel Shipment

Ya, untuk paket Professional ke atas. Anda bisa:
  • Setup multiple sender addresses
  • Assign warehouse ke product/category
  • Auto-select warehouse berdasarkan order items
  • Manual select saat create shipment
Hubungi sales untuk upgrade ke paket Professional.

Plugin ini compatible dengan:
  • WooCommerce HPOS
  • WooCommerce Subscriptions
  • WPML (multi-language)
  • AgenWebsite WhatsApp Notification
  • Most popular page builders
Jika ada conflict, hubungi support untuk troubleshooting.

Jika license aktif, update otomatis via WordPress:
  1. Dashboard akan menampilkan notifikasi update tersedia
  2. Backup database dulu (safety first!)
  3. Klik "Update Now" di Plugins page
  4. Tunggu proses selesai
  5. Clear cache (browser & server)
  6. Test functionality
Update changelog tersedia di Member Area.

Pertanyaan Anda tidak terjawab?

Hubungi Support Team

Update terakhir: 15 November 2025
Untuk Plugin versi 1.5.0