الإلغاء والاسترداد والمرتجعات
ثلاثة إجراءات مختلفة كثيرًا ما تختلط. اختر بينها حسب مكان البضاعة:
| البضاعة… | استخدم | النتيجة |
|---|---|---|
| ما زالت لديك | الإلغاء | يُغلق الطلب، ويوقف العمل المعلّق، ويعيد المخزون اختياريًا |
| مع العميل | المرتجع | طلب مُتتبَّع ← استرداد ← إعادة للمخزون |
| لا علاقة للبضاعة — عليك رد مبلغ فقط | الاسترداد | تعديل سجل الدفع |
إلغاء الطلب
الإلغاء يوقف كل ما لم يُشحن بعد، دون تغيير ما شُحن فعلًا.
لا يمكن إلغاء إلا الطلبات المفتوحة. الطلب الملغى مسبقًا يفشل بالخطأ ORDER_ALREADY_CANCELLED، والمؤرشف بالخطأ ORDER_NOT_CANCELLABLE.
ما يحدث، بالترتيب:
- يُعلَّم الطلب كملغى مع السبب الذي اخترته (عناصر غير متوفرة، نفاد المخزون، مشكلة دفع، احتيال، خطأ من الموظفين، أخرى).
- تُسوّى الدفعة:
- مُصرّح به (بانتظار اعتماد لقطة إثبات الدفع) ← يُلغى التصريح ويُحرَّر الحجز.
- مدفوع أو مسترد جزئيًا مع تفعيلك لخيار استرداد المبلغ المتبقي ← يُسترد الرصيد المحصَّل المتبقي.
- غير مدفوع أو فاشل أو منتهي الصلاحية أو مُلغى التصريح أو مسترد بالفعل ← لا شيء.
- يُغلق عمل التجهيز غير المشحون. تُعلَّم العناصر التي لم تُشحن بعد كمُزالة، وتحتفظ العناصر المشحونة بحالتها، فيبقى السجل صادقًا بشأن ما خرج فعلًا.
- يعود المخزون إذا فعّلت إعادة العناصر إلى المخزون — وللكميات غير المشحونة فقط. أما ما شُحن فلا يعود، لأنه غادر مخزنك.
- تُلغى التحميلات الرقمية.
- يُرسَل بريد للعميل، ما لم تعطّل ذلك في الطلب أو تعطّل رسائل الإلغاء في إعدادات إشعارات متجرك.
الطلب غير المدفوع لا يوجد فيه ما يُسترد. ألغِه مع تفعيل إعادة العناصر إلى المخزون.
المرتجعات
استخدم المرتجع عندما تكون البضاعة لدى العميل ب الفعل وهو يعيدها. وخلافًا للاسترداد المجرد، المرتجع طلب مُتتبَّع له دورة حياة خاصة.
شروط القبول
| القاعدة | التفصيل |
|---|---|
| يجب أن تكون الدفعة مدفوعة أو مدفوعة جزئيًا | وإلا يظهر الخطأ PAYMENT_NOT_ELIGIBLE_FOR_REFUND |
| خلال 14 يومًا من تاريخ الطلب | وإلا RETURN_WINDOW_EXPIRED. المدة ثابتة وغير قابلة للتعديل. |
| العناصر المشحونة فعلًا فقط | لا يمكن إرجاع كمية أكبر مما جُهِّز (INVALID_RETURN_QUANTITY) |
| مرتجع واحد لكل طلب | الطلب الثاني يفشل بالخطأ RETURN_ALREADY_EXISTS |
الحالات
قيد الانتظار ← قيد المعالجة ← مسترد ← معاد للمخزون اختياريًا. ويمكن إلغاء المرتجع ما دام قيد الانتظار أو المعالجة، وبعدها يثبت (RETURN_INVALID_STATE).
وإلغاء المرتجع يفصله عن الطلب، فيمكن إنشاء مرتجع جديد.
استرداد قيمة المرتجع
يُحتسب مبلغ الاسترداد من العناصر المرتجعة، مضافًا إليه الشحن إذا فعّلت استرداد الشحن. وإذا أرسلت مبلغًا غير مطابق، يُرفض الطلب مع بيان المبلغ المتوقع — وهو ضابط ضد الأخطاء في الإدخال.
إعادة المخزون
إعادة المخزون خطوة منفصلة عن الاسترداد، ولا تعمل إلا إذا أُنشئ المرتجع مع تفعيل إعادة المخزون. وتُنفَّذ مرة واحدة فقط (RESTOCK_ALREADY_PROCESSED). أما العناصر المخصصة — البنود التي ليست منتجات حقيقية في الكتالوج — فتُتخطى.
نفّذها عند وصول البضاعة فعليًا، لا عند إصدار الاسترداد.
الاسترداد
الاسترداد المباشر يعدّل الدفعة دون سجل مرتجع. والقواعد الكاملة في كيف تعمل المدفوعات، وأهمها:
- لا يمكن استرداد إلا المدفوعات بحالة مدفوع أو مسترد جزئيًا.
- لا أكثر مما حُصِّل أبدًا — يُفحص لحظة الكتابة، فلا يمر استردادان متزامنان معًا.
- لا يمكن استرداد العنصر نفسه بالكمية نفسها مرتين.
- استرداد كل المبلغ ← مسترد، وجزء منه ← مسترد جزئيًا.
- تختار طريقة الاسترداد: الطريقة الأصلية أو غيرها كالنقد أو رصيد المتجر.
TakeTheme تسجّل الاسترداد ولا تستدعي واجهة الاسترداد لدى بوابتك. نفّذ الاسترداد في كاشير أو باي موب أو باي تابس أو باي بال أو سترايب، ثم سجّله هنا حتى تتطابق التقارير.
مرجع الـ API
| الإجراء | العنو ان |
|---|---|
| إلغاء طلب | POST /v1/order/vendor/cancel/:orderId |
| أرشفة طلب | POST /v1/order/vendor/archive/:orderId |
| إنشاء مرتجع | POST /v1/order/:orderId/returns |
| استرداد قيمة مرتجع | POST /v1/order/:orderId/returns/refund |
| إعادة مرتجع للمخزون | POST /v1/order/:orderId/returns/restock |
| إلغاء مرتجع | POST /v1/order/:orderId/returns/cancel |
اقرأ أيضًا
- دورة حياة الطلب
- تعديل الطلبات — إزالة العناصر تسجّل استردادًا تلقائيًا
- كيف تعمل المدفوعات