للمطوّرين
الواجهة البرمجية العمومية
اربط متجرك في دقائق معدودة
لربط متجر إلكتروني وأتمتة الإرساليات: كل ميزة من مساحة التاجر متاحة برمجيًا، مع مصادقة بمفتاح ورمز.
43 ميزة · 8 قسمًا
البدء والمصادقة
واجهة REST بصيغة JSON
واجهة REST معيارية تكون فيها كل الطلبات والاستجابات بصيغة JSON (UTF-8، تواريخ ISO 8601)، سهلة الربط بأي متجر إلكتروني أو تطبيق.
المصادقة بمفتاح ورمز
كل استدعاء مؤمَّن بمعرِّفين — مفتاح ثابت ورمز قابل للتجديد — يُرسَلان في الترويستين X-API-Key و X-API-Token.
التحقّق من المعرِّفات
استدعاء اختباري يؤكّد فورًا صحّة معرِّفاتك ويعيد هوية حسابك كتاجر.
تجديد الرمز
جدّد رمزك في أي وقت لإلغاء وصول مخترَق فورًا، دون الحاجة إلى تغيير مفتاحك.
حصص استعمال واضحة
حدود واضحة وسخيّة (50 طلبًا في الدقيقة، 2000 في الساعة، 20000 في اليوم) تحمي الخدمة وتغطّي بأريحية استعمالًا تجاريًا إلكترونيًا.
متابعة الاستهلاك مباشرة
تشير كل استجابة، عبر ترويسات مخصَّصة، إلى الحصة المستهلَكة وإلى إصدار الواجهة البرمجية، لقيادة تكاملاتك بدقّة.
مجموعة Postman جاهزة
حمّل مجموعة Postman معدَّة مسبقًا (كل نقاط الوصول، ترويسات المصادقة وأمثلة الأجسام) لاختبار الواجهة في دقائق.
سجلّ الإصدارات
سجلّ تغييرات يمكن الاستعلام عنه عبر الواجهة يبقيك على اطّلاع بالتطويرات وبالإصدار الجاري للواجهة العمومية.
مراجع التوصيل
الولايات المخدومة
استرجِع قائمة الولايات مع طرق التوصيل المتاحة لكل واحدة منها (إلى المنزل، في نقطة استلام).
البلديات القابلة للتوصيل
احصل على بلديات كل ولاية واكتشف غير المخدومة منها، تفاديًا لتسجيل طلبات غير قابلة للتوصيل.
المكاتب / نقاط الاستلام (Stopdesk)
اعرض مكاتب Stopdesk لكل ولاية مع عنوانها وموقعها على Google Maps ورقم الاتصال بها، لاقتراح الاستلام من نقطة استلام.
وضعيات الطرود
اطّلع على التسميات الرسمية للوضعيات (جارية، مسلَّمة، ملغاة، محصَّلة…) لتفسير حالة كل طرد وعرضها.
الحالات اللوجستية
تابع الحالة المادية للطرد في السلسلة (قيد التحضير، في المكتب، قيد التوصيل، مسلَّم…) إلى جانب وضعيته التجارية.
جدول التسعيرة
اطّلع على أسعار التوصيل الخاصة بك حسب الولاية (المنزل و Stopdesk) وكذلك مصاريف الخدمة والتغليف، لعرض السعر الصحيح على زبائنك.
إنشاء طرودك وتحضيرها
الإنشاء على دفعات
أنشئ من 1 إلى 100 طرد في استدعاء واحد، مع نجاح أو فشل كل سطر بشكل مستقلّ ورسالة خطأ دقيقة.
المنزل أو نقطة الاستلام
اختر لكل طرد توصيلًا إلى المنزل (حسب البلدية) أو استلامًا من مكتب Stopdesk (حسب رمز المكتب).
طرد تبديل
حدّد طردًا كتبديل لإدارة استبدال المنتجات، دون قيد على المبلغ.
مرجع الطلب
أرفِق مرجعك الداخلي بكل طرد لمطابقته بسهولة مع طلبات متجرك.
إنشاء مؤكَّد مباشرة
أنشئ طردًا مباشرة في حالة «جاهز للإرسال» عندما لا تحتاج إلى مرحلة تحضير.
التعديل قبل الإرسال
صحّح معلومات الطرد (المرسَل إليه، العنوان، المبلغ، طريقة التوصيل) ما دام في مرحلة التحضير.
التأكيد على دفعات
انقُل دفعة من الطرود من «قيد التحضير» إلى «جاهز للإرسال» في استدعاء واحد، وهو ما يعادل زرّ التأكيد في اللوحة.
الحذف قبل الإرسال
احذف طردًا أُنشئ بالخطأ ما دام لم يغادر مرحلة التحضير.
المتابعة والمزامنة
قائمة مقسَّمة ومرشَّحة
تصفّح كل طرودك مع تقسيم إلى صفحات ومرشّحات (الولاية، التواريخ، نوع التاريخ، أرقام التتبّع) للعثور على ما تبحث عنه بالضبط.
مزامنة تدريجية
استرجِع فقط الطرود التي تغيّرت خلال فترة محدَّدة (حسب تاريخ العملية أو منذ تاريخ معيّن)، وهو مثالي لمزامنة متجرك دون إعادة تحميل كل شيء.
تفصيل الطرد ومساره
احصل على كل معلومات الطرد مرفقة بسجلّه الكامل، مرحلة بمرحلة.
الحالات على دفعات
استعلِم عن حالة ما يصل إلى 100 طرد في طلب واحد، برقم التتبّع و/أو بمرجع طلبك الخاص.
السجلّ على دفعات
استرجِع في طلب واحد المسار المفصّل لعدّة طرود (حتى 40) لتتبّع مسيرتها.
ملخّص إحصائي
اعرض نظرة عامة فورية: العدد الإجمالي للطرود، نسبة التسليم، والتوزيع حسب الوضعية وحسب الحالة اللوجستية.
طباعة الوصولات
وصل جاهز للطباعة
أنشئ ملصق طرد بالمقاسات الدقيقة (100×100 أو 100×130 مم)، مع الشعار والباركود وكل معلومات الإرسال.
طباعة مجمَّعة
اجمع حتى 100 وصل في مستند واحد (صفحة لكل طرد) لطباعة جولة كاملة دفعة واحدة.
كتالوج المنتجات (حسابات المخزون)
كتالوج المنتجات
اعرض منتجاتك (المرجع والتسمية) على الحسابات المُدارة بالمخزون، حيث يشير كل طرد إلى مرجع منتج.
إضافة منتج
أنشئ منتجًا جديدًا بمرجع فريد، مباشرة من نظامك، دون المرور باللوحة.
تحديث منتج
عدّل في أي وقت مرجع أو تسمية منتج موجود في كتالوجك.
الحزم والعروض المجمَّعة
اجمع عدّة مواد تحت مرجع «حزمة» واحد لبيعها معًا في طرد واحد، بسعر مادة واحدة.
الاستلام والتحويلات
طلب استلام
برمِج استلام طرودك مع تحديد عدد الطرود، نوع المركبة، البلدية والساعة المرغوبة.
قائمة التحويلات
اطّلع على السجلّ المقسَّم إلى صفحات لتحويلاتك مع المبلغ الصافي المراد استلامه وعدد الطرود المسلَّمة والملغاة لكل واحد منها.
تفصيل تحويل
افتح تفصيل تحويل لترى كل طرد يتكوّن منه والحساب الدقيق للمصاريف المطبَّقة.
Webhooks — إشعارات فورية
الاشتراك في الأحداث
استقبل تلقائيًا إشعارًا على رابطك الخاص عند كل تغيير في وضعية طرد، دون الحاجة إلى استجواب الواجهة البرمجية باستمرار.
اختيار الأحداث
اشترِك في كل الأحداث أو في تلك التي تهمّك فقط (مثلًا «مسلَّم» وحدها)، عبر كتالوج الأحداث المتاحة.
حدث اختباري
أرسِل حدثًا اختباريًا نحو رابطك للتحقّق من تكاملك قبل الانتقال إلى الإنتاج.
توقيع آمن
كل إشعار موقَّع بـ HMAC-SHA256 باستعمال مفتاحك السرّي، للتحقّق من أنّه صادر منّا فعلًا وأنّه لم يُغيَّر.
تسليم موثوق
عند الإخفاق، تُعاد محاولة الإشعارات تلقائيًا وفق مهلة متدرّجة، مع معرِّف فريد لكل حدث لتفادي التكرار.
سجلّ الإشعارات
اطّلع على سجلّ آخر إشعاراتك المُرسَلة (الحالة، المحاولة، الخطأ) لتشخيص تكاملك بسهولة.