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

# Nombres del turnero

> Evita que un nombre ofensivo aparezca en la pantalla pública de retiro, sin frenar ningún pedido.

El nombre que el cliente escribe en el kiosco aparece en el turnero, la pantalla del local donde se llama a retirar los pedidos. Basta un insulto, un mensaje político o el nombre de la competencia para que quede a la vista de todo el restaurante, y una foto de esa pantalla en redes cuesta más que cualquier pedido.

Con **Nombres del turnero** decides qué nombres se aceptan en cada país: el formato, una lista de términos prohibidos y qué pasa cuando alguien insiste. El kiosco revisa el nombre antes del pago y el backoffice lo vuelve a revisar cuando llega el pedido.

> [!NOTE]
>
> **Lo mínimo que hay que saber**
>
> * Las reglas y la lista son **por país**: las del país elegido en el selector de arriba a la derecha.
> * Sin reglas guardadas, o con **Filtro activo** apagado, el kiosco acepta cualquier nombre, como antes.
> * El pedido nunca queda bloqueado: después de los intentos configurados, el kiosco usa un nombre genérico como **PEDIDO 83K** y sigue al pago.

## Antes de empezar

* Acceso al backoffice de Fire con el canal **Canal - Kioscos** y permiso sobre **Configuración General → Nombres del turnero**.
* El país correcto en el selector de arriba a la derecha. Todo lo que guardes aplica a ese país.

## El camino simple

1. En **Canal - Kioscos**, abre **Configuración General → Nombres del turnero**.
2. Activa **Filtro activo** y pulsa **Guardar reglas**. Los valores por defecto sirven para la mayoría de los casos: de 2 a 12 caracteres, solo el primer nombre, 3 intentos y **PEDIDO \{code}** como nombre genérico.
3. En **Términos prohibidos**, pulsa **Importar lista**, pega los términos (uno por línea) y pulsa **Importar**.
4. Escribe un nombre de la lista en **Probar un nombre** y pulsa **Probar** para confirmar que se rechaza.

![Pantalla Nombres del turnero con el filtro activo, las reglas, el probador y Cómo funciona](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/01-overview.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=d46c34285b533317a9141a1da97f4a89)

> [!TIP]
>
> Si lo que necesitas es bloquear una lista de palabras con las reglas por defecto, ya terminaste. No hace falta actualizar los kioscos: la lista vive en el backoffice.

## Reglas del nombre

![Tarjeta Reglas con el formato del nombre, los intentos y la vista previa del nombre genérico](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/02-rules.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=2e1ee4668c573b2aba8a1f18fc2593f9)

* **Filtro activo**: prende o apaga todo el filtro del país. Apagado, el kiosco acepta cualquier nombre.
* **Formato del nombre**
  * **Longitud permitida**: mínimo y máximo de caracteres, contando espacios. El kiosco no deja escribir más del máximo.
  * **Solo el primer nombre**: el kiosco no acepta más de una palabra. Si un pedido llega con dos, el turnero muestra solo la primera.
  * Siempre se aceptan solo letras, incluidas las tildes y la ç. Los números, símbolos y emojis no se pueden escribir.
* **Si el nombre no pasa**
  * **Intentos**: cuántos nombres rechazados acepta el kiosco en un pedido antes de usar el nombre genérico (de 1 a 10).
  * **Nombre genérico**: lo que se muestra en lugar del nombre. Tiene que incluir `{code}`, que se reemplaza por el código corto del pedido: **PEDIDO \{code}** se ve como **PEDIDO 83K**. Hasta 30 caracteres. La vista previa de abajo muestra cómo queda en el turnero.

Pulsa **Guardar reglas** para aplicar los cambios, o **Descartar** para volver a lo guardado.

> [!NOTE]
>
> Las reglas llegan a los kioscos en unos 5 minutos: cada kiosco las guarda un rato para no consultarlas en cada pedido. Los términos se aplican en 1 minuto, porque se consultan cada vez que el cliente acepta un nombre.

## Términos prohibidos

![Lista de términos prohibidos con filtros por categoría, coincidencia y estado](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/03-terms.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=46e290fba5da060c82691709924a5f4f)

Antes de comparar, el nombre se normaliza: sin tildes ni mayúsculas, con las letras separadas vueltas a juntar, el leetspeak traducido (0→O, 1→I o L, 3→E, 4→A, 5→S, 7→T, @→A, \$→S, !→I), las letras repetidas reducidas a una y la K leída como C. Por eso "Idiota", "I d i o t a", "1d10t4" e "Idiotaaa" se comparan igual.

Para agregar un término, escríbelo, elige la **Categoría** y la **Coincidencia**, y pulsa **Agregar**.

* **Categoría**: Figura política, Partido político, Grosería o insulto, Competencia u Otro. Sirve para ordenar y filtrar la lista; todas bloquean igual.
* **Coincidencia**
  * **Exacto**: el nombre, o una de sus palabras, es el término. Desde 4 letras también lo encuentra pegado a otra palabra: "Burro" bloquea "BurroTonto", pero no "Burrito".
  * **Contiene**: el término aparece en cualquier parte del nombre.
  * **Automático** (solo al agregar): hasta 5 letras, exacto; desde 6, contiene.

En cada fila puedes cambiar la categoría y la coincidencia, apagar el término con **Activo** sin borrarlo, o eliminarlo con la papelera. Los botones de categoría y la búsqueda filtran la lista.

### Importar una lista

![Diálogo Importar términos con tres términos pegados](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/04-import.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=acafe6f41a63b56a9fc932e0784be1f7)

Pega un término por línea, o separados por coma, punto y coma o tabulación. Si copias de una planilla, se toma la primera columna. La categoría y la coincidencia que elijas aplican a todos los términos de esa importación. Los repetidos se omiten.

## Probar un nombre

![Probador con un nombre rechazado y el nombre genérico que mostraría el turnero](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/05-tester.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=9437fb54a87e4b923912fe8ff36bcb17)

Escribe cualquier nombre y pulsa **Probar**. El resultado muestra:

* **Kiosco**: si lo acepta o lo rechaza, el motivo y qué término coincidió.
* **Turnero (pedido de ejemplo 83K)**: qué mostraría la pantalla si ese nombre llegara en un pedido: igual, recortado o reemplazado por el nombre genérico.
* **Formas comparadas**: el nombre ya normalizado, tal como se compara con la lista.

El probador usa las reglas y la lista guardadas, no los cambios sin guardar, y no guarda nada. Si el filtro está apagado, lo avisa y prueba igual.

## Qué ve el cliente en el kiosco

![Pantalla de nombre del kiosco en portugués con la indicación de solo el primer nombre](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/06-kiosk-name.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=b300a947e5005f2aab743cf1ff10d3c4)

Mientras escribe, el kiosco no deja ingresar números, símbolos ni emojis, ni pasar de la longitud máxima, y le indica **Solo tu primer nombre, sin números ni símbolos** (o **Solo letras, sin números ni símbolos** si se permiten dos palabras). Con **Solo el primer nombre** activo, si escribe dos palabras le pide **Escribe solo tu primer nombre** y no lo deja aceptar.

![Kiosco en portugués con un nombre rechazado y los intentos restantes](https://mintcdn.com/firepos/YzbvK9R_IBrrGFD5/images/manuals/kiosk/name-filter/07-kiosk-rejected.png?fit=max\&auto=format\&n=YzbvK9R_IBrrGFD5\&q=85\&s=0d8b7c6bbb0bf4c7c88cc9d30b24ce98)

Al tocar **Aceptar**, el kiosco consulta la lista:

* Si el nombre no pasa, muestra el motivo y los **Intentos restantes**, y el cliente puede escribir otro.
* En el último intento muestra **Te llamaremos por tu número de orden** y sigue al pago con el nombre genérico.
* Si el backoffice no responde en 3 segundos, el kiosco acepta el nombre para no frenar la venta. El backoffice lo revisa igual cuando llega el pedido.

## Cuando llega el pedido

El backoffice vuelve a revisar el nombre de cada pedido de kiosco antes de que llegue al turnero, y también cuando el pedido se corrige después:

* Si tiene un término prohibido, lo reemplaza por el nombre genérico con el código de ese pedido.
* Si el formato no cumple, lo arregla: deja la primera palabra si está activo **Solo el primer nombre**, quita números y símbolos, y lo corta en la longitud máxima. "Ana Clara" queda como "Ana".
* Deja como están los nombres vacíos, los números de localizador (como "07") y el propio nombre genérico.

Esta segunda revisión también cubre a los kioscos que todavía no tienen la actualización.

## Ejemplo: cómo se compara un nombre

Lista con "Idiota" (Contiene) y "Burro" (Exacto), con **Solo el primer nombre** activo y de 2 a 12 caracteres:

| El cliente escribe | Se compara como | En el turnero |
| - | - | - |
| Idiota | idiota | PEDIDO 83K (bloqueado) |
| Idiotá | idiota | PEDIDO 83K (bloqueado) |
| I d i o t a | idiota | PEDIDO 83K (bloqueado) |
| 1d10t4 | idiota | PEDIDO 83K (bloqueado) |
| Idiotaaa | idiota | PEDIDO 83K (bloqueado) |
| Burro | buro | PEDIDO 83K (bloqueado) |
| BurroTonto | burotonto | PEDIDO 83K (bloqueado) |
| Burrito | burito | Burrito |
| Ana Clara | ana · clara · anaclara | Ana |

En el kiosco no se pueden escribir números ni símbolos, y con **Solo el primer nombre** no se puede aceptar un nombre con espacios. Filas como "1d10t4" o "I d i o t a" muestran lo que hace el backoffice cuando el pedido llega.

## Recetas

> **Activar el filtro en un país**
>
> 1. Elige el país en el selector de arriba a la derecha.
> 2. Abre **Configuración General → Nombres del turnero**.
> 3. Activa **Filtro activo** y pulsa **Guardar reglas**.
> 4. Importa la lista de términos con **Importar lista**.
> 5. Confirma con **Probar un nombre** usando un término de la lista.

> **Cargar la lista que manda el cliente**
>
> 1. Copia la columna de términos de la planilla.
> 2. Pulsa **Importar lista** y pega.
> 3. Elige la categoría y deja la coincidencia en **Automático**.
> 4. Revisa el contador de términos y pulsa **Importar**.
> 5. Repite por categoría si quieres tener la lista ordenada.

> **Un nombre real quedó bloqueado**
>
> 1. Escribe ese nombre en **Probar un nombre** y pulsa **Probar**.
> 2. Mira qué término coincidió en el resultado del kiosco.
> 3. Busca ese término en la lista.
> 4. Cámbialo a **Exacto**, o apágalo con **Activo**.
> 5. Vuelve a probar el nombre.

> **Bloquear una marca de la competencia**
>
> 1. Escribe la marca tal como se escribe, con espacios si los tiene.
> 2. Elige la categoría **Competencia**.
> 3. Elige **Contiene** si el nombre es largo: así también bloquea la marca pegada a otra palabra.
> 4. Pulsa **Agregar** y pruébala con y sin espacios.

> **Permitir nombre y apellido**
>
> 1. Apaga **Solo el primer nombre**.
> 2. Sube la longitud máxima, por ejemplo a 20.
> 3. Pulsa **Guardar reglas**.
> 4. Recuerda que el turnero mostrará el texto completo.

> **Usar el nombre genérico desde el primer rechazo**
>
> 1. Pon **Intentos** en 1.
> 2. Pulsa **Guardar reglas**.
> 3. Desde ese momento, el primer nombre rechazado ya pasa al nombre genérico.

## Errores que salen caros

> [!WARNING]
>
> **Términos cortos con Contiene.** "Ana" con Contiene bloquea también "Mariana" y "Juliana". Los clientes no pueden usar su nombre y la fila se demora. Para términos de 5 letras o menos usa **Exacto**: **Automático** ya lo hace.

> [!WARNING]
>
> **Bloquear un nombre de pila.** Como la K se lee como C, bloquear "Nikolas" también bloquea "Nicolas". Antes de agregar un nombre propio, pruébalo junto con sus variantes en **Probar un nombre**.

> [!WARNING]
>
> **Una longitud máxima muy corta.** El kiosco no deja escribir más del máximo y el backoffice corta los nombres más largos. Con un máximo de 5, "Mariana" no entra completo.

> [!WARNING]
>
> **Apagar el filtro para "probar".** Con **Filtro activo** apagado se acepta cualquier nombre en todos los kioscos del país, también en la revisión al llegar el pedido. Para probar usa **Probar un nombre**, que funciona con el filtro apagado.

## Glosario

| Término | Qué significa |
| - | - |
| Turnero | Pantalla pública del local donde se llama a retirar los pedidos. |
| Nombre genérico | Texto que reemplaza a un nombre rechazado, con el código del pedido. Por ejemplo, **PEDIDO 83K**. |
| Código del pedido | Código corto que el kiosco le da a cada pedido, como **83K**. |
| Término prohibido | Palabra de la lista que no puede aparecer en el nombre. |
| Exacto | El nombre, o una de sus palabras, es el término. |
| Contiene | El término aparece en cualquier parte del nombre. |
| Forma comparada | El nombre normalizado (sin tildes, en minúsculas, con el leetspeak traducido) que se compara con la lista. |
| Intento | Cada nombre rechazado dentro del mismo pedido. |

## Preguntas frecuentes

> **¿El filtro puede frenar una venta?**
>
> No. Después de los intentos configurados, el kiosco usa el nombre genérico y sigue al pago. Si el backoffice no responde en 3 segundos, el kiosco acepta el nombre y el backoffice lo revisa cuando llega el pedido.

> **¿Cuánto tarda en aplicarse un cambio?**
>
> Los términos, 1 minuto. Las reglas (filtro activo, longitud, intentos, nombre genérico), unos 5 minutos.

> **¿Las reglas son por tienda?**
>
> No, por país. Todas las tiendas del país usan las mismas reglas y la misma lista.

> **¿Hay que actualizar los kioscos para cambiar la lista?**
>
> No. La lista vive en el backoffice y el kiosco la consulta cada vez que el cliente acepta un nombre.

> **¿Qué pasa con los kioscos que todavía no tienen la actualización?**
>
> No revisan el nombre mientras el cliente escribe, pero el backoffice lo revisa cuando llega el pedido: el turnero muestra el nombre genérico en lugar de un término prohibido.


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