Erge Asia · Developer API
ادمج الشحن الدولي من إندونيسيا إلى أكثر من 30 دولة مباشرة في تطبيقك. أنشئ الشحنات واحسب الأسعار وتتبع الطرود لحظياً.
https://system.ergeasia.com/api/external/v1اتبع هذه الخطوات لربط نظامك بواجهة ERGE ASIA البرمجية للشحن.
احصل عليه بنفسك من system.ergeasia.com ← الملف الشخصي ← API Saya.
GET /countries و /couriers.
POST /rates/calculate للحصول على تقدير.
POST /shipments لإرسال طرد.
GET /tracking/{awb} لحظياً.
تتطلب جميع الطلبات (عدا Tracking) مفتاح API بصيغة Bearer Token في الترويسة.
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 | اختياري | رمز 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 | إلزامي | الوزن الإجمالي بالكغ (بحد أقصى 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 | إلزامي | الوزن الإجمالي بالكغ |
courier_service | string | إلزامي | رمز شركة التوصيل |
items | array | إلزامي | سلعة واحدة على الأقل في الطرد |
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}تفاصيل الشحنةالتفاصيل الكاملة لشحنة حسب المعرّف أو رقم 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." }
}تواصل مع فريقنا للحصول على مفتاح API والبدء في شحن الطرود من تطبيقك.
نستخدم ملفات تعريف الارتباط لتحسين تجربتك.
باستمرارك في استخدام هذا الموقع، فإنك توافق على استخدامنا لملفات تعريف الارتباط وفقاً لـ سياسة الخصوصية الخاصة بنا.