服务申请
对 包裹（入库）或 发货单（出库）申请并跟踪增值服务。
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 | 确认报价 |
ID：svc_*。状态：PENDING · AWAITING_CONFIRMATION · PROCESSING · COMPLETED · FAILED · CANCELLED。
列表筛选
GET /v1/fulfillment/service-requests 查询参数：
| 参数 | 说明 |
|---|---|
resource_type | PACKAGE | SHIPMENT |
resource_id | 精确匹配关联资源 ID |
service_code | 精确匹配 VAS CODE（转大写） |
stage | INBOUND | OUTBOUND |
status | 可多选：PENDING,COMPLETED 或重复 status= |
created_from / created_to | 按 created_at（ISO-8601） |
page / page_size | 默认 1 / 20，page_size 最大 100 |
详情 GET …/service-requests/{id} 无筛选，仅按 ID 取单条。
创建
批量创建原子化。PACKAGE→入库，SHIPMENT→出库。目录见 增值服务。
确认报价
报价类（AWAITING_CONFIRMATION）：提交 { "fee_amount", "currency" }，须与当前 pricing.amount 一致；已确认幂等。
获取支持
需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复