طلبات الشراء

العمليات

آلية العمل

تتضمن قائمة الطلبات وتفاصيلها delivery.dates. التواريخ بصيغة YYYY-MM-DD مخططة ولا تؤكد الشحن الفعلي. للتواريخ الحالية الأولوية؛ وتستخدم الطلبات القديمة التقدير المحفوظ. القيم المحذوفة أو غير المعروفة هي null. تتضمن التفاصيل أيضًا جميع بنود الطلب وصور المنتجات.

احصل على معرّفات حالات صالحة من /api/v1/order-statuses. تستخدم حالة الطلب وحالة الدفع نقطتي نهاية PATCH وصلاحيات منفصلة. لا يؤدي تغيير حالة الدفع المسجلة إلى خصم مبلغ من بطاقة أو إصدار استرداد عبر مزود دفع.

عمليات كتابة آمنة

الصلاحيات والخطط

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. تواريخ الشحن والتسليم: YYYY-MM-DD; null. المنطقة الزمنية للشحن: IANA.

الطلب · المجاميع

تأتي المبالغ ومعدلات الضريبة من الطلب المحفوظ، بما يشمل تصحيحات البنود⁦.⁩ تكون البيانات التاريخية المفقودة ⁦null⁩ ولا تُستبدل بمعدلات الكتالوج الحالية⁦.⁩ تبقى المبالغ سلاسل نصية عشرية⁦.⁩

• ⁦tax_country_code⁩ · بلد الضريبة · بيانات الطلب المحفوظة · ⁦ISO 3166-1 alpha-2; null.⁩
• ⁦lines[].unit_*⁩ · وحدة واحدة · قبل الخصومات⁦; lines[].original_total_*⁩ · قبل الخصومات⁦; lines[].total_*⁩ · بعد الخصومات⁦.⁩
• ⁦lines[].discount_*⁩ · الخصومات⁦; manual_discount⁩ · خصم يدوي⁦; percentage "10" = 10%.⁩
• ⁦delivery.net / tax / gross⁩ · بعد الخصومات⁦; delivery.original_*⁩ · قبل الخصومات⁦; delivery.discount_*⁩ · الخصومات⁦.⁩
• ⁦tax_rate: "0.23" = 23%; "0" ≠ null.⁩ غير معروف⁦: null⁩؛ صفر معروف⁦: 0.⁩
• ⁦totals⁩ · المجاميع⁦; tax_breakdown.groups⁩ · مجموعات الضرائب⁦;⁩ ضريبة غير موزعة ⁦= order.tax − Σ groups.tax; ±.⁩

تعيد القائمة ملخصات⁦.⁩ اجلب ⁦GET /api/v1/orders/{order_id}⁩ لكل نتيجة لتصدير التفاصيل المالية الكاملة⁦.⁩ محاولات ⁦GET⁩ محدودة وتلتزم بـ ⁦Retry-After.⁩ لا يزامن التصدير حسب تاريخ الإنشاء التصحيحات اللاحقة⁦.⁩

⁦payment.amount⁩ هو إجمالي الطلب⁦.⁩ لا تحدد حالة الدفع المبالغ المدفوعة أو المستردة أو المتبقية⁦.⁩