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

# Configure un quiosco de Maple

> Convierta una tableta Android o un quiosco en un quiosco de autopedido de Maple

La app Maple Device convierte una tableta Android o un quiosco en un quiosco de autopedido. Los clientes piden por pantalla táctil o por voz, y los pedidos llegan a su local como cualquier otro pedido de Maple.

## Qué necesita

- **Un dispositivo:** una tableta Android o un quiosco con Android 8 o superior.
- **Wi-Fi:** una conexión a internet que funcione en el lugar donde estará el quiosco.
- **Acceso al panel de Maple** del local.
- **Una impresora (opcional):** una impresora de recibos integrada, o una impresora de recibos ESC/POS en la misma red. Usa papel de 58 mm u 80 mm.

## Active el quiosco en Maple

1. ### Abra Manage Kiosk

   En el panel de Maple, vaya a **Orders** y haga clic en **Manage Kiosk**.

2. ### Active el quiosco

   Haga clic en **Enable Kiosk**. Solo lo hace una vez por local.

3. ### Obtenga un código de emparejamiento

   Haga clic en **Pair a kiosk**. Maple muestra un código de 6 dígitos. Mantenga abierto el panel; escribirá este código en el dispositivo.

> [!NOTE]
>
> Si no ve **Manage Kiosk** en la página Orders, [comuníquese con Maple](https://docs.maple.inc/es/need-help.md). Es posible que el quiosco aún no esté activado para su local.

> [!WARNING]
>
> Cada código funciona una sola vez y vence a los 10 minutos. Si vence, haga clic en **Pair a kiosk** de nuevo.

## Instale la app Maple Device

1. ### Descargue la app

   En el dispositivo, abra [device-apks.maple.inc/latest.apk](https://device-apks.maple.inc/latest.apk) en el navegador.

2. ### Abra el archivo
   Abra el archivo cuando termine de descargarse.

3. ### Permita la instalación

   Cuando Android se lo pida, permita instalaciones desde este origen. Android lo muestra una sola vez, porque la app no viene de Play Store.

4. ### Instale y abra
   Toque **Install** y luego **Open**.

5. ### Permita los permisos

   Permita Bluetooth, notificaciones y el micrófono. Los clientes necesitan el micrófono para pedir por voz.

## Empareje el dispositivo

1. ### Ingrese el código

   En la pantalla **Pair this device**, escriba el código de 6 dígitos del panel y toque **Pair**.

2. ### Elija el modo Kiosk

   El dispositivo abre su configuración. En la tarjeta **Mode**, elija **Kiosk**. Deje **Kiosk address** como está y luego toque **Save mode**.

3. ### Termine la configuración

   El quiosco se abre y muestra una pantalla de configuración con algunas verificaciones. Toque **Finish setup and open kiosk**. Esta pantalla solo aparece la primera vez.

De vuelta en el panel, el dispositivo ahora aparece en la lista **Devices** de **Manage Kiosk**, marcado como **Online**.

## Revise el sonido

Los clientes hablan con el quiosco, así que verifique que pueda oír y ser oído.

1. ### Abra la configuración
   Mantenga presionada la esquina superior izquierda de la pantalla durante 5 segundos y luego toque **Open settings**.

2. ### Revise el micrófono

   En la tarjeta **Sound**, **Microphone** debe decir **Allowed**. Si no, toque **Allow microphone** (o **Open app settings** si Android lo bloqueó) y actívelo.

3. ### Reproduzca un sonido de prueba

   Toque **Test sound**. Debe oír tres tonos por el altavoz. Si no los oye, suba el volumen de llamada e inténtelo de nuevo.

4. ### Regrese
   Toque **Return to kiosk**.

## Configure una impresora (opcional)

1. ### Abra la configuración
   Mantenga presionada la esquina superior izquierda durante 5 segundos y luego toque **Open settings**.

2. ### Elija la impresora

   En **Printer settings**, elija **Built-in (Kozen)** o **Built-in (Bluetooth)** si el dispositivo tiene una impresora integrada, o **Network printer**. Para una impresora de red, ingrese su dirección IP en **Address** y deje **Port** en 9100. La hoja de autodiagnóstico de la impresora muestra su dirección.

3. ### Elija el ancho del papel

   Seleccione **58 mm** u **80 mm** según el rollo de papel. Las impresoras **Built-in (Kozen)** no muestran este ajuste.

4. ### Guarde y pruebe

   Toque **Save settings** y luego **Test print**.

5. ### Regrese
   Toque **Return to kiosk**.

Qué significa el resultado de la prueba:

| Mensaje                                         | Qué hacer                                                           |
| ----------------------------------------------- | ------------------------------------------------------------------- |
| **Test ticket sent.**                           | La impresora lo confirmó. Todo listo.                               |
| **Sent to the printer, but it didn’t confirm.** | Verifique que salió papel. Si salió, todo listo.                    |
| Cualquier otro mensaje                          | La app indica qué falló. Corríjalo y toque **Test print** de nuevo. |

## Vuelva a la configuración

El quiosco ocupa toda la pantalla y el botón de retroceso de Android no hace nada. Para llegar a la configuración:

1. Mantenga presionada la esquina superior izquierda de la pantalla durante 5 segundos.
2. Toque **Open settings**.
3. Cuando termine, toque **Return to kiosk**.

Para volver a usar el quiosco solo como impresora de comandas, elija **Printer** en la tarjeta **Mode** y toque **Save mode**.

## Actualizaciones

Las actualizaciones pequeñas de la app se descargan solas. El quiosco las instala durante la noche, entre las 2 y las 5 a. m., para no interrumpir a los clientes.

De vez en cuando sale una versión nueva de la app. Cuando ocurre, la pantalla de configuración muestra **A new version of Maple Device is ready**. Toque **Download**, abra el archivo y luego toque **Install**. El emparejamiento y la configuración se conservan. El aviso solo aparece en la configuración, nunca en la pantalla del quiosco que ven los clientes, así que abra la configuración de vez en cuando para revisarlo.

## Administre el quiosco desde el panel

En **Orders** > **Manage Kiosk**, la lista **Devices** muestra cada dispositivo emparejado con:

- **Online** u **Offline**, y cuándo supo Maple de él por última vez
- Su modo (**Kiosk** o **Printer**), la versión de la app y el estado de la impresora
- La última comanda que imprimió

Haga clic en **Unpair** para quitar un dispositivo. Deja de funcionar hasta que lo empareje de nuevo con un código nuevo. La misma página también configura los colores del quiosco, la imagen de la pantalla de reposo, el mensaje de bienvenida, la voz y los idiomas.

## Solución de problemas

**No hay sonido**

Abra la configuración y toque **Test sound** en la tarjeta **Sound**. Si no oye tres tonos, suba el volumen de llamada con los botones de volumen del dispositivo. Si **Microphone** no dice **Allowed**, toque **Allow microphone** o **Open app settings** y active el micrófono.

**El código de emparejamiento no funciona**

Los códigos funcionan una sola vez y vencen a los 10 minutos. En el panel, haga clic en **Pair a kiosk** para obtener un código nuevo e ingréselo de inmediato. Verifique que escribió los 6 dígitos.

**El quiosco aparece sin conexión**

Verifique que el dispositivo esté en Wi-Fi y que la red tenga acceso a internet. Abra la configuración: en la tarjeta **Status**, **Connection** debe decir **Connected**. La app sigue intentando mientras está sin conexión, así que se reconecta sola cuando vuelve la red. Si sigue sin conexión, reinicie el dispositivo.

**La impresora no imprime**

Abra la configuración y toque **Test print**. Verifique que la impresora esté encendida, tenga papel y esté en la misma red que el dispositivo. En una impresora de red, compare la dirección IP con la hoja de autodiagnóstico de la impresora y verifique que el puerto sea 9100. La tarjeta **Status** muestra **Out of paper** o **Error** cuando la impresora reporta un problema.

**La pantalla del quiosco no carga**

Revise primero el Wi-Fi. Luego abra la configuración y verifique que **Kiosk address** en la tarjeta **Mode** esté llena. Toque **Return to kiosk** para intentarlo de nuevo.

¿Sigue sin resolverlo? [Comuníquese con Maple](https://docs.maple.inc/es/need-help.md).
