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

<Steps>
  <Step title="Abra Manage Kiosk">
    En el panel de Maple, vaya a **Orders** y haga clic en **Manage Kiosk**.
  </Step>

  <Step title="Active el quiosco">
    Haga clic en **Enable Kiosk**. Solo lo hace una vez por local.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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

<Warning>Cada código funciona una sola vez y vence a los 10 minutos. Si vence, haga clic en **Pair a kiosk** de nuevo.</Warning>

## Instale la app Maple Device

<Steps>
  <Step title="Descargue la app">
    En el dispositivo, abra [device-apks.maple.inc/latest.apk](https://device-apks.maple.inc/latest.apk) en el navegador.
  </Step>

  <Step title="Abra el archivo">Abra el archivo cuando termine de descargarse.</Step>

  <Step title="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.
  </Step>

  <Step title="Instale y abra">Toque **Install** y luego **Open**.</Step>

  <Step title="Permita los permisos">
    Permita Bluetooth, notificaciones y el micrófono. Los clientes necesitan el micrófono para pedir por voz.
  </Step>
</Steps>

## Empareje el dispositivo

<Steps>
  <Step title="Ingrese el código">
    En la pantalla **Pair this device**, escriba el código de 6 dígitos del panel y toque **Pair**.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

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.

<Steps>
  <Step title="Abra la configuración">Mantenga presionada la esquina superior izquierda de la pantalla durante 5 segundos y luego toque **Open settings**.</Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Regrese">Toque **Return to kiosk**.</Step>
</Steps>

## Configure una impresora (opcional)

<Steps>
  <Step title="Abra la configuración">Mantenga presionada la esquina superior izquierda durante 5 segundos y luego toque **Open settings**.</Step>

  <Step title="Elija la impresora">
    En **Printer settings**, elija **Built-in printer** si el dispositivo tiene una, 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.
  </Step>

  <Step title="Elija el ancho del papel">Seleccione **58 mm** u **80 mm** según el rollo de papel.</Step>

  <Step title="Guarde y pruebe">
    Toque **Save settings** y luego **Test print**.
  </Step>

  <Step title="Regrese">Toque **Return to kiosk**.</Step>
</Steps>

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

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

¿Sigue sin resolverlo? [Comuníquese con Maple](/es/need-help).


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