Internationales Fulfillment Übersicht

/v1/fulfillment/* deckt internationale Logistik ab, nachdem Waren im HIOBuy-Warehouse eingetroffen sind. Inländischer Einkauf: Beschaffungsbestellungen.

Erfordert Warehouse-Fulfillment auf Ihrer App (Portal-Autorisierung). Self-Fulfillment-Apps erhalten 403 FULFILLMENT_MODE_NOT_SUPPORTED.

API-Verfügbarkeit {#availability}

Pfad	Status
/v1/fulfillment/shipments/*	Geplant - Spezifikation stabil; Gateway-Rollout läuft
/v1/fulfillment/balance	Geplant
/v1/shipments (legacy)	Veraltet

End-to-End-Ablauf {#end-to-end-flow}

1. Beschaffungsbestellung erstellen → Verkäufer versendet ans Warehouse
2. Bestelldetail → parcel_nos[], wenn inbound
3. Frachtabschätzung → shipping_channel_code auswählen
4. Shipment Preview → exakter Preis
5. Sendung erstellen → shipment_id
6. Sendung bezahlen → Wallet belasten
7. Internationales Tracking

Endpoint-Leitfaden

Thema	Pfad	Doku
Schnelles Frachtangebot	POST .../freight/estimate	Frachtabschätzung
Exaktes Warehouse-Angebot	POST .../preview	Shipment Preview
Create / Pay / Cancel / Detail	POST .../shipments/*	Sendungen
Internationaler Trace	POST .../logistics/trace	Tracking
Wallet-Guthaben	GET /v1/fulfillment/balance	Guthaben
Antwortfelder	—	Fulfillment-Antwortmodelle
Artikelattribute	GET .../item-attributes	Frachtabschätzung

Beschaffung im Warehouse-Modus

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

Inland-Trace: Order Logistics Trace (im Warehouse-Modus proxied).

Fehler

FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE - siehe Fehler.