EXPEDITION API

API Cek Ongkos Kirim Gratis — JNE, JNT, SiCepat, SAP, dan Lainnya

Hitung ongkos kirim antar kelurahan di seluruh Indonesia dengan API Cek Ongkir gratis kami. Dukungan 14+ ekspedisi populer termasuk JNE Express, JNT Express, SiCepat, SAP, dan lainnya. Dapatkan estimasi harga dan waktu pengiriman secara real-time.

API Cek Ongkir: Solusi Lengkap untuk Perhitungan Biaya Pengiriman

API Cek Ongkos Kirim (Expedition API) adalah layanan API yang memungkinkan Anda menghitung biaya pengiriman antar kelurahan di seluruh Indonesia. Dengan dukungan lebih dari 14 ekspedisi populer seperti JNE, JNT, SiCepat, SAP, iDexpress, Lion Parcel, AnterAja, dan Ninja Express, API ini menjadi solusi lengkap untuk integrasi perhitungan ongkir di aplikasi e-commerce, marketplace, atau sistem logistik Anda.

API ini dirancang dengan sistem caching otomatis untuk respons yang lebih cepat, mendukung perhitungan berbasis berat, dan menyediakan estimasi waktu pengiriman. Semua data ongkir diperbarui secara berkala untuk memastikan akurasi harga yang selalu terkini.

🚚 Ekspedisi yang Didukung

JNE Express
Express Delivery

JNE Cargo
Cargo Service

SiCepat Express
Express Delivery

SiCepat Cargo
Cargo Service

SAP Express
Express Delivery

SAP Lite
Economy Service

SAP Cargo
Cargo Service

iDexpress
Express Delivery

iDlite
Economy Service

J&T Express
Express Delivery

Lion Parcel
Express Delivery

iDexpress Cargo
Cargo Service

AnterAja
Express Delivery

Ninja Express
Express Delivery

🚚

14+ Ekspedisi

Dukungan lengkap untuk JNE, JNT, SiCepat, SAP, iDexpress, dan ekspedisi populer lainnya.

Cepat & Caching

Respons cepat dengan sistem caching otomatis untuk performa optimal.

📦

Berbasis Berat

Perhitungan ongkir akurat berdasarkan berat paket dalam kilogram.

⏱️

Estimasi Waktu

Dapatkan estimasi waktu pengiriman untuk setiap layanan ekspedisi.

📍 Kode Kelurahan (Village Code)

Untuk menggunakan API ini, Anda memerlukan kode kelurahan (village_code) yang terdiri dari 10 digit. Kode kelurahan dapat Anda dapatkan melalui API Wilayah Indonesia. Gunakan endpoint /regional/indonesia/villages untuk mencari kelurahan dan mendapatkan kode 10 digit yang diperlukan untuk perhitungan ongkir.

Dokumentasi API Cek Ongkir

Endpoint REST yang jelas untuk perhitungan biaya pengiriman antar kelurahan di Indonesia. Pelajari cara menggunakan layanan ini dengan mudah.

🔐 Authentication: Semua request memerlukan header x-api-co-id dengan API key Anda. Dapatkan API key gratis di dashboard.

GET
{{base-url}}/expedition/shipping-cost

Hitung biaya pengiriman dari kelurahan asal ke kelurahan tujuan. Endpoint ini mengembalikan daftar semua ekspedisi yang tersedia beserta harga dan estimasi waktu pengiriman. Hanya ekspedisi dengan harga lebih dari 0 yang dikembalikan.

Query Parameters (Required):

  • origin_village_code – Kode kelurahan asal (10 digit). Dapatkan dari API Wilayah Indonesia
  • destination_village_code – Kode kelurahan tujuan (10 digit). Dapatkan dari API Wilayah Indonesia
  • weight – Berat paket dalam kilogram (harus lebih besar dari 0)
Example Request
GET https://use.api.co.id/expedition/shipping-cost?origin_village_code=3172051003&destination_village_code=3204402005&weight=1

Headers:
  x-api-co-id: YOUR_API_KEY

Example Response (Success)
{
  "is_success": true,
  "message": "Success",
  "data": {
    "origin_village_code": "3172051003",
    "destination_village_code": "3204402005",
    "weight": 1,
    "couriers": [
      {
        "courier_code": "JNE",
        "courier_name": "JNE Express",
        "price": 8000,
        "weight": 1,
        "estimation": "2 - 3 days"
      },
      {
        "courier_code": "JNECargo",
        "courier_name": "JNE Cargo",
        "price": 55000,
        "weight": 1,
        "estimation": "2 - 3 days"
      },
      {
        "courier_code": "SAP",
        "courier_name": "SAP Express",
        "price": 12000,
        "weight": 1,
        "estimation": "3 - 5 days"
      },
      {
        "courier_code": "JT",
        "courier_name": "J&T Express",
        "price": 13000,
        "weight": 1,
        "estimation": null
      }
    ]
  }
}

Error Responses:

  • 400 Bad Request: Parameter wajib tidak lengkap atau berat kurang dari atau sama dengan 0
  • 404 Not Found: Kode kelurahan tidak ditemukan dalam database
  • 400 Bad Request: Kelurahan belum didukung (belum memiliki courier_id). Silakan buka tiket untuk mengaktifkan kelurahan tersebut
Example Response (Error – Missing Parameters)
{
  "is_success": false,
  "message": "origin_village_code is required"
}

Example Response (Error – Invalid Weight)
{
  "is_success": false,
  "message": "weight must be greater than 0"
}

Example Response (Error – Village Not Found)
{
  "is_success": false,
  "message": "Origin village code '9999999999' does not exist. Please find valid village codes at https://api.co.id/indonesia-regional-api/"
}

Example Response (Error – Village Not Supported)
{
  "is_success": false,
  "message": "This village was not supported yet, please open ticket to activate this village"
}

Pertanyaan Umum tentang API Cek Ongkir

Temukan jawaban untuk pertanyaan umum seputar API cek ongkir, penggunaan, dan integrasi.

Apa itu API Cek Ongkir?

API Cek Ongkir (Expedition API) adalah layanan API yang memungkinkan Anda menghitung biaya pengiriman antar kelurahan di seluruh Indonesia. API ini mendukung lebih dari 14 ekspedisi populer seperti JNE Express, JNE Cargo, J&T Express, SiCepat Express, SiCepat Cargo, SAP Express, SAP Lite, SAP Cargo, iDexpress, iDlite, Lion Parcel, iDexpress Cargo, AnterAja, dan Ninja Express. API ini dirancang untuk integrasi mudah di aplikasi e-commerce, marketplace, atau sistem logistik Anda.

Bagaimana cara menggunakan API Cek Ongkir?

Untuk menggunakan API ini, Anda perlu mendaftar dan mendapatkan API key terlebih dahulu di dashboard. Setelah mendapatkan API key, sertakan dalam header request sebagai x-api-co-id: YOUR_API_KEY. Anda juga memerlukan kode kelurahan (village_code) 10 digit untuk asal dan tujuan, yang dapat Anda dapatkan melalui API Wilayah Indonesia. Kirim request ke endpoint /expedition/shipping-cost dengan parameter origin_village_code, destination_village_code, dan weight.

Bagaimana cara mendapatkan kode kelurahan (village_code)?

Kode kelurahan (village_code) yang terdiri dari 10 digit dapat Anda dapatkan melalui API Wilayah Indonesia. Gunakan endpoint /regional/indonesia/villages untuk mencari kelurahan berdasarkan nama atau filter lainnya. Setiap kelurahan memiliki kode unik 10 digit yang diperlukan untuk perhitungan ongkir. Pastikan kedua kelurahan (asal dan tujuan) memiliki kode yang valid dan sudah didukung oleh sistem ekspedisi.

Ekspedisi apa saja yang didukung?

API ini mendukung lebih dari 14 ekspedisi populer di Indonesia, termasuk: JNE Express, JNE Cargo, SiCepat Express, SiCepat Cargo, SAP Express, SAP Lite, SAP Cargo, iDexpress, iDlite, J&T Express, Lion Parcel, iDexpress Cargo, AnterAja, dan Ninja Express. Setiap request akan mengembalikan semua ekspedisi yang tersedia untuk rute tersebut, dengan harga dan estimasi waktu pengiriman.

Apa yang terjadi jika kelurahan belum didukung?

Jika kelurahan yang Anda gunakan belum memiliki courier_id yang diperlukan, API akan mengembalikan error dengan pesan “This village was not supported yet, please open ticket to activate this village”. Dalam hal ini, Anda dapat membuka tiket melalui dashboard atau menghubungi support untuk mengaktifkan kelurahan tersebut. Tim kami akan segera memproses permintaan Anda.

Bagaimana format response API?

Response API mengembalikan format JSON dengan struktur konsisten: is_success (boolean), message (string), dan data (object). Data berisi origin_village_code, destination_village_code, weight, dan array couriers. Setiap item dalam array couriers berisi courier_code, courier_name, price (dalam Rupiah), weight, dan estimation (estimasi waktu pengiriman). Hanya ekspedisi dengan harga lebih dari 0 yang dikembalikan.

Berapa berat minimum yang didukung?

Parameter weight harus lebih besar dari 0 (dalam kilogram). Tidak ada batas maksimum, namun pastikan berat yang Anda masukkan sesuai dengan berat aktual paket. Perhitungan ongkir akan disesuaikan dengan berat yang Anda berikan. Untuk akurasi yang lebih baik, gunakan berat yang tepat dari paket yang akan dikirim.

Apakah estimasi waktu pengiriman selalu tersedia?

Tidak selalu. Beberapa ekspedisi menyediakan estimasi waktu pengiriman, sementara yang lain mungkin mengembalikan null untuk field estimation. Ini tergantung pada data yang tersedia dari masing-masing ekspedisi. Jika estimasi tersedia, akan ditampilkan dalam format seperti “2 – 3 days” atau “3 – 5 days”. Jika tidak tersedia, field akan berisi null.

Mulai Gunakan API Cek Ongkir Sekarang

Integrasikan perhitungan ongkir ke aplikasi Anda dengan mudah. Dapatkan API key gratis dan mulai hitung biaya pengiriman untuk 14+ ekspedisi populer di Indonesia.

Dapatkan API Key Anda

Scroll to Top