Download Erge Asia
Kirim paket ke 100+ negara
langsung dari HP Anda
Unduh Aplikasi Erge Asia
Belanja global, pengiriman internasional, lacak real-time, dan kelola paket internasional dari genggaman Anda.
Erge Asia · Developer API
将从印尼寄往 30 多个国家的国际快递直接集成到您的应用中。创建寄件、计算运费并实时追踪包裹。
https://system.ergeasia.com/api/external/v1按以下流程将您的系统与 ERGE ASIA 寄件 API 对接。
联系我们的团队获取 API 凭证。
GET /countries 与 /couriers。
POST /rates/calculate 获取预估。
POST /shipments 寄送包裹。
GET /tracking/{awb} 实时追踪。
除追踪接口外，所有请求都需在请求头中以 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/rates/calculate计算运费计算预估寄件费用。会员等级折扣将自动应用。
| Field | Type | 必填 | 说明 |
|---|---|---|---|
country_code | string | 必填 | 目的地 ISO 国家代码（如 "TW"） |
courier_code | string | 必填 | 快递代码（来自 /v1/couriers） |
weight | number | 必填 | 总重量（公斤，最大 100） |
items | array | 必填 | 物品列表（决定计费类别） |
delivery_type | string | 可选 | "home"（默认）或 "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/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 | 必填 | 总重量（公斤） |
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 | 可选 | 每页条数（最大 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 或运单号查询寄件的完整详情，包含物品数据与追踪信息。
/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.寄件可能经历的状态，从创建运单到送达。
| 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." }
}