أخطاء ربط المتجر وفشل استيراد الطلبات

ما الذي يعنيه الخطأ#

عند ربط متجرك (زد أو سلة أو WooCommerce أو Shopify) تتحول طلباته إلى طرود تلقائياً بالمسار نفسه الذي تستخدمه صفحة «طرد جديد». وقد يتعطل ذلك من جهتين. الأولى ربط لا يستطيع الاتصال بالمتجر لانتهاء صلاحيته أو رفض مفاتيحه. والثانية طلب وصل فعلاً لكن تعذّر إنشاء طرد منه، فيأخذ الحالة «فشل» مع سبب، ويصل التاجر إشعار فوري (Push) بعنوان «طلب ما انعمل طرد».

من يستطيع الوصول#

تجار المنصة فقط، من صفحة «ربط المتاجر». التاجر التابع لشركة توصيل لا يستطيع استخدامها. وعند تفعيل باقات التجار يُشترط لربط متجر WooCommerce أو Shopify أو سلة أن تتضمن الباقة ميزة ربط المتاجر، وقد يحدّد حدٌّ في الباقة عدد المتاجر المربوطة.

الأسباب المحتملة#

صلاحية الربط (زد وسلة). يظهر شريط «صلاحية الربط:» في قسم كل منصة (زد وسلة):

• زد: «تطبيقنا انشال من متجر زد — اربطه من جديد.» أو «صلاحية الربط مع زد انتهت — اكبس "إعادة الربط بزد".» أو صلاحية قاربت على الانتهاء ولا يوجد رمز تجديد محفوظ. الحل هو «إعادة الربط بزد».
• سلة: «سلة رفضت تجديد الصلاحية — افتح تطبيقنا من لوحة سلة (التطبيقات المثبتة) ووافق على الصلاحيات من جديد.» وإذا انتهت الصلاحية فجرّب «جدّد الآن» أولاً.
• «آخر محاولة تجديد فشلت: ...» يتبعها سبب الفشل، مثل «سلة رفضت التجديد (HTTP 500)». أما رفض سلة بالرمز HTTP 400 أو 401 فيُظهر بدلاً منه رسالة «سلة رفضت تجديد الصلاحية» أعلاه.
• يجري التجديد تلقائياً كل ساعة. صلاحية زد سنة وتُجدَّد قبل انتهائها بـ 60 يوماً، وصلاحية سلة نحو 14 يوماً وتُجدَّد عند بقاء أقل من 3 أيام.
• أما ربط WooCommerce أو ربط Shopify فلا يظهر له هذا الشريط. اضغط «فحص الاتصال» فتظهر رسالة مثل «المفاتيح مرفوضة من المتجر (401)...». ويظهر آخر خطأ على بطاقة المتجر بعلامة ⚠.

فشل استيراد الطلب. يظهر السبب في عمود «ملاحظة / سبب» بصفحة «الطلبات» للمتجر، وفي قائمة «آخر طلبات زد» لزد:

• «إعداد المتجر ناقص: ...»: لم تحدد شركة الشحن أو مكان الاستلام للمتجر، أو لم يعودا متاحين لحسابك.
• أي سبب من أسباب رفض الطرد: التغطية أو الوزن أو العملة أو الباقة. وللطلب بعملة لا تقبلها الشركة وليس لها سعر صرف تظهر رسالة تطلب من مدير المنصة تحديده من «العملات وسعر الصرف».
• طلبات زد: «طريقة الشحن مو Delivery Syria: ...» (الافتراضي أن تُقبل الطلبات التي اختار الزبون فيها شحننا فقط)، أو «الطلب ملغي أو غير مدفوع في زد، ما انعمل طرد». ولا يصل إشعار عند الرفض بسبب طريقة الشحن. أما «بانتظار اكتمال الدفع الأونلاين» فليست فشلاً: يبقى الطلب منتظراً مع هذه الملاحظة ويُنشأ طرده عندما تُبلِّغ زد المنصة بإتمام الدفع، ولا حاجة لإعادة المحاولة.
• نقص الرصيد ليس فشلاً: يُنشأ الطرد «بانتظار الرصيد» وتظهر الملاحظة «رصيد المحفظة غير كافٍ — الطرد بانتظار شحن الرصيد وسيكتمل تلقائياً.» (وفي زد: «رصيد المحفظة غير كافٍ، الطرد بانتظار الشحن»). ويكتمل تلقائياً بعد أن تشحن «رصيد الشحن»، ويُلغى بعد 24 ساعة إن لم يتوفر الرصيد.
• «الطلب انلغى بالمتجر بعد إنشاء الطرد ...»: الطرد لا يُلغى تلقائياً، فألغِه أو احذفه يدوياً.

الإعادة التلقائية والإشعار

• طلبات WooCommerce أو Shopify أو سلة التي بقيت «قيد المعالجة»، أو علقت في «جاري الإنشاء» أكثر من 10 دقائق، يلتقطها النظام كل 5 دقائق ما دامت محاولاتها أقل من 5 (ويُشترط في طلبات WooCommerce أو Shopify أيضاً أن يقل عمر الطلب عن 7 أيام).
• أما طلبات زد المنتظرة (الجديدة، أو المنتظرة اكتمال الدفع الأونلاين) فيلتقطها النظام كل دقيقة.
• والطلب الذي صار «فشل» لا يُعاد تلقائياً في أي منصة، إلا ما فشل بسبب «إعداد المتجر ناقص» فيُعاد عند حفظ إعدادات المتجر.
• نص الإشعار: «طلب {tracking} من متجرك ما انعمل طرد: {reason}»، حيث {tracking} رقم الطلب في المتجر و{reason} سبب الفشل مقتطعاً عند 200 حرف. يُرسل عند أول فشل ولا يتكرر مع المعالجة التلقائية (وفي زد قد يُرسل مجدداً إذا فشل الطلب من جديد بعد إعادة محاولة يدوية)، إلى أجهزتك المسجّلة، فلا يصلك إن لم يكن لك جهاز مسجّل.

كيف تشخّص المشكلة#

• افتح «ربط المتاجر». تعرض بطاقة المتجر المربوط (WooCommerce أو Shopify أو سلة) «طرود: ... بانتظار الدفع: ... فشل: ...» مع آخر خطأ، أما شريط الصلاحية فيظهر في قسمي سلة وزد من الصفحة لا على البطاقة. وفي قسم سلة تعرض «آخر طلبات سلة الواصلة» آخر أحداث الطلبات مع نتيجة كل منها.
• اضغط «الطلبات» لتعرف حالة كل طلب وسببها. ولا تملك زد بطاقة متجر: استخدم قسم زد (إعادة الربط بزد، الإعدادات، آخر طلبات زد مع أسبابها).

خطوات الحل#

1. جدّد الربط

   اضغط «جدّد الآن» (وهو يظهر لزد ما دامت الصلاحية سارية فقط). فإن لم ينجح، أو كان تطبيق زد قد أُزيل أو انتهت صلاحيته، فأعد الربط: «إعادة الربط بزد»، أو افتح تطبيق Delivery Syria في لوحة سلة ووافق من جديد. وفي ربط WooCommerce أو ربط Shopify اقرأ رسالة «فحص الاتصال». ولا تحوي بطاقة المتجر حقلاً للمفاتيح: لاستبدالها اربط رابط المتجر نفسه من جديد بالمفاتيح الجديدة في نموذج «ربط ووكمرس» أو «ربط شوبيفاي» (فيُحدَّث الربط ويُفحص وتُسجَّل روابط ويب هوك المتجر تلقائياً). أما «إعادة تسجيل الـ Webhooks» فتعيد محاولة التسجيل بالمفاتيح المحفوظة فقط.

2. حدّد شركة الشحن ومكان الاستلام

   اخترهما على بطاقة المتجر (أو في إعدادات زد) واحفظ. تُعاد الطلبات التي توقفت بسبب نقصهما تلقائياً.

3. صحّح العنوان وأعد المحاولة

   في «الطلبات» اكتب العنوان الصحيح أو اختر المحافظة في سطر الطلب الفاشل ثم اضغط «إعادة المحاولة». وفي زد استخدم قائمة «آخر طلبات زد»: «أعد المحاولة» لطلب واحد أو «أعد محاولة كل الطلبات الفاشلة» للجميع.

4. فعّل الربط إن كان موقوفاً

   إذا كانت حالة الربط «موقوف» فاضغط «تفعيل» على بطاقته. وتبقى طلبات الربط الموقوف، أو الذي أُطفئ إنشاؤه التلقائي، بانتظار المعالجة.

123

1. شاهد طلبات هذا المتجر
2. شركة التوصيل لطلبات المتجر
3. مكان الاستلام الافتراضي

متى تتواصل مع الدعم#

• إذا كان سبب فشل التجديد إعداداً في الخادم، مثل «ZID_CLIENT_ID أو ZID_CLIENT_SECRET فاضي بملف .env»، فهذا لا يمكنك معالجته من حسابك. أما إذا ظهرت بعد «آخر محاولة تجديد فشلت:» الرسالة «الـ refresh token ما بينقرا (ممكن APP_KEY تغيّر) — أعد الربط بزد.» فاضغط «إعادة الربط بزد» فتُحفظ رموز الربط من جديد.
• إذا نجح «فحص الاتصال» ومع ذلك لا تصل طلبات المتجر إلى المنصة فتواصل مع الدعم.
• أرسل اسم منصة المتجر (زد أو سلة أو WooCommerce أو Shopify) ورابط المتجر ورقم الطلب ونص السبب ووقت المحاولة.