MATJRAH DEVELOPERS + APPS CENTER

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

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

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

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

منصة متجرة

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

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

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

+3,500متجر يستخدم متجرة

مسار تطبيق واحدأنشئ تطبيق شحن من مركز المطورين

تثبيت مستقلصلاحيات ورمز وصول وملكية شحنات لكل متجر

شحن وإرجاععقد واحد يدعم الشحنة الأمامية وشحنة الإرجاع

شركة شحن مجمّع شركات شحن مزود 3PL أسطول توصيل

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

نقطة فحص SANDBOX

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

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

قبل كتابة الكود

جهّز طرف شركة الشحن أولًا.

يبدأ الربط العملي بثلاثة مدخلات واضحة. جهّزها قبل بناء المعالجات أو ربط الحقول.

01 / API الناقل

أثبت الإنشاء والملصق والإلغاء

تأكد من بيانات بيئة ناقل الاختبار والطلبات الفعلية لإنشاء الشحنة وجلب البوليصة والملصق والتتبع والإلغاء.

دورة التشغيل ←

02 / WEBHOOK آمن

استقبل المهمة واحفظها

وفّر عنوان HTTPS واحدًا يتحقق من توقيع الجسم الخام ويحفظ الحدث، ثم أرسل عمل الناقل البطيء إلى طابور.

عقد Webhook ←

03 / جدول الربط

اربط الخدمات والحالات

ضع كل رمز خدمة وتغطية ودعم للدفع عند الاستلام وحالة تتبع لدى الناقل بجانب قيمة متجرة الموثقة.

نطاق الاعتماد ←

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

ابنِ أول شحنة تعمل بهذا الترتيب.

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

01سجّلأنشئ حساب الشريك لفريق التكامل.
02أنشئ التطبيقاختر نوع الشحن وأضف عنوان Webhook الآمن.
03عرّف الخدماتأضف الرموز والتغطية والأسعار والفترات والدفع عند الاستلام.
04أثبت الاستلامتحقق من الحدث الموقّع وامنع معالجته مرتين.
05اختبر الدورةأرفق البوليصة وادفع التتبع واختبر الإلغاء.
06أرسل وانشرأكمل المراجعة ثم اسمح لكل تاجر بالتثبيت المستقل.

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

اضبط مركز المطورين ونظامك الخلفي معًا.

للشحن مسار واحد: تطبيق شحن معتمد. تعمل API وWebhooks داخل التطبيق المثبّت، وليستا بيانات ربط مباشرة مستقلة من لوحة المتجر.

مركز المطورينالإعداد

أنشئ تطبيق الشحن وعرّف خدمته

اضبط المنتج الذي سيثبته التجار والخدمات التي سيعرضها.

اختر نوع تطبيق الشحن
أضف الاسم والشعار والدعم وروابط السياسات
سجّل عنوان Webhook يعمل عبر HTTPS
عرّف رموز الناقل والتغطية والأسعار والفترات والدفع عند الاستلام

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

نظامك الخلفيالتشغيل

ابنِ عامل شحنة واحدًا آمنًا

اجعل استجابة Webhook سريعة، وانقل طلب الناقل إلى ما بعد حجز المهمة وحفظها.

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

افتح مرجع API للشحن ↗

لديك تطبيق جاهز على سلة؟

احتفظ بمنطق الناقل.
واستبدل طبقة المنصة.

إذا كان تطبيق سلة لديك ينشئ البوليصات والملصقات ويرسل التتبع بالفعل، فلا تعِد بناء ربط شركة الشحن. احتفظ بهذه الطبقة المجربة، وأضف بجانبها محوّل تطبيق شحن متجرة للتثبيت والأحداث الموقعة وملكية الشحنة والاستجابات.

حمّل Skill التحويل العملية اقرأ عقد تحويل الشحن ↗

احتفظ بها

نواة الشحن المجربة

دخول شركة الشحن وعميل API
إنشاء البوليصة والملصق
توحيد حالات التتبع
قواعد الإلغاء والإرجاع
الطوابير والمراقبة وأدوات الدعم

استبدلها

حافة منصة التجارة

Salla OAuth ← حدث app.installed موقّع
دورة رمز سلة ← رمز ait_… مستقل لكل متجر
توقيع حدث سلة ← HMAC متجرة للجسم الخام
بيانات شحنة سلة ← shipment.creating
استجابات سلة ← إرفاق وتتبع وإلغاء متجرة

نموذج أولي مركزشحنة واحدة تعمل خلال 24 ساعة

هدف عملي عندما يكون تطبيق سلة وAPI شركة الشحن جاهزين، وليس ضمانًا للجاهزية الإنتاجية أو الاعتماد.

01احصر محوّل سلة من دون تعديل
02أضف تثبيت متجرة والتحقق من التوقيع
03اربط عينة shipment.creating واحدة
04أعد بوليصة وملصقًا واحدًا بأمان

ما الذي يجب أن يسلّمه وكيل AI؟ ملفات inventory.md وmapping.md وgaps.md وtest-plan.md، ومحوّل متجرة مستقل، واختبارات للتوقيع الخاطئ والتكرار وعزل المتاجر وأمان إعادة المحاولة.

لا ترسل رموز الإنتاج أو بيانات المستلم أو payloads حقيقية إلى أي أداة AI ما لم تعتمدها مؤسستك وتوافق على ضوابط بياناتها.

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

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

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.
عزل المتاجرلا تخلط رموز الوصول أو الطوابير أو الملصقات أو السجلات بين المتاجر.
اكتمال الاستجابةأعد البوليصة والملصق، ثم ادفع التتبع والإلغاء والحالات النهائية.
مراقبة قابلة للتصرفاربط الخطأ بالتثبيت والشحنة من دون كشف الأسرار أو بيانات المستلم.