フォローする:
24時間年中無休サポート
  • IndonesiaIndonesia
  • EnglishEnglish
  • 繁體中文繁體中文
  • 简体中文简体中文
  • 日本語日本語
  • 한국어한국어
  • العربيةالعربية
会社情報

国際物流パートナー、Erge Asia をご紹介します。

Erge Asia について
サービス&機能

個人にもビジネスにも対応する総合国際配送サービス。

必要なツールをすべてひとつの統合エコシステムに。

リアルタイム追跡とラベル自動作成のための REST API 連携。

すべてのサービス すべての機能を見る 連携を始める
情報

国際配送のためのガイド、記事、資料。

すべての記事を見る
ERGE ASIA
ログイン無料登録
ホーム
言語

Erge Asia · Developer API

配送 API ドキュメント

インドネシアから30か国以上への国際配送を、あなたのアプリに直接組み込めます。出荷作成、料金計算、荷物のリアルタイム追跡が可能です。

Base URLhttps://system.ergeasia.com/api/external/v1
30か国以上 リアルタイム追跡 API キー認証 ウォレット決済
はじめに

API 連携の5ステップ

以下の手順で、お使いのシステムを ERGE ASIA 配送 API に接続します。

1
API キーを取得

system.ergeasia.com → プロフィール → API Saya から自分で取得できます。

2
国&配送業者

GET /countries と /couriers。

3
料金を計算

POST /rates/calculate で見積もり。

4
出荷を作成

POST /shipments で荷物を発送。

5
荷物を追跡

GET /tracking/{awb} でリアルタイム追跡。

認証

すべてのリクエスト(Tracking を除く)は、ヘッダーに Bearer Token として API キーが必要です。

API へのアクセスには一定の条件があります。API キーはご自身で取得できます: system.ergeasia.com → プロフィール → API Saya(テスト用の Sandbox キーも含む)。
HTTP Headers
Authorization: Bearer YOUR_API_KEYX-EA-Client-ID:YOUR_CLIENT_IDContent-Type: application/json
エンドポイント

API エンドポイント

エンドポイントをクリックすると、パラメータ、リクエスト、レスポンスの詳細が表示されます。

ERGE ASIA が対応するすべての配送先の国の一覧を返します。

レスポンス
JSON — 200 OK
{ "success": true, "data": [ { "code": "TW", "name": "Taiwan" }, { "code": "SG", "name": "Singapore" }, { "code": "JP", "name": "Japan" }, { "code": "MY", "name": "Malaysia" } ], "count": 30
}

指定した配送先の国で利用できる配送業者を返します。

パラメータ
FieldType必須説明
country_codestring任意2文字の ISO 国コード(例:"TW")
レスポンス
JSON — 200 OK
{ "success": true, "data": [ { "code": "ERGE", "name": "ERGE ASIA", "description": "International Express" } ], "count": 1
}

Cari kecamatan/kelurahan asal untuk pickup domestik. Mengembalikan subdistrict_id yang dipakai di rates/calculate.

パラメータ
FieldType必須説明
qstring必須Kata kunci nama area (minimal 3 karakter)
レスポンス
JSON — 200 OK
{ "success": true, "data": [ { "subdistrict_id": 12345, "subdistrict": "COBLONG", "city": "BANDUNG", "province": "JAWA BARAT", "label": "COBLONG, COBLONG, BANDUNG, JAWA BARAT, 40132" } ], "count": 1
}

送料の見積もりを計算します。お客様のティア料金が自動で適用されます。

パラメータ
FieldType必須説明
country_codestring必須配送先の ISO 国コード(例:"TW")
courier_codestring必須配送業者コード(/v1/couriers から取得)
weightnumber必須総重量 kg(最大100)
itemsarray必須品目リスト(料金カテゴリーを決定)
delivery_typestring任意"home"(デフォルト)または "store"
origin_subdistrict_idnumber任意Opsional. ID area asal (dari /areas/search). Bila diisi, response menambah ongkir domestik + grand_total (total pickup + internasional).
リクエストボディ
JSON
{ "country_code": "TW", "courier_code": "ERGE", "weight": 2, "items": [ { "name": "Indomie Goreng", "quantity": 10, "category": "general_cargo" } ]
}
レスポンス
JSON — 200 OK
{ "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 } }
}

新しい出荷を作成します。費用はウォレット残高から自動で差し引かれ、AWB 番号が発行されます。

重要: このエンドポイントはウォレット残高を即時に差し引きます。必ず先に /v1/rates/calculate を呼び出してください。
パラメータ
FieldType必須説明
sender_namestring必須送り主の氏名
sender_phonestring必須送り主の電話番号
sender_locationstring必須送り主の都市/地域
receiver_countrystring必須配送先の国(名称または ISO コード)
receiver_namestring必須受取人の氏名
receiver_phonestring必須受取人の電話番号(国番号付き)
receiver_postalstring必須受取人の郵便番号
receiver_addressstring必須受取人の住所(全体)
receiver_idstring任意台湾宛ての場合は必須(ARC/パスポート)
package_weightnumber必須総重量 kg
courier_servicestring必須配送業者コード
itemsarray必須荷物に1つ以上の品目
colliesarray任意複数個口(個口ごとの重量+品目)
voucher_codestring任意割引クーポンコード
リクエストボディ
JSON
{ "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" } ]
}
レスポンス
JSON — 200 OK
{ "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 }
}

アカウントのすべての出荷をページ送りとフィルター付きで一覧表示します。

パラメータ
FieldType必須説明
pageinteger任意ページ(デフォルト:1)
per_pageinteger任意1ページあたりの件数(最大100)
statusstring任意フィルター:submitted、in_process、completed
country_codestring任意配送先の国で絞り込み
from_datestring任意開始日(YYYY-MM-DD)
to_datestring任意終了日(YYYY-MM-DD)
レスポンス
JSON — 200 OK
{ "success": true, "data": [ ... ], "pagination": { "current_page": 1, "per_page": 20, "total_items": 48, "total_pages": 3 }
}

ID または AWB 番号で、品目データや追跡を含む出荷の詳細をすべて取得します。

リアルタイムの追跡履歴。公開エンドポイントのため API キーは不要です。

公開エンドポイント — API キーは不要です。
レスポンス
JSON — 200 OK
{ "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" } ] }
}

出荷を作成する前に、ウォレット残高が十分か確認します。

レスポンス
JSON — 200 OK
{ "success": true, "data": { "balance": 5000000, "formatted": "Rp 5.000.000" }
}
リファレンス

品目カテゴリー

すべての品目には、送料を決めるカテゴリーが必要です。

general_cargo
一般貨物

食品、衣類、書籍、お土産、サプリメント、スキンケア、化粧品

sensitif_items
センシティブ品

医薬品、鶏腸チップス、鶏皮チップス、牛皮せんべい、boci、塩干し魚

electronic
電子機器

スマートフォン、ノートパソコン、充電器、モバイルバッテリー

優先順位: 1つの荷物にカテゴリーが混在する場合は、最も高いものが適用されます: electronic > sensitif_items > general_cargo.
追跡

追跡ステータス一覧

AWB 作成から配達完了まで、出荷がたどる可能性のあるステータス。

Status CodeBahasa IndonesiaEnglish
AWB_CREATEDAirwaybill Berhasil DibuatAWB Created
PAYMENT_COMPLETEDPembayaran BerhasilPayment Confirmed
PICKED_UPKiriman Telah DijemputPicked Up
WAREHOUSE_RECEIVEDDiterima di Gudang JakartaReceived at Warehouse
PROCESSINGSedang Diproses di GudangProcessing
DEPARTED_ORIGINBerangkat dari IndonesiaDeparted from Indonesia
IN_TRANSITDalam Perjalanan ke Negara TujuanIn Transit
ARRIVED_DESTINATIONTelah Sampai di Negara TujuanArrived at Destination
CUSTOMS_CLEARANCEProses Bea CukaiCustoms Clearance
OUT_FOR_DELIVERYSedang Dikirim ke PenerimaOut for Delivery
DELIVEREDKiriman Telah DiterimaDelivered
RETURNEDKiriman DikembalikanReturned
CANCELLEDKiriman DibatalkanCancelled
エラー

HTTP ステータスコード

API が返す標準のエラーレスポンス形式。

200OKリクエスト成功
201Createdリソースの作成に成功
400Bad Request無効なリクエスト
401UnauthorizedAPI キーがない/無効
404Not Foundリソースが見つかりません
422Unprocessable検証に失敗
429Rate Limitedリクエストが多すぎます
500Server Error内部エラー
Error Response Format
{ "success": false, "error": { "code": "INSUFFICIENT_BALANCE", "message": "Saldo wallet tidak cukup." }
}

連携の準備はできましたか?

当社チームに連絡して API キーを取得し、あなたのアプリから荷物の発送を始めましょう。

ホーム料金
チャットアカウント
ERGE ASIA
AI CS アシスタント24時間オンライン

チャットを読み込み中...

AI Powered © Erge Digital (ErDig)