Übersicht internationales Fulfillment

/v1/fulfillment/* deckt die internationale Logistik ab, nachdem die Ware im HIOBuy-Lager eingegangen ist. Inlandseinkauf: Beschaffungsbestellungen.

Die App benötigt Lager-Fulfillment (Portal-Autorisierung). Apps mit Eigenfulfillment erhalten 403 FULFILLMENT_MODE_NOT_SUPPORTED.

Währungseinheit {#monetary-unit}

Standard-JSON-Antworten auf Fulfillment-Routen mit Beträgen enthalten monetary_unit: "CNY_minor" auf oberster Ebene. Alle { amount, currency } verwenden CNY-Fen (1 Yuan = 100 Fen). Siehe Fulfillment-Antwortmodelle.

API-Verfügbarkeit {#availability}

PfadStatus
/v1/fulfillment/inbounds/createLive Lager simple-store im Lagermodus; Mock in der Sandbox
/v1/fulfillment/packagesLive Lager packages/index im Lagermodus; Mock in der Sandbox
/v1/fulfillment/packages/{package_id}Live Lager packages/detail/{id} im Lagermodus; Mock in der Sandbox
/v1/fulfillment/packages/{package_id}/trackingLive Lager packages/logs/{id} im Lagermodus; Mock in der Sandbox
/v1/fulfillment/unclaimed-packagesLive Liste + Anspruch im Lagermodus; Mock in der Sandbox
/v1/fulfillment/returnsMock — Rücksendung an Verkäufer erstellen / listen / bestätigen / stornieren
/v1/fulfillment/locationsLive Lager warehouse im Lagermodus; Mock in der Sandbox
/v1/fulfillment/value-added-servicesLive Lager services im Lagermodus; Mock in der Sandbox
/v1/fulfillment/service-requestsMock — erstellen / listen / Detail / bestätigen
/v1/fulfillment/shipments/{id}/interceptLive Lager shipments/set-exceptional im Lagermodus; Mock in der Sandbox
/v1/fulfillment/shipmentsLive Lager shipments/index im Lagermodus; Mock in der Sandbox
/v1/fulfillment/shipping/channelsLive-Kanalkatalog im Lagermodus; Mock in der Sandbox
/v1/fulfillment/shipping/quotesLive-Angebote im Lagermodus; Mock in der Sandbox
/v1/fulfillment/shipments/*Verfügbar (Lager-HTTP wenn konfiguriert, sonst Mock)
/v1/fulfillment/balanceVerfügbar
/v1/shipments (Alt)Veraltet

Ende-zu-Ende-Ablauf {#end-to-end-flow}

  1. Beschaffungsbestellung anlegen → Verkäufer versendet an das Lager
    oder Eingangsavisierung für Pakete, die Sie bereits steuern
  2. Paketdetail / Tracking → Lagermessung / Ausnahmen / VAS / Zeitlinie
    oder Bestelldetail → tracking_numbers[] nach Eingang aus der Beschaffung
  3. Versandkanäle für Fähigkeiten, dann Versandangebote → quotes[].channel.code wählen
  4. Sendung erstellen → id / order_sn (PENDING)
  5. Lagerverpackung und Endmessung → boxes[], Endgewicht / Maße / Endfracht
  6. Sendung zahlungsbereit (WAIT_PAYMENT) → siehe Detail; zu frühes Zahlen liefert 409 SHIPMENT_NOT_READY_FOR_PAYMENT
  7. Sendung bezahlen → Abbuchung vom Wallet
  8. Liste / Detail → leichte Zeilen oder Kartons / Packdateien / timeline / First-/Last-Mile-Nummern
    Optional: Abfangen, um eine WAIT_SHIP / SHIPPED-Sendung zu halten
  9. Internationales Tracking → Scan-Ereignisse

Neu beim Lager-Fulfillment? Folgen Sie dem WH-DEV-Testleitfaden und durchlaufen Sie den gesamten Ablauf einschließlich Verpackung und Abrechnung.

WH-DEV-Test starten →

Endpoint-Leitfaden

ThemaPfadDoku
EingangsavisierungPOST .../inbounds/createEingänge
Paketdetail / Tracking / unbeanspruchtGET .../packages/* · unclaimed-packagesPakete
RücksendungenPOST/GET .../returns · confirm/cancelRücksendungen
StandorteGET .../locationsStandorte
MehrwertdiensteGET .../value-added-servicesVAS
ServiceanfragenPOST/GET .../service-requests · confirmServiceanfragen
VersandkanäleGET .../shipping/channelsVersandkanäle
VersandangebotePOST .../shipping/quotesVersandangebote
Erstellen / zahlen / stornieren / abfangenPOST .../shipments/create · {id}/pay · {id}/cancel · {id}/interceptSendungen
SendungslisteGET .../shipmentsSendungen · Liste
SendungsdetailGET .../shipments/{id}Sendungen · Detail
Internationales TrackingGET .../shipments/{id}/trackingTracking
Wallet-GuthabenGET /v1/fulfillment/balanceGuthaben
Antwortfelder—Antwortmodelle
ArtikelattributeGET .../item-attributesVersandangebote

Beschaffung im Lagermodus

Die Pfade /v1/orders/* bleiben unverändert; das Gateway leitet an HIOBuy weiter. Produkt-APIs rufen die Marktplätze weiterhin direkt auf.

Inland-Tracking: Bestell-Logistikspur (im Lagermodus über das Gateway).

Lebenszyklus-Diagramme {#lifecycle}

Zustandsdiagramme: Pakete, Sendungen, Rücksendungen.

Fehler

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), Abfangcodes (SHIPMENT_NOT_FOUND, SHIPMENT_NOT_INTERCEPTABLE, SHIPMENT_INTERCEPTION_ALREADY_REQUESTED) — siehe Fehler und Sendungen.

Get Support

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

Email support