问题类型与答案结构

问题采用结构化类型而非自由文本，这正是答案可被程序直接消费的原因：packed_weight 一定返回数值加单位，而不是”大概一公斤多吧”。

提问格式

{
  "type": "packed_weight",
  "note": "含彩盒的重量"
}
字段必填说明
type是下列十种类型之一
note否给客服的补充说明，最长 500 字符
question仅 other 必填自由文本问题，最长 500 字符

规则：单条消息 1–10 个问题；同一条消息中标准类型只能出现一次（否则 INVALID_QUESTION_SCHEMA）；other 可以重复，因为每条都是不同的问题。标准类型上传入的 question 会被忽略，补充信息请放 note。

答案外层结构

每个答案都带状态：

状态含义
answered供应商已回答，value 有值
unavailable供应商没有这个信息
refused供应商拒绝回答
unknown未能取得可用答案

只有 answered 携带 value，其余三种恒为 value: null。

{
  "question_id": "sqst_...",
  "type": "packed_weight",
  "status": "answered",
  "value": 1250,
  "unit": "g",
  "provider_note": null,
  "answered_at": "2026-05-20T11:40:00.000Z"
}

十种类型

packed_weight

单件按供应商包装后的重量。

{
  "status": "answered",
  "value": 1250,
  "unit": "g"
}

value 为正数，unit 为 g 或 kg。

package_dimensions

单件包装后的外尺寸。

{
  "status": "answered",
  "value": {
    "length": 32,
    "width": 24,
    "height": 12,
    "unit": "cm"
  }
}

三边均为正数，unit 为 cm、mm 或 in。

carton_info

外箱规格——决定头程运费的关键信息。

{
  "status": "answered",
  "value": {
    "quantity_per_carton": 24,
    "gross_weight": 14.5,
    "weight_unit": "kg",
    "length": 60,
    "width": 40,
    "height": 35,
    "dimension_unit": "cm"
  }
}

quantity_per_carton 为正整数，其余为正数，单位分别取 g/kg 与 cm/mm/in。

stock

{
  "status": "answered",
  "value": {
    "availability": "in_stock",
    "quantity": 800
  }
}

availability 取 in_stock、out_of_stock、partial、unknown；quantity 可选，可为 null。

lead_time

生产或补货所需天数。

{
  "status": "answered",
  "value": {
    "min_days": 7,
    "max_days": 15
  }
}

均为整数，且 max_days 不小于 min_days。

moq

{
  "status": "answered",
  "value": {
    "quantity": 100,
    "unit": "pieces"
  }
}

unit 使用供应商的原始口径（pieces、sets、cartons 等），最长 32 字符。

neutral_packaging

供应商是否可以去除自有品牌标识发货。

{
  "status": "answered",
  "value": {
    "support": "conditional",
    "note": "200 件以上免费"
  }
}

support 取 yes、no、conditional、unknown；note 可选。

customization

印 logo、改颜色、定制包装等。

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "单色印刷，另收版费"
  }
}

moq 与 note 均为可选。

product_details

材质、认证、电压、型号差异等描述性问题。

{
  "status": "answered",
  "value": {
    "text": "304 不锈钢，壁厚 1.2mm"
  }
}

other

兜底类型。提问时必须填 question；答案为自由文本，最长 4000 字符。

{
  "status": "answered",
  "value": {
    "text": "可以，周六也能发货。"
  }
}

能用标准类型就别用 other

标准类型有校验、可跨供应商比较，并会沉淀进共享的物流数据集；自由文本三者皆无。只有确实没有匹配类型时才使用 other。

重量与尺寸答案会被复用

packed_weight、package_dimensions、carton_info 的答案会以供应商确认的物流观测记录到 channel + source_product_id + sku 维度，供该商品后续订单的运费试算使用。只保留物理属性，不会保存你的提问、备注或业务上下文。

获取支持

需要集成帮助？请联系开发者支持 support@hiobuy.com · 预计 1–2 个工作日内回复

发送邮件