Les API Taobao nécessitent un abonnement payant actif. L’essai gratuit de 7 jours inclut uniquement 1688 et Weidian. Sans l’abonnement requis, les appels Taobao renvoient HTTP 403 avec le code PAID_SUBSCRIPTION_REQUIRED. Passez à une offre payante dans le centre développeur et conservez la même clé API.

Vue d’ensemble des commandes d’approvisionnement

Les lectures de produits renvoient des données réelles. Les aperçus de commande et devis de transport estiment les coûts sans créer ni payer une commande. La création d’achat produit une commande réelle ; les paiements d’achat et d’expédition peuvent débiter des fonds réels. Les avis d’entrée créent des enregistrements et la création d’expédition demande un traitement au dépôt. Vérifiez l’activation, la commande, le montant et le compte. Conservez les identifiants métier et utilisez Idempotency-Key selon la documentation ; après un résultat incertain, consultez l’opération existante avant toute nouvelle tentative de paiement.

Un canal, un vendeur, une commande d’achat

Une commande d’achat peut contenir plusieurs produits ou SKU, mais tous les articles doivent appartenir au même canal et au même vendeur.

Si votre client achète des articles auprès de vendeurs ou de canaux différents, votre application doit les répartir en commandes d’achat distinctes avant d’appeler l’API de commande HIOBuy.

HIOBuy ne scinde pas automatiquement les commandes d’achat et ne propose pas d’API de commande par lots pour ce parcours.

Consultez la création d’achat et les achats manuels pour les identifiants vendeur, les exemples valides et invalides, les erreurs et les responsabilités de l’entrepôt. Les achats restent distincts lorsque leurs colis sont regroupés dans une expédition. Conservez chaque order_list[].order_id ; le champ racine order_id contient uniquement le premier ID.

API achats manuels — channel=manual · jd / pinduoduo / poizon

/v1/orders/* couvre l’approvisionnement domestique — commandes auprès de vendeurs 1688/Taobao pour livraison vers une adresse d’entrée en Chine. Ce n’est pas l’expédition internationale ; utilisez Fulfillment après l’entrée en entrepôt.

Les montants sont en fen CNY (分). Définissez response_format selon Format de réponse.

Mappez les IDs produit depuis Produits : search/detail id → lines[].id (compatible: offer_id, Taobao mi_id), variants[].sku_id → lines[].spec_id.

L’id / mi_id Taobao change périodiquement. Ne le mettez pas en cache longtemps. Un id périmé casse detail, similar et les commandes. Récupérez-le avant le checkout.

Cycle de vie

  1. Prévisualisation — valider lignes, prix, fret
  2. Création — passer la commande d’approvisionnement
  3. Paiement — Payez la commande via le compte correspondant à son mode
  4. Détail / liste — suivre le statut
  5. Suivi domestique — vendeur → entrepôt
  6. Annulation — lorsque c’est autorisé

Guide des endpoints

ÉtapeCheminDoc
PrévisualisationPOST /v1/orders/previewPrévisualisation de commande
CréationPOST /v1/orders/createCréer une commande
PaiementPOST /v1/orders/payPayer une commande
DétailPOST /v1/orders/detailDétail de commande
ListePOST /v1/orders/listDétail de commande
AnnulationPOST /v1/orders/cancelAnnuler une commande
Suivi domestiquePOST /v1/orders/logistics/traceSuivi logistique domestique
Achats TaobaoPOST /v1/orders/purchase/queryDétail de commande
Schémas de réponse—Modèles de réponse commande

Raccourcis de canal : /v1/orders/1688/*, /v1/orders/taobao/* (le corps peut omettre channel).

Logistique domestique vs internationale

SegmentAPI
Vendeur → entrepôt ChineSuivi domestique
Entrepôt → acheteur à l’étrangerSuivi international

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support