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 | true seulement après validation du total payable, des groupes vendeurs, des lignes demandées, de la disponibilité et du mode de transaction applicable |
total.merchandise | Money | null | Sous-total marchandises ; null uniquement s’il est réellement inconnu |
total.payment | Money | Total à payer |
total.shipping | Money | null | Expédition domestique ; la gratuité connue est un Money avec amount: 0 |
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 |
code / message | string | Statut métier optionnel, notamment LINE_UNAVAILABLE, UNSUPPORTED_TRADE_MODE, PREVIEW_INCOMPLETE |
monetary_unit | string | Toujours CNY_minor pour un standard preview |
request_id | string | Identifiant de corrélation de requête |
Un standard preview interprétable mais incomplet renvoie HTTP 200 avec success:false. Pour compatibilité, les erreurs explicites 1688 de SKU, stock, MOQ et restriction marketplace conservent HTTP 502 CHANNEL_UPSTREAM_ERROR. Avec response_format:"upstream", HTTP 200 peut contenir un échec métier upstream ; inspectez les champs bruts upstream.success, code, message et leurs équivalents imbriqués.
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}
Taobao self standard renvoie success: true seulement après confirmation par la commande. code: "0" ou un ancien succès ne prouve pas le débit. pending est un état non confirmé du Gateway, pas une file officielle.
| Champ | Description |
|---|---|
success | Taobao self standard : true seulement après confirmation du paiement par la commande |
pending / payment_status | success / pending / failed / unknown |
payment_submission_status | Nouveaux champs facultatifs: submitted / rejected / unknown |
payment_recovery | Nouveaux champs facultatifs: action, reason, elapsed_seconds. API |
order_status / order_status_raw | Taobao self |
upstream_request_id | Taobao self |
pay_channel | 1688 |
error_code / error_message | Motif d’un refus explicite ; peut être absent pour pending/unknown |
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 |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days