Manual de Usuario

QR-Carta es un sistema de gestión de cartas digitales para restaurantes. Permite crear y publicar menús interactivos accesibles mediante código QR, con soporte multiidioma, información de alérgenos, múltiples plantillas de diseño y exportación a PDF.

¿Qué puedes hacer con QR-Carta?

• Crear cartas digitales con categorías, productos, precios e imágenes
• Generar códigos QR personalizados con el logo de tu restaurante
• Publicar menús en varios idiomas (español, inglés, etc.)
• Indicar alérgenos por producto de forma visual con iconos personalizados
• Personalizar la cabecera y el pie de página del menú público con imágenes, HTML enriquecido y colores
• Exportar cualquier menú como PDF profesional con dos columnas y fotos
• Gestionar varios restaurantes desde una sola cuenta
• Importar menús desde una web o fichero XML
• Usar inteligencia artificial para detectar alérgenos y traducir contenidos

Acceso al panel

El panel de administración está disponible en:

Carta pública

La carta pública de cada menú es accesible sin necesidad de cuenta, directamente desde el código QR o la URL pública asignada al menú.

Crear una cuenta nueva

1. Accede a /admin/register desde tu navegador.
2. Completa el formulario: nombre, correo electrónico, contraseña y confirmación.
3. Completa el captcha de seguridad (checkbox «No soy un robot»).
4. Haz clic en «Registrarse». Serás redirigido automáticamente al panel principal.

Iniciar sesión

1. Accede a /admin/login.
2. Introduce tu correo y contraseña.
3. Haz clic en «Iniciar sesión».

Cambiar idioma del panel

El panel detecta automáticamente el idioma de tu navegador (español o inglés). Si deseas cambiarlo manualmente, usa los botones ES / EN ubicados en la barra superior derecha.

El restaurante es la unidad principal. Todo menú, categoría y producto pertenece a un restaurante concreto.

Crear un restaurante

1. Ve a Restaurantes en el menú lateral.
2. Pulsa el botón «Nuevo restaurante».
3. Rellena los campos y guarda.

Campos del formulario

• NombreNombre visible del restaurante. Obligatorio. Al escribirlo, el slug se genera automáticamente.
• SlugIdentificador URL (ej. mi-restaurante). Se genera automáticamente a partir del nombre pero es editable. Debe ser único.
• Clave APIGenerada automáticamente. Solo lectura. Úsala para integraciones externas (ej. plugin de WordPress). Cópiala con el botón de copia junto al campo.

Un restaurante puede tener varios menús (carta principal, menú del día, carta de vinos, etc.). Cada menú tiene su propio código QR, URL pública, cabecera personalizable y pie de página.

Crear un menú

1. Ve a Menús y pulsa «Nuevo menú».
2. Selecciona el restaurante al que pertenece.
3. Añade las traducciones del nombre en los idiomas que desees (aparecen justo debajo del selector de restaurante).
4. Activa «Es público» para que sea accesible mediante QR.
5. Asigna un slug público (ej. carta-principal) o déjalo en blanco para que se genere automáticamente.
6. Elige una plantilla de diseño.
7. Configura opcionalmente la cabecera y el pie de página del menú.
8. Guarda.

Campos básicos del formulario

• RestauranteRestaurante al que pertenece este menú. Obligatorio.
• TraduccionesNombre del menú en cada idioma activo. Aparece debajo del selector de restaurante.
• Es públicoSi está activo, el menú es accesible por cualquier persona con el enlace o QR.
• Slug públicoParte de la URL pública: /m/{slug}. Se genera automáticamente si se deja vacío.
• Plantilla de diseñoEstilo visual de la carta pública. Hay tres plantillas disponibles.
• ProductosSelecciona los productos que aparecerán en este menú.

Cabecera del menú público NUEVO

La sección de Cabecera del menú público permite personalizar completamente la parte superior de la carta pública con imagen de fondo, texto HTML enriquecido y colores.

• Logo de cabeceraImagen de logotipo que aparece en la parte superior del menú público. Es independiente del logo del código QR.
• Imagen de fondo de cabeceraImagen a ancho completo que se muestra como fondo de la cabecera del menú público.
• Texto HTML de cabeceraEditor enriquecido (RichEditor) con soporte para títulos H1–H6, negrita, cursiva, enlaces, etc. El texto se superpone sobre la imagen de fondo.
• Alto de cabeceraAltura mínima de la cabecera en píxeles (ej. 300). Controla cuánto espacio ocupa la zona de cabecera.
• Color del texto de cabeceraSelector de color para el texto de la cabecera. Sobreescribe el color predeterminado de la plantilla seleccionada.

Pie de página del menú público NUEVO

Similar a la cabecera, el pie de página permite añadir información de contacto, redes sociales, aviso de alérgenos u otro contenido al final de la carta pública.

• Imagen de fondo del pieImagen a ancho completo como fondo del pie de página.
• Texto HTML del pieEditor enriquecido para el contenido del pie (teléfono, dirección, aviso legal, etc.).
• Alto del pieAltura mínima del pie en píxeles.
• Color del texto del pieSelector de color para el texto del pie de página.

Logo del código QR y personalización QR

La sección Logo del código QR controla exclusivamente la apariencia del código QR. Este logo es diferente al logo de cabecera del menú.

• Logo del código QRImagen que aparece superpuesta en el centro del código QR. Formatos: JPEG, PNG, WebP, GIF, SVG. Máx. 2 MB. Solo visible en el QR, no en la carta pública.
• Color del QRColor de los módulos del código QR. Por defecto azul marino (#1e2d40).
• Previsualización QRVista previa del código QR generado en tiempo real.
• Descargar PNG / SVGBotones para descargar el QR en formato rasterizado (PNG, incluye logo) o vectorial (SVG).

Descargar PDF del menú NUEVO

Desde el listado de menús (acción de fila) o desde el botón verde en la página de edición del menú, puedes generar y descargar el menú completo en formato PDF profesional.

1. En el listado de menús, haz clic en el botón «Descargar PDF» de la fila correspondiente, o abre el menú y usa el botón verde «Descargar PDF» en la cabecera.
2. En el modal que aparece, selecciona el idioma (ES o EN).
3. El PDF se generará y se descargará automáticamente.

URL pública del menú

Una vez guardado y marcado como público, el menú estará disponible en:

Puedes especificar el idioma añadiendo ?lang=en al final de la URL.

Traducir con IA

Disponible en la página de edición del menú. Traduce todos los productos y categorías a los idiomas activos de una sola vez. Requiere plan Pro o Plus.

Las categorías organizan los productos dentro de la carta (ej. «Entrantes», «Carnes», «Postres», «Bebidas»). Admiten subcategorías y tienen soporte completo para imágenes de fondo, iconos de navegación y contenido multiidioma.

Crear una categoría

1. Ve a Categorías y pulsa «Nueva categoría».
2. Selecciona el restaurante.
3. Opcionalmente, elige una categoría padre si es una subcategoría.
4. Define el orden en que aparecerá en el menú.
5. Añade el nombre traducido en cada idioma.
6. Guarda.

Campos del formulario

• RestauranteObligatorio.
• Categoría padreOpcional. El selector muestra todas las categorías del restaurante (no solo las raíz), lo que permite crear jerarquías anidadas de múltiples niveles.
• OrdenNúmero que determina la posición en el menú. Menor número = aparece antes.
• Imagen de fondo ACT.Se muestra a ancho completo de la sección en la carta pública, con una capa semitransparente sobre ella. Visible en las tres plantillas de diseño.
• Imagen de navegación ACT.Imagen circular que aparece en la barra de navegación fija de la carta pública para identificar visualmente la categoría. Visible en las tres plantillas.
• Icono emojiEmoji o carácter (máx. 10) que identifica la categoría en la barra de navegación fija cuando no hay imagen de navegación. Visible en las tres plantillas.
• TraduccionesNombre, descripción de cabecera y descripción de pie de la categoría en cada idioma activo.

Los productos son los platos, bebidas o artículos que aparecen en la carta. Cada uno tiene nombre, descripción, precio, imagen y alérgenos, todo ello en múltiples idiomas.

Crear un producto

1. Ve a Productos y pulsa «Nuevo producto».
2. Selecciona el restaurante y la categoría.
3. Introduce el precio en euros.
4. Añade una imagen del plato (opcional pero recomendado).
5. Marca los alérgenos que contiene.
6. En el bloque Traducciones, añade el nombre y descripción del plato en cada idioma.
7. Guarda.

Campos del formulario

• RestauranteObligatorio.
• CategoríaSección de la carta donde aparecerá el producto.
• PrecioPrecio en euros (ej. 12,50). Obligatorio.
• ActivoSi está desactivado, el producto no aparece en la carta pública.
• OrdenPosición dentro de la categoría. Menor = antes.
• Imagen del productoFoto del plato. Se muestra en la carta pública y en el PDF exportado.
• AlérgenosSelecciona todos los alérgenos que contiene el plato (multiselección). Los iconos se muestran en la carta pública.
• TraduccionesNombre y descripción del producto en cada idioma activo.

Ocultar/mostrar un producto temporalmente

Usa el campo «Activo» para desactivar un producto sin eliminarlo. Útil cuando un plato se agota temporalmente.

Deducción automática de alérgenos con IA

En el listado de productos, selecciona varios y usa la Acción masiva → «Deducir alérgenos». La IA analiza el nombre y descripción de cada plato y asigna automáticamente los alérgenos más probables.

Cada menú público tiene su propio código QR que puedes descargar e imprimir para colocar en las mesas, la puerta o cualquier soporte físico.

Acceder al QR de un menú

1. Ve a Menús y edita el menú que desees.
2. Asegúrate de que «Es público» está activado.
3. En la sección «Logo del código QR» verás la previsualización del código QR.
4. Usa los botones «Descargar PNG» o «Descargar SVG».

Personalizar el QR

• Logo del código QRSe superpone en el centro del QR con fondo blanco circular. Formatos admitidos: JPEG, PNG, WebP, GIF, SVG.
• Color del QRSelector de color para los módulos del código. Por defecto azul marino (#1e2d40).

URL directa del QR

Puedes enlazar directamente a la imagen QR usando esta URL.

QR-Carta permite publicar la carta en múltiples idiomas. Los comensales pueden seleccionar su idioma directamente en la carta pública.

Idiomas disponibles

El sistema admite varios idiomas activos, cada uno identificado por su código ISO (ej. es, en, fr). Los idiomas activos aparecen como opción en los formularios de traducción y como selector en la carta pública.

Añadir traducciones a un producto

1. Edita el producto.
2. Desplázate hasta la sección «Traducciones».
3. Pulsa «Añadir traducción».
4. Selecciona el idioma e introduce el nombre y descripción.
5. Repite para cada idioma que desees y guarda.

El mismo proceso aplica para categorías y menús.

Traducción automática con IA

Si tu cuenta tiene el plan Pro o Plus y el administrador ha configurado la API de DeepSeek, puedes usar la función de traducción automática disponible en la página de edición del menú para traducir todos los contenidos de una vez.

Selector de idioma en la carta pública

La carta pública muestra un selector de idioma en la esquina superior. Al cambiar de idioma, la URL añade el parámetro ?lang=en (o el código correspondiente).

Idioma por defecto

Si un producto no tiene traducción en el idioma solicitado, el sistema muestra el contenido en español (es) como idioma de reserva.

QR-Carta ofrece tres planes de suscripción. Puedes cambiar de plan en cualquier momento desde el panel de facturación.

Comparativa de características

Característica	Free	Pro	Plus
Restaurantes	1	3	Ilimitados
Menús por restaurante	1	5	Ilimitados
Productos por menú	20	100	Ilimitados
Código QR personalizado	✓	✓	✓
Menú público	✓	✓	✓
Exportación PDF	✓	✓	✓
Traducciones con IA	✗	✓	✓
Plantillas personalizadas	✗	✓	✓
Soporte prioritario	✗	✗	✓

Cómo suscribirse

1. Accede a /billing/plans o haz clic en «Ver planes» desde el panel.
2. Elige el plan y el ciclo de pago (mensual o anual).
3. Haz clic en «Suscribirse».
4. Completa el pago en la pasarela segura de Stripe. Puedes introducir un código promocional si tienes uno.
5. Serás redirigido al panel de confirmación. Recibirás un correo de confirmación.

El panel de facturación te permite ver el estado de tu suscripción, consultar el uso de recursos y descargar facturas.

Información disponible

• Plan actual y estado de la suscripción (activo, en periodo de prueba, pago pendiente, cancelado)
• Barras de uso: restaurantes, menús y productos usados respecto al límite del plan
• Historial de facturas con opción de descarga en PDF
• Fecha de renovación o de cancelación

Cambiar de plan

1. Ve a /billing y pulsa «Cambiar plan», o accede directamente a /billing/plans.
2. Selecciona el nuevo plan y el ciclo de facturación.
3. Confirma el cambio. El nuevo plan es efectivo de inmediato.

Cancelar la suscripción

1. Ve a /billing y pulsa «Cancelar suscripción».
2. La suscripción permanece activa hasta el fin del periodo ya pagado.
3. Pasada esa fecha, la cuenta pasa automáticamente al plan Free.

Reactivar una suscripción cancelada

Si cancelaste pero aún estás en el periodo activo pagado, puedes pulsar «Reactivar» para reanudar la suscripción sin interrupciones.

Portal de Stripe

Desde /billing/portal puedes gestionar tu método de pago, descargar facturas pasadas y consultar el historial de cobros directamente en la plataforma segura de Stripe.

QR-Carta permite generar un PDF profesional de cualquier menú con un solo clic. El PDF incluye categorías con jerarquía, productos en diseño de dos columnas, fotos circulares, precios e iconos de alérgenos.

Cómo generar el PDF

1. En el listado de menús, haz clic en el botón de acción de fila «Descargar PDF».
2. O bien, abre el menú para editarlo y usa el botón verde «Descargar PDF» en la cabecera del formulario.
3. En el modal de descarga, selecciona el idioma (ES o EN).
4. El PDF se genera automáticamente y se descarga en tu dispositivo.

Contenido del PDF

• Cabecera y pie personalizables (texto e imágenes de ancho completo A4)
• Categorías con sus imágenes de fondo (si están configuradas)
• Productos en diseño de dos columnas con foto circular
• Precio visible por producto
• Iconos de alérgenos al lado de cada producto
• Tabla de alérgenos en el pie de cada página (opcional)

Si ya tienes tu carta en otro sitio, puedes importarla automáticamente en lugar de crear los productos uno a uno.

Importar desde una web

Extrae categorías y productos directamente de la web actual de tu restaurante. Introduce la URL, selecciona el restaurante de destino y el sistema analizará la página para crear las categorías y los productos automáticamente.

Importar desde XML

Importa una carta desde un fichero XML exportado de otro sistema (por ejemplo, una exportación de WordPress). Sube el fichero, revisa la previsualización y confirma la importación.