Типы вопросов и схемы ответов

Вопросы типизированы, а не заданы свободным текстом — именно поэтому ответы пригодны для машинной обработки: packed_weight всегда возвращается как число плюс единица измерения, а не как «где-то килограмма 1,2, наверное».

Как задать вопрос

{
  "type": "packed_weight",
  "note": "Вес вместе с розничной коробкой"
}

Правила: от 1 до 10 вопросов в сообщении; стандартный тип может встречаться в сообщении только один раз (иначе — INVALID_QUESTION_SCHEMA); тип other может повторяться, так как каждый такой вопрос уникален. Для стандартных типов поле question игнорируется — контекст указывайте в note.

Оболочка ответа

Каждый ответ содержит статус:

Только 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

Нанесение логотипа, нестандартный цвет, индивидуальная упаковка.

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "Печать логотипа в один цвет, оплачивается изготовление клише"
  }
}

Поля moq и note необязательны.

product_details

Всё описательное — материал, сертификация, напряжение, отличия моделей.

{
  "status": "answered",
  "value": {
    "text": "Нержавеющая сталь 304, толщина стенки 1,2 мм"
  }
}

other

Запасной вариант. При отправке обязательно поле question; ответ приходит свободным текстом, максимум 4000 символов.

{
  "status": "answered",
  "value": {
    "text": "Да, они могут отгружать по субботам."
  }
}

Ответы о весе и габаритах переиспользуются

Ответы на packed_weight, package_dimensions и carton_info сохраняются как подтверждённые поставщиком логистические данные по связке channel + source_product_id + sku. Благодаря этому они доступны для расчёта доставки в последующих заказах по тому же товару. Сохраняются только физические характеристики — никогда ваши вопросы, заметки или бизнес-контекст.