Tipos de pregunta y esquemas de respuesta

Las preguntas son tipadas en lugar de texto libre, y eso es lo que hace que las respuestas sean procesables por máquina: packed_weight siempre vuelve como un número más una unidad, nunca como «creo que alrededor de 1,2 kilos».

Formular una pregunta

{
  "type": "packed_weight",
  "note": "Peso incluyendo la caja de venta al público"
}

Reglas: de 1 a 10 preguntas por mensaje; un tipo estándar solo puede aparecer una vez por mensaje (de lo contrario, INVALID_QUESTION_SCHEMA); other puede repetirse porque cada instancia es una pregunta distinta. En los tipos estándar el campo question se ignora: pon el contexto en note.

Envoltura de la respuesta

Cada respuesta lleva un estado:

Solo answered incluye un value; los otros tres siempre devuelven 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"
}

Los diez tipos

packed_weight

Peso de una unidad tal como la embala el proveedor.

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

value es un número positivo y unit es g o kg.

package_dimensions

Dimensiones exteriores de una unidad embalada.

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

Los tres valores son números positivos; unit es cm, mm o in.

carton_info

Especificación de la caja máster, la que determina tu coste de transporte.

{
  "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 es un entero positivo; el resto son números positivos con unidades g/kg y cm/mm/in.

stock

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

availability es in_stock, out_of_stock, partial o unknown. quantity es opcional y puede ser null.

lead_time

Tiempo de producción o de reposición en días.

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

Ambos son enteros y max_days debe ser mayor o igual que min_days.

moq

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

unit usa la propia terminología del proveedor (pieces, sets, cartons, …), máximo 32 caracteres.

neutral_packaging

Si el proveedor envía sin su propia marca.

{
  "status": "answered",
  "value": {
    "support": "conditional",
    "note": "Gratis a partir de 200 unidades"
  }
}

support es yes, no, conditional o unknown; note es texto libre opcional.

customization

Impresión de logotipo, color personalizado, embalaje personalizado.

{
  "status": "answered",
  "value": {
    "support": "yes",
    "moq": 500,
    "note": "Impresión de logotipo a un color, se aplica coste de cliché"
  }
}

moq y note son ambos opcionales.

product_details

Cualquier dato descriptivo: material, certificación, voltaje, diferencias entre modelos.

{
  "status": "answered",
  "value": {
    "text": "Acero inoxidable 304, pared de 1,2 mm"
  }
}

other

La vía de escape. question es obligatorio al preguntar; la respuesta es texto libre, máximo 4000 caracteres.

{
  "status": "answered",
  "value": {
    "text": "Sí, pueden enviar los sábados."
  }
}

Las respuestas de peso y dimensiones se reutilizan

Las respuestas a packed_weight, package_dimensions y carton_info se registran como observaciones logísticas confirmadas por el proveedor asociadas a channel + source_product_id + sku. Así quedan disponibles para estimar el transporte en pedidos posteriores del mismo producto. Solo se conservan los atributos físicos; nunca tus preguntas, notas o contexto de negocio.