질문 유형 및 답변 스키마

질문은 자유 텍스트가 아니라 타입으로 정의되며, 덕분에 답변을 기계가 읽을 수 있습니다. packed_weight는 “대략 1.2kg 정도인 것 같아요” 같은 문장이 아니라 언제나 숫자와 단위로 돌아옵니다.

질문 보내기

{
  "type": "packed_weight",
  "note": "소매 박스를 포함한 중량"
}

규칙: 메시지당 질문은 1~10개이며, 표준 유형은 메시지당 한 번만 사용할 수 있습니다(그렇지 않으면 INVALID_QUESTION_SCHEMA). other는 각각 다른 질문이므로 반복해서 사용할 수 있습니다. 표준 유형에서는 question 필드가 무시되므로 부가 설명은 note에 담으세요.

답변 공통 구조

모든 답변에는 상태가 포함됩니다.

value가 채워지는 것은 answered뿐이며, 나머지 세 가지는 항상 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

공급업체가 포장한 상태에서의 개당 중량입니다.

{
  "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

로고 인쇄, 색상 변경, 맞춤 포장 등에 대한 질문입니다.

{
  "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": "네, 토요일에도 출고 가능합니다."
  }
}

중량 및 치수 답변은 재사용됩니다

packed_weight, package_dimensions, carton_info에 대한 답변은 channel + source_product_id + sku 기준으로 공급업체가 확인한 물류 정보로 기록됩니다. 따라서 같은 상품의 이후 주문에서 운임 산정에 활용할 수 있습니다. 물리적 속성만 보관되며, 질문이나 메모, 비즈니스 맥락은 저장되지 않습니다.