نماذج استجابة 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 | تكون true فقط بعد التحقق من إجمالي الدفع ومجموعات البائعين وكل البنود المطلوبة والتوفر وطريقة المعاملة المطبقة |
total.merchandise | Money | null | المجموع الفرعي للبضائع؛ null فقط عندما تكون القيمة مجهولة فعلا |
total.payment | Money | إجمالي المبلغ المستحق |
total.shipping | Money | null | الشحن المحلي؛ الشحن المجاني المعروف هو Money بقيمة amount: 0 |
sellers[] | array | مجمعة حسب البائع مع lines[] والرسوم |
unavailable_lines[] | array | فشل التحقق أو المخزون |
trade_types[] | array | 1688 فقط |
promotions | object | عروض 1688 عند وجودها |
code / message | string | حالة أعمال اختيارية مثل LINE_UNAVAILABLE وUNSUPPORTED_TRADE_MODE وPREVIEW_INCOMPLETE |
monetary_unit | string | دائما CNY_minor في standard preview |
request_id | string | معرف ربط الطلب |
تعيد standard preview القابلة للتفسير لكنها غير مكتملة HTTP 200 مع success:false. للتوافق، تحتفظ أخطاء 1688 الصريحة الخاصة بـ SKU أو المخزون أو MOQ أو قيود السوق بسلوك HTTP 502 CHANNEL_UPSTREAM_ERROR. في وضع response_format:"upstream" قد يحتوي HTTP 200 على فشل أعمال upstream؛ افحص الحقول الأصلية upstream.success وcode وmessage وما يقابلها داخل العناصر المتداخلة.
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}
يعيد Taobao self القياسي success: true بعد تأكيد الدفع باستعلام الطلب فقط. لا يثبت code: "0" أو نجاح قديم خصم المال. تعني pending نتيجة Gateway غير المؤكدة، لا حالة طابور رسمية.
| الحقل | الوصف |
|---|---|
success | Taobao self القياسي: true فقط بعد تأكيد الدفع من استعلام الطلب |
pending / payment_status | success / pending / failed / unknown |
payment_submission_status | حقول جديدة اختيارية: submitted / rejected / unknown |
payment_recovery | حقول جديدة اختيارية: action, reason, elapsed_seconds. API |
order_status / order_status_raw | Taobao self |
upstream_request_id | Taobao self |
pay_channel | 1688 |
error_code / error_message | سبب الرفض الصريح؛ قد يغيب في pending/unknown |
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 | معرفات متأثرة بالإلغاء الجزئي |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days