> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.

# التنفيذ التلقائي لحماية الشحن لا يعمل كما هو متوقع

> يوضح هذا المقال كيفية عمل ميزة التنفيذ التلقائي لحماية الشحن في Upcart ويحدد خطوات استكشاف الأخطاء عندما لا تعمل كما هو متوقع.

<div id="how-auto-fulfillment-works">
  ## كيف يعمل التنفيذ التلقائي
</div>

ينفّذ Upcart تلقائيًا عنصر **حماية الشحن** عند استيفاء جميع الشروط التالية:

1. **تفعيل التنفيذ التلقائي لحماية الشحن في Upcart**
   * في Cart Editor، افتح وحدة **Add-ons** وانتقل إلى قسم **Advanced settings** الخاص بها.
   * تأكد من تفعيل **Auto-fulfill shipping protection**. لا يظهر مربع الاختيار إلا بعد أن تكون حماية الشحن نفسها نشطة في **General settings** الخاصة بالوحدة — إذا لم تتمكن من العثور عليه، ففعّل حماية الشحن أولًا.
2. **أن يكون منتج حماية الشحن عنصرًا رقميًا**
   * في Shopify، انتقل إلى **Products** وحدد منتج **Shipping Protection** الذي أنشأه Upcart.
   * افتح المنتج، ومرّر إلى قسم **Shipping**، وتأكد من أن مربع الاختيار **This is a physical product** **غير محدد**.
     * يضمن ذلك أن تتعامل Shopify معه كمنتج رقمي وتسمح بالتنفيذ التلقائي. **نصيحة:** إذا كانت لديك عدة مستويات لحماية الشحن، فيجب أن تستوفي جميع المنتجات ذات الصلة هذا الشرط نفسه.
3. **وجود خصائص المنتج المطلوبة**\
   ينفّذ Upcart العنصر عبر الاستماع إلى webhook **orders/partially\_fulfilled**.\
   عند تنفيذ جزء من الطلب، ينفّذ Upcart حماية الشحن تلقائيًا إذا تعرّف على خصائص عنصر السطر التالية:
   * `__upcartAddon: XXX`
   * `__upcartShippingProtection: true` تحقق من إعدادات منتجك للتأكد من تضمين كلتا الخاصيتين.

<img src="https://mintcdn.com/aftersell/uVGuDiyXpd6WOLO4/images/upcart/shipping-protection-fulfillment-unfulfilled-order-line-item.png?fit=max&auto=format&n=uVGuDiyXpd6WOLO4&q=85&s=98b3412c68b5444220132621f3038309" alt="طلب غير منفَّذ في Shopify يعرض عنصر سطر Shipping Protection مع خاصيتَي عنصر السطر الخاصتين بإضافة Upcart وحماية الشحن" width="2990" height="1242" data-path="images/upcart/shipping-protection-fulfillment-unfulfilled-order-line-item.png" />

***

<div id="why-shipping-protection-is-treated-as-a-product">
  ## لماذا تُعامل حماية الشحن كمنتج
</div>

تُهيّأ حماية الشحن في Shopify كـ **منتج** لدعم التسعير المتدرج والتفاعل مع قواعد السلة.\
يتيح ذلك لـ Upcart حساب الحماية وتطبيقها ديناميكيًا بناءً على قيمة الطلب أو محتويات السلة.

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

***

<div id="managing-storefront-visibility">
  ## إدارة الظهور في واجهة المتجر
</div>

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

1. في لوحة إدارة Shopify، انتقل إلى **Products** وافتح منتج **Shipping Protection** الذي أنشأه Upcart.
2. في القائمة المنسدلة **Status** بالقرب من أعلى صفحة المنتج، اختر **Unlisted**.
3. انقر على **Save**.

المنتج **Unlisted** مخفي عن بحث واجهة متجرك وصفحات المجموعات وتوصيات المنتجات وكتالوج Shopify ومحركات البحث، مع استمراره في العمل بشكل طبيعي في السلة وعند الدفع ولتنفيذ الطلبات. يُبقي ذلك حماية الشحن بعيدة عن أنظار العملاء المتصفحين بينما يستمر Upcart في إضافتها وتنفيذها تلقائيًا في الخلفية.

<Note>
  تتصرف المنتجات Unlisted مثل المنتجات Active في السلة وعند الدفع وفي الطلبات، لذا فإن ضبط Shipping Protection على Unlisted لا يتعارض مع التنفيذ التلقائي أو مع كيفية تطبيق الإضافة على السلة.
</Note>

<Tip>
  يحل Unlisted محل النهج القديم المتمثل في إخفاء هذا المنتج عبر حقل تعريف `seo.hidden`. لم تعد بحاجة إلى تعديل حقول التعريف لإبقائه بعيدًا عن واجهة متجرك.
</Tip>

***

<div id="summary">
  ## ملخص
</div>

لضمان تنفيذ حماية الشحن تلقائيًا بشكل صحيح:

* فعّل **Auto-fulfill shipping protection** في Upcart.
* حدّد المنتج على أنه **غير مادي** في Shopify.
* تحقق من تطبيق **خصائص عنصر السطر** الصحيحة.
* استثنِه من قواعد الخصم، واضبطه على **Unlisted** لإبقائه بعيدًا عن واجهة متجرك، إذا لزم الأمر.

يضمن اتباع هذه الخطوات تنفيذًا سلسًا ويمنع التعارضات مع إعدادات الخصم أو ظهور المنتجات في Shopify.