Obtener menús

{
  "data": [
    {
      "id": "almuerzo-delivery",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "brand_id": null,
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "store_id": "centro",
      "store_uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "channel_id": "app",
      "channel_uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "fulfillment_id": "delivery",
      "fulfillment_uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
      "name": { "en_us": "Menú almuerzo delivery" },
      "description": { "en_us": "Ítems de almuerzo entre semana para delivery en app" },
      "schedules": [
        { "day_of_week": "monday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "tuesday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "wednesday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "thursday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "friday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] }
      ],
      "products": [
        {
          "id": "hamburguesa-clasica",
          "name": { "en_us": "Hamburguesa clásica" },
          "description": { "en_us": "Carne Angus con lechuga y tomate." },
          "image_url": "https://cdn.example.com/hamburguesa-clasica.jpg",
          "cms_template_id": null,
          "status": "ACTIVE",
          "bundled_items": [],
          "pricing": {
            "minimum_quantity": 1,
            "maximum_quantity": 10,
            "is_tax_inclusive": true,
            "tax_rate": 0.15,
            "price": 12.99,
            "anchor_price": 14.99,
            "anchor_price_percentage": 0.13,
            "modifiers": [],
            "modifier_group_ids": ["elige-bebida"]
          },
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        },
        {
          "id": "refresco",
          "name": { "en_us": "Refresco" },
          "description": null,
          "image_url": null,
          "cms_template_id": null,
          "status": "ACTIVE",
          "bundled_items": [],
          "pricing": {
            "minimum_quantity": 0,
            "maximum_quantity": 1,
            "is_tax_inclusive": true,
            "tax_rate": 0.15,
            "price": 0,
            "anchor_price": 0,
            "anchor_price_percentage": 0,
            "modifiers": [],
            "modifier_group_ids": []
          },
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        },
        {
          "id": "cola",
          "name": { "en_us": "Cola" },
          "description": null,
          "image_url": null,
          "cms_template_id": null,
          "status": "ACTIVE",
          "bundled_items": [],
          "pricing": {
            "minimum_quantity": 0,
            "maximum_quantity": 1,
            "is_tax_inclusive": true,
            "tax_rate": 0.15,
            "price": 0,
            "anchor_price": 0,
            "anchor_price_percentage": 0,
            "modifiers": [],
            "modifier_group_ids": []
          },
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        }
      ],
      "categories": [
        {
          "id": "principales",
          "name": { "en_us": "Platos fuertes" },
          "description": { "en_us": "Hamburguesas y sándwiches" },
          "image_url": "https://cdn.example.com/mains.jpg",
          "cms_template_id": null,
          "status": "ACTIVE",
          "items": [{ "type": "PRODUCT", "id": "e5f6a7b8-c9d0-1234-ef56-789012345678" }],
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        }
      ],
      "modifier_groups": [
        {
          "id": "elige-bebida",
          "title": { "en_us": "Elige una bebida" },
          "description": null,
          "display_type": "LIST",
          "modifier_ids": ["cola", "refresco"],
          "minimum_quantity": 0,
          "maximum_quantity": 1,
          "charge_above_quantity": null,
          "metadata": {}
        }
      ],
      "metadata": {},
      "cms_template_id": null,
      "cms": null,
      "status": "ACTIVE",
      "release": "v2026-07-10-21h"
    }
  ]
}

Devuelve todos los menús disponibles para el contexto de venta actual del cliente. Pasa fulfillment_id, store_id, channel_id y brand_id para cargar catálogos de esa combinación. Si falta algún parámetro, o si no existe un menú para la combinación, Fire spark usa el menú default del comercio (fulfillment_id, store_id, channel_id y brand_id en __ANY__). Cuando store_id, channel_id y fulfillment_id vienen todos informados (y no son __ANY__), Fire spark comprueba que esas entidades existan y estén en ACTIVE (y que brand_id esté ACTIVE si se envía). Un scope inactivo o inexistente responde 422 con details.issues[] de { code: "SCOPE_INACTIVE", field }, donde field es store_id, channel_id, fulfillment_id o brand_id. Cuando varios menús comparten el mismo contexto y sus horarios coinciden con la hora actual, Fire spark los devuelve todos en data. Los menús con schedules: null están siempre disponibles. Cuando ningún menú está en horario, Fire spark devuelve en data el o los menús cuya próxima ventana de disponibilidad es la más cercana a la hora actual. Si varios menús comparten esa misma hora de inicio, se devuelven todos.

Requiere un access token de Fire spark obtenido mediante intercambio de token.

Parámetros de consulta

Parámetro	Requerido	Descripción
`fulfillment_id`	No	Identificador externo de fulfillment (por ejemplo `delivery`, `pickup`). Solo alfanuméricos, `_` y `-`. 1–64 caracteres. Omítelo para recibir el menú default.
`store_id`	No	Identificador externo de la tienda. Solo alfanuméricos, `_` y `-`. 1–64 caracteres. Omítelo para recibir el menú default.
`channel_id`	No	Identificador externo del canal. Solo alfanuméricos, `_` y `-`. 1–64 caracteres. Omítelo para recibir el menú default.
`brand_id`	No	Identificador externo de la marca. Solo alfanuméricos, `_` y `-`. 1–64 caracteres. Omítelo para recibir el menú default.
`streaming`	No	Si es `true`, responde NDJSON (un menú por línea) en vez de un JSON. Default `false`. Acepta `true` / `1` / `false` / `0`.
`category_limit`	No	Máximo de categorías aplanadas en la primera línea. Entero 1–50. Default `10`. Solo aplica con `streaming=true`.
`product_limit`	No	Máximo de products vendibles por categoría del fold en la primera línea. Entero 1–100. Default `10`. Solo aplica con `streaming=true`.

Solicitud

curl "https://firespark.cloud/api/storefront/v1/menus?fulfillment_id=delivery&store_id=centro&channel_id=app&brand_id=0001" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Streaming

Omite streaming (o envía false) para conservar el JSON único de abajo. Con streaming=true, Fire spark responde Content-Type: application/x-ndjson. Cada línea es { "data": Menu[] } con un menú. Haz upsert por id (gana la línea más reciente); no reemplaces la lista.

Fold del primer menú. Las primeras category_limit categorías en orden de display (depth-first, el mismo del nav), cada una con hasta product_limit products vendibles. Cada uno incluye su árbol de customización (modifier_groups, modifiers anidados y bundled_items) para poder abrir customización de inmediato. recommendations es [].
Primer menú completo. El primer menú completo del payload sin streaming.
Menús restantes. Un menú completo por línea, en el orden del catálogo.

404 y 422 siguen siendo JSON y se deciden antes de abrir el stream.

curl "https://firespark.cloud/api/storefront/v1/menus?fulfillment_id=delivery&store_id=centro&channel_id=app&brand_id=0001&streaming=true" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Respuesta

La respuesta envuelve un arreglo de menús en data. Solo se devuelven menús ACTIVE. Si al menos un menú está en horario ahora, se incluyen todos los que coinciden. Si no, Fire spark incluye el menú o menús cuya próxima ventana programada comienza antes.

{
  "data": [
    {
      "id": "almuerzo-delivery",
      "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "brand_id": null,
      "merchant_id": "22222222-2222-2222-2222-222222222222",
      "store_id": "centro",
      "store_uid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "channel_id": "app",
      "channel_uid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
      "fulfillment_id": "delivery",
      "fulfillment_uid": "d4e5f6a7-b8c9-0123-def4-567890abcdef",
      "name": { "en_us": "Menú almuerzo delivery" },
      "description": { "en_us": "Ítems de almuerzo entre semana para delivery en app" },
      "schedules": [
        { "day_of_week": "monday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "tuesday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "wednesday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "thursday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] },
        { "day_of_week": "friday", "periods": [{ "start_time": "11:00:00", "end_time": "15:00:00" }] }
      ],
      "products": [
        {
          "id": "hamburguesa-clasica",
          "name": { "en_us": "Hamburguesa clásica" },
          "description": { "en_us": "Carne Angus con lechuga y tomate." },
          "image_url": "https://cdn.example.com/hamburguesa-clasica.jpg",
          "cms_template_id": null,
          "status": "ACTIVE",
          "bundled_items": [],
          "pricing": {
            "minimum_quantity": 1,
            "maximum_quantity": 10,
            "is_tax_inclusive": true,
            "tax_rate": 0.15,
            "price": 12.99,
            "anchor_price": 14.99,
            "anchor_price_percentage": 0.13,
            "modifiers": [],
            "modifier_group_ids": ["elige-bebida"]
          },
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        },
        {
          "id": "refresco",
          "name": { "en_us": "Refresco" },
          "description": null,
          "image_url": null,
          "cms_template_id": null,
          "status": "ACTIVE",
          "bundled_items": [],
          "pricing": {
            "minimum_quantity": 0,
            "maximum_quantity": 1,
            "is_tax_inclusive": true,
            "tax_rate": 0.15,
            "price": 0,
            "anchor_price": 0,
            "anchor_price_percentage": 0,
            "modifiers": [],
            "modifier_group_ids": []
          },
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        },
        {
          "id": "cola",
          "name": { "en_us": "Cola" },
          "description": null,
          "image_url": null,
          "cms_template_id": null,
          "status": "ACTIVE",
          "bundled_items": [],
          "pricing": {
            "minimum_quantity": 0,
            "maximum_quantity": 1,
            "is_tax_inclusive": true,
            "tax_rate": 0.15,
            "price": 0,
            "anchor_price": 0,
            "anchor_price_percentage": 0,
            "modifiers": [],
            "modifier_group_ids": []
          },
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        }
      ],
      "categories": [
        {
          "id": "principales",
          "name": { "en_us": "Platos fuertes" },
          "description": { "en_us": "Hamburguesas y sándwiches" },
          "image_url": "https://cdn.example.com/mains.jpg",
          "cms_template_id": null,
          "status": "ACTIVE",
          "items": [{ "type": "PRODUCT", "id": "e5f6a7b8-c9d0-1234-ef56-789012345678" }],
          "availability": {
            "status": "AVAILABLE",
            "schedules": null,
            "out_of_stock_until": null
          },
          "metadata": {}
        }
      ],
      "modifier_groups": [
        {
          "id": "elige-bebida",
          "title": { "en_us": "Elige una bebida" },
          "description": null,
          "display_type": "LIST",
          "modifier_ids": ["cola", "refresco"],
          "minimum_quantity": 0,
          "maximum_quantity": 1,
          "charge_above_quantity": null,
          "metadata": {}
        }
      ],
      "metadata": {},
      "cms_template_id": null,
      "cms": null,
      "status": "ACTIVE",
      "release": "v2026-07-10-21h"
    }
  ]
}

Objeto menú

Campo	Tipo	Descripción
`id`	string	Identificador externo del menú. Solo alfanuméricos, `_` y `-`. 1–64 caracteres.
`uid`	string (UUID)	Identificador interno de Fire spark.
`brand_id`	string \| null	Identificador externo de marca. `null` cuando el recurso no está ligado a una marca.
`merchant_id`	string (UUID)	Identificador de comercio en Fire spark.
`store_id`	string	Identificador externo de la tienda.
`store_uid`	string (UUID)	Identificador de tienda en Fire spark.
`channel_id`	string	Identificador externo del canal.
`channel_uid`	string (UUID)	Identificador de canal en Fire spark.
`fulfillment_id`	string	Identificador externo de fulfillment.
`fulfillment_uid`	string (UUID)	Identificador de fulfillment en Fire spark.
`name`	object	Nombre visible localizado por locale (por ejemplo `en_us`). Cada valor tiene 1–1024 caracteres.
`description`	object \| null	Descripción localizada por locale. `null` si se omite. Cada valor tiene 1–1024 caracteres.
`schedules`	array \| null	Entradas de horario semanal. `null` cuando no hay restricción de horarios.
`products`	array	Productos en este menú. Usa Obtener producto para detalles.
`categories`	array	Categorías en este menú. Usa Obtener categoría para detalles.
`modifier_groups`	array	Grupos de modificadores referenciados por productos en este menú.
`variant_groups`	array	Grupos de variantes referenciados por productos en este menú. Solo incluye opciones cuyos productos están en el menú.
`metadata`	object	Metadatos del partner. Por defecto `{}`.
`cms_template_id`	string (UUID)	Plantilla CMS vinculada a este menú. `null` si no hay plantilla asignada.
`cms`	object	Solo lectura. Plantilla CMS resuelta cuando `cms_template_id` está asignado.
`status`	string	`ACTIVE` o `INACTIVE`. Solo se devuelven menús `ACTIVE`.
`release`	string	Id del release que publicó este menú.

schedules

Arreglo de entradas de horario, o null cuando no hay restricción de horarios. Cada entrada representa un día de la semana:

Campo	Requerido	Tipo	Descripción
`day_of_week`	Sí	string	`monday` a `sunday`.
`periods`	Sí	array	Una o más ventanas horarias en las que el menú está activo ese día.

Cada periodo:

Campo	Requerido	Tipo	Descripción
`closed`	No	boolean	`true` cuando este periodo está cerrado. Por defecto `false`.
`start_time`	Condicional	string	Hora ISO (por ejemplo `11:00:00`). Requerido salvo que `closed` sea `true`.
`end_time`	Condicional	string	Hora ISO (por ejemplo `15:00:00`). Requerido salvo que `closed` sea `true`.
`start_date`	No	string \| null	Fecha ISO 8601, o `null` para el fallback siempre activo. Definir junto con `end_date`.
`end_date`	No	string \| null	Fecha ISO 8601, o `null` para el fallback siempre activo. Definir junto con `start_date`.

products

Cada producto en un menú compuesto incluye campos de catálogo más precio y disponibilidad del contexto:

Campo	Requerido	Tipo	Descripción
`id`	Sí	string	Identificador externo del producto.
`name`	Sí	object	Nombre visible localizado por locale (por ejemplo `en_us`).
`description`	No	object \| null	Descripción localizada. `null` si se omite.
`image_url`	No	string	URL de imagen del producto. `null` si se omite.
`cms_template_id`	No	string (UUID)	Plantilla CMS vinculada. `null` si no hay plantilla.
`status`	Sí	string	`ACTIVE` o `INACTIVE`.
`bundled_items`	No	array	Ítems incluidos en un bundle o combo. Por defecto `[]`.
`pricing`	Sí	object	Precio, impuestos, límites de cantidad y configuración de modificadores. Ver pricing.
`availability`	Sí	object	Disponibilidad del producto. Ver campos abajo.
`metadata`	No	object	Metadatos del partner. Por defecto `{}`.

Cada objeto availability:

Campo	Requerido	Tipo	Descripción
`status`	Sí	string	`AVAILABLE`, `HIDDEN` u `OUT_OF_STOCK`.
`schedules`	No	array \| null	Entradas de horario con `day_of_week` y `periods`. `null` cuando no hay restricción de horarios.
`out_of_stock_until`	No	string	Fecha y hora ISO 8601 opcional cuando el producto vuelve a stock.

Cada entrada de bundled_items:

Campo	Requerido	Tipo	Descripción
`id`	Sí	string	Identificador externo del producto incluido.
`refund_price`	Sí	number	Monto de reembolso si el cliente quita este ítem del bundle. ≥ 0.
`included_quantity`	Sí	number	Unidades incluidas por defecto. ≥ 0.

Ejemplo de producto

{
  "id": "hamburguesa-clasica",
  "name": { "en_us": "Hamburguesa clásica" },
  "description": { "en_us": "Carne Angus con lechuga y tomate." },
  "image_url": "https://cdn.example.com/hamburguesa-clasica.jpg",
  "cms_template_id": null,
  "status": "ACTIVE",
  "bundled_items": [],
  "pricing": {
    "minimum_quantity": 1,
    "maximum_quantity": 10,
    "is_tax_inclusive": true,
    "tax_rate": 0.15,
    "price": 12.99,
    "anchor_price": 14.99,
    "anchor_price_percentage": 0.13,
    "modifiers": [],
    "modifier_group_ids": ["elige-bebida"]
  },
  "availability": {
    "status": "AVAILABLE",
    "schedules": null,
    "out_of_stock_until": null
  },
  "metadata": {}
}

categories

Cada categoría en un menú compuesto:

Campo	Requerido	Tipo	Descripción
`id`	Sí	string	Identificador externo de la categoría.
`name`	Sí	object	Nombre visible localizado por locale.
`description`	No	object \| null	Descripción localizada. `null` si se omite.
`image_url`	No	string	URL de imagen de la categoría. `null` si se omite.
`cms_template_id`	No	string (UUID)	Plantilla CMS vinculada. `null` si no hay plantilla.
`status`	Sí	string	`ACTIVE` o `INACTIVE`.
`items`	No	array	Entradas ordenadas de la categoría. Por defecto `[]`.
`availability`	Sí	object	Disponibilidad de la categoría. Ver campos abajo.
`metadata`	No	object	Metadatos del partner. Por defecto `{}`.

Cada entrada en items:

Campo	Requerido	Tipo	Descripción
`type`	Sí	string	`CATEGORY` o `PRODUCT`.
`id`	Sí	string	Identificador externo de categoría o producto.

Cada objeto availability:

Campo	Requerido	Tipo	Descripción
`status`	Sí	string	`AVAILABLE`, `HIDDEN` u `OUT_OF_STOCK`.
`schedules`	No	array \| null	Entradas de horario con `day_of_week` y `periods`. `null` cuando no hay restricción de horarios.
`out_of_stock_until`	No	string	Fecha y hora ISO 8601 opcional cuando el producto vuelve a stock.

Ejemplo de categoría

{
  "id": "principales",
  "name": { "en_us": "Platos fuertes" },
  "description": { "en_us": "Hamburguesas y sándwiches" },
  "image_url": "https://cdn.example.com/mains.jpg",
  "cms_template_id": null,
  "status": "ACTIVE",
  "items": [{ "type": "PRODUCT", "id": "e5f6a7b8-c9d0-1234-ef56-789012345678" }],
  "availability": {
    "status": "AVAILABLE",
    "schedules": null,
    "out_of_stock_until": null
  },
  "metadata": {}
}

modifier_groups

Cada grupo de modificadores en un menú compuesto:

Campo	Requerido	Tipo	Descripción
`id`	Sí	string	Identificador externo del grupo de modificadores. Referenciado desde `pricing.modifier_group_ids`.
`title`	Sí	object	Título localizado del grupo por locale.
`description`	No	object \| null	Descripción localizada. `null` si se omite.
`display_type`	No	string	`GRID` o `LIST`.
`modifier_ids`	Sí	array	UUIDs de productos modificadores en este grupo. Al menos 2 entradas.
`minimum_quantity`	Sí	number	Selecciones mínimas requeridas. ≥ 0.
`maximum_quantity`	Sí	number	Selecciones máximas permitidas. 0–1,000,000.
`charge_above_quantity`	No	number	Selecciones gratuitas antes de cobrar adicionales. Opcional.
`metadata`	No	object	Metadatos del partner. Por defecto `{}`.

Ejemplo de grupo de modificadores

{
  "id": "elige-bebida",
  "title": { "en_us": "Elige una bebida" },
  "description": null,
  "display_type": "LIST",
  "modifier_ids": ["cola", "refresco"],
  "minimum_quantity": 0,
  "maximum_quantity": 1,
  "charge_above_quantity": null,
  "metadata": {}
}

variant_groups

Cada grupo de variantes:

Campo	Requerido	Tipo	Descripción
`id`	Sí	string	Identificador externo del grupo de variantes. Referenciado desde `pricing.variant_group_ids`.
`title`	Sí	object	Pregunta localizada por locale.
`description`	No	object \| null	Descripción localizada.
`display_type`	No	string	`GRID` o `LIST`.
`variants`	Sí	array	Opciones del grupo. Entre 1 y 100. Mira los campos abajo.
`metadata`	No	object	Metadatos del partner. Por defecto `{}`.

Cada entrada en variants:

Campo	Requerido	Tipo	Descripción
`id`	Sí	string	Identificador de la opción, único entre todos los grupos de variantes. Referenciado desde `pricing.variants[].variant_group_option_ids`.
`name`	Sí	object	Etiqueta localizada de la opción.
`description`	No	object \| null	Descripción localizada.
`image_url`	No	string \| null	URL de imagen de la opción, servida desde el almacenamiento de Firespark igual que las imágenes de productos.
`product_ids`	Sí	array	Productos variante a los que puede llevar esta opción. Cada uno debe existir y listar esta opción en su `pricing.variants`. Entre 1 y 1000.
`metadata`	No	object	Metadatos del partner. Por defecto `{}`.

Example variant group

{
  "id": "size",
  "title": { "en_us": "Size" },
  "description": null,
  "display_type": "GRID",
  "variants": [
    { "id": "medium", "name": { "en_us": "Medium" }, "description": null, "image_url": null, "product_ids": ["pep-m-thin", "pep-m-thick"], "metadata": {} },
    { "id": "large", "name": { "en_us": "Large" }, "description": null, "image_url": null, "product_ids": ["pep-l-thin", "pep-l-thick"], "metadata": {} }
  ],
  "metadata": {}
}

pricing

Precio de producto en un menú compuesto:

Campo	Requerido	Tipo	Descripción
`minimum_quantity`	Sí	number	Unidades mínimas por pedido. ≥ 0.
`maximum_quantity`	Sí	number	Unidades máximas por pedido. 0–1,000,000.
`is_tax_inclusive`	Sí	boolean	Si `price` incluye impuestos.
`tax_rate`	Sí	number	Tasa de impuesto como decimal (por ejemplo `0.15` para 15%). 0–1.
`price`	Sí	number	Precio de lista. ≥ 0.
`anchor_price`	Sí	number	Precio de referencia para tachado o comparación. ≥ 0.
`anchor_price_percentage`	Sí	number	Descuento mostrado respecto a `anchor_price`. 0–1.
`starting_price`	No	number \| null	Precio más bajo posible al elegir los modificadores obligatorios. Muéstralo como “Desde $X” cuando sea mayor que `price`. `null` o ausente significa mostrar `price`.
`modifiers`	No	array	Overrides de precio por modificador. Por defecto `[]`.
`modifier_group_ids`	No	array	Identificadores externos de grupos de modificadores del producto. Por defecto `[]`.
`variant_group_ids`	No	array	Grupos de variantes que se preguntan en este producto base. Cada id debe existir en `variant_groups` y aparecer una vez. Un producto con grupos de variantes no puede tener `modifier_group_ids`. Por defecto `[]`. Mira Variantes.
`variants`	No	array	Cuando este producto es una variante: una entrada por base, cada una `{ "product_id": id de la base, "variant_group_option_ids": [...] }` con exactamente una opción de cada grupo de la base. Por defecto `[]`.

Cada entrada de modifiers agrega:

Campo	Requerido	Tipo	Descripción
`modifier_group_id`	Sí	string	Identificador externo del grupo de modificadores.
`default_quantity`	Sí	number	Cantidad preseleccionada. ≥ 0.
`charge_above_quantity`	No	number	Selecciones gratuitas antes de cobrar adicionales. Opcional.
`display_type`	No	string	`RADIO`, `CHECKBOX` o `QUANTITY`.

Respuestas de error

Estado	Descripción
`400`	Parámetros de consulta ausentes o inválidos.
`401`	Access token ausente o inválido.
`403`	El token no tiene acceso a los menús de este comercio.
`404`	No hay menú activo para el contexto solicitado y ningún menú tiene una ventana de horario futura.

Documentación de API

Endpoints

Guías

Recursos

Parámetros de consulta

Solicitud

Streaming

Respuesta

Objeto menú

Respuestas de error

​Parámetros de consulta

​Solicitud

​Streaming

​Respuesta

​Objeto menú

​Respuestas de error

Parámetros de consulta

Solicitud

Streaming

Respuesta

Objeto menú

Respuestas de error