Ajustes — General
Ruta: /ajustes
Quién la usa: dueño, gerente
Permiso requerido: settings.manage
Capturas: docs/manual/screenshots/ajustes/
Qué es
La pantalla General reúne en una sola página los datos de la organización (contacto público, zona horaria, moneda e impuesto), la marca que se usa en los correos de acceso, el tema de color del POS, los campos obligatorios al registrar un cliente y, debajo, cinco tarjetas de reglas de negocio que se guardan por separado: General, Tarjetas de regalo, Promociones, Productos y Conciliación bancaria. Cada tarjeta tiene su propio botón de guardado: el botón Guardar de arriba no guarda las tarjetas de abajo.
Cuándo se usa
Al montar el restaurante, y después cada vez que cambia una regla del negocio:
la tasa de ITBMS, la moneda, los campos que el cajero debe llenar al crear un
cliente, o los rangos y plazos con los que la conciliación bancaria juzga cada
liquidación. El grupo Conciliación bancaria conviene revisarlo antes de la
primera importación del estado de cuenta: de esos números depende que una
liquidación se marque como variación o como vencida en /conciliacion.
Paso a paso
- Abra Ajustes en el menú lateral. La pantalla entra en General; la
fila de pestañas de arriba lleva al resto de las secciones de Ajustes.

- En Organización, revise teléfono y correo públicos, Zona horaria
(
America/Panama), Moneda (USDen Frankie's), Nombre del impuesto (ITBMS) e Impuesto global (%) (7). - En Marca cargue el logo y el nombre de marca, y en Diseño de tu página elija uno de los cuatro diseños (Brasa, Noche, Ultra, Sol). Desde el 12 de septiembre de 2026 el diseño viste TODO: la página de pedidos, el seguimiento, los recibos, el tablero del motorista, los correos de acceso y esta misma app (POS y cocina). Ya no existe un tema aparte para el POS.
- El modo claro/oscuro no es parte del diseño: lo elige cada dispositivo con el botón de la barra superior.
- En Datos de clientes marque los campos obligatorios. El nombre siempre es obligatorio; en pedidos en línea, nombre, celular y correo son siempre obligatorios además de su selección.
- Presione Guardar. Ese botón guarda únicamente el formulario de Organización, Marca, Diseño y Datos de clientes.
- Baje a las tarjetas de grupo y ajuste lo que corresponda. Cada tarjeta se guarda con su propio botón (Guardar general, Guardar tarjetas de regalo, Guardar promociones, Guardar servicios y productos, Guardar conciliación bancaria).
- En Conciliación bancaria revise los rangos de comisión esperados y los
días de liquidación de cada riel.

- Más abajo, en el mismo grupo, revise las tres palabras clave con las que se
reconoce cada movimiento del banco (
YAPPY,ADQUIR,TILOPAY), el Modo de acreditación de Yappy y el chip del Mapeo de columnas del estado de cuenta. Cierre con Guardar conciliación bancaria.
Campos y botones
| Campo/Botón | Qué hace | Notas |
|---|---|---|
| Teléfono público / Email público (directorio) | Contacto que se publica en el directorio | Opcional |
| Zona horaria | Fija la hora con la que se agrupan horarios y pedidos | En Frankie's: America/Panama |
| Moneda | Moneda de todos los montos | En Frankie's: USD |
| Nombre del impuesto (se imprime, ej. ITBMS) | Etiqueta que aparece en recibos y facturas | En Frankie's: ITBMS |
| Impuesto global (%) | Tasa aplicada a los artículos gravados | 7. Cada sede puede sobrescribirla |
| Descripción del impuesto (opcional) | Texto largo del impuesto | Vacío en Frankie's |
| Nombre de marca / Logo / Subir logo | Marca de los correos de acceso | Vacío = nombre de la organización |
| Diseño de tu página (Brasa · Noche · Ultra · Sol) | Elige uno de los cuatro diseños predefinidos; la vista previa de al lado muestra cómo quedará la página de pedidos | Se aplica a la página de pedidos, el seguimiento, los recibos, el tablero del motorista, los correos de acceso y a esta app (POS y cocina). Ya no hay selectores de color libres; un restaurante con colores anteriores aparece como «personalizado (heredado)» hasta que elige un diseño |
| Apellido · Correo · Celular · Género · Fecha de nacimiento | Campos obligatorios al registrar un cliente | El nombre siempre es obligatorio |
| Guardar | Guarda el formulario superior | No guarda las tarjetas de grupo |
| Exigir cliente en cada venta | Obliga a elegir cliente (o walk-in) antes de cobrar | Tarjeta General. No tiene efecto en el POS del restaurante: desde el 10 de septiembre de 2026 el POS pregunta siempre «¿Para quién es el pedido?» al iniciar cada venta, con el interruptor encendido o apagado (ver POS). Las ventas sin datos siguen quedando a nombre de Consumidor Final |
| Habilitar tarjetas de regalo · Vencimiento por defecto (meses) · Exigir destinatario al emitir | Reglas de las tarjetas de regalo | «Exigir destinatario» admite override Por sede |
| Habilitar promociones · Permitir combinar promociones | Reglas de promociones en POS y en línea | Tarjeta Promociones |
| Mostrar artículos inactivos · Nuevos artículos gravados | Reglas del catálogo | Tarjeta Productos |
| Comisión de tarjeta mínima/máxima esperada (%) | Rango de MDR del adquirente; fuera de rango la liquidación se marca como variación | 2 y 3.5 |
| Comisión mínima/máxima esperada de Tilopay (%) | Mismo rango para Tilopay | 3 y 5 |
| Días de liquidación de Yappy | Plazo esperado de acreditación de Yappy | 2 |
| Días mínimos/máximos de liquidación de tarjeta (datáfono) | Plazo esperado del datáfono | 1 y 4 |
| Días máximos de liquidación de Tilopay | Plazo esperado de Tilopay | 14 |
| Días de liquidación de marketplace | Plazo esperado de PedidosYa, Uber Eats, etc. | 5 |
| Palabra clave para líneas de Yappy / de tarjeta (datáfono) / de Tilopay | Texto que debe contener la descripción del movimiento bancario | YAPPY, ADQUIR, TILOPAY |
| Modo de acreditación de Yappy | «Un movimiento diario» o «Uno por transacción» | En Frankie's: un movimiento diario |
| Mapeo de columnas del estado de cuenta | Muestra Configurado / No configurado | Solo lectura aquí: se arma en Conciliación |
| Heredar / Sí / No (Por sede) | Override de una sede sobre el valor de la organización | «Heredar» usa el valor general |
Mensajes y errores
Esta pantalla no emite códigos NG_*: los guardados escriben directamente la
configuración y no devuelven mensajes traducidos. El único mensaje propio que
muestra es el de permiso, en lugar del formulario:
"No tienes permiso para gestionar la configuración general."
Lo que la pantalla no hace:
- El botón Guardar de arriba no guarda las tarjetas de abajo, y cada tarjeta guarda solo su grupo. Si cambia dos tarjetas, presione los dos botones.
- Mapeo de columnas del estado de cuenta no se puede editar aquí: la pantalla muestra el estado y remite a Conciliación.
- Un usuario sin
settings.manage(por ejemplo el cajero) no ve Ajustes en el menú lateral, y si escribe la ruta ve la página con la fila de pestañas vacía y el aviso de permiso.