Bestell-API-Antwortmodelle

Typen in packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). Alle Beträge: Fen.

StandardOrderPreviewResult {#standard-order-preview-result}

Aus Order Preview.

Feld	Typ	Beschreibung
success	boolean	false, wenn Positionen nicht gekauft werden können; unavailable_lines prüfen
total.payment	Money	Gesamtbetrag zahlbar
total.shipping	Money	Anteil Inlandsversand
sellers[]	array	Nach Verkäufer gruppiert mit lines[], Gebühren
unavailable_lines[]	array	Fehlgeschlagene Validierung oder Bestand
trade_types[]	array	Nur 1688
promotions	object	1688-Aktionen, wenn vorhanden

StandardOrderCreateResult {#standard-order-create-result}

Feld	Typ	Beschreibung
order_id	string	Für Pay, Detail und Trace verwenden
total.payment	Money	Zu zahlender Betrag
order_list[]	array	Teilbestellungen / Verkäufer-Splits
failed_offers[]	array	Teilweises Create mit success: true möglich
outer_purchase_id	string	Taobao-Idempotenzschlüssel
payment_url	string	Optionale Taobao-Zahlungs-URL

StandardOrderPayResult {#standard-order-pay-result}

Feld	Beschreibung
success	Zahlung akzeptiert
pay_channel	1688-Zahlungsmethode
error_code / error_message	Wenn success: false

StandardOrderDetail {#standard-order-detail}

Feld	Beschreibung
status	z. B. wait_payment, wait_shipment, shipped
refund_status	Read-only; Refund-APIs sind nicht öffentlich
amounts	total, product_total, shipping_fee, refund (Fen)
line_items[]	Produktzeilen mit sku_specs, status
times	created_at, paid_at, shipped_at, …
domestic_parcels[]	Warehouse-Modus → Fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

Aus Inland-Trace.

Feld	Beschreibung
packages[]	tracking_number, carrier, steps[]
cross_border_packages[]	1688-Cross-Border-Knoten - kein internationales Fulfillment

StandardOrderCancelResult {#standard-order-cancel-result}

Feld	Beschreibung
success	Storno akzeptiert (kann noch verarbeitet werden)
pending	Asynchrones Taobao-Storno
sub_order_ids	Betroffene IDs bei Teilstorno