ERGE ASIA
CS AI AssistantOnline 24/7
Erge Asia · Developer API
Integrasikan pengiriman internasional dari Indonesia ke 30+ negara langsung ke aplikasi Anda. Buat kiriman, hitung ongkir, dan lacak paket secara real-time.
https://system.ergeasia.com/api/external/v1Ikuti alur berikut untuk menghubungkan sistem Anda dengan Shipping API ERGE ASIA.
Hubungi tim kami untuk kredensial API.
GET /countries dan /couriers.
POST /rates/calculate untuk estimasi.
POST /shipments untuk kirim paket.
GET /tracking/{awb} real-time.
Semua request (kecuali Tracking) memerlukan API Key sebagai Bearer Token di header.
Authorization: Bearer YOUR_API_KEYX-EA-Client-ID:YOUR_CLIENT_IDContent-Type: application/json
Klik endpoint untuk melihat detail parameter, request, dan response.
/v1/countriesDaftar Negara TujuanMengembalikan daftar semua negara tujuan yang didukung oleh ERGE ASIA.
{ "success": true, "data": [ { "code": "TW", "name": "Taiwan" }, { "code": "SG", "name": "Singapore" }, { "code": "JP", "name": "Japan" }, { "code": "MY", "name": "Malaysia" } ], "count": 30
}/v1/couriersDaftar Kurir TersediaMengembalikan kurir yang tersedia untuk negara tujuan tertentu.
| Field | Type | Wajib | Keterangan |
|---|---|---|---|
country_code | string | Opsional | Kode negara ISO 2 huruf (e.g. "TW") |
{ "success": true, "data": [ { "code": "ERGE", "name": "ERGE ASIA", "description": "International Express" } ], "count": 1
}/v1/rates/calculateHitung OngkirHitung estimasi biaya pengiriman. Diskon tier membership otomatis diterapkan.
| Field | Type | Wajib | Keterangan |
|---|---|---|---|
country_code | string | Wajib | Kode negara tujuan ISO (e.g. "TW") |
courier_code | string | Wajib | Kode kurir (dari /v1/couriers) |
weight | number | Wajib | Berat total dalam kg (maks 100) |
items | array | Wajib | Daftar barang (menentukan kategori pricing) |
delivery_type | string | Opsional | "home" (default) atau "store" |
{ "country_code": "TW", "courier_code": "ERGE", "weight": 2, "items": [ { "name": "Indomie Goreng", "quantity": 10, "category": "general_cargo" } ]
}{ "success": true, "data": { "country": "Taiwan", "courier": { "code": "ERGE", "name": "ERGE ASIA" }, "weight": { "actual": 2, "charged": 2 }, "category": "Barang Umum", "pricing": { "shipping_cost": 140700, "store_fee": 0, "total_cost": 140700, "formatted": "Rp 140.700" }, "tier": { "name": "Bronze", "discount_percent": 3 }, "wallet": { "sufficient": true, "balance": 5000000 } }
}/v1/shipmentsBuat Kiriman BaruBuat kiriman baru. Biaya otomatis dipotong dari saldo wallet dan nomor AWB akan di-generate.
| Field | Type | Wajib | Keterangan |
|---|---|---|---|
sender_name | string | Wajib | Nama pengirim |
sender_phone | string | Wajib | Telepon pengirim |
sender_location | string | Wajib | Kota / Wilayah pengirim |
receiver_country | string | Wajib | Negara tujuan (nama atau kode ISO) |
receiver_name | string | Wajib | Nama penerima |
receiver_phone | string | Wajib | Telepon penerima (dgn country code) |
receiver_postal | string | Wajib | Kode pos penerima |
receiver_address | string | Wajib | Alamat lengkap penerima |
receiver_id | string | Opsional | Wajib utk Taiwan (ARC/Passport) |
package_weight | number | Wajib | Berat total dalam kg |
courier_service | string | Wajib | Kode kurir |
items | array | Wajib | Minimal 1 item dalam paket |
collies | array | Opsional | Multi-koli (berat + items per koli) |
voucher_code | string | Opsional | Kode voucher diskon |
{ "sender_name": "Budi Santoso", "sender_phone": "081234567890", "sender_location": "DKI Jakarta", "receiver_country": "TW", "receiver_name": "Wang Wei", "receiver_phone": "+886912345678", "receiver_postal": "10617", "receiver_address": "No. 1, Section 4, Roosevelt Road", "package_weight": 3, "courier_service": "ERGE", "items": [ { "name": "Indomie Goreng", "quantity": 20, "unit": "pcs", "price": 3500, "category": "general_cargo" } ]
}{ "success": true, "message": "Kiriman berhasil dibuat! Resi: 88826028HXDYD", "data": { "shipment_id": 12345, "awb_number": "88826028HXDYD", "status": "submitted", "courier": "ERGE ASIA", "colly_awbs": ["88826028HXDYD"], "pricing": { "shipping_cost": 211000, "discount": 0, "total_cost": 211000, "total_formatted": "Rp 211.000" }, "wallet_balance": 4789000 }
}/v1/shipmentsList Semua KirimanDaftar semua kiriman akun Anda dengan pagination dan filter.
| Field | Type | Wajib | Keterangan |
|---|---|---|---|
page | integer | Opsional | Halaman (default: 1) |
per_page | integer | Opsional | Item per halaman (maks 100) |
status | string | Opsional | Filter: submitted, in_process, completed |
country_code | string | Opsional | Filter negara tujuan |
from_date | string | Opsional | Dari tanggal (YYYY-MM-DD) |
to_date | string | Opsional | Sampai tanggal (YYYY-MM-DD) |
{ "success": true, "data": [ ... ], "pagination": { "current_page": 1, "per_page": 20, "total_items": 48, "total_pages": 3 }
}/v1/shipments/{id|awb}Detail KirimanDetail lengkap sebuah kiriman berdasarkan ID atau nomor AWB, termasuk data items dan tracking.
/v1/tracking/{awb_number} PublicLacak KirimanRiwayat tracking real-time. Endpoint publik — tidak memerlukan API Key.
{ "success": true, "data": { "awb_number": "88826028HXDYD", "destination": "Taiwan", "current_status": "IN_TRANSIT", "current_status_name": "Dalam Perjalanan", "history": [ { "status_code": "IN_TRANSIT", "status_name": "Dalam Perjalanan ke Negara Tujuan", "location": "Jakarta", "timestamp": "2026-02-26T08:00:00+07:00" }, { "status_code": "PROCESSING", "status_name": "Sedang Diproses di Gudang", "location": "Gudang Jakarta", "timestamp": "2026-02-25T14:30:00+07:00" } ] }
}/v1/wallet/balanceCek Saldo WalletCek saldo wallet untuk memastikan dana cukup sebelum membuat kiriman.
{ "success": true, "data": { "balance": 5000000, "formatted": "Rp 5.000.000" }
}Setiap item harus memiliki kategori yang menentukan tarif pengiriman.
general_cargoMakanan, pakaian, buku, souvenir, suplemen, skincare, kosmetik
sensitif_itemsObat, kripik usus ayam, kripik kulit ayam, rambak sapi, boci, ikan asin
electronicHP, laptop, charger, power bank
electronic > sensitif_items > general_cargo.Status yang mungkin dilalui kiriman, dari AWB dibuat hingga terkirim.
| Status Code | Bahasa Indonesia | English |
|---|---|---|
AWB_CREATED | Airwaybill Berhasil Dibuat | AWB Created |
PAYMENT_COMPLETED | Pembayaran Berhasil | Payment Confirmed |
PICKED_UP | Kiriman Telah Dijemput | Picked Up |
WAREHOUSE_RECEIVED | Diterima di Gudang Jakarta | Received at Warehouse |
PROCESSING | Sedang Diproses di Gudang | Processing |
DEPARTED_ORIGIN | Berangkat dari Indonesia | Departed from Indonesia |
IN_TRANSIT | Dalam Perjalanan ke Negara Tujuan | In Transit |
ARRIVED_DESTINATION | Telah Sampai di Negara Tujuan | Arrived at Destination |
CUSTOMS_CLEARANCE | Proses Bea Cukai | Customs Clearance |
OUT_FOR_DELIVERY | Sedang Dikirim ke Penerima | Out for Delivery |
DELIVERED | Kiriman Telah Diterima | Delivered |
RETURNED | Kiriman Dikembalikan | Returned |
CANCELLED | Kiriman Dibatalkan | Cancelled |
Format error response standar yang dikembalikan oleh API.
{ "success": false, "error": { "code": "INSUFFICIENT_BALANCE", "message": "Saldo wallet tidak cukup." }
}Hubungi tim kami untuk mendapatkan API Key dan mulai kirim paket dari aplikasi Anda.