サービスリクエスト
付加サービスを package（入庫）または shipment（出庫）に申請・追跡します。
Availability: Sandbox / Gateway MOCK is live.
| Method | Path | Purpose |
|---|---|---|
| POST | /v1/fulfillment/service-requests | 作成 |
| GET | /v1/fulfillment/service-requests | 一覧 |
| GET | /v1/fulfillment/service-requests/{id} | 詳細 |
| POST | /v1/fulfillment/service-requests/{id}/confirm | 料金確認 |
IDs: svc_*. Statuses: PENDING · AWAITING_CONFIRMATION · PROCESSING · COMPLETED · FAILED · CANCELLED.
一覧フィルタ
GET /v1/fulfillment/service-requests のクエリパラメータ:
| パラメータ | 説明 |
|---|---|
resource_type | PACKAGE | SHIPMENT |
resource_id | Exact match (e.g. pkg_*, shipment id) |
service_code | Exact VAS CODE (normalized to uppercase) |
stage | INBOUND | OUTBOUND |
status | Multi: PENDING,COMPLETED or repeated status= |
created_from / created_to | Filter by created_at (ISO-8601) |
page / page_size | Default 1 / 20, max page_size 100 |
詳細 GET …/service-requests/{id} にフィルタはありません — ID のみ。
作成
バッチ作成はアトミック。PACKAGE→INBOUND、SHIPMENT→OUTBOUND。カタログ: Value-added services。
確認
見積もり料金（AWAITING_CONFIRMATION）: 現在の pricing.amount と一致する { "fee_amount", "currency" } を送信。確認済みは冪等。
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days