Glosario — Términos técnicos del sistema de caja¶
Todos los términos técnicos relacionados con DiKAS, los sistemas de caja y la informática para la gastronomía.
A¶
ACK / NACK¶
Señales de confirmación y de error en la comunicación con los sistemas de grifo. ACK (Acknowledge) confirma la recepción de un comando. NACK (Negative Acknowledge) señaliza un error: el comando se repite automáticamente.
Addimat¶
Fabricante de sistemas de grifo. DiKAS admite el protocolo Addimat (encuadre STX/ETX con suma de control XOR-CRC) para el tiraje automático de bebidas.
Alérgenos (UE-14)¶
Los 14 alérgenos de declaración obligatoria según el Reglamento UE n.º 1169/2011. DiKAS almacena los alérgenos por artículo y los imprime en los recibos.
API (Application Programming Interface)¶
Interfaz de programación. DiKAS ofrece más de 120 endpoints de REST API para la integración con sistemas externos. Autenticación mediante token JWT.
Grupo de artículos (Artikelgruppe)¶
Estructura de ordenación para los artículos. Los grupos están organizados de forma jerárquica (hasta 3 niveles) y determinan la asignación de impresoras, la ordenación en la caja y el análisis por grupos de mercancías. La configuración de la impresora se hereda automáticamente del grupo superior.
Opción de artículo (Artikeloption)¶
Selección adicional en un pedido (p. ej. ingrediente extra, guarnición, tipo de preparación). Las opciones pueden tener un suplemento y configurarse como selección obligatoria u opcional.
Registro de auditoría (Audit-Log)¶
Protocolo a prueba de manipulaciones de todos los procesos relevantes para la caja. Se lleva automáticamente y puede descargarse como archivo. Relevante para las inspecciones fiscales.
B¶
Copia de seguridad (Backup)¶
Copia completa de todos los datos de DiKAS como archivo ZIP. Contiene todos los documentos (comprimidos en JSONL con Brotli) y los archivos adjuntos. Puede restaurarse de forma selectiva (p. ej. solo artículos o solo clientes).
Opción de impresión por zona (Bereichsabhängige Druckoption)¶
Control de impresoras que utiliza distintas impresoras según el grupo de mesas (zona de servicio). Ejemplo: los pedidos de cerveza en el jardín cervecero van a la impresora del jardín, en el salón a la impresora de la barra.
Comprobante de hospitalidad (Bewirtungsbeleg)¶
Comprobante con relevancia fiscal para gastos de hospitalidad de carácter comercial. DiKAS imprime automáticamente un comprobante de hospitalidad con el motivo, los participantes y la propina.
Recibo (Bon)¶
Recibo de caja. DiKAS distingue cuatro tipos de recibo: Factura (para el cliente), Comanda agrupada (resumen de cocina), Ticket de estación (estación individual) y Recibo de anulación (anulación).
BYOD (Bring Your Own Device)¶
Concepto según el cual cualquier dispositivo puede utilizarse como caja: PC, tablet, smartphone. DiKAS funciona en el navegador y no requiere hardware especial.
C¶
Clean Architecture¶
Patrón de arquitectura de software. DiKAS está estructurado en cuatro capas: Domain (lógica de negocio), Application (casos de uso), Infrastructure (base de datos, impresoras), Web (endpoints de la API).
CouchDB¶
Base de datos NoSQL que DiKAS utiliza como almacén de datos estándar. Ventajas: capacidad sin conexión gracias a la replicación, modelo de datos documental, notificaciones de cambios en tiempo real.
CQRS (Command Query Responsibility Segregation)¶
Patrón de arquitectura que separa las operaciones de lectura y escritura. DiKAS utiliza Commands para los cambios (realizar un pedido, ejecutar un pago) y Queries para las consultas (cargar artículos, mostrar informes).
D¶
DATEV¶
Software de contabilidad estándar en Alemania. DiKAS exporta los datos de caja en formato DATEV (EXTF v13) con 7 modos de exportación distintos. Admite archivos ZIP cifrados y el envío por correo electrónico al asesor fiscal.
Venta directa (Direktverkauf)¶
Proceso de cobro sin asignación a una mesa. Ideal para puestos de comida, panaderías, kioscos o servicio de barra. Seleccionar artículos, elegir método de pago, listo.
Docker¶
Tecnología de contenedores para el despliegue en servidor. DiKAS se distribuye como una única imagen Docker (API + frontend en un contenedor).
DSFinV-K¶
Interfaz digital de la administración tributaria para sistemas de caja. Formato de exportación estandarizado para las inspecciones fiscales. DiKAS crea exportaciones conformes con DSFinV-K.
E¶
ESC/POS¶
Protocolo de impresión para impresoras térmicas (impresoras de tickets de caja). Desarrollado por Epson, compatible con casi todas las impresoras de tickets (Epson, Star, Bixolon, etc.). DiKAS se comunica por TCP/IP con las impresoras ESC/POS.
Ticket de estación (ExtraBon)¶
Recibo adicional que se imprime automáticamente en una estación determinada al realizar un pedido (p. ej. cocina, bar, estación de ensaladas). Cada artículo puede tener hasta dos impresoras de ticket de estación.
F¶
FinTS (Financial Transaction Services)¶
Protocolo de banca electrónica en Alemania (sucesor de HBCI). DiKAS utiliza FinTS para la consulta automática de extractos de cuenta y la asignación de los pagos entrantes.
FlexCel¶
Biblioteca para la generación de archivos Excel. DiKAS utiliza FlexCel para las exportaciones a Excel (control de horario, informes, plantillas DATEV).
FreeCount (cantidad gratuita)¶
Ajuste de los grupos de opciones. Determina cuántas de las opciones más económicas seleccionadas son gratuitas. Ejemplo: «Una salsa incluida» → FreeCount = 1.
G¶
Portata (curso) (Gang / Kurs)¶
Sucesión de platos en un menú de varios tiempos. DiKAS admite la gestión de portadas: el camarero cambia de tiempo y la cocina recibe una comanda de tiempo con la información de qué platos deben prepararse a continuación.
Comanda de tiempo (Gang-Bon)¶
Recibo que se imprime automáticamente al cambiar de tiempo. Informa a la cocina de que debe prepararse el siguiente tiempo. Solo se imprime en las impresoras con la opción de comanda de tiempo activada.
GDPdU (GoBD)¶
Principios para la llevanza y conservación correctas de libros, registros y documentos en formato electrónico. DiKAS cumple los requisitos de GoBD y crea exportaciones conformes con GDPdU.
Gruber¶
Fabricante de sistemas de grifo. DiKAS admite el protocolo Gruber (encuadre STX/ETX con handshake ENQ y suma de control XOR opcional).
Vale (vale de valor / vale individual) (Gutschein)¶
DiKAS distingue dos tipos de vale: vales de valor (importe arbitrario, 0 % de IVA en la venta, IVA en el canje) y vales individuales (para un artículo determinado, IVA normal en la venta, 0 % en el canje).
H¶
Hausbon¶
Método de pago «a factura». El importe se contabiliza en la cuenta del cliente y puede emitirse posteriormente como factura. Sin efecto en caja (no hay flujo de efectivo).
Hogatron¶
Fabricante de sistemas de grifo (también WMF). DiKAS admite el protocolo Hogatron con longitudes de campo configurables.
J¶
JWT (JSON Web Token)¶
Mecanismo de autenticación. DiKAS utiliza tokens JWT para la autenticación de la API. Los tokens se emiten al iniciar sesión y se envían con cada llamada a la API.
K¶
KassenSichV¶
Reglamento de seguridad de cajas (Kassensicherungsverordnung). Obligatorio en Alemania desde el 01.01.2020. Toda caja electrónica debe utilizar una TSE (dispositivo técnico de seguridad) que firme las transacciones de forma inviolable.
KDS (Kitchen Display System)¶
Monitor de cocina. Muestra los pedidos en una pantalla en lugar de en papel. DiKAS utiliza SignalR para las actualizaciones en tiempo real: los nuevos pedidos aparecen de inmediato.
Saldo del cliente (Kundenguthaben)¶
Saldo prepago en la cuenta del cliente. DiKAS distingue AccountBalance (saldo en efectivo recargado) y BonusBalance (bonificación de recarga en porcentaje/importe). Recarga = 0 % de IVA, canje = IVA normal.
M¶
MediatR¶
Biblioteca de .NET para el patrón CQRS. Todos los comandos (Commands) y consultas (Queries) de DiKAS se distribuyen a través de MediatR.
Consumo mínimo (Mindestverzehr)¶
Importe mínimo de pedido por cliente (p. ej. en clubes). Se calcula como recargo al pagar si el cliente no ha alcanzado el consumo mínimo.
N¶
NFC (Near Field Communication)¶
Comunicación sin contacto a corta distancia. DiKAS utiliza NFC para el inicio de sesión del personal (el camarero acerca un chip al lector) y las cuentas de invitado de Disco (ID de tarjeta).
NgRx Signal Store¶
Biblioteca de Angular para la gestión global del estado. DiKAS utiliza el Signal Store (AppStore) para el estado de la aplicación en el frontend.
O¶
OpenBon¶
Posición de pedido abierta. Cada artículo pedido en una mesa se almacena como un documento OpenBon individual. Todos los OpenBons con el mismo BonId pertenecen a una sesión de pedido. Al pagar se convierte en ReceiptItem.
Plantilla de opciones (OptionTemplate)¶
Colección reutilizable de opciones de artículo. Se crea una vez y puede asignarse a varios artículos. Los cambios en la plantilla se aplican de inmediato a todos los artículos asignados.
P¶
PLU (Price Look-Up)¶
Número de artículo para los sistemas de grifo. Cada grifo tiene un número PLU. El artículo en DiKAS se vincula con el grifo a través del campo «PLU del sistema de grifo».
POS (Point of Sale)¶
Sistema de caja / punto de venta. En DiKAS, el área en la que se cobra (a diferencia del área Admin para la gestión).
Regla de precios (Preisregel)¶
Cambio de precio automático basado en condiciones como el día de la semana, la hora, el grupo de mesas, el grupo de clientes o el modo de entrega. Las reglas de artículo tienen prioridad sobre las reglas de grupo.
PrintPool¶
Servicio de impresión en segundo plano de DiKAS. Gestiona una cola de trabajos de impresión, los envía por TCP a las impresoras y trata los errores con reintentos automáticos e impresoras de respaldo.
Q¶
Código QR (TSE)¶
DiKAS imprime un código QR en los recibos de caja que contiene la firma TSE. Formato según DSFinV-K Anexo I: número de serie, contador de firmas, momento de inicio, momento de fin, firma.
R¶
Receipt (comprobante)¶
Recibo de caja tras un pago. Contiene todas las posiciones, el desglose de impuestos, el método o métodos de pago y la firma TSE. Se almacena de forma permanente en la base de datos.
REST API¶
Interfaz de programación a través de HTTP. DiKAS ofrece más de 120 endpoints en /api/v1/... para todas las funciones: artículos, pedidos, pagos, clientes, informes, configuración.
S¶
Comanda agrupada (Sammelbon)¶
Recibo resumido que agrupa todos los artículos de un pedido para una estación determinada. A diferencia del ticket de estación (un recibo por artículo), la comanda agrupada muestra todas las posiciones de un vistazo.
Sistema de grifo (Beverage Dispensing System)¶
Sistema automático de tiraje de bebidas. DiKAS admite Gruber, Addimat y Hogatron/WMF mediante Serial, TCP o UDP. Los pedidos activan el tiraje automático.
Adeudo SEPA (SEPA-Lastschrift)¶
Procedimiento de cobro europeo. DiKAS crea archivos XML SEPA para el cobro bancario automático de facturas pendientes y suscripciones.
SignalR¶
Tecnología de comunicación en tiempo real. DiKAS utiliza SignalR para las actualizaciones en vivo del monitor de cocina, los cambios de mesa y los cambios de configuración. Todos los dispositivos conectados ven los cambios de inmediato.
Soft Delete¶
Mecanismo de borrado en el que los registros no se eliminan físicamente, sino que se marcan como «eliminados». De este modo se conservan en los informes y en los datos históricos.
Pago dividido (Split-Zahlung)¶
Pago separado de una factura. DiKAS admite tanto la división por posiciones (cada cliente paga sus artículos) como por importe (división a partes iguales).
SQLite¶
Motor de base de datos local. DiKAS puede funcionar con SQLite como alternativa a CouchDB, ideal para instalaciones en un único puesto y para la app de Android.
Artículo de sistema (System-Artikel)¶
Artículos predefinidos en DiKAS que se necesitan para funciones internas (p. ej. recarga de saldo, canje de vales, depósito/casco). No se pueden eliminar.
T¶
Cierre de caja (informe Z) (Tagesabschluss / Z-Bericht)¶
Cierre de un turno de negocio. Resume todas las ventas, métodos de pago, impuestos y diferencias. Se firma con TSE y se imprime como PDF o como recibo. Restablece el sistema de grifo (si está configurado).
Grupo de mesas (Tischgruppe)¶
Zona de servicio del establecimiento (p. ej. interior, terraza, jardín cervecero, VIP). Los grupos de mesas controlan la asignación de impresoras (opciones de impresión por zona) y pueden tener sus propias reglas de precios.
TSE (dispositivo técnico de seguridad)¶
Mecanismo de firma a prueba de manipulaciones para sistemas de caja. Obligatorio en Alemania desde el 01.01.2020. DiKAS admite TSE de hardware (Swissbit USB) y proxy TSE (red). Cada comprobante, cada pedido y cada cierre de caja se firma.
V¶
Impresora virtual (Virtueller Drucker)¶
Impresora de marcador de posición en DiKAS: impresora del camarero (__kellner__) = la impresora del dispositivo actual. Impresora estándar (__standard__) = la impresora estándar definida en la configuración.
Voucher¶
→ véase Vale
Z¶
Artículo por tiempo (Zeitartikel)¶
Artículo con facturación por tiempo (p. ej. mesa de billar, bolera por hora). El precio se calcula automáticamente según la duración.
ZVT (Zahlungsverkehrstechnik)¶
Protocolo estándar para la comunicación entre el sistema de caja y el terminal de tarjetas en Alemania. DiKAS se comunica por ZVT con cualquier terminal compatible (Ingenico, Verifone, CCV, etc.), sin estar atado a un proveedor de pagos concreto.
Siguiente paso¶
→ Preguntas frecuentes (FAQ) — Las preguntas y respuestas más importantes
→ Solución de problemas — Cuando algo no funciona