تابعنا :
دعم على مدار الساعة
  • 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 الدفع بالمحفظة
ابدأ الآن

5 خطوات لدمج الـ API

اتبع هذه الخطوات لربط نظامك بواجهة ERGE ASIA البرمجية للشحن.

1
احصل على مفتاح API

احصل عليه بنفسك من system.ergeasia.com ← الملف الشخصي ← API Saya.

2
الدول وشركات التوصيل

GET /countries و /couriers.

3
احسب الأسعار

POST /rates/calculate للحصول على تقدير.

4
أنشئ شحنة

POST /shipments لإرسال طرد.

5
تتبع الطرد

GET /tracking/{awb} لحظياً.

المصادقة

تتطلب جميع الطلبات (عدا Tracking) مفتاح API بصيغة Bearer Token في الترويسة.

الوصول إلى 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اختياريرمز 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إلزاميالوزن الإجمالي بالكغ (بحد أقصى 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إلزاميالوزن الإجمالي بالكغ
courier_servicestringإلزاميرمز شركة التوصيل
itemsarrayإلزاميسلعة واحدة على الأقل في الطرد
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 }
}

التفاصيل الكاملة لشحنة حسب المعرّف أو رقم 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طلب غير صالح
401Unauthorizedمفتاح API مفقود/غير صالح
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 Powered © Erge Digital (ErDig)