質問タイプと回答スキーマ
質問はフリーテキストではなく型付けされており、これが回答を機械可読にしています。packed_weight は常に数値と単位で返り、「だいたい 1.2 キロくらいだと思います」のような形にはなりません。
質問の送り方
{
"type": "packed_weight",
"note": "小売箱を含む重量"
}| フィールド | 必須 | 説明 |
|---|---|---|
type | はい | 以下の 10 タイプのいずれか |
note | いいえ | オペレーター向けの補足情報、最大 500 文字 |
question | other の場合のみ | フリーテキストの質問、最大 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 は正の数値、unit は g または kg です。
package_dimensions
梱包済み 1 個の外寸。
{
"status": "answered",
"value": {
"length": 32,
"width": 24,
"height": 12,
"unit": "cm"
}
}3 辺はいずれも正の数値で、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
ロゴ印刷、カラー変更、梱包のカスタマイズなど。
{
"status": "answered",
"value": {
"support": "yes",
"moq": 500,
"note": "1 色ロゴ印刷、版代が別途必要"
}
}moq と note はいずれも任意です。
product_details
素材、認証、電圧、モデル間の違いなど、記述的な情報全般。
{
"status": "answered",
"value": {
"text": "SUS304 ステンレス、肉厚 1.2 mm"
}
}other
どのタイプにも当てはまらない場合の受け皿です。質問時は question が必須で、回答は最大 4000 文字のフリーテキストになります。
{
"status": "answered",
"value": {
"text": "はい、土曜日の出荷が可能です。"
}
}other よりも標準タイプを優先してください
標準タイプは検証され、サプライヤー間で比較でき、共有物流データセットにも反映されます。フリーテキストではいずれも得られません。他に該当するタイプがない場合にのみ other を使用してください。
重量と寸法の回答は再利用されます
packed_weight、package_dimensions、carton_info への回答は、channel + source_product_id + sku に紐づく サプライヤー確認済みの物流実測値 として記録されます。これにより、同じ商品の以後の注文で送料見積りに利用できます。保存されるのは物理属性のみで、質問内容やメモ、ビジネス上の文脈は一切保存されません。
Get Support
Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days