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 | 선택 | 페이지당 항목 수(최대 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." }
}더 나은 이용 경험을 위해 쿠키를 사용합니다.
이 사이트를 계속 이용하면 저희 개인정보 처리방침에 따른 쿠키 사용에 동의하는 것으로 간주됩니다.