أنواع الأسئلة ومخططات الإجابات

الأسئلة ذات أنواع محددة بدلاً من كونها نصًا حرًا، وهذا ما يجعل الإجابات قابلة للمعالجة آليًا: فالنوع packed_weight يعود دائمًا كرقم مع وحدة قياس، لا كعبارة مثل “حوالي 1.2 كيلوغرام على ما أظن”.

طرح سؤال

{
  "type": "packed_weight",
  "note": "Weight including the retail box"
}

القواعد: من 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": "Free above 200 units"
  }
}

الحقل support يأخذ إحدى القيم yes أو no أو conditional أو unknown؛ وnote نص حر اختياري.

customization

طباعة الشعار، أو لون مخصص، أو تغليف مخصص.

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "One-colour logo print, plate fee applies"
  }
}

الحقلان moq وnote اختياريان.

product_details

أي معلومة وصفية — الخامة، الشهادات، الجهد الكهربائي، الفروق بين الموديلات.

{
  "status": "answered",
  "value": {
    "text": "304 stainless steel, 1.2 mm wall"
  }
}

other

مخرج الطوارئ. الحقل question مطلوب عند السؤال؛ والإجابة نص حر بحد أقصى 4000 حرف.

{
  "status": "answered",
  "value": {
    "text": "Yes, they can ship on Saturdays."
  }
}

إعادة استخدام إجابات الوزن والأبعاد

تُسجَّل إجابات packed_weight وpackage_dimensions وcarton_info بوصفها ملاحظات لوجستية مؤكَّدة من المورد مرتبطة بالمزيج channel + source_product_id + sku. وهذا يتيح استخدامها في تقدير الشحن للطلبات اللاحقة على المنتج نفسه. ولا يُحتفظ إلا بالخصائص المادية — ولا يُحتفظ أبدًا بأسئلتك أو ملاحظاتك أو سياقك التجاري.