端點

API 端點

點選端點檢視其引數、請求與響應詳情。

GET/v1/countries目的地國家列表

返回 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
}

GET/v1/couriers可用快遞列表

返回指定目的地國家可用的快遞。

引數

Field	Type	必填	說明
`country_code`	string	可選	2 位 ISO 國家程式碼（如 "TW"）

響應

JSON — 200 OK

{ "success": true, "data": [ { "code": "ERGE", "name": "ERGE ASIA", "description": "International Express" } ], "count": 1
}

POST/v1/rates/calculate計算運費

計算預估寄件費用。會員等級折扣將自動應用。

引數

Field	Type	必填	說明
`country_code`	string	必填	目的地 ISO 國家程式碼（如 "TW"）
`courier_code`	string	必填	快遞程式碼（來自 /v1/couriers）
`weight`	number	必填	總重量（公斤，最大 100）
`items`	array	必填	物品列表（決定計費類別）
`delivery_type`	string	可選	"home"（預設）或 "store"

請求體

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 } }
}

POST/v1/shipments建立新寄件

建立新寄件。費用將自動從錢包餘額中扣除，並生成運單號 (AWB)。

重要： 此端點會立即扣除錢包餘額。請務必先呼叫 /v1/rates/calculate。

引數

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	必填	總重量（公斤）
`courier_service`	string	必填	快遞程式碼
`items`	array	必填	包裹中至少 1 件物品
`collies`	array	可選	多件包裹（每件的重量 + 物品）
`voucher_code`	string	可選	折扣優惠券碼

請求體

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 }
}

GET/v1/shipments列出全部寄件

列出您賬戶的所有寄件，支援分頁與篩選。

引數

Field	Type	必填	說明
`page`	integer	可選	頁碼（預設：1）
`per_page`	integer	可選	每頁條數（最大 100）
`status`	string	可選	篩選：submitted、in_process、completed
`country_code`	string	可選	按目的地國家篩選
`from_date`	string	可選	起始日期（YYYY-MM-DD）
`to_date`	string	可選	截止日期（YYYY-MM-DD）

響應

JSON — 200 OK

{ "success": true, "data": [ ... ], "pagination": { "current_page": 1, "per_page": 20, "total_items": 48, "total_pages": 3 }
}

GET/v1/shipments/{id|awb}寄件詳情

按 ID 或運單號查詢寄件的完整詳情，包含物品資料與追蹤資訊。

GET/v1/tracking/{awb_number} Public追蹤寄件

實時追蹤記錄。公開端點——無需 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" } ] }
}

GET/v1/wallet/balance查詢錢包餘額

查詢錢包餘額，確保建立寄件前資金充足。

響應

JSON — 200 OK

{ "success": true, "data": { "balance": 5000000, "formatted": "Rp 5.000.000" }
}

追蹤

追蹤狀態列表

寄件可能經歷的狀態，從建立運單到送達。

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 文件

API 整合五步驟

獲取 API 金鑰

國家與快遞

計算運費

建立寄件

追蹤包裹

身份驗證

API 端點

響應

引數

響應

引數

請求體

響應

引數

請求體

響應

引數

響應

響應

響應

物品類別

普通貨物

敏感物品

電子產品

追蹤狀態列表

HTTP 狀態碼

準備好整合了嗎？