تعديل الطلبات
يمكنك إضافة عناصر وإزالتها وتغيير الكميات وتعديل الشحن على طلب قائم. وكل تعديل يمسّ ثلاثة أشياء في آن واحد — المخزون، وإجمالي الدفع، وسجل التجهيز — ولهذا تُمنع بعض التعديلات تمامًا.
متى يتعذّر تعديل الطلب
| الحالة | الخطأ |
|---|---|
| الطلب ملغى أو مؤرشف | ORDER_NOT_EDITABLE |
| الطلب مُجهَّز بالكامل ويحتوي عنصرًا ماديًا واحدًا على الأقل | ORDER_NOT_EDITABLE |
| الكمية الجديدة أقل مما عُبِّئ فعلًا لذلك العنصر | ITEM_QUANTITY_BELOW_FULFILLED |
ولقاعدة "مُجهَّز بالكامل" استثناء مقصود: الطلبات الرقمية بالكامل تبقى قابلة للتعديل. فهي تُجهَّز تلقائيًا عند الإنشاء، ومعنى "مُجهَّز" فيها هو "لا شيء للشحن" لا "انتهى العمل".
أما قاعدة "أقل مما عُبِّئ" فهي مرآة ضابط التعبئة: لا يمكنك تعبئة أكثر مما طُلب، ولا أن تطلب أقل مما عُبِّئ. وكلا الأمرين يجعل السجل يدّعي شحن وحدات غير موجودة.
أثر كل تعديل على المبالغ
إضافة عناصر
يرتفع إجمالي الطلب ويصبح الفارق رصيدًا مستحقًا. والطلب الذي كان مدفوعًا ينتقل إلى مدفوع جزئيًا.
وإذا كان العنصر المضاف منتجًا رقميًا والطلب مدفوعًا بالفعل، يُصدَر رابط تحميله فورًا.
إزالة عناصر أو تقليل الكمية
ينخفض إجمالي الطلب.
- إذا كان الطلب مدفوعًا بالفعل، تُسجَّل قيمة المُزال كـاسترداد، بحد أقصى ما حُصِّل فعلًا. وتنتقل حالة الدفع إلى مسترد جزئيًا، أو مسترد إذا لم يتبقَّ شيء.
- إذا لم يكن الطلب مدفوعًا بعد، يتغير المبلغ المستحق فقط ولا يُسترد شيء.
وكالعادة، الاسترداد تسجيل لا تحويل. فالمال المستحق ردّه في طلب مدفوع بالبطاقة يجب إعادته عبر البوابة.
المخزون
إزالة عنصر تعيد كمياته إلى المخزون، وإضافته تسحب كميات، وتُرفض الإضافة إن لم تكن الكمية كافية (INSUFFICIENT_QUANTITY / PRODUCT_OUT_OF_STOCK).
العناصر المخصصة والأسعار المخصصة
يمكنك إضافة عنصر مخصص — بند باسم وسعر غير موجود في كتالوجك — لرسم خاص أو خدمة أو منتج فردي.
كما تدعم عناصر الكتالوج تجاوز السعر بـسعر مخصص على البند. وهكذا تحتفظ منتجات "ادفع ما تراه مناسبًا" بالسعر الذي اختاره العميل.
لأن بند الطلب لا يتذكر أن العنصر كان من نوع "ادفع ما تراه مناسبًا"، فق د تُعيد عملية الحفظ السعر إلى سعر الكتالوج. راجع إجمالي البند بعد تعديل أي طلب يحتوي عناصر من هذا النوع.
الشحن
يمكن تجاوز قيمة الشحن على الطلب بسعر واسم مخصصين — وهو مفيد عند التفاوض على رسوم توصيل أو التنازل عنها كبادرة حسن نية.
ما الذي يُسجَّل
كل تعديل يُكتب في السجل الزمني للطلب: العناصر المضافة والمُزالة، وتغيّرات الكميات، وتغيير طريقة الشحن، والخصومات المضافة أو المُزالة. ويذكر السجل من نفّذ التغيير.
مرجع الـ API
| الإجراء | العنوان |
|---|---|
| تعديل عناصر الطلب | PATCH /v1/order/:orderId/items |
| تحديث بيانات الطلب | PATCH /v1/order/:orderId |