شحنات تصلك تلقائيًا
كل طلب توصيل في مدينة تغطيها يصلك كعرض شحنة. تقبله أو ترفضه، ويمكنك عند القبول تحديد نافذة الاستلام والمندوب، كما يمكنك التنازل عن الشحنة قبل استلامها.
Carrier API · لشركات الشحن
اربط شركة الشحن بسوق Seto عبر API
Seto سوق ليبي لقطع غيار السيارات. اربط نظام شركتك بمنصة Seto لتصلك طلبات التوصيل تلقائيًا في المدن التي تغطيها، فتحدّث حالتها، وتحصّل قيمتها عند التسليم، وتستلم كشفًا شهريًا.
Read this page in Englishماذا يقدّم الـAPI
كل دورة الشحنة من نظامك
من عرض الشحنة إلى التسليم والتحصيل والكشف الشهري، دون إدخال يدوي في نظامين.
حالة الشحنة من البداية للنهاية
تم الاستلام، في الطريق، خرجت للتوصيل، تم التسليم، محاولة فاشلة، إعادة جدولة، مرتجع. يرى المشتري والبائع كل تحديث داخل تطبيق Seto بالعربية.
تأكيد التسليم برمز المشتري
يُؤكَّد التسليم بالرمز المكوّن من ستة أرقام الذي يحمله المشتري.
إثبات التسليم
ارفع إثبات التسليم للشحنة مباشرة من نظامك.
التحصيل عند الاستلام
مطابقة المبالغ المحصّلة عند التسليم والإبلاغ عن توريدها.
إعداد الشركة عبر الـAPI
الفروع ونقاط الخدمة والتغطية والتسعير والتوافر، تديرها كلها من نظامك.
Webhooks موقعة وسجل أحداث
تصلك الأحداث على خادمك عبر Webhooks موقعة، ويمكنك استرجاع ما فاتك من سجل الأحداث GET /events.
كشف رسوم شهري
كشف شهري بالرسوم المستحقة على شركتك.
خطوات الانضمام
من الاتفاق إلى التشغيل الكامل
تبدأ في Sandbox ببيانات تجريبية، ولا تصلك طلبات حقيقية إلا بعد الاعتماد والموافقة.
-
الخطوة 1: الاتفاق مع Seto
تواصل معنا على shipping@seto.ly أو املأ استبيان شركات الشحن.
-
الخطوة 2: دعوة Sandbox
نرسل رابط دعوة يُستخدم مرة واحدة إلى المسؤول التقني لديكم. فتح الرابط ينشئ بيانات اعتماد الـAPI ويعرض السر مرة واحدة فقط.
-
الخطوة 3: البناء والتجربة في Sandbox
أنشئ شحنات تجريبية من البوابة، ومرّرها عبر كل الحالات، وسجّل خادم استقبال الـWebhook وتحقق منه. مجموعة Postman وملف OpenAPI متاحان للتنزيل من الوثائق.
-
الخطوة 4: الاعتماد
تعرض البوابة قائمة تحقق مبنية على أدلة فعلية من الخادم، وعند اكتمالها تطلب الموافقة.
-
الخطوة 5: مراجعة Seto ودعوة Production
نراجع ونوافق، ثم نرسل دعوة منفصلة لبيئة Production. بيانات اعتماد Sandbox لا تعمل في Production أبدًا.
-
الخطوة 6: التشغيل التجريبي
20 يوم تشغيل و10 شحنات حقيقية على الأقل قبل التشغيل الكامل.
البيئات
بيئة Sandbox للتطوير، وبيئة Production للطلبات الحقيقية
| البيئة | عنوان الـAPI | البوابة | البيانات | الاستخدام |
|---|---|---|---|---|
| Sandbox تجريبية | https://sandbox-api.seto.ly |
https://sandbox-api.seto.ly |
بيانات تجريبية | للتطوير والتجربة |
| Production حقيقية | https://api.seto.ly |
https://api.seto.ly |
طلبات حقيقية | متاحة فقط بعد الاعتماد والموافقة |
لكل بيئة بيانات اعتماد مستقلة، وبيانات اعتماد Sandbox لا تعمل في Production.
الأمان
أمان مبني في الربط من اليوم الأول
بيانات المشترين وشحناتك وحساب شركتك محمية بطبقات واضحة يمكن لفريقك التقني مراجعتها.
الدخول والصلاحيات
- OAuth 2.0 client credentials.
- رموز دخول موقعة بـ Ed25519 وصلاحيتها عشر دقائق.
- صلاحيات بالحد الأدنى اللازم لكل عميل.
- قائمة عناوين IP مسموحة اختيارية تُطبَّق على نقطة إصدار الرموز وعلى البوابة.
- HTTPS فقط.
- بيانات اعتماد مستقلة لكل بيئة.
- الأسرار تُعرض مرة واحدة فقط، وSeto لا تطلبها أبدًا عبر البريد أو واتساب.
سلامة العمليات
- كل عملية كتابة تحمل
Idempotency-Keyفلا تُطبَّق إعادة المحاولة مرتين. - حدود معدل طلبات لكل عميل.
- رمز التسليم يُقفل بعد محاولات خاطئة متكررة.
- العقد بإصدارات، والتغييرات عليه إضافية فقط.
Webhooks والبيانات
- Webhooks موقعة بـ HMAC-SHA256 على الطابع الزمني ومعرّف الإرسال والمحتوى.
- تدوير السر مع فترة تداخل بين القديم والجديد.
- أقل قدر من بيانات المشتري: تفاصيل المستلم كاملة بعد قبولك الشحنة فقط، وتُخفى بعد انتهائها.
- كل شركة شحن ترى شحناتها فقط.
الوثائق
كل ما يحتاجه فريقك التقني
الوثائق متاحة على بوابة Sandbox، وتتضمن مجموعة Postman وملف OpenAPI للتنزيل.
وثائق الربط
/partner/portal/docs
مرجع الـAPI التفاعلي
/partner/portal/reference
عقد OpenAPI
/partner/portal/openapi.yaml
دليل البدء السريع بالعربية
/partner/portal/docs/quickstart
دليل الـWebhooks
/partner/portal/docs/webhooks
مطابقة الحالات
/partner/portal/docs/status-mapping
قائمة تحقق الاعتماد
/partner/portal/docs/certification
الأسئلة
أسئلة شائعة
هل نحتاج إلى بناء تطبيق؟
لا. تربط نظامك الحالي فقط. وإن لم يكن لديكم نظام، يمكن لفريقكم استخدام تطبيق HODO من Seto بدلًا من ذلك.
هل للربط تكلفة؟
الربط مجاني. رسوم الخدمة على كل توصيلة محددة في الاتفاقية.
كم يستغرق الربط؟
عادةً أيامًا، حسب جاهزية فريقكم. بيئة Sandbox متاحة لكم فور إرسال الدعوة.
بمن نتواصل؟
فريق الشحن في Seto على shipping@seto.ly.
التواصل
جاهزون لربط شركتكم؟
راسلوا فريق الشحن في Seto لبدء الاتفاق وإرسال دعوة Sandbox إلى المسؤول التقني لديكم.
البريد
shipping@seto.ly
لا ترسل أي أسرار أو رموز دخول في البريد.
تنبيه أمني
Seto لا تطلب الأسرار أبدًا
لا عبر البريد ولا عبر واتساب. السر يُعرض لكم مرة واحدة عند فتح الدعوة.