> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Categorías

> Cómo se agrupan los productos para que el cliente navegue el menú.

Las **categorías** organizan el menú en secciones que el cliente entiende — entradas, burgers, bebidas, postres, combos. Definen **cómo se siente la oferta**, no solo qué está técnicamente a la venta.

## Rol comercial

| Aspecto | Por qué importa |
| - | - |
| Flujo de navegación | Buena agrupación sube ticket y reduce fricción |
| Merchandising | Destacados, bloques estacionales y promos suelen vivir en secciones nombradas |
| UX por canal | Agregadores y tu app pueden presentar categorías distinto; la estructura sigue el menú compuesto por contexto |
| Testing | Orden y nombres de categoría son palancas comunes en experimentos de menú |

Las categorías se sincronizan desde tu POS o RMS con el resto del menú. Renombrar o reordenar en operación fluye a los canales vía Fire spark.

## Categorías vs productos

* **Categoría** — El estante (por ejemplo “Ensaladas”).
* **Producto** — Lo que va en el estante (por ejemplo “Ensalada César”).

Un producto suele pertenecer a una o más categorías según cómo tu operación modela el catálogo.

## Disponibilidad por contexto

Las categorías incluyen un mapa `channels`. Cada entrada de canal lista tiendas, y cada tienda lista tipos de fulfillment con un objeto `availability`:

| Campo | Significado |
| - | - |
| `status` | `ACTIVE`, `INACTIVE` o `HIDDEN` para esa combinación canal/tienda/fulfillment |
| `schedules` | Horario de semana completa (`monday`–`sunday`) con `periods` (`start_time` / `end_time`, `closed` opcional, `start_date` / `end_date` opcionales). `null` cuando no hay restricción de horarios |
| `inactive_until` | Fin opcional de un estado inactivo temporal |
| `items` | Entradas ordenadas en esta categoría para esa combinación canal/tienda/fulfillment. Cada item tiene `type` (`CATEGORY` o `PRODUCT`) e `id`. Usa `CATEGORY` para anidar otra categoría. |

Esto permite ocultar una categoría en un agregador mientras sigue visible en tu app propia, o programar secciones estacionales sin duplicar registros de categoría en el POS.

## Conceptos relacionados

> [card] [Menús](https://firespark.cloud/docs/es/concepts/menus.md)
>
> Catálogo completo que ve el cliente

> [card] [Productos](https://firespark.cloud/docs/es/concepts/products.md)
>
> Ítems dentro de cada categoría


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.