Модели ответов Order API

Типы в packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). Все суммы: fen.

StandardOrderPreviewResult {#standard-order-preview-result}

Из order preview.

Поле	Тип	Описание
success	boolean	false, когда lines нельзя купить; проверяйте unavailable_lines
total.payment	Money	Общая сумма к оплате
total.shipping	Money	Часть внутренней доставки
sellers[]	array	Сгруппировано по продавцу с lines[], fees
unavailable_lines[]	array	Ошибка validation или stock
trade_types[]	array	Только 1688
promotions	object	Promotions 1688, когда присутствуют

StandardOrderCreateResult {#standard-order-create-result}

Поле	Тип	Описание
order_id	string	Используйте для pay, detail, trace
total.payment	Money	Сумма к оплате
order_list[]	array	Sub-orders / seller splits
failed_offers[]	array	Возможен partial create с success: true
outer_purchase_id	string	Idempotency key Taobao
payment_url	string	Опциональный payment URL Taobao

StandardOrderPayResult {#standard-order-pay-result}

Поле	Описание
success	Payment accepted
pay_channel	Метод оплаты 1688
error_code / error_message	Когда success: false

StandardOrderDetail {#standard-order-detail}

Поле	Описание
status	Например wait_payment, wait_shipment, shipped
refund_status	Read-only; refund APIs не публичные
amounts	total, product_total, shipping_fee, refund (fen)
line_items[]	Product rows с sku_specs, status
times	created_at, paid_at, shipped_at, …
domestic_parcels[]	Складской режим → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

Из domestic trace.

Поле	Описание
packages[]	tracking_number, carrier, steps[]
cross_border_packages[]	Cross-border nodes 1688 — не international fulfillment

StandardOrderCancelResult {#standard-order-cancel-result}

Поле	Описание
success	Cancel accepted (может еще обрабатываться)
pending	Асинхронная отмена Taobao
sub_order_ids	Affected ids при частичной отмене