> ## 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.

# Kiosco

> Autoservicio en tienda con el mismo motor de menú que canales digitales.

El **kiosco** acelera filas y sube ticket en el local. Fire spark permite que los kioscos lean el **mismo menú operativo** que app y agregadores — con oferta compuesta para la pantalla si quieres combos al frente.

## Cómo ayudamos

* **Sync de menú** — Sin maestro solo-kiosco; cambios en POS aplican en todos lados.
* **Por tienda** — Cada kiosco respeta disponibilidad local y fulfillment (dine-in, retiro en mostrador).
* **Pedidos** — Tickets van a sistemas de cocina que el staff ya monitorea.

No compras un silo de vendor kiosco. Sumas una **superficie** al hub que ya operas.

## Vincular por código, luego MDM opcional

Cada tablet deriva un **device code** de su ID de hardware Android/iOS (SHA-1 → primeros 8 hex → base36) para que el mismo código sobreviva reinstalaciones. El código es único por merchant. La tablet consulta [Vincular dispositivo kiosco](https://firespark.cloud/docs/es/storefront-api/kiosk/devices/link/post.md). El panel reclama ese código con **Link device**. En el primer contacto la API fija el secreto. Después la tablet recibe scope, ajustes, catálogo de pagos y overrides.

[Emitir token realtime de kiosco](https://firespark.cloud/docs/es/storefront-api/kiosk/realtime/token/post.md) empuja `kiosk.config.changed` y comandos (`refresh_cache`, `reload`, `unlink`). El [heartbeat](https://firespark.cloud/docs/es/storefront-api/kiosk/devices/me/post.md) puede incluir batería, almacenamiento, red y si la app está en primer plano o segundo plano. La tablet puede [hacer PATCH](https://firespark.cloud/docs/es/storefront-api/kiosk/devices/me/patch.md) en la misma ruta para overrides.

Google Play es **opcional**. Conéctalo cuando quieras bloqueo MDM o APKs privados. Sigue [Conectar una cuenta de Google Play](https://firespark.cloud/docs/es/guides/channels/kiosk/connect-google-play.md) y [enrola la tablet en MDM](https://firespark.cloud/docs/es/guides/channels/kiosk/enroll-mdm.md). Las tablets se enrolan con un QR (`afw#setup`) y quedan bloqueadas vía Android Management API.

* **Ajustes** — timeout de inactividad, umbrales de salud, package name y modo de bloqueo.
* **Dispositivos** — vínculo por código, overrides de pago, comandos remotos, QR de enrollment opcional, estado de app.
* **Releases** — hotfix de emergencia o release normal. Mientras instalan, los kioscos no pueden tomar pedidos.
* **Salud** — batería, offline y no operativos por tienda.

La app prefiere la **config vinculada**, luego la configuración administrada, luego env. El menú y la disponibilidad se refrescan con eventos push, y cada bloque CMS que muestra la tablet se refresca con su propio topic `cms.changed`; el resto queda en cache hasta cold start, `menu.changed` / `availability.changed` o un comando `refresh_cache`.

> [card] [API Storefront](https://firespark.cloud/docs/es/storefront-api/introduction.md)
>
> Construye experiencias de kiosco


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