Autorisation du portail
Après l’approbation de votre app, autorisez les canaux dans le portail développeur avant d’appeler les API d’approvisionnement ou de fulfillment.
Il y a deux niveaux de choix :
- Mode de fulfillment — si HioBuy entrepose et expédie à l’international
- Mode d’approvisionnement (uniquement lorsque le fulfillment entrepôt est activé) — qui achète sur Taobao / 1688 / Weidian
Mode de fulfillment (par app)
| Mode | Qui détient la liaison entrepôt | Expédition internationale (/v1/fulfillment/*) |
|---|---|---|
| Self fulfillment (par défaut) | Aucune — vous gérez la logistique vous-même | Non disponible (403) |
| Entrepôt HioBuy | Un code développeur entrepôt | Disponible — Vue d’ensemble fulfillment |
Les chemins d’API publics restent les mêmes (/v1/products/*, /v1/orders/*, …). La Gateway route selon les modes de votre app.
Approvisionnement sous fulfillment entrepôt
Lorsque vous choisissez Entrepôt HioBuy, l’approvisionnement propose deux options. L’entreposage et l’expédition internationaux fonctionnent dans les deux cas ; seul qui passe les commandes d’achat sur la marketplace diffère.
| Mode d’approvisionnement | Qui achète sur la marketplace | Jetons de canal | /v1/orders/* | /v1/products/* |
|---|---|---|---|---|
| HioBuy procurement (par défaut) | HioBuy achète pour vous | Émis via l’autorisation entrepôt ; la Gateway les stocke | Routé via l’approvisionnement entrepôt HioBuy | La Gateway utilise les jetons stockés → marketplace |
| Self procurement | Vous achetez avec vos propres comptes | Vous gérez OAuth / identifiants dans le portail | Gateway → marketplace avec vos jetons (comme le flux self classique) | Idem — vos jetons |
| Capacité | HioBuy procurement | Self procurement |
|---|---|---|
| Lier le code entrepôt une fois | Oui | Oui |
| Entrée entrepôt / colis / VAS / retours | Oui | Oui |
| Expéditions internationales et portefeuille | Oui | Oui |
| OAuth marketplace géré par vous | Non | Oui (par canal) |
Le passage d’une option d’approvisionnement à l’autre peut effacer ou réémettre les jetons de canal ; le portail vous demandera de confirmer.
Self fulfillment (sans entrepôt HioBuy)
Pour chaque canal activé (Taobao, 1688, Weidian, …) :
- Ouvrez Authorizations → sélectionnez l’app → Authorize
- Collez les identifiants OAuth ou terminez OAuth lorsque disponible
- Le portail affiche le statut, le nom du compte et l’expiration — jamais les jetons complets
/v1/fulfillment/* n’est pas disponible dans ce mode.
Fulfillment entrepôt HioBuy (configuration)
- Obtenez un warehouse developer code auprès des opérations HioBuy
- Portal → Authorizations → choisissez Use HioBuy fulfillment
- Choisissez le mode d’approvisionnement : HioBuy procurement ou self procurement
- Saisissez le code entrepôt une fois — la liaison est au niveau de l’app (pas par canal)
- Si HioBuy procurement : le portail liste le statut de chaque canal et
expires_at(les jetons ne sont ni visibles ni modifiables) - Si self procurement : complétez vous-même l’OAuth / la saisie d’identifiants par canal ; la liaison entrepôt débloque uniquement les API de fulfillment
Revenir au self fulfillment efface la liaison entrepôt ; une confirmation vous sera demandée.
Ce que vous n’envoyez jamais dans les appels API
- Jetons d’accès marketplace
- Warehouse developer code (la Gateway l’attache côté serveur)
Seulement Authorization: Bearer hio_live_… (ou hio_test_…) sur https://api.hiobuy.com.
Suivant : Vue d’ensemble fulfillment · Commandes
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days