Value-added services

Catalog of warehouse value-added services.

Availability: Sandbox is MOCK. Warehouse-mode live keys forward to POST /api/gateway-worker/v1/services. Service requests remain mock.

Requires warehouse fulfillment. Scope: warehouse:read.

List Value-added Services

Returns currently available HioBuy Fulfillment value-added services, supported fulfillment stage, pricing method and current rate.

Query: stage (INBOUND | OUTBOUND), category, status. Default returns ACTIVE only. No pagination.

Live warehouse code is a numeric id as a string (e.g. "1" / "2"). Codes are unique per stage, not globally. price is yuan (warehouse fen / 100). pricing_type PER + unit=package maps to PER_PACKAGE. Empty category / description stay empty strings.

Sandbox mock still uses stable codes such as PHOTO and WOODEN_FRAME. Do not use those mock codes against live warehouse.

Stages map to resource types used by Service requests:

Live example (default ACTIVE)

{
  "data": [
    {
      "code": "1",
      "name": "拆包清点",
      "stage": "INBOUND",
      "pricing_type": "PER_PACKAGE",
      "unit": "package",
      "price": 5,
      "currency": "CNY",
      "status": "ACTIVE"
    }
  ],
  "request_id": "req_..."
}

Related

• Service requests
• Internal: value-added-services.md