Modèles de réponse de l’API Commandes

Types dans packages/shared/src/ (order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts). Tous les montants : fen.

StandardOrderPreviewResult {#standard-order-preview-result}

Depuis prévisualisation de commande.

Champ	Type	Description
success	boolean	false lorsque les lignes ne peuvent pas être achetées ; vérifiez unavailable_lines
total.payment	Money	Total à payer
total.shipping	Money	Part de l’expédition domestique
sellers[]	array	Groupé par vendeur avec lines[], frais
unavailable_lines[]	array	Échec de validation ou stock
trade_types[]	array	1688 uniquement
promotions	object	Promotions 1688 lorsqu’elles sont présentes

StandardOrderCreateResult {#standard-order-create-result}

Champ	Type	Description
order_id	string	À utiliser pour payer, détail, suivi
total.payment	Money	Montant à payer
order_list[]	array	Sous-commandes / divisions par vendeur
failed_offers[]	array	Création partielle possible avec success: true
outer_purchase_id	string	Clé d’idempotence Taobao
payment_url	string	URL de paiement Taobao optionnelle

StandardOrderPayResult {#standard-order-pay-result}

Champ	Description
success	Paiement accepté
pay_channel	Méthode de paiement 1688
error_code / error_message	Lorsque success: false

StandardOrderDetail {#standard-order-detail}

Champ	Description
status	par ex. wait_payment, wait_shipment, shipped
refund_status	Lecture seule ; les API de remboursement ne sont pas publiques
amounts	total, product_total, shipping_fee, refund (fen)
line_items[]	Lignes produit avec sku_specs, status
times	created_at, paid_at, shipped_at, …
domestic_parcels[]	Mode entrepôt → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

Depuis suivi domestique.

Champ	Description
packages[]	tracking_number, carrier, steps[]
cross_border_packages[]	Nœuds transfrontaliers 1688 — pas le fulfillment international

StandardOrderCancelResult {#standard-order-cancel-result}

Champ	Description
success	Annulation acceptée (peut encore être en traitement)
pending	Annulation asynchrone Taobao
sub_order_ids	IDs affectés par une annulation partielle