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:
- Nuevo terminal.
- Tipo de terminal:
KIOSK.
- Tienda: elige de la lista.
- ID del dispositivo: escríbelo, o presiona el botón QR y escanea el código que muestra el kiosco.
- 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.
Esta es la parte más importante de la pantalla, porque dos de las tres parecen éxito.
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.
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:
- La tienda no tiene país o ciudad. Arregla la tienda y reintenta.
- El canal era inalcanzable cuando se guardó el cambio. Reintentar suele bastar.
- 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:
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 para ese flujo.
Los registros POS sí aparecen en esta lista, y puedes administrarlos desde aquí — ver Terminal administration para suspender, reactivar y revocar.
La guía más vieja 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
Registrar un kiosco recién instalado
- Nuevo terminal → escribe
KIOSK.
- Elige la Tienda.
- Presiona el botón QR y escanea el código que muestra el kiosco, o escribe el ID del dispositivo a mano.
- Deja Nombre vacío a menos que tengas una convención de nombres — Fire lo nombra con el código de la tienda.
- Registrar, y lee el mensaje.
Si volvió amarillo, ve a la tarjeta y presiona Reintentar.Un kiosco no está cobrando y no sabes por qué
En este orden:
- ¿Hay un panel ámbar en su tarjeta? Si es así, Reintentar y lee el error.
- 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.
- Si dice Sigue a la tienda: pausado, la pausa es a nivel tienda — arréglalo en configuración por tienda.
- 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.
Un kiosco tiene el pinpad roto
- Abre el detalle de ese terminal.
- Métodos de pago → apaga el método de tarjeta.
- 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.Poner la contraseña de admin para una tienda entera
- Abre el detalle de cualquier kiosco en esa tienda.
- Contraseña de administrador → escríbela bajo Contraseña nueva.
- Se aplica a: Todos los kioscos de esta tienda.
- 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.Cargar un valor que pertenece a un dispositivo
- Abre el detalle del terminal → Métodos de pago.
- Expande el método con el chevron.
- 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.Encontrar todos los terminales de una tienda
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.
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
Preguntas frecuentes
Registré un kiosco y no está en el canal.
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.
¿Qué pasa si el ID de dispositivo ya estaba registrado?
Fire no te deja: te dice qué terminal ya lo está usando. Un ID de dispositivo no se puede repetir dentro de una cuenta.
¿Apagar un método en un kiosco afecta a los otros?
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 — que es para lo que está el enlace arriba de la sección. ¿Por qué no puedo activar un método que la tienda no ofrece?
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.
¿Puedo ver la contraseña de admin?
No. Puedes ver si está configurada, heredada o ausente, nunca el valor. Si nadie la recuerda, pones una nueva.
¿Los registros POS reciben sus métodos de pago desde aquí?
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.