مركز المطورين والتطبيقات

MATJRAH DEVELOPERS + APPS CENTER

انشر تطبيق الشحن
على متجرة.

يبدأ ربط الشحن دائمًا بإنشاء تطبيق شحن. انشر تطبيقًا عامًا لعدة تجار أو أرسل دعوة تطبيق خاص لمتجر واحد، ثم شغّل البوليصات والملصقات والتتبع والإلغاء والمرتجعات من خلال التطبيق المثبّت.

ابدأ من مركز المطورين احجز موعدًا مع فريق الشراكات

دعم التكامل: dev@matjrah.com · دليل ربط ERP · مرجع API

منصة متجرة

ربط شحن واحد يغطي رحلة طلب التاجر.

تحوّل متجرة خدمة الشحن إلى تطبيق يستطيع التاجر تثبيته، وليس إلى مفتاح API منفصل. تنشئ شركة الشحن تطبيقها وتختبره في مركز المطورين، ثم يكتشفه التجار أو يقبلون دعوته من مركز التطبيقات.

يوافق كل تاجر على التطبيق بشكل مستقل. تبقى رموز الوصول والشحنات وعمليات إرسال Webhooks معزولة لكل تثبيت، ويمكن إلغاؤها من دون مشاركة بيانات الدخول الرئيسية للمتجر.

+3,500متجر يستخدم متجرة
نموذجان للتطبيقتطبيق شحن عام أو تطبيق شحن خاص بالدعوة
تثبيت مستقلصلاحيات ورمز وصول وملكية شحنات لكل متجر
شحن وإرجاععقد واحد يدعم الشحنة الأمامية وشحنة الإرجاع
مكتبة عبدالوهاب ميرزا عطار دزلول للمجوهرات متاجر ريرتي قيم ستور
متجرة
شركة شحن مجمّع شركات شحن مزود 3PL أسطول توصيل

هذه نماذج شراكات يدعمها العقد، وليست ادعاءً بوجود تكامل جاهز مع شركة شحن محددة.

نقطة فحص SANDBOX

حدث شحنة واحد موقّع، يتم قبوله وحفظه بأمان.

يثبت Sandbox الذاتي التثبيت، والتحقق من توقيع HMAC، واستلام shipment.creating. أما إرفاق البوليصة والتتبع والإلغاء وعزل المتاجر فتُختبر على متجر تجريبي نشط. تعرّف على بيئات الاختبار ↗

اختر نموذج التشغيل

تطبيق شحن واحد، يناسب طريقة تشغيلك.

شركة شحن أو مجمّع أو مزود 3PL أو أسطول خاص: تنشئ كل جهة تطبيق شحن يعرّف خدماتها وطريقة عملها مع التجار.

01 / شركة شحن

انشر خدمة شحن باسمك

عرّف الخدمة والتغطية وفترة التوصيل والسعر الافتراضي، ثم اسمح للتجار بتثبيتها من تصنيف الشحن.

مسار التطبيق العام ←
02 / مجمّع أو 3PL

قدّم عدة خدمات شحن

عرّف عدة رموز لشركات أو خدمات الشحن داخل تطبيق واحد، مع ربط كل بوليصة وملصق وتحديث تتبع بالخدمة المختارة.

مسار إعداد الخدمات ←
03 / أسطول خاص

شغّل الشحن لمتجر واحد

أنشئ تطبيق شحن خاصًا بالدعوة لحساب ناقل أو أسطول يخص تاجرًا واحدًا. يظل تطبيقًا له تثبيت وصلاحيات ومراجعة، لكنه لا يظهر في المركز العام.

مسار التطبيق الخاص ←

منتج متكامل — وليس ENDPOINT فقط

من إعداد خدمة الشحن إلى تطبيق جاهز للتجار

يدير مركز المطورين إنشاء تطبيق الشحن وبيانات خدماته وSandbox والمراجعة. ويدير مركز التطبيقات الظهور العام أو الدعوة. لا يستقبل التطبيق مهام الشحن ولا يعيد نتائج التشغيل إلا بعد تثبيته وموافقة التاجر.

  1. 01سجّلأنشئ حساب الشريك لفريق التكامل.
  2. 02أنشئ التطبيقاختر تطبيق شحن عامًا أو خاصًا.
  3. 03عرّف الخدماتأضف الرموز والتغطية والأسعار والفترات والدفع عند الاستلام.
  4. 04أثبت الاستلامتحقق من الحدث الموقّع وامنع معالجته مرتين.
  5. 05اختبر الدورةأرفق البوليصة وادفع التتبع واختبر الإلغاء.
  6. 06انشر أو ادعُثبّت التطبيق بشكل مستقل لكل متجر.

اختر نموذج التطبيق

عام للانتشار، أو خاص لمتجر واحد.

هذان هما مسارا الشحن فقط. ينشئ كلاهما تطبيق شحن مثبّتًا برمز وصول مستقل لكل متجر. لا يوجد للشحن مسار API أو Webhooks مباشر من لوحة المتجر من دون تطبيق.

تطبيق شحن عاملعدة تجار

انشر في تصنيف الشحن

مناسب لشركات الشحن والمجمّعين ومزودي 3PL الذين يملكون خدمة قابلة للتكرار ودعمًا واضحًا للتجار.

  • يظهر تحت تصنيف الشحن بعد الموافقة
  • يمكن لبيانات التطبيق تعريف خدمة واحدة أو عدة خدمات
  • لكل تاجر تثبيت ورمز وصول مستقل
  • يمكن للتاجر تعديل أسعاره المحلية بعد التثبيت
أنشئ تطبيق شحن عامًا ↗
تطبيق شحن خاصلمتجر واحد

أرسل تطبيق شحن خاصًا بالدعوة

مناسب لحساب شحن خاص بالتاجر، أو أسطول مخصص، أو مشروع تنفيذ لا يجب أن يظهر لبقية التجار.

  • لا يظهر في المركز العام
  • الدعوة مرتبطة بنطاق المتجر المحدد
  • يراجع التاجر الربط ويوافق عليه
  • يؤدي فصل التطبيق إلى إلغاء رمز التثبيت
أنشئ تطبيق شحن خاصًا ↗

عقد تشغيل الشحنة

استقبل المهمة، ثم أعد حقيقة الشحن.

API وWebhooks هما طبقة تشغيل تطبيق شحن معتمد ومثبّت، وليسا مسار ربط منفصلًا. تحقق من جسم Webhook الخام، واحفظ request_id وshipment_id، واستخدم رمز ذلك التثبيت فقط.

01 / MANIFEST

الخدمات والإعدادات

عرّف رموز الخدمات والدول والمدن والسعر الافتراضي وفترة التوصيل وقدرات مثل الدفع عند الاستلام.

02 / WEBHOOK

shipment.creating

استقبل الطلب والمستلم والمنتجات والوزن ومبلغ الدفع عند الاستلام واتجاه forward | return في حدث موقّع.

03 / AWB + LABEL

PUT /v1/shipments/{id}

أرفق رقم البوليصة ورقم التتبع ورابط تتبع ثابتًا ورابط الملصق الاختياري بالشحنة المحددة.

04 / LIFECYCLE

حدّث أو ألغِ

أرسل حالات الاستلام والنقل والخروج للتوصيل والتسليم والإرجاع أو الفشل، واستخدم مسار الإلغاء المخصص.

افتح مرجع API للشحن ↗Bearer ait_… · 120 طلبًا/دقيقة/تثبيت

ما الذي يجب اختباره؟

دورة التشغيل كاملة

الشعار ونجاح Webhook تجريبي لا يكفيان. تشمل المراجعة دورة المتجر المثبت فعليًا والتعامل مع حالات الفشل.

الشحنات الأماميةشحنات الإرجاعالبوليصة وملصق الشحنروابط تتبع ثابتةمبلغ الدفع عند الاستلامالمناطق والأسعار الافتراضيةالإلغاء وأمان إعادة المحاولةعزل بيانات كل متجر

الجاهزية للمراجعة

تطبيق شحن يستطيع التاجر تشغيله

تبدأ المراجعة بملكية الشحنة والتعافي من الفشل، وليس بنص صفحة التطبيق.

  • التحقق من التوقيعتحقق من HMAC باستخدام الجسم الخام قبل قراءة JSON.
  • منع التكرارلا تنشئ شحنة ثانية لدى الناقل عند تكرار request_id أو shipment_id.
  • عزل المتاجرلا تخلط رموز الوصول أو الطوابير أو الملصقات أو السجلات بين المتاجر.
  • اكتمال الاستجابةأعد البوليصة والملصق، ثم ادفع التتبع والإلغاء والحالات النهائية.
  • مراقبة قابلة للتصرفاربط الخطأ بالتثبيت والشحنة من دون كشف الأسرار أو بيانات المستلم.

أنشئ تطبيق الشحن

حوّل خدمة الشحن إلى تطبيق جاهز لتجار متجرة.

ابدأ بإنشاء تطبيق شحن من مركز المطورين. إذا كنت تمثل شركة شحن أو مجمّعًا أو مزود 3PL أو أسطولًا خاصًا وتحتاج إلى تنسيق تقني أو تجاري، احجز اجتماعًا مع فريقنا. ولدعم ربط التطبيق راسل dev@matjrah.com.

أنشئ تطبيق الشحناحجز اجتماعًا لمدة 30 دقيقة