API Shipping Indonesia: Integrasi Mudah Tanpa Ribet, Ini Caranya

14 Jul 2026
Raihan Firdhan

Bagikan ke

Kalau toko online Anda masih menghitung ongkir secara manual — copy-paste tarif dari situs ekspedisi satu per satu — Anda sedang membuang waktu yang bisa dipakai untuk hal yang lebih produktif. Integrasi API Shipping Indonesia adalah solusi yang sudah lama tersedia, tapi masih banyak developer dan pemilik toko yang menghindarinya karena dianggap rumit. Kenyataannya, tidak serumit itu.

Artikel ini akan menunjukkan cara kerjanya, apa saja yang perlu dipersiapkan, dan bagaimana memilih provider yang tepat untuk kebutuhan bisnis Anda.

Apa Itu API Shipping dan Mengapa Bisnis Online Butuh Ini?

API (Application Programming Interface) shipping adalah jembatan komunikasi antara sistem toko Anda dengan sistem ekspedisi. Lewat API ini, toko Anda bisa secara otomatis:

Menampilkan tarif ongkir real-time ke pelanggan
Membuat resi pengiriman tanpa input manual
Melacak status paket langsung dari dashboard
Mengelola pickup request ke kurir

Tanpa integrasi ini, setiap order membutuhkan intervensi manual: buka situs ekspedisi, input alamat, catat tarif, buat resi sendiri. Ini tidak skalabel. Begitu order Anda menembus 50–100 per hari, sistem manual akan mulai menjadi bottleneck serius.

Jenis-Jenis Provider API Shipping Indonesia

Sebelum mulai integrasi, pahami dulu tipe provider yang tersedia di pasar Indonesia.

1. API Langsung dari Ekspedisi

Beberapa ekspedisi besar seperti JNE, J&T, dan SiCepat menyediakan API langsung (first-party API). Keuntungannya: data tarif dan resi lebih akurat karena tidak melewati perantara. Kekurangannya: Anda harus mendaftar dan mengelola kredensial ke masing-masing ekspedisi secara terpisah.

2. API Aggregator Shipping

Provider seperti AutoLaris, Shipper, iSeller Logistics, dan Biteship mengumpulkan banyak ekspedisi dalam satu endpoint. Anda cukup integrasi satu API, dan bisa mengakses tarif dari belasan kurir sekaligus. Ini pilihan yang paling efisien untuk mayoritas toko online.

3. API OMS/WMS dengan Modul Shipping

Beberapa sistem manajemen order atau gudang sudah memiliki modul shipping bawaan. Cocok jika Anda berencana mengelola inventori dan pengiriman dalam satu platform.

Cara Integrasi API Shipping Indonesia: Langkah demi Langkah

Integrasi API bukan sihir. Prosesnya sistematis dan bisa diulang.

Langkah 1: Tentukan Kebutuhan Anda

Jawab tiga pertanyaan ini sebelum memilih provider:

Berapa ekspedisi yang ingin Anda support?
Apakah Anda butuh fitur COD?
Seberapa sering volume order Anda berubah (perlu auto-scaling)?

Jika Anda hanya butuh 2–3 ekspedisi dan volume masih kecil, API langsung cukup. Jika Anda ingin fleksibilitas multi-kurir dan fitur lengkap, pilih aggregator.

Langkah 2: Daftar dan Dapatkan API Key

Semua provider API shipping memerlukan pendaftaran akun. Setelah diverifikasi, Anda akan mendapatkan:

API Key — identifikasi unik akun Anda
Base URL — endpoint untuk semua request
User ID / Merchant ID — tergantung provider

Simpan kredensial ini di file .env proyek Anda, bukan di kode langsung. Ini bukan sekadar best practice — ini keharusan keamanan.

Langkah 3: Pahami Endpoint Utama

Hampir semua API shipping Indonesia memiliki struktur endpoint yang serupa:

Fungsi	Contoh Endpoint
Cek ongkir	`/v1/rates` atau `/cek-ongkir`
Buat order/resi	`/v1/order/create`
Lacak paket	`/v1/tracking/{resi}`
Daftar ekspedisi	`/v1/couriers`
Ambil distrik/kota	`/v1/destination`

Baca dokumentasi provider Anda dengan seksama. Perhatikan format request (JSON), metode HTTP (GET/POST), dan parameter wajib vs opsional.

Langkah 4: Implementasi di Backend

Contoh implementasi sederhana menggunakan PHP (CI4):

php

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => env('autolaris.baseUrl') . '/cek-ongkir',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        'api_key'      => env('autolaris.apiKey'),
        'origin'       => $originId,
        'destination'  => $destinationId,
        'weight'       => $weightGram,
    ]),
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
]);
$response = json_decode(curl_exec($curl), true);

Selalu tangani error response. Jangan asumsikan API shipping indonesia selalu mengembalikan data yang valid — tambahkan fallback dan logging.

Langkah 5: Uji dengan Data Nyata

Gunakan lingkungan sandbox jika tersedia. Jika tidak, uji dengan order kecil sungguhan. Verifikasi:

Tarif yang muncul sesuai dengan tarif di situs ekspedisi
Resi yang dibuat bisa dilacak
Format alamat tujuan diterima tanpa error

Kesalahan Umum yang Harus Dihindari

Banyak developer gagal di tahap ini bukan karena tidak paham API shipping indonesia nya, tapi karena hal-hal kecil yang terlewat.

Masalah format distrik/kota. Hampir semua API shipping Indonesia menggunakan ID distrik numerik, bukan nama kota teks bebas. Pastikan Anda menyimpan master data distrik di database lokal dan menggunakan autocomplete yang mengembalikan ID yang benar — bukan nama string.

Nilai .env tidak ter-parse. Di CodeIgniter 4, nilai .env yang mengandung spasi atau koma wajib dibungkus tanda kutip ganda. Contoh: autolaris.apiKey = "kunci-api-anda". Tanpa itu, parser CI4 memotong nilai di karakter pertama yang bermasalah.

Tidak ada caching untuk cek ongkir. Setiap request ke API shipping indonesia memakan waktu dan kuota. Implementasikan cache sederhana (misalnya 10–15 menit) untuk kombinasi origin-destination-weight yang sama agar halaman checkout tetap responsif.

Pilih Provider yang Tepat, Bukan yang Paling Populer

Popularitas bukan jaminan kesesuaian. Evaluasi provider berdasarkan:

Coverage ekspedisi — apakah kurir yang Anda butuhkan tersedia?
Kelengkapan dokumentasi — apakah ada contoh kode dan sandbox?
Dukungan teknis — seberapa cepat mereka merespons saat ada error produksi?
Stabilitas uptime — minta data SLA mereka sebelum komitmen
Model harga — per request, per resi, atau flat bulanan?

Untuk referensi perbandingan provider, Anda bisa mengunjungi dokumentasi resmi masing-masing platform seperti Biteship API Docs yang menyediakan panduan integrasi lengkap beserta sandbox environment.

Saatnya Anda Mulai Integrasi

Tidak ada alasan teknis yang cukup kuat untuk menunda integrasi API Shipping Indonesia di sistem toko Anda. Prosesnya terstruktur, dokumentasinya tersedia, dan hasilnya langsung terasa: checkout lebih cepat, tidak ada input manual, dan pelanggan Anda mendapat pengalaman belanja yang lebih profesional.

Mulai dari satu provider aggregator, integrasikan endpoint cek ongkir terlebih dahulu, kemudian baru tambahkan fitur pembuatan resi dan tracking. Bertahap lebih baik daripada menunda karena menunggu kondisi “sempurna” yang tidak akan pernah datang.

Sudah tahu provider mana yang ingin Anda coba? Tentukan itu dulu — sisanya bisa dikerjakan hari ini.

GUNAKAN AUTOKIRIM SEKARANG!