質問タイプと回答スキーマ

質問はフリーテキストではなく型付けされており、これが回答を機械可読にしています。packed_weight は常に数値と単位で返り、「だいたい 1.2 キロくらいだと思います」のような形にはなりません。

質問の送り方

{
  "type": "packed_weight",
  "note": "小売箱を含む重量"
}
フィールド必須説明
typeはい以下の 10 タイプのいずれか
noteいいえオペレーター向けの補足情報、最大 500 文字
questionother の場合のみフリーテキストの質問、最大 500 文字

ルール: 1 メッセージあたり質問は 1〜10 件。標準タイプは 1 メッセージ内で 1 回のみ指定できます(違反すると INVALID_QUESTION_SCHEMA)。other は各々が別の質問となるため複数指定できます。標準タイプでは question フィールドは無視されるため、補足は note に記述してください。

回答のエンベロープ

すべての回答にはステータスが付きます。

ステータス意味
answeredサプライヤーが回答した。value が入る
unavailableサプライヤーがこの情報を持っていない
refusedサプライヤーが回答を拒否した
unknown有効な回答を得られなかった

value が入るのは answered のみで、他の 3 つは常に 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"
}

10 種類のタイプ

packed_weight

サプライヤーが梱包した状態での 1 個あたりの重量。

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

value は正の数値、unitg または kg です。

package_dimensions

梱包済み 1 個の外寸。

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

3 辺はいずれも正の数値で、unitcmmmin のいずれかです。

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
  }
}

availabilityin_stockout_of_stockpartialunknown のいずれかです。quantity は任意で、null になることがあります。

lead_time

生産または再入荷にかかる日数。

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

いずれも整数で、max_daysmin_days 以上でなければなりません。

moq

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

unit はサプライヤー自身の表現(piecessetscartons など)で、最大 32 文字です。

neutral_packaging

サプライヤーが自社ブランドを付けずに出荷できるかどうか。

{
  "status": "answered",
  "value": {
    "support": "conditional",
    "note": "200 個以上で無償"
  }
}

supportyesnoconditionalunknown のいずれかで、note は任意のフリーテキストです。

customization

ロゴ印刷、カラー変更、梱包のカスタマイズなど。

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "1 色ロゴ印刷、版代が別途必要"
  }
}

moqnote はいずれも任意です。

product_details

素材、認証、電圧、モデル間の違いなど、記述的な情報全般。

{
  "status": "answered",
  "value": {
    "text": "SUS304 ステンレス、肉厚 1.2 mm"
  }
}

other

どのタイプにも当てはまらない場合の受け皿です。質問時は question が必須で、回答は最大 4000 文字のフリーテキストになります。

{
  "status": "answered",
  "value": {
    "text": "はい、土曜日の出荷が可能です。"
  }
}

other よりも標準タイプを優先してください

標準タイプは検証され、サプライヤー間で比較でき、共有物流データセットにも反映されます。フリーテキストではいずれも得られません。他に該当するタイプがない場合にのみ other を使用してください。

重量と寸法の回答は再利用されます

packed_weightpackage_dimensionscarton_info への回答は、channel + source_product_id + sku に紐づく サプライヤー確認済みの物流実測値 として記録されます。これにより、同じ商品の以後の注文で送料見積りに利用できます。保存されるのは物理属性のみで、質問内容やメモ、ビジネス上の文脈は一切保存されません。

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support