Fragetypen und Antwortschemata

Fragen sind typisiert statt Freitext, und genau das macht die Antworten maschinenlesbar: packed_weight kommt immer als Zahl plus Einheit zurück, nie als „ungefähr 1,2 Kilo, glaube ich”.

Eine Frage stellen

{
  "type": "packed_weight",
  "note": "Gewicht inklusive Verkaufsverpackung"
}

Regeln: 1–10 Fragen pro Nachricht; ein Standardtyp darf pro Nachricht nur einmal vorkommen (andernfalls INVALID_QUESTION_SCHEMA); other darf sich wiederholen, da jede Instanz eine andere Frage ist. Bei Standardtypen wird ein question-Feld ignoriert — hinterlegen Sie den Kontext in note.

Antwort-Envelope

Jede Antwort trägt einen Status:

Nur answered enthält einen value — die anderen drei liefern stets 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"
}

Die zehn Typen

packed_weight

Gewicht einer Einheit, wie vom Lieferanten verpackt.

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

value ist eine positive Zahl, unit ist g oder kg.

package_dimensions

Außenmaße einer einzelnen verpackten Einheit.

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

Alle drei Werte sind positive Zahlen; unit ist cm, mm oder in.

carton_info

Spezifikation des Umkartons — die Angabe, die Ihre Frachtkosten bestimmt.

{
  "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 ist eine positive Ganzzahl; die übrigen Werte sind positive Zahlen mit den Einheiten g/kg und cm/mm/in.

stock

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

availability ist in_stock, out_of_stock, partial oder unknown. quantity ist optional und kann null sein.

lead_time

Produktions- oder Nachlieferzeit in Tagen.

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

Beide Werte sind Ganzzahlen, und max_days muss größer oder gleich min_days sein.

moq

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

unit ist die Formulierung des Lieferanten selbst (pieces, sets, cartons, …), maximal 32 Zeichen.

neutral_packaging

Ob der Lieferant ohne eigenes Branding versendet.

{
  "status": "answered",
  "value": {
    "support": "conditional",
    "note": "Kostenlos ab 200 Stück"
  }
}

support ist yes, no, conditional oder unknown; note ist optionaler Freitext.

customization

Logodruck, Sonderfarbe, individuelle Verpackung.

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "Einfarbiger Logodruck, Klischeekosten fallen an"
  }
}

moq und note sind beide optional.

product_details

Alles Beschreibende — Material, Zertifizierung, Spannung, Modellunterschiede.

{
  "status": "answered",
  "value": {
    "text": "Edelstahl 304, 1,2 mm Wandstärke"
  }
}

other

Die Notlösung. question ist beim Stellen der Frage erforderlich; die Antwort ist Freitext mit maximal 4000 Zeichen.

{
  "status": "answered",
  "value": {
    "text": "Ja, es kann auch samstags versendet werden."
  }
}

Antworten zu Gewicht und Maßen werden wiederverwendet

Antworten auf packed_weight, package_dimensions und carton_info werden als vom Lieferanten bestätigte Logistikdaten zu channel + source_product_id + sku erfasst. Dadurch stehen sie für die Frachtkalkulation späterer Bestellungen desselben Produkts zur Verfügung. Gespeichert werden ausschließlich die physischen Attribute — niemals Ihre Fragen, Notizen oder Ihr geschäftlicher Kontext.