국제 풀필먼트 개요

/v1/fulfillment/*는 상품이 HIOBuy 창고에 입고된 뒤의 국제 물류를 다룹니다. 중국 내 구매는 Procurement orders를 참고하세요.

앱에 warehouse fulfillment가 필요합니다(Portal authorization). Self-fulfillment 앱은 403 FULFILLMENT_MODE_NOT_SUPPORTED를 받습니다.

API 제공 상태 {#availability}

경로	상태
/v1/fulfillment/shipments/*	계획됨 — 사양 안정화, Gateway 롤아웃 진행 중
/v1/fulfillment/balance	계획됨
/v1/shipments (legacy)	사용 중단됨

전체 흐름 {#end-to-end-flow}

1. Create procurement order → 판매자가 창고로 발송
2. Order detail → 입고 시 parcel_nos[]
3. Freight estimate → shipping_channel_code 선택
4. Shipment preview → 정확한 가격
5. Create shipment → shipment_id
6. Pay shipment → 지갑 차감
7. International tracking

엔드포인트 가이드

주제	경로	문서
빠른 운임 견적	POST .../freight/estimate	Freight estimate
정확한 창고 견적	POST .../preview	Shipment preview
생성 / 결제 / 취소 / 상세	POST .../shipments/*	Shipments
국제 추적	POST .../logistics/trace	Tracking
지갑 잔액	GET /v1/fulfillment/balance	Balance
응답 필드	—	Fulfillment response models
상품 속성	GET .../item-attributes	Freight estimate

창고 모드 구매

/v1/orders/* 경로는 변경되지 않습니다. Gateway가 HIOBuy로 전달합니다. Product API는 계속 마켓플레이스에 직접 호출합니다.

중국 내 추적: order logistics trace(창고 모드에서 프록시됨).

오류

FULFILLMENT_MODE_NOT_SUPPORTED, PARCEL_NOT_FOUND, INVALID_SHIPPING_CHANNEL, INSUFFICIENT_BALANCE — Errors를 참고하세요.