Loại câu hỏi và lược đồ câu trả lời

Câu hỏi được định kiểu thay vì để dạng văn bản tự do, và đó chính là lý do câu trả lời có thể đọc được bằng máy: packed_weight luôn trả về một con số kèm đơn vị, chứ không phải “khoảng 1,2 kg thì phải”.

Đặt một câu hỏi

{
  "type": "packed_weight",
  "note": "Khối lượng bao gồm hộp bán lẻ"
}

Quy tắc: 1–10 câu hỏi mỗi tin nhắn; mỗi loại chuẩn chỉ được xuất hiện một lần trong một tin nhắn (nếu không sẽ nhận INVALID_QUESTION_SCHEMA); other có thể lặp lại vì mỗi lần là một câu hỏi khác nhau. Với các loại chuẩn, trường question sẽ bị bỏ qua — hãy đưa bối cảnh vào note.

Khung câu trả lời

Mọi câu trả lời đều mang một trạng thái:

Chỉ answered mới có value — ba trạng thái còn lại luôn trả về 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"
}

Mười loại câu hỏi

packed_weight

Khối lượng của một sản phẩm sau khi nhà cung cấp đóng gói.

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

value là số dương, unit là g hoặc kg.

package_dimensions

Kích thước ngoài của một sản phẩm đã đóng gói.

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

Cả ba giá trị đều là số dương; unit là cm, mm hoặc in.

carton_info

Thông số thùng carton lớn — yếu tố quyết định chi phí vận chuyển của bạn.

{
  "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 là số nguyên dương; các giá trị còn lại là số dương với đơn vị g/kg và cm/mm/in.

stock

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

availability là in_stock, out_of_stock, partial hoặc unknown. quantity là tùy chọn và có thể là null.

lead_time

Thời gian sản xuất hoặc bổ sung hàng, tính theo ngày.

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

Cả hai đều là số nguyên và max_days phải lớn hơn hoặc bằng min_days.

moq

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

unit là cách diễn đạt của chính nhà cung cấp (pieces, sets, cartons, …), tối đa 32 ký tự.

neutral_packaging

Nhà cung cấp có giao hàng không kèm thương hiệu của họ hay không.

{
  "status": "answered",
  "value": {
    "support": "conditional",
    "note": "Miễn phí khi trên 200 sản phẩm"
  }
}

support là yes, no, conditional hoặc unknown; note là văn bản tự do và không bắt buộc.

customization

In logo, tùy chỉnh màu sắc, tùy chỉnh bao bì.

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "In logo một màu, có phí làm bản in"
  }
}

moq và note đều là tùy chọn.

product_details

Mọi thông tin mang tính mô tả — chất liệu, chứng nhận, điện áp, khác biệt giữa các mẫu.

{
  "status": "answered",
  "value": {
    "text": "Thép không gỉ 304, thành dày 1,2 mm"
  }
}

other

Phương án dự phòng. question là bắt buộc khi đặt câu hỏi; câu trả lời là văn bản tự do, tối đa 4000 ký tự.

{
  "status": "answered",
  "value": {
    "text": "Có, họ có thể giao hàng vào thứ Bảy."
  }
}

Câu trả lời về khối lượng và kích thước được tái sử dụng

Câu trả lời cho packed_weight, package_dimensions và carton_info được ghi nhận là dữ liệu logistics đã được nhà cung cấp xác nhận gắn với channel + source_product_id + sku. Nhờ đó chúng có thể dùng để ước tính chi phí vận chuyển cho các đơn hàng sau của cùng sản phẩm. Chỉ các thuộc tính vật lý được lưu lại — không bao giờ lưu câu hỏi, ghi chú hay bối cảnh kinh doanh của bạn.