نماذج استجابة Order API
الأنواع في packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). كل المبالغ: fen.
StandardOrderPreviewResult {#standard-order-preview-result}
من معاينة الطلب.
| الحقل | النوع | الوصف |
|---|---|---|
success | boolean | تكون false عندما لا يمكن شراء البنود؛ افحص unavailable_lines |
total.payment | Money | إجمالي المبلغ المستحق |
total.shipping | Money | جزء الشحن المحلي |
sellers[] | array | مجمعة حسب البائع مع lines[] والرسوم |
unavailable_lines[] | array | فشل التحقق أو المخزون |
trade_types[] | array | 1688 فقط |
promotions | object | عروض 1688 عند وجودها |
StandardOrderCreateResult {#standard-order-create-result}
| الحقل | النوع | الوصف |
|---|---|---|
order_id | string | استخدمه للدفع والتفاصيل والتتبع |
total.payment | Money | المبلغ المطلوب دفعه |
order_list[] | array | طلبات فرعية / تقسيمات البائع |
failed_offers[] | array | قد يكون الإنشاء جزئيا مع success: true |
outer_purchase_id | string | مفتاح idempotency في Taobao |
payment_url | string | رابط دفع Taobao اختياري |
StandardOrderPayResult {#standard-order-pay-result}
| الحقل | الوصف |
|---|---|
success | تم قبول الدفع |
pay_channel | طريقة دفع 1688 |
error_code / error_message | عند success: false |
StandardOrderDetail {#standard-order-detail}
| الحقل | الوصف |
|---|---|
status | مثل wait_payment, wait_shipment, shipped |
refund_status | للقراءة فقط؛ واجهات refund ليست عامة |
amounts | total, product_total, shipping_fee, refund (fen) |
line_items[] | صفوف المنتج مع sku_specs, status |
times | created_at, paid_at, shipped_at, … |
domestic_parcels[] | وضع المستودع → fulfillment |
UnifiedLogisticsTrace {#unified-logistics-trace}
من التتبع المحلي.
| الحقل | الوصف |
|---|---|
packages[] | tracking_number, carrier, steps[] |
cross_border_packages[] | عقد 1688 عبر الحدود — ليست international fulfillment |
StandardOrderCancelResult {#standard-order-cancel-result}
| الحقل | الوصف |
|---|---|
success | تم قبول الإلغاء (قد يستمر في المعالجة) |
pending | إلغاء Taobao غير متزامن |
sub_order_ids | معرفات متأثرة بالإلغاء الجزئي |