팔로우하기 :
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선택페이지당 항목 수(최대 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
전자제품

휴대폰, 노트북, 충전기, 보조배터리

우선순위: 한 소포에 카테고리가 섞여 있으면 가장 높은 카테고리가 적용됩니다: 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 상담 어시스턴트24시간 온라인

채팅을 불러오는 중...

AI Powered © Erge Digital (ErDig)