Types de questions et schémas de réponse

Les questions sont typées plutôt que rédigées en texte libre : c’est ce qui rend les réponses exploitables par machine. packed_weight revient toujours sous forme d’un nombre accompagné d’une unité, jamais sous la forme « environ 1,2 kilo je crois ».

Poser une question

{
  "type": "packed_weight",
  "note": "Poids avec la boîte de vente incluse"
}

Règles : 1 à 10 questions par message ; un type standard ne peut apparaître qu’une seule fois par message (sinon INVALID_QUESTION_SCHEMA) ; other peut être répété, chaque occurrence correspondant à une question différente. Sur les types standard, un champ question est ignoré — placez le contexte dans note.

Enveloppe de réponse

Chaque réponse porte un statut :

Seul answered porte une value — les trois autres renvoient toujours 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"
}

Les dix types

packed_weight

Poids d’une unité telle qu’emballée par le fournisseur.

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

value est un nombre positif, unit vaut g ou kg.

package_dimensions

Dimensions extérieures d’une unité emballée.

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

Les trois valeurs sont des nombres positifs ; unit vaut cm, mm ou in.

carton_info

Spécification du carton maître — celle qui détermine votre coût de fret.

{
  "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 est un entier positif ; les autres valeurs sont des nombres positifs exprimés avec les unités g/kg et cm/mm/in.

stock

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

availability vaut in_stock, out_of_stock, partial ou unknown. quantity est facultatif et peut valoir null.

lead_time

Délai de production ou de réapprovisionnement, en jours.

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

Les deux valeurs sont des entiers et max_days doit être supérieur ou égal à min_days.

moq

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

unit reprend la formulation du fournisseur (pieces, sets, cartons, …), 32 caractères maximum.

neutral_packaging

Indique si le fournisseur expédie sans sa propre marque.

{
  "status": "answered",
  "value": {
    "support": "conditional",
    "note": "Gratuit au-delà de 200 unités"
  }
}

support vaut yes, no, conditional ou unknown ; note est un texte libre facultatif.

customization

Impression de logo, couleur sur mesure, emballage personnalisé.

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "Impression logo une couleur, frais de cliché applicables"
  }
}

moq et note sont tous deux facultatifs.

product_details

Tout élément descriptif — matériau, certification, tension, différences entre modèles.

{
  "status": "answered",
  "value": {
    "text": "Acier inoxydable 304, paroi de 1,2 mm"
  }
}

other

La solution de repli. question est obligatoire au moment de la demande ; la réponse est un texte libre de 4000 caractères maximum.

{
  "status": "answered",
  "value": {
    "text": "Oui, ils peuvent expédier le samedi."
  }
}

Les réponses de poids et de dimensions sont réutilisées

Les réponses à packed_weight, package_dimensions et carton_info sont enregistrées comme observations logistiques confirmées par le fournisseur pour la clé channel + source_product_id + sku. Elles sont ainsi disponibles pour l’estimation de fret des commandes ultérieures portant sur le même produit. Seuls les attributs physiques sont conservés — jamais vos questions, vos notes ni votre contexte commercial.