서비스 요청
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