Vue d’ensemble du fulfillment international

/v1/fulfillment/* couvre la logistique internationale une fois les marchandises reçues dans l’entrepôt HIOBuy. Achats domestiques : commandes d’achat.

L’application doit utiliser le fulfillment entrepôt(autorisation du portail). Les applications en autofulfillment reçoivent 403 FULFILLMENT_MODE_NOT_SUPPORTED.

Unité monétaire {#monetary-unit}

Les réponses JSON standard des routes de fulfillment qui portent des montants incluent monetary_unit: "CNY_minor" au niveau racine. Tous les { amount, currency } utilisent des fen CNY(1 yuan = 100 fen). Voir modèles de réponse fulfillment.

Disponibilité des API {#availability}

CheminStatut
/v1/fulfillment/inbounds/createLive entrepôt simple-store en mode entrepôt ; mock en sandbox
/v1/fulfillment/packagesLive entrepôt packages/index en mode entrepôt ; mock en sandbox
/v1/fulfillment/packages/{package_id}Live entrepôt packages/detail/{id} en mode entrepôt ; mock en sandbox
/v1/fulfillment/packages/{package_id}/trackingLive entrepôt packages/logs/{id} en mode entrepôt ; mock en sandbox
/v1/fulfillment/unclaimed-packagesLive liste + réclamation en mode entrepôt ; mock en sandbox
/v1/fulfillment/returnsMock — création / liste / confirmation / annulation des retours vendeur
/v1/fulfillment/locationsLive entrepôt warehouse en mode entrepôt ; mock en sandbox
/v1/fulfillment/value-added-servicesLive entrepôt services en mode entrepôt ; mock en sandbox
/v1/fulfillment/service-requestsMock — création / liste / détail / confirmation
/v1/fulfillment/shipments/{id}/interceptLive entrepôt shipments/set-exceptional en mode entrepôt ; mock en sandbox
/v1/fulfillment/shipmentsLive entrepôt shipments/index en mode entrepôt ; mock en sandbox
/v1/fulfillment/shipping/channelsCatalogue de canaux live en mode entrepôt ; mock en sandbox
/v1/fulfillment/shipping/quotesDevis live en mode entrepôt ; mock en sandbox
/v1/fulfillment/shipments/*Disponible(HTTP entrepôt si configuré, sinon mock)
/v1/fulfillment/balanceDisponible
/v1/shipments(ancien)Obsolète

Flux de bout en bout {#end-to-end-flow}

  1. Créer une commande d’achat → le vendeur expédie vers l’entrepôt
    ou préavis d’entrée pour les colis que vous contrôlez déjà
  2. Détail / suivi du colis → mesures entrepôt / exceptions / VAS / chronologie
    ou détail de commande → tracking_numbers[] après entrée depuis l’achat
  3. Canaux d’expédition pour les capacités, puis devis d’expédition → choisir quotes[].channel.code
  4. Créer une expédition → id / order_sn(PENDING)
  5. Emballage et mesure finale en entrepôt → boxes[], poids / dimensions / fret finaux
  6. Expédition prête au paiement(WAIT_PAYMENT)→ voir le détail ; un paiement trop tôt renvoie 409 SHIPMENT_NOT_READY_FOR_PAYMENT
  7. Payer l’expédition → débit du portefeuille
  8. Liste / détail → lignes légères, ou cartons / fichiers d’emballage / timeline / numéros premier et dernier kilomètre
    Optionnel : intercepter pour retenir une expédition WAIT_SHIP / SHIPPED
  9. Suivi international → événements de scan

Nouveau sur le fulfillment entrepôt ? Suivez le guide de test WH-DEV pour parcourir tout le flux, y compris l’emballage et le règlement.

Démarrer le test WH-DEV →

Guide des endpoints

SujetCheminDoc
Préavis d’entréePOST .../inbounds/createEntrées
Détail / suivi / non réclamésGET .../packages/* · unclaimed-packagesColis
RetoursPOST/GET .../returns · confirm/cancelRetours
EmplacementsGET .../locationsEmplacements
Services à valeur ajoutéeGET .../value-added-servicesVAS
Demandes de servicePOST/GET .../service-requests · confirmDemandes de service
Canaux d’expéditionGET .../shipping/channelsCanaux d’expédition
Devis d’expéditionPOST .../shipping/quotesDevis d’expédition
Créer / payer / annuler / intercepterPOST .../shipments/create · {id}/pay · {id}/cancel · {id}/interceptExpéditions
Liste des expéditionsGET .../shipmentsExpéditions · liste
Détail d’expéditionGET .../shipments/{id}Expéditions · détail
Suivi internationalGET .../shipments/{id}/trackingSuivi
Solde du portefeuilleGET /v1/fulfillment/balanceSolde
Champs de réponse—Modèles de réponse
Attributs d’articleGET .../item-attributesDevis d’expédition

Achats en mode entrepôt

Les chemins /v1/orders/* restent inchangés ; la passerelle transmet vers HIOBuy. Les API produits appellent toujours les marketplaces directement.

Suivi domestique : trace logistique de commande(proxifié en mode entrepôt).

Diagrammes de cycle de vie {#lifecycle}

Diagrammes d’états : Colis, Expéditions, Retours.

Erreurs

FULFILLMENT_MODE_NOT_SUPPORTED, SHIPMENT_CREATE_EXCEPTION, SHIPMENT_CREATE_FAILED, PARCEL_NOT_FOUND, EXTERNAL_ORDER_ID_ALREADY_EXISTS, SHIPMENT_NOT_READY_FOR_PAYMENT, SHIPMENT_ALREADY_PAID, INSUFFICIENT_BALANCE, NOT_FOUND(SHIPMENT_NOT_EXISTS), codes d’interception(SHIPMENT_NOT_FOUND, SHIPMENT_NOT_INTERCEPTABLE, SHIPMENT_INTERCEPTION_ALREADY_REQUESTED)— voir Erreurs et Expéditions.

Get Support

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

Email support