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-Keyselon 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_idTaobao 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
- Prévisualisation — valider lignes, prix, fret
- Création — passer la commande d’approvisionnement
- Paiement — Payez la commande via le compte correspondant à son mode
- Détail / liste — suivre le statut
- Suivi domestique — vendeur → entrepôt
- Annulation — lorsque c’est autorisé
Guide des endpoints
| Étape | Chemin | Doc |
|---|---|---|
| Prévisualisation | POST /v1/orders/preview | Prévisualisation de commande |
| Création | POST /v1/orders/create | Créer une commande |
| Paiement | POST /v1/orders/pay | Payer une commande |
| Détail | POST /v1/orders/detail | Détail de commande |
| Liste | POST /v1/orders/list | Détail de commande |
| Annulation | POST /v1/orders/cancel | Annuler une commande |
| Suivi domestique | POST /v1/orders/logistics/trace | Suivi logistique domestique |
| Achats Taobao | POST /v1/orders/purchase/query | Dé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
| Segment | API |
|---|---|
| Vendeur → entrepôt Chine | Suivi domestique |
| Entrepôt → acheteur à l’étranger | Suivi international |
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days