Vue d’ensemble du fulfillment international
/v1/fulfillment/* couvre la logistique internationale après l’arrivée des marchandises dans l’entrepôt HIOBuy. Achat domestique : Commandes d’approvisionnement.
Nécessite le fulfillment entrepôt sur votre app (Autorisation portail). Les apps en fulfillment autonome reçoivent 403 FULFILLMENT_MODE_NOT_SUPPORTED.
Disponibilité API {#availability}
| Chemin | Statut |
|---|---|
/v1/fulfillment/shipments/* | Planifié — spécification stable ; déploiement Gateway en cours |
/v1/fulfillment/balance | Planifié |
/v1/shipments (legacy) | Obsolète |
Flux de bout en bout {#end-to-end-flow}
- Créer une commande d’approvisionnement → le vendeur expédie vers l’entrepôt
- Détail de commande →
parcel_nos[]lorsque les colis sont entrants - Estimation de fret → choisir
shipping_channel_code - Prévisualisation d’expédition → prix exact
- Créer l’expédition →
shipment_id - Payer l’expédition → débit du wallet
- Suivi international
Guide des endpoints
| Sujet | Chemin | Doc |
|---|---|---|
| Devis fret rapide | POST .../freight/estimate | Estimation de fret |
| Devis entrepôt exact | POST .../preview | Prévisualisation d’expédition |
| Créer / payer / annuler / détail | POST .../shipments/* | Expéditions |
| Suivi international | POST .../logistics/trace | Suivi |
| Solde du wallet | GET /v1/fulfillment/balance | Solde |
| Champs de réponse | — | Modèles de réponse fulfillment |
| Attributs d’article | GET .../item-attributes | Estimation de fret |
Approvisionnement en mode entrepôt
Les chemins /v1/orders/* restent inchangés ; la passerelle transmet à HIOBuy. Les API produit appellent toujours directement les marketplaces.
Suivi domestique : suivi logistique de commande (proxy en mode entrepôt).
Erreurs
FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE — voir Erreurs.