Erge Asia · Developer API
インドネシアから30か国以上への国際配送を、あなたのアプリに直接組み込めます。出荷作成、料金計算、荷物のリアルタイム追跡が可能です。
https://system.ergeasia.com/api/external/v1以下の手順で、お使いのシステムを ERGE ASIA 配送 API に接続します。
system.ergeasia.com → プロフィール → API Saya から自分で取得できます。
GET /countries と /couriers。
POST /rates/calculate で見積もり。
POST /shipments で荷物を発送。
GET /tracking/{awb} でリアルタイム追跡。
すべてのリクエスト(Tracking を除く)は、ヘッダーに Bearer Token として API キーが必要です。
Authorization: Bearer YOUR_API_KEYX-EA-Client-ID:YOUR_CLIENT_IDContent-Type: application/json
エンドポイントをクリックすると、パラメータ、リクエスト、レスポンスの詳細が表示されます。
/v1/countries配送先の国一覧ERGE ASIA が対応するすべての配送先の国の一覧を返します。
{ "success": true, "data": [ { "code": "TW", "name": "Taiwan" }, { "code": "SG", "name": "Singapore" }, { "code": "JP", "name": "Japan" }, { "code": "MY", "name": "Malaysia" } ], "count": 30
}/v1/couriers利用可能な配送業者一覧指定した配送先の国で利用できる配送業者を返します。
| Field | Type | 必須 | 説明 |
|---|---|---|---|
country_code | string | 任意 | 2文字の ISO 国コード(例:"TW") |
{ "success": true, "data": [ { "code": "ERGE", "name": "ERGE ASIA", "description": "International Express" } ], "count": 1
}/v1/areas/searchCari Area Asal (Domestik)Cari kecamatan/kelurahan asal untuk pickup domestik. Mengembalikan subdistrict_id yang dipakai di rates/calculate.
| Field | Type | 必須 | 説明 |
|---|---|---|---|
q | string | 必須 | Kata kunci nama area (minimal 3 karakter) |
{ "success": true, "data": [ { "subdistrict_id": 12345, "subdistrict": "COBLONG", "city": "BANDUNG", "province": "JAWA BARAT", "label": "COBLONG, COBLONG, BANDUNG, JAWA BARAT, 40132" } ], "count": 1
}/v1/rates/calculate送料を計算送料の見積もりを計算します。お客様のティア料金が自動で適用されます。
| Field | Type | 必須 | 説明 |
|---|---|---|---|
country_code | string | 必須 | 配送先の ISO 国コード(例:"TW") |
courier_code | string | 必須 | 配送業者コード(/v1/couriers から取得) |
weight | number | 必須 | 総重量 kg(最大100) |
items | array | 必須 | 品目リスト(料金カテゴリーを決定) |
delivery_type | string | 任意 | "home"(デフォルト)または "store" |
origin_subdistrict_id | number | 任意 | Opsional. ID area asal (dari /areas/search). Bila diisi, response menambah ongkir domestik + grand_total (total pickup + internasional). |
{ "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/shipments新規出荷を作成新しい出荷を作成します。費用はウォレット残高から自動で差し引かれ、AWB 番号が発行されます。
| Field | Type | 必須 | 説明 |
|---|---|---|---|
sender_name | string | 必須 | 送り主の氏名 |
sender_phone | string | 必須 | 送り主の電話番号 |
sender_location | string | 必須 | 送り主の都市/地域 |
receiver_country | string | 必須 | 配送先の国(名称または ISO コード) |
receiver_name | string | 必須 | 受取人の氏名 |
receiver_phone | string | 必須 | 受取人の電話番号(国番号付き) |
receiver_postal | string | 必須 | 受取人の郵便番号 |
receiver_address | string | 必須 | 受取人の住所(全体) |
receiver_id | string | 任意 | 台湾宛ての場合は必須(ARC/パスポート) |
package_weight | number | 必須 | 総重量 kg |
courier_service | string | 必須 | 配送業者コード |
items | array | 必須 | 荷物に1つ以上の品目 |
collies | array | 任意 | 複数個口(個口ごとの重量+品目) |
voucher_code | string | 任意 | 割引クーポンコード |
{ "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/shipments出荷一覧アカウントのすべての出荷をページ送りとフィルター付きで一覧表示します。
| Field | Type | 必須 | 説明 |
|---|---|---|---|
page | integer | 任意 | ページ(デフォルト:1) |
per_page | integer | 任意 | 1ページあたりの件数(最大100) |
status | string | 任意 | フィルター:submitted、in_process、completed |
country_code | string | 任意 | 配送先の国で絞り込み |
from_date | string | 任意 | 開始日(YYYY-MM-DD) |
to_date | string | 任意 | 終了日(YYYY-MM-DD) |
{ "success": true, "data": [ ... ], "pagination": { "current_page": 1, "per_page": 20, "total_items": 48, "total_pages": 3 }
}/v1/shipments/{id|awb}出荷の詳細ID または AWB 番号で、品目データや追跡を含む出荷の詳細をすべて取得します。
/v1/tracking/{awb_number} Public荷物追跡リアルタイムの追跡履歴。公開エンドポイントのため API キーは不要です。
{ "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/balanceウォレット残高を確認出荷を作成する前に、ウォレット残高が十分か確認します。
{ "success": true, "data": { "balance": 5000000, "formatted": "Rp 5.000.000" }
}すべての品目には、送料を決めるカテゴリーが必要です。
general_cargo食品、衣類、書籍、お土産、サプリメント、スキンケア、化粧品
sensitif_items医薬品、鶏腸チップス、鶏皮チップス、牛皮せんべい、boci、塩干し魚
electronicスマートフォン、ノートパソコン、充電器、モバイルバッテリー
electronic > sensitif_items > general_cargo.AWB 作成から配達完了まで、出荷がたどる可能性のあるステータス。
| 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 |
API が返す標準のエラーレスポンス形式。
{ "success": false, "error": { "code": "INSUFFICIENT_BALANCE", "message": "Saldo wallet tidak cukup." }
}より快適にご利用いただくため、Cookie を使用しています。
本サイトを引き続きご利用いただくと、当社の プライバシーポリシーに従った Cookie の使用に同意したものとみなされます。