Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/AbyssDevs/CUSCATLECO/llms.txt

Use this file to discover all available pages before exploring further.

El rol Cajero cubre el cierre económico del ciclo de servicio en el restaurante. Una vez que Cocina marca un pedido como listo y el mesero lo entrega, corresponde al Cajero emitir la factura electrónica y cerrar el pedido. El Cajero puede generar comprobantes de tipo Consumidor Final o Crédito Fiscal, gestionar el registro de clientes y consultar el menú, pero no interviene en la creación de pedidos ni en la operación de sala.

Acceso al panel

El Cajero accede a su panel exclusivo en:
/cajero
Esta ruta está protegida por el permiso ver_cajero. Sin ese permiso, el sistema redirige a /403.

Permisos asignados

El rol Cajero cuenta con 6 permisos enfocados en facturación y atención al cliente.
PermisoMóduloDescripción
ver_dashboardGeneralVer el panel principal
ver_menuMenúConsultar el catálogo de platillos para referencia en la factura
ver_pedidosPedidosVer el listado de pedidos listos para facturar
generar_facturaFacturaciónEmitir facturas electrónicas (Consumidor Final o Crédito Fiscal)
gestionar_clientesClientesVer y administrar clientes registrados y sus rangos de fidelidad
ver_cajeroCajeroAcceder al panel de cajero

Lo que el Cajero NO puede hacer

El Cajero no tiene acceso a los siguientes módulos. Cualquier intento de acceso resulta en una respuesta 403 Permiso denegado.
  • Crear pedidos: no puede registrar nuevos pedidos (sin crear_pedido). Esa responsabilidad recae en el Mesero o el Administrador.
  • Actualizar estado de pedido: no puede cambiar manualmente el estado de los pedidos en el flujo de cocina.
  • Gestión del menú: puede ver el menú pero no modificarlo (sin gestionar_menu).
  • Gestión de mesas: no tiene acceso al plano de mesas ni puede cambiar su estado (sin listar_mesas, gestionar_mesas ni actualizar_estado_mesa).
  • Gestión de usuarios: no puede crear ni editar cuentas de empleados.
  • Reservaciones: no puede crear ni gestionar reservaciones.
  • Reportes y auditoría: no tiene acceso a estadísticas ni al log de auditoría del sistema.

Flujo de facturación

1

Revisar pedidos pendientes de pago

El Cajero consulta el listado de pedidos con estado Listo o Entregado que aún no tienen factura asociada. Puede identificar la mesa, el mesero responsable y el total del pedido.
2

Seleccionar el tipo de comprobante

Según la solicitud del cliente, el Cajero elige entre dos tipos de documento fiscal:
  • Consumidor Final: para clientes que no requieren crédito fiscal. Solo necesita el nombre del cliente.
  • Crédito Fiscal: para empresas o personas que necesitan deducir IVA. Requiere NIT, NRC y dirección fiscal del cliente.
3

Completar los datos fiscales

Dependiendo del tipo de comprobante elegido, el Cajero completa los campos obligatorios. La factura incluye subtotal, IVA calculado automáticamente y total.
factura_subtotal  →  monto antes de IVA
factura_iva       →  impuesto calculado
factura_total     →  monto final a cobrar
4

Emitir la factura

Al confirmar, el sistema genera la factura con un correlativo único (factura_correlativo), la asocia al pedido y al cajero que la emitió, y registra la fecha y hora de emisión.
5

Cerrar el pedido

Con la factura emitida, el pedido avanza al estado Cerrado. El ciclo de servicio queda completado y la mesa queda disponible para liberar.

Tipos de factura

CUSCATLECO soporta los dos tipos de documento fiscal utilizados en El Salvador:

Consumidor Final

Para clientes particulares. Requiere únicamente el nombre del cliente. El sistema puede asociar la factura a un cliente registrado o generar una para “Consumidor Final” anónimo.

Crédito Fiscal

Para personas jurídicas o naturales con actividad económica. Requiere NIT (factura_dui_nit), NRC (factura_nrc) y dirección fiscal (factura_direccion).

Gestión de clientes

El Cajero puede registrar nuevos clientes, consultar su historial de consumo y verificar su rango de fidelidad. Los rangos vigentes y sus descuentos son:
RangoPedidos mínimosConsumo mínimoDescuento
Bronce1$0.005%
Plata5$100.0010%
Oro15$300.0015%
El descuento del rango se aplica al calcular el total del pedido antes de generar la factura. El Cajero debe verificar el rango del cliente al momento de facturar para aplicar el beneficio correspondiente.

Volver a Roles y Acceso

Build docs developers (and LLMs) love