> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# Terminales
> Registra los kioscos de cada tienda desde una pantalla, y decide qué cobra cada dispositivo y quién puede desbloquearlo.
Registrar un kiosco recién instalado solía significar ir a otro sistema, crear un restaurante ahí, volver, y esperar que los dos lados coincidieran. Esta pantalla reemplaza todo eso: registras el kiosco en Fire con el ID de su pantalla de QR, y Fire lo crea en el canal — o lo **adopta** si ya estaba ahí.
También es la lista maestra de la cuenta. Cada terminal en cada tienda, POS y kiosco, en un solo lugar con filtro por tienda. Navega a **Operación → Terminales**.
***
## Lo mínimo que hay que saber
**1. Registrar un kiosco necesita dos cosas: la tienda y el ID de dispositivo.** Sin plantilla de restaurante, sin métodos de pago. Un kiosco nace sin nada configurado, a propósito.
**2. Un registro puede medio-salir.** *"Quedó registrado en Fire, pero el canal todavía no lo aceptó"* es una advertencia, no un error, y el diálogo se cierra igual. Ese kiosco no cobra hasta que alguien presione **Reintentar**.
**3. Los métodos de pago y la contraseña de admin funcionan igual**: la tienda pone el default, un terminal puede sobreescribirlo, y siempre hay una forma de volver a heredar.
***
## El camino simple
Alguien acaba de enchufar un kiosco en una tienda y lo quieres funcionando:
1. **Nuevo terminal**.
2. **Tipo de terminal**: `KIOSK`.
3. **Tienda**: elige de la lista.
4. **ID del dispositivo**: escríbelo, o presiona el botón QR y escanea el código que muestra el kiosco.
5. **Registrar**.
Lee el mensaje que aparece. Si dice **Kiosco registrado** o que fue adoptado, ya terminaste — el dispositivo está en la lista y listo para configurarse. Si está en amarillo, sigue leyendo: no terminó.
El kiosco muestra su QR y su ID de dispositivo en su propia pantalla de inicio. No tienes que anotar nada: el escáner lo lee.
***
## Las tres formas en que termina un registro
Esta es la parte más importante de la pantalla, porque dos de las tres parecen éxito.
| Mensaje | Qué pasó | Qué haces |
| ------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| **Kiosco registrado** | Creado en Fire y en el canal | Nada |
| **El kiosco ya existía en el canal y quedó adoptado** | Ya estaba del otro lado — Fire se lo apropió en vez de duplicarlo. De ahora en más Fire manda | Nada |
| ⚠️ **Quedó registrado en Fire, pero el canal todavía no lo aceptó** | El registro está **a mitad** | Encuentra la tarjeta en la lista y presiona **Reintentar** |
**La tercera cierra el diálogo igual que las otras dos.** El kiosco aparece en la lista, se ve normal, y no está operando: el canal nunca lo recibió. Nada reintenta solo. Si cierras la pantalla sin leer el mensaje, te enteras cuando la tienda llama a decir que el kiosco no cobra.
Adopción tampoco es un error — es el camino esperado para un dispositivo que ya estaba instalado. Fire no crea un segundo; toma el que existe y empieza a manejarlo.
***
## Por qué no pregunta por una plantilla ni por métodos de pago
Porque el registro pasa en el campo, a menudo por quien físicamente está instalando la máquina, y cada pregunta de más es una chance de ponerla mal.
Un kiosco siempre nace **sin métodos de pago**. Eso es deliberado: si el formulario los pre-llenara con lo que tenía la tienda en ese momento, dos registros idénticos hechos con una semana de diferencia producirían dos kioscos distintos, y nadie sabría por qué. Lo que cobra se decide después, desde esta misma pantalla o desde [configuración por tienda](/es/manuals/payments/store-configuration).
La plantilla de restaurante tampoco es obligatoria. Si existe en el canal, Fire la usa. Si no, Fire arma el mínimo desde los datos propios de la tienda y sigue. Parar ahí significaría irse a crear un restaurante en otro sistema para poder registrar una máquina que ya está instalada y enchufada.
Hay una cosa que la tienda **sí** necesita tener cargada: **país y ciudad**. Sin eso el canal no puede crear el kiosco, y el registro vuelve con el mensaje amarillo.
***
## Sync failed y Reintentar
La tarjeta solo habla cuando algo está mal. No hay banner verde diciendo que todo está bien — eso convertiría la lista en ruido y la única tarjeta que necesita atención se perdería en él.
Un panel ámbar con **Sync failed** — o **Not synced** — significa que Fire y el canal no coinciden, y el último error está impreso abajo. **Reintentar** hace dos cosas en orden: re-provisiona el kiosco en el canal (creándolo, o adoptándolo, si no estaba ahí) y después empuja los métodos de pago y la contraseña.
Causas comunes, en el orden que vale revisar:
1. **La tienda no tiene país o ciudad.** Arregla la tienda y reintenta.
2. **El canal era inalcanzable** cuando se guardó el cambio. Reintentar suele bastar.
3. **El kiosco no existe del otro lado** — alguien lo eliminó ahí. El reintento lo recrea.
**Nada reintenta solo.** No hay reintento automático y no hay reintento masivo: es un botón por tarjeta. Un kiosco dejado en *Sync failed* sigue cobrando con su configuración anterior mientras nadie lo mire.
***
## Herencia y override: el patrón que maneja la vista de detalle
Abre la tarjeta de un terminal — el menú **⋮**, luego **Ver detalles** — y vas a encontrar dos secciones que se comportan idénticamente.
En ambas, **la tienda pone el default y cada kiosco en ella hereda**. Cuando una máquina necesita diferir, pones el valor en ese terminal y se convierte en un **override** que solo aplica ahí. Y en ambas hay una forma explícita de volver a heredar, porque un override que no puedes deshacer es una trampa.
Apréndelo una vez, y las dos secciones se leen solas.
### Contraseña de administrador
Esto es lo que desbloquea la pantalla de admin en el dispositivo mismo. La línea arriba te dice dónde está parado el kiosco actualmente: **Heredada de la tienda**, **Propia de este terminal**, o **Sin configurar — este kiosco no tiene contraseña** en ámbar.
Para cambiarla, escríbela bajo **Contraseña nueva** y elige **Se aplica a**:
* **Todos los kioscos de esta tienda** — el default, y lo que quieres casi siempre.
* **Solo este terminal** — crea el override.
**Volver a la de la tienda** aparece solo cuando hay un override, y lo quita.
La contraseña nunca se muestra. Puedes ver si hay una configurada, no cuál es — poner una credencial en una respuesta HTTP la dejaría en el historial del navegador. Tiene que ser de al menos 6 caracteres; si es más corta, el error vuelve del servidor después de presionar **Guardar contraseña**.
**Limpiarla no desbloquea un dispositivo que ya tiene una.** Fire simplemente deja de imponer una contraseña; no quita la llave que un kiosco ya recibió. Para cambiar de verdad lo que pide la máquina, ponés una nueva.
### Métodos de pago
Misma forma, aplicada a lo que cobra el kiosco.
Cada método lleva una leyenda que dice de dónde viene su posición actual:
| Leyenda | Qué significa |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *No se ofrece en los kioscos de esta tienda.* | La tienda no lo ofrece. El switch está deshabilitado aquí — activarlo habilitaría el método en **todos** los kioscos de la tienda, y esa es una decisión para [configuración por tienda](/es/manuals/payments/store-configuration) |
| *Sigue a la tienda: cobra.* | Heredando, y cobra |
| *Sigue a la tienda: pausado.* | Heredando, y pausado a nivel tienda |
| *Ajuste de este equipo: cobra.* | Override — cobra aquí aunque la tienda lo tenga pausado |
| *Ajuste de este equipo: no cobra.* | Override — esta máquina no lo cobra, las otras sí |
Cambiar el switch crea el override para **este dispositivo solo**. **Volver a la de la tienda** lo quita y el método vuelve a hacer lo que hace la tienda.
El caso para el que existe esto: tres kioscos en una tienda, uno con el pinpad roto. Le apagas el método de tarjeta a ese uno y los otros dos siguen cobrando. Antes, esa era una decisión que solo podías tomar para la tienda entera.
Expandir un método muestra **Valores de este terminal**: los campos que el método declaró a nivel *Terminal* — una IP de pinpad, un número de serie de dispositivo. Si no declara ninguno, lo dice.
***
## Los registros POS no se crean aquí
Elegir **POS** en el selector de tipo reemplaza el formulario con un aviso: *Las cajas POS se vinculan*. Un POS se vincula desde el dispositivo mismo con un código de 6 dígitos, así que se crea desde su propia pantalla — **Ir a terminales del POS** te lleva ahí.
Los dos caminos son genuinamente distintos: un kiosco ya lleva su identidad en el QR, así que pedirle que se vincule sería inventar un paso que no protege nada. Ver [POS → Linking](/es/manuals/pos/linking) para ese flujo.
Los registros POS sí aparecen en esta lista, y puedes administrarlos desde aquí — ver [Terminal administration](/es/manuals/pos/terminal-admin) para suspender, reactivar y revocar.
La guía más vieja [Kiosk → Linking](/es/manuals/kiosk/linking) describe registrar kioscos desde el otro sistema, con una plantilla de restaurante y métodos de pago en el modal. Es el flujo anterior. Lo que este manual describe es el actual.
***
## Recetas: cómo manejar casos reales
1. **Nuevo terminal** → escribe `KIOSK`.
2. Elige la **Tienda**.
3. Presiona el botón QR y escanea el código que muestra el kiosco, o escribe el **ID del dispositivo** a mano.
4. Deja **Nombre** vacío a menos que tengas una convención de nombres — Fire lo nombra con el código de la tienda.
5. **Registrar**, y **lee el mensaje**.
Si volvió amarillo, ve a la tarjeta y presiona **Reintentar**.
En este orden:
1. **¿Hay un panel ámbar en su tarjeta?** Si es así, **Reintentar** y lee el error.
2. **Abre el detalle → Métodos de pago.** Mira las leyendas: *No se ofrece en los kioscos de esta tienda* es un problema de tienda, *Ajuste de este equipo: no cobra* es un override que alguien dejó atrás.
3. Si dice *Sigue a la tienda: pausado*, la pausa es a nivel tienda — arréglalo en [configuración por tienda](/es/manuals/payments/store-configuration).
4. Si cobra pero falla contra el proveedor, probablemente al método le falta un valor obligatorio: busca el chip ámbar en la pantalla de tienda.
1. Abre el detalle de ese terminal.
2. **Métodos de pago** → apaga el método de tarjeta.
3. Verifica que la leyenda ahora diga *Ajuste de este equipo: no cobra.*
Los otros kioscos de la tienda siguen cobrando. Cuando reparen el pinpad: **Volver a la de la tienda**, y vuelve a hacer lo que hace la tienda.
1. Abre el detalle de **cualquier** kiosco en esa tienda.
2. **Contraseña de administrador** → escríbela bajo **Contraseña nueva**.
3. **Se aplica a**: *Todos los kioscos de esta tienda*.
4. **Guardar contraseña**.
Cada kiosco de la tienda la hereda, incluyendo los que se registren después. Los que tienen override propio conservan el suyo — para traer esos de vuelta a la línea, abre cada uno y usa **Volver a la de la tienda**.
1. Abre el detalle del terminal → **Métodos de pago**.
2. Expande el método con el chevron.
3. Completa **Valores de este terminal** y **Guardar valores**.
Solo aparecen aquí campos que el método declaró a nivel *Terminal*. Los de nivel cuenta y tienda no son editables desde aquí a propósito: cambiarlos desde el detalle de un dispositivo afectaría a los otros sin que fuera visible.
Usa el selector de tienda en el encabezado. Las pestañas después separan lo que queda por estado: **Activos**, **Suspendidos**, **Revocados**, más **Eliminados** si tildas **Mostrar eliminados**.
No hay cuadro de búsqueda: el filtro de tienda y las pestañas son las herramientas. La lista se ordena del más nuevo al más viejo, así que un dispositivo que acabas de registrar está arriba.
***
## Tres kioscos en una tienda, seguidos de punta a punta
*Laboratorio* tiene K-01, K-02 y K-03. La tienda ofrece Efectivo y Datafast. El pinpad de K-02 se rompe.
| | K-01 | K-02 | K-03 |
| ---------------------------------------------- | -------------------------- | -------------------------------------- | -------------------------- |
| **Antes** | Sigue a la tienda: cobra | Sigue a la tienda: cobra | Sigue a la tienda: cobra |
| Apagar Datafast en K-02 | Sigue a la tienda: cobra | **Ajuste de este equipo: no cobra** | Sigue a la tienda: cobra |
| La tienda pausa Datafast por una caída | Sigue a la tienda: pausado | Ajuste de este equipo: no cobra | Sigue a la tienda: pausado |
| La tienda lo reanuda | Sigue a la tienda: cobra | **Ajuste de este equipo: no cobra** ⚠️ | Sigue a la tienda: cobra |
| Pinpad reparado → **Volver a la de la tienda** | Sigue a la tienda: cobra | Sigue a la tienda: cobra | Sigue a la tienda: cobra |
La fila que vale leer dos veces es la cuarta. **El override sobrevive a los cambios de la tienda** — eso es exactamente para lo que está, y también es cómo una máquina termina sin cobrar semanas después de que todos se olvidaron que el pinpad alguna vez estuvo roto. Un override es una decisión que se queda hasta que alguien la deshace.
***
## Errores que cuestan plata
**Cerrar el diálogo de registro sin leer el mensaje.** *"Quedó registrado en Fire, pero el canal todavía no lo aceptó"* está en amarillo, se cierra como un éxito, y deja un kiosco que no cobra.
**Dejar un override en su lugar después de que se fue el motivo para ponerlo.** La máquina deja de seguir a la tienda para siempre. Semanas después un método está cobrando en todas partes menos en ese kiosco, y nada en la pantalla de tienda explica por qué. Usa **Volver a la de la tienda**.
**Ignorar una tarjeta con Sync failed.** No hay reintento automático. Ese kiosco sigue operando con la configuración que tenía antes del cambio — precios viejos de un método de pago, una contraseña vieja, un método que ya no debería ofrecerse.
**Asumir que limpiar la contraseña bloquea el dispositivo.** No lo hace. Fire deja de imponer una; el kiosco conserva la llave que ya tiene. Para cambiar lo que pide, pones una nueva contraseña.
***
## Glosario
| Término | Qué significa |
| ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| **ID del dispositivo** | El identificador que el kiosco muestra en su pantalla de QR. Lo que Fire usa para encontrarlo en el canal. |
| **Adopción** | El kiosco ya existía en el canal y Fire se lo apropió en vez de duplicarlo. |
| **Provisioning** | Crear o adoptar el kiosco del lado del canal. |
| **Sync** | Empujar lo que está configurado en Fire hacia el dispositivo. |
| **Override** | Un valor puesto en un terminal que lo hace dejar de heredar de la tienda. |
| **Pairing** | El flujo del POS: un código de 6 dígitos ingresado en el dispositivo. Los kioscos no lo usan. |
***
## Preguntas frecuentes
Mira su tarjeta. Si hay un panel ámbar, presiona **Reintentar** y lee el error. La causa más común es que la tienda no tiene país o ciudad — con eso cargado, el reintento pasa.
Fire no te deja: te dice qué terminal ya lo está usando. Un ID de dispositivo no se puede repetir dentro de una cuenta.
No. El switch en el detalle de un terminal solo crea un override para ese dispositivo. Para cambiar lo que ofrece la tienda entera, usa [configuración por tienda](/es/manuals/payments/store-configuration) — que es para lo que está el enlace arriba de la sección.
Porque hacerlo desde aquí lo habilitaría en todos los kioscos de la tienda, y esa decisión pertenece a la pantalla de tienda. Habilítalo ahí y el kiosco lo hereda.
No. Puedes ver si está configurada, heredada o ausente, nunca el valor. Si nadie la recuerda, pones una nueva.
No. Esa sección solo aparece para kioscos. El POS todavía recibe sus métodos de pago a través de su propio snapshot.
***
## Lo que viene
Cosas que esta pantalla **no** hace hoy:
* **No hay reintento automático de sync**, ni reintento masivo: es un **Reintentar** por tarjeta.
* **No hay filtro de tipo POS/kiosco.** El filtro es por tienda, y las pestañas por estado.
* **No hay búsqueda ni paginación.** Todo en la cuenta — o la tienda seleccionada — se carga de una vez.
* **Cierre manual de caja** está visible pero deshabilitado, marcado *Próximamente*.
* **Los registros POS no se crean aquí**: se vinculan desde el dispositivo.
* **Un registro que medio-sale no se revierte.** El kiosco se queda en Fire esperando un reintento, a propósito: deshacerlo significaría rehacer todo el registro por un timeout.