Services

Para qué sirve y para quién

Servicios es el catálogo de lo que vende una peluquería o un centro de estética cuando lo que se vende no es un artículo: cada servicio con su nombre, su tarifa, su precio, su duración, su categoría y su categoría fiscal (el IVA con el que se cobra), y qué profesionales lo hacen, con su duración y su precio propios si los tienen. De este catálogo leen la agenda de Citas (qué se reserva, cuánto dura y con quién), el TPV de Ventas (qué se cobra), la respuesta automática de WhatsApp y los menús.

También guarda los bonos: un bono es un paquete de sesiones de servicios concretos que una clienta compra una vez y gasta en varias visitas. Un bono paga una línea de servicio entera, no un importe (no es una tarjeta regalo), y la titular es una sola clienta.

Quién la usa:

• El empleado (recepción, caja): ve el catálogo, las categorías y los bonos, da de alta servicios, ve los bonos vendidos y sus movimientos, concede un bono a una clienta y gasta sesiones.
• El responsable: además edita servicios y categorías, crea y edita bonos, asigna profesionales a un servicio, anula o ajusta un bono vendido y ve los bonos que se quedaron sin cliente.
• El propietario y el administrador: además archivan servicios, eliminan categorías y bonos y cambian los ajustes.

Solo lo usa la peluquería: la plantilla de restaurante no lo trae y ningún flujo de restaurante depende de él.

Referencia adoptada

• Catálogo de salón (Fresha, Vagaro, Mangomint, DaySmart, Square Appointments): un servicio = nombre, precio, duración y categoría; archivar en vez de borrar; un servicio de precio no cerrado («Desde», «Variable») se cobra preguntando el importe.
• Quién hace cada servicio se asigna en el servicio (Fresha «Team members», Square Appointments, Vagaro, Mangomint, Odoo Appointments), con la duración y el precio propios de cada profesional.
• Bonos (Mindbody, Vagaro, Boulevard, Fresha): el bono se paga al venderlo y gastarlo no emite documento fiscal; cubre líneas de servicio, no importes; la caducidad cuenta desde la compra; lo vendido conserva las condiciones con que se vendió; regalar o corregir es un movimiento aparte con motivo; anular solo un bono que no se ha usado.
• Decisiones del producto actual que mandan aquí: ADR-0386 (un bono cubre líneas; una tarjeta regalo, importes), ADR-0390 (la titularidad nace al venderlo, el reloj arranca en la compra y no se transfiere) y ADR-0085 (el IVA se enlaza por la categoría fiscal de Impuestos).

Antes de empezar

1. Servicios enciende con él Impuestos, Personal y Clientes, y no se pueden apagar mientras Servicios esté encendida: la categoría fiscal de cada servicio es de Impuestos, los profesionales son de Personal y la titular de un bono es una ficha de Clientes.
2. En Impuestos → Categorías tiene que haber al menos una categoría fiscal activa: sin ella el formulario de servicio avisa «Todavía no hay categorías fiscales. Configúralas en Impuestos antes de añadir servicios.».
3. Crea las categorías que quieras para agrupar el catálogo (SERVICE-F07) y da de alta los servicios (SERVICE-F01). Para muchos a la vez, el asistente los da de alta de golpe (SERVICE-F06).
4. Abre cada servicio y asígnale los profesionales que lo hacen (SERVICE-F31). Mientras un servicio no tenga a nadie asignado, la agenda deja que lo haga todo el equipo reservable (SERVICE-F33).
5. Crea los bonos en Bonos y paquetes (SERVICE-F12) poniendo siempre Usos: vacío significa sesiones ilimitadas.
6. En Ajustes elige la duración, el margen y la categoría fiscal que toma un servicio nuevo cuando no se dicen (SERVICE-F11).

Pantallas

Servicios se abre desde el menú Servicios y tiene tres pestañas: Servicios, Categorías y Bonos y paquetes, más Ajustes para quien puede cambiarlos. Lo que una persona no puede hacer no aparece, y la app lo rechaza aunque lo intente por la API o por el asistente.

Servicios

Tabla con buscador «Buscar servicio…», columnas Nombre, Categoría, Tarifa (Precio fijo, Por hora, Desde, Variable, Gratis), Precio, Duración (min) y Estado: Activo, Sin configurar (con el motivo debajo, «Sin categoría fiscal: no se puede cobrar») o Archivado. Se ordena por cualquier columna y se filtra por Nombre, Categoría, Tarifa, Precio (desde–hasta), Duración y Estado (el filtro de Estado en Archivado cambia a la vista de archivados); vista de lista o de tarjetas; 50 por página.

Nuevo servicio abre el formulario: Nombre, Tarifa, Precio (en euros, «22,50»; al salir del campo se reescribe con la notación del idioma), Duración (min), Categoría («Sin categoría» o una de la lista) y Categoría fiscal (sin opción vacía; viene elegida la de los Ajustes) y el botón Crear servicio. Tocar una fila (o su Editar) abre «Editando servicio — » con el botón Guardar cambios y, debajo, Profesionales que lo hacen (SERVICE-F31, F32). Por fila: Editar y Archivar; en la vista de archivados, Restaurar. Archivar pide confirmar: «Archivar servicio» — « — dejará de ofrecerse y de poder reservarse. Se conservan su histórico y las citas ya reservadas.».

Categorías

Tabla con buscador «Buscar categoría…» y columnas Nombre, Categoría padre, Orden y Servicios (cuántos servicios en oferta tiene). Nueva categoría abre el formulario: Nombre, Categoría padre («Sin padre (raíz)» u otra) y Orden, con Crear categoría / Guardar cambios. Por fila: Editar y Eliminar; Eliminar pide confirmar: «Eliminar categoría» — « — la categoría desaparece; los servicios que contiene se conservan, sin categoría.» y, si tiene servicios, «{count} servicio(s) se quedarán sin categoría.».

Bonos y paquetes

Arriba, Bonos sin cliente (solo responsable, propietario y administrador). Tabla con buscador «Buscar paquete…», columnas Nombre, Descuento, Precio cerrado, Líneas y Estado (Activo, Archivado o Eliminado). El filtro de Estado en Eliminado cambia a la vista de los bonos eliminados del catálogo que alguien compró: por fila solo Movimientos y Bonos vendidos. Nuevo paquete abre el formulario: Nombre, Tipo de descuento (Porcentaje o Importe fijo), Descuento (%) o Descuento (importe), Precio cerrado («Déjalo vacío para que valga la suma de sus líneas menos el descuento.»), Vigencia (días) («Días canjeable desde la compra; vacío = no caduca.»), Usos («Usos que concede el bono; vacío = ilimitados.») y Servicios incluidos: una fila por servicio con Servicio y Sesiones, «Quitar línea» y Añadir servicio; botón Crear paquete. Al editar, en lugar de las líneas sale «Los servicios incluidos no se cambian una vez creado: elimina este paquete y crea uno nuevo.». Por fila: Editar, Movimientos, Bonos vendidos y Eliminar (con «Eliminar paquete»: « — el paquete y sus {count} línea(s) salen del catálogo y ya no se pueden vender; los bonos ya vendidos se siguen pudiendo gastar y los encuentras filtrando Estado por Eliminado.»).

Hojas que se abren encima, todas con Cerrar, «Cargando…» mientras llegan, su vacío, su error y Cargar más con «Se muestran {shown} de {total}» cuando hay más:

• Movimientos del bono: cada sesión y cada ajuste de ese bono, de todas las clientas, el más reciente primero, con su etiqueta (Reservada, Entregada, Liberada, Caducada, Devuelta, Cortesía, Corrección), el servicio, la fecha, «Cliente: », quién y el motivo. Vacía: «Este bono aún no se ha usado.».
• Bonos vendidos: una fila por compra, con Activo o Anulado, la clienta, la fecha, el importe, «{used} usadas · quedan {remaining}» (o «· sin límite»), «Caduca el …» o «No caduca» y lo regalado o corregido después; en una anulada, «Anulado por {who} el {when}» y el motivo. Botones Ajustar y Anular cuando proceden. Vacía: «Nadie ha comprado este bono todavía.».
• Bonos sin cliente: los bonos vivos cuya ficha se eliminó o se anonimizó, con «Quedan {remaining} sesión(es)», «Sin límite de sesiones» o «Agotado», el bono, el importe, «Cliente borrado el {when}», «Caducado» si lo está y «Referencia del cliente: ». Vacía: «Ningún bono se ha quedado sin cliente.».

Ajustes de Servicios

Solo para quien puede cambiarlos. Campos: «Duración por defecto (min)», «Tiempo de margen por defecto (min)», «Categoría fiscal por defecto», «Mostrar precios», «Mostrar duración» y «Permitir reserva online»; botón Guardar. Mientras el negocio no ha guardado nunca, salen los de fábrica (60 min, 0 min, ninguna categoría, sí, sí, sí). Guardado: «Ajustes guardados.».

Estados de cada pantalla

Importes, duraciones y fechas salen con el formato del idioma de quien mira.

Flujos

SERVICE-F01 Dar de alta un servicio

Estado: hecho Actor: empleado, responsable, asistente Pantalla: Servicios Pasos: 1. En Servicios pulsa Nuevo servicio. 2. Escribe el Nombre, elige la Tarifa (viene Precio fijo), el Precio y la Duración (min). Elige una Categoría o deja «Sin categoría». 3. Elige la Categoría fiscal (son las de Impuestos, por su nombre y su tipo; viene la de los Ajustes si hay una). Sin ella Crear servicio no se puede pulsar. 4. Pulsa Crear servicio: el formulario se cierra y el servicio sale en la tabla como Activo. Entra: las categorías de Servicios y las categorías fiscales activas de Impuestos. Sale: el servicio en oferta y reservable (service.service.created); desde ese momento lo ven la agenda, el TPV y WhatsApp. Lo que no se dice toma los Ajustes: duración, margen antes y después, reserva online y categoría fiscal; sin Ajustes, 60 min, sin margen y con reserva online. Si falla: dentro del formulario, cada motivo debajo de su campo: un importe que no se entiende («Esto no es un importe. Escribe una cifra, por ejemplo 12,50.»), uno que se lee de dos maneras o uno negativo; una categoría eliminada («Esa categoría no está disponible: no existe en este negocio o se ha eliminado.»); una categoría fiscal que no existe o está desactivada («Esa categoría fiscal no existe en Impuestos o está desactivada.»); sin ninguna categoría fiscal, el aviso de Impuestos. Lo tecleado se conserva. Implicados: TAX-F01

SERVICE-F02 Editar un servicio

Estado: hecho Actor: responsable, asistente Pantalla: Servicios Pasos: 1. Toca la fila del servicio o su Editar: se abre «Editando servicio — » con sus datos. 2. Cambia Nombre, Tarifa, Precio, Duración, Categoría o Categoría fiscal (esta no se puede vaciar). 3. Pulsa Guardar cambios: el formulario se cierra y la tabla se pone al día sola. Entra: el servicio completo. Sale: el servicio cambiado (service.service.updated); se cambia solo lo que se tocó. Las citas ya reservadas conservan el nombre, el precio y la duración que tenían; los bonos ya vendidos no cambian. Si falla: los motivos de SERVICE-F01; un servicio que ya no existe, «Ese servicio no existe en este negocio.». Un servicio cuya categoría se eliminó sale «Sin categoría» y se guarda sin problema. Implicados: SERVICE-F31

SERVICE-F03 Poner un servicio a precio abierto

Estado: hecho Actor: responsable, asistente Pantalla: Servicios Pasos: 1. En el formulario elige la Tarifa Desde, Por hora, Variable o Gratis (o pídeselo al asistente: «Mechas desde 65 €»). 2. La columna Tarifa lo enseña. Entra: el servicio. Sale: el servicio con su tarifa (service.service.updated). Para Ventas, un servicio que no es de precio fijo pide el importe al cobrarlo, con su precio como sugerencia; «Gratis» no fuerza el precio a 0. Los precios mínimo y máximo (asistente y API) se guardan; el mínimo no puede pasar del máximo. Si falla: una tarifa fuera de las cinco o un mínimo por encima del máximo se rechazan con su motivo. Implicados: SALE-F09

SERVICE-F04 Archivar un servicio

Estado: hecho (el aviso de citas próximas sale cuando exista Citas) Actor: propietario, administrador Pantalla: Servicios Pasos: 1. En la fila del servicio pulsa Archivar. 2. Lee «Archivar servicio»: « — dejará de ofrecerse y de poder reservarse. Se conservan su histórico y las citas ya reservadas.». 3. Pulsa Archivar (o Cancelar). La fila desaparece de la lista. Entra: el servicio. Sale: el servicio fuera de oferta, no borrado (service.service.archived): deja de salir en la agenda, en el TPV, en WhatsApp y en el selector de líneas de un bono. Las citas ya reservadas, los bonos que lo incluyen y los profesionales asignados no cambian. Si falla: en la confirmación, «No se pudo archivar el servicio» o «Ese servicio no existe en este negocio.». Archivar uno ya archivado no cambia nada. Implicados: APPOINTMENT-F01

SERVICE-F05 Ver y restaurar los servicios archivados

Estado: hecho Actor: responsable Pantalla: Servicios Pasos: 1. En el filtro de Estado elige Archivado: la tabla enseña solo los archivados. 2. En la fila pulsa Restaurar (no pide confirmación). 3. El servicio vuelve a la lista como antes, con su nombre, precio, duración y categoría. Entra: los servicios archivados. Sale: el servicio otra vez en oferta y reservable (service.service.restored). Si falla: encima de la tabla, «No se pudo restaurar el servicio» o «Ese servicio no existe en este negocio.». Restaurar uno que ya está en oferta no cambia nada. En la vista de archivados la fila no ofrece Editar ni Archivar y tocarla no abre nada.

SERVICE-F06 Dar de alta muchos servicios de golpe

Estado: hecho (asistente y API; no hay importador en pantalla) Actor: responsable, asistente Pantalla: ninguna Pasos: 1. Pide al asistente que cree una lista de servicios (hasta 500), cada uno con nombre, precio, duración y, si quieres, categoría fiscal y categoría. 2. El asistente responde cuántos se crearon. Entra: la lista de servicios. Sale: los servicios, todos o ninguno, cada uno con su aviso (service.service.created). Lo que una línea no dice toma los Ajustes, como el alta suelta. Si falla: una línea mal formada, con una categoría o una categoría fiscal que no existen, rechaza el lote entero antes de crear nada, con el motivo de cada línea en su campo (services.3.price).

SERVICE-F07 Crear y editar categorías

Estado: hecho Actor: responsable, asistente Pantalla: Categorías Pasos: 1. En Categorías pulsa Nueva categoría. 2. Escribe el Nombre y, si quieres, elige la Categoría padre y un Orden. 3. Pulsa Crear categoría. Para cambiarla, toca la fila o su Editar («Editando categoría — »), cambia lo que haga falta y pulsa Guardar cambios. Entra: las categorías vivas del negocio. Sale: la categoría (service.category.created, service.category.updated), que aparece en el campo Categoría del formulario de servicio y en el filtro de la columna Categoría. Las listas y el TPV las ordenan por Orden y nombre. Si falla: un nombre que ya tiene otra categoría viva (sin distinguir mayúsculas ni espacios de más) sale debajo del campo: «Ya hay una categoría con ese nombre. Elige otro nombre.». Una categoría no puede ser su propio padre ni colgar de una de sus hijas: «Una categoría no puede colgar de sí misma ni de una de sus subcategorías.». Un padre eliminado: «Esa categoría padre no está disponible: no existe en este negocio o se ha eliminado.».

SERVICE-F08 Eliminar una categoría

Estado: hecho Actor: propietario, administrador Pantalla: Categorías Pasos: 1. En la fila de la categoría pulsa Eliminar. 2. Lee «Eliminar categoría» y, si tiene servicios, cuántos se quedarán sin categoría. 3. Pulsa Eliminar (o Cancelar). La fila desaparece. Entra: la categoría y cuántos servicios en oferta tiene. Sale: la categoría eliminada, no borrada (service.category.deleted); su nombre queda libre. Sus servicios se quedan sin categoría y sus subcategorías pasan a colgar de su padre (o a ser raíz). Si falla: en la confirmación, «No se pudo eliminar la categoría» o «Esa categoría no existe en este negocio.».

SERVICE-F09 Vender un servicio en el TPV

Estado: hecho — lo hace Ventas: Servicios le da service.service.list_for_sale y service.service.get (ver «Contrato con Ventas» y SALE-F38) Actor: empleado Pantalla: Ventas: Vender Pasos: 1. En la tira de categorías del TPV, Servicios enseña cada servicio en oferta con su precio y su duración (también salen en el buscador). 2. Un servicio Sin configurar sale con la marca «Falta el IVA» y no se vende. 3. Un servicio que no es de precio fijo pide el importe, con su precio como sugerencia. Entra: los servicios en oferta, su tarifa y su categoría fiscal. Sale: la línea de venta con el servicio; Servicios no anota nada por vender un servicio suelto. Si falla: lo dice Ventas (SALE-F38). Implicados: SALE-F01, SALE-F38

SERVICE-F10 Dar el catálogo a Citas, Ventas, WhatsApp y Menús

Estado: hecho Actor: sistema, asistente Pantalla: ninguna Pasos: 1. Quien reserva, cobra, contesta un WhatsApp o compone un menú no abre Servicios: lee su lista de servicios en oferta (service.service.list_for_sale) o un servicio concreto (service.service.get). 2. La lista trae solo los servicios en oferta, con nombre, tarifa, precio, mínimo y máximo, duración, margen, si es reservable, su categoría y su categoría fiscal (y si le falta); también los que aún no tienen categoría fiscal, marcados. Entra: el catálogo. Sale: nada; Servicios no guarda quién lo lee. Si falla: cada lector decide. Implicados: APPOINTMENT-F01, SALE-F01, WHATSAPP_INBOX-F21, COMBO-F06

SERVICE-F11 Cambiar los ajustes de Servicios

Estado: hecho Actor: propietario, administrador Pantalla: Ajustes de Servicios Pasos: 1. Abre Servicios → Ajustes. 2. Cambia los campos y pulsa Guardar. 3. Sale «Ajustes guardados.». Entra: los ajustes guardados (o los de fábrica). Sale: los ajustes (service.settings.updated). La duración, el margen (antes y después), la reserva online y la categoría fiscal por defecto los toma todo servicio nuevo que no los diga (formulario, asistente, API y alta de golpe); el formulario trae elegida la categoría fiscal por defecto. «Mostrar precios» y «Mostrar duración» los leerá la reserva online cuando exista. Si falla: «No se pudieron guardar los ajustes.» y el motivo debajo del campo (una duración de 0, una categoría fiscal que no existe).

SERVICE-F12 Crear un bono

Estado: hecho Actor: responsable, asistente Pantalla: Bonos y paquetes Pasos: 1. Pulsa Nuevo paquete. 2. Escribe el Nombre («Bono 5 cortes»). Elige el Tipo de descuento y su valor, y si quieres un Precio cerrado. 3. Pon la Vigencia (días), que cuenta desde la compra (vacía = no caduca), y los Usos: las sesiones que da el bono en total (vacío = ilimitadas). 4. En «Servicios incluidos» elige cada Servicio (los que están en oferta) y sus Sesiones; Añadir servicio añade otra fila y «Quitar línea» la quita. 5. Pulsa Crear paquete: sale en la tabla como Activo con su número de líneas. Entra: los servicios en oferta. Sale: el bono en el catálogo (service.package.created). Al gastarlo, cualquier servicio de sus líneas consume uno de sus «Usos». Si falla: sin ningún servicio, «Añade al menos un servicio: un paquete sin líneas no se puede canjear.»; un servicio repetido, archivado o que no existe; un importe ilegible o negativo, debajo de su campo; un nombre que ya tiene otro bono vivo, «Ya hay un paquete con ese nombre. Elige otro nombre.».

SERVICE-F13 Editar o eliminar un bono

Estado: hecho Actor: responsable (editar), propietario y administrador (eliminar) Pantalla: Bonos y paquetes Pasos: 1. Toca la fila o su Editar («Editando paquete — »): cambia Nombre, Descuento, Precio cerrado, Vigencia o Usos; las líneas no se cambian. Pulsa Guardar cambios. 2. Para quitarlo del catálogo pulsa Eliminar y confirma. 3. Para ver lo vendido de un bono eliminado, filtra Estado por Eliminado. Entra: el bono del catálogo. Sale: al editar, el bono cambiado (service.package.updated); «Usos» y «Vigencia» valen para las ventas futuras, los bonos vendidos conservan lo que se vendió; el nombre nuevo se ve también en ellos. Al eliminar (service.package.deleted), el bono sale del catálogo y ya no se puede conceder; los ya vendidos se siguen gastando, ajustando y anulando igual. Un bono eliminado que nadie compró no sale en ninguna vista. Si falla: «No se pudo guardar el paquete» o «Ese paquete no existe en este negocio.».

SERVICE-F14 Vender un bono a una clienta

Estado: hecho la concesión (asistente y API); la venta en el TPV, no (ver «Lo que queda fuera») Actor: empleado, responsable, asistente Pantalla: asistente Pasos: 1. Pide al asistente que conceda el bono a la clienta (por su nombre o su teléfono), con el importe cobrado y la venta si los hay. 2. El bono sale en Bonos vendidos de ese bono (SERVICE-F16). Entra: el bono del catálogo, vivo y activo, y la clienta (Clientes). Sale: un bono vendido con la titular, la fecha, el importe y los «Usos» y la «Vigencia» del catálogo congelados; la caducidad cuenta desde ese momento (service.grant.granted). No sale ningún documento fiscal: lo emite la venta del bono. Si falla: «Elige el cliente al que pertenece el bono…» si no se dice; «Ese paquete no existe en este negocio.» si el bono se eliminó o está desactivado; una fecha de compra futura, «Un bono no se puede comprar en el futuro.» (alargar un bono es Ajustar, SERVICE-F18), y una sin zona horaria, que la diga; un nombre de clienta que vale para varias, la lista para elegir (customer.customer_ambiguous). Implicados: CUSTOMER-F01

SERVICE-F15 Consultar los bonos de una clienta

Estado: hecho (asistente y API) Actor: empleado, responsable, asistente Pantalla: asistente Pasos: 1. Pregunta al asistente por los bonos de la clienta: responde una fila por compra, con el bono, la fecha, lo pagado, las sesiones usadas y las que quedan, cuándo caduca y si ya caducó o se anuló. Entra: la clienta (Clientes) y sus bonos vendidos. Sale: nada; solo lectura.

SERVICE-F16 Ver quién ha comprado un bono

Estado: hecho Actor: empleado, responsable Pantalla: Bonos y paquetes Pasos: 1. En la fila del bono pulsa Bonos vendidos (de uno eliminado, con Estado en Eliminado). 2. Sale una fila por compra, la más reciente primero (ver «Pantallas»). 3. Cargar más trae la siguiente página; Cerrar vuelve a la tabla. Entra: las compras de ese bono y el nombre de cada clienta (Clientes); de una ficha eliminada, su identificador. Sale: nada; solo lectura. Ajustar y Anular salen donde proceden y para quien puede.

SERVICE-F17 Anular un bono vendido por error

Estado: hecho Actor: responsable, asistente Pantalla: Bonos y paquetes Pasos: 1. En Bonos vendidos, en la compra equivocada pulsa Anular (solo sale si no se ha gastado ninguna sesión). 2. Lee «¿Anular este bono?»: «El bono del cliente {customer} ({amount}) deja de poder usarse y queda en la lista como anulado. El dinero no se devuelve aquí: si se cobró, devuelve la venta desde Ventas con una devolución.». 3. Escribe el Motivo (obligatorio) y pulsa Anular. Entra: la compra y el motivo. Sale: el bono deja de poder gastarse y queda como rastro, con quién, cuándo y el motivo (service.grant.voided). No mueve dinero ni emite documento. Si falla: «Ese bono ya se ha usado: no se puede anular.», «Ese bono ya estaba anulado.» o «Indica por qué se anula este bono: el motivo queda en su registro.». Si otra caja gasta una sesión a la vez, la anulación espera y recibe el motivo real.

SERVICE-F18 Regalar sesiones, alargar la caducidad o corregir el saldo

Estado: hecho Actor: responsable, asistente Pantalla: Bonos y paquetes Pasos: 1. En Bonos vendidos pulsa Ajustar en una compra viva con límite de sesiones o caducidad. 2. Elige Añadir sesiones o Quitar sesiones y cuántas (hasta 100; quitar, hasta las que le quedan), y/o «Días que se alarga» (hasta 366). 3. Escribe el Motivo y revisa «Tras el ajuste: quedan {remaining} sesión(es) · caduca el {when}». 4. Pulsa Ajustar. Entra: la compra, las cantidades y el motivo. Sale: un movimiento aparte con quién, cuándo, cuánto y por qué (service.grant.adjusted), que sale en Movimientos como Cortesía o Corrección; la compra no se reescribe. Revive un bono caducado o agotado. Si falla: «Indica por qué se ajusta este bono…», «Añade o quita al menos una sesión, o añade al menos un día.», «No puedes quitar más sesiones de las que le quedan al cliente.», «Ese bono no tiene límite de sesiones…», «Ese bono no caduca…» o «Ese bono ya estaba anulado.».

SERVICE-F19 Ver los movimientos de un bono

Estado: hecho Actor: empleado, responsable Pantalla: Bonos y paquetes Pasos: 1. En la fila del bono pulsa Movimientos. 2. Sale cada sesión entregada y cada ajuste, el más reciente primero (ver «Pantallas»). Entra: las sesiones y los ajustes de ese bono. Sale: nada; solo lectura.

SERVICE-F20 Un bono caduca

Estado: hecho Actor: sistema Pantalla: ninguna Pasos: 1. Un bono con «Vigencia (días)» caduca ese número de días después de su compra, más los días regalados con Ajustar. 2. Desde ese momento gastarlo se rechaza con «Este bono ha caducado.»; sus sesiones sin usar se quedan y Ajustar lo revive. Entra: la fecha de compra, la vigencia vendida y los días regalados. Sale: nada se escribe al caducar.

SERVICE-F21 Gastar una sesión fuera del cobro

Estado: hecho (asistente y API) Actor: empleado, responsable, asistente Pantalla: asistente Pasos: 1. Pide al asistente que gaste una sesión de un bono comprado por la clienta, y si quieres que diga qué servicio se hizo y la enlace a la cita o a la venta. Antes puede preguntarse si se podría y por qué no. Entra: la compra del bono; el servicio, la cita y la venta, como referencia. Sale: una sesión Entregada al momento (service.grant.redeemed), que cuenta contra los «Usos». No emite documento fiscal. Si falla: «Este bono está anulado: ya no se puede usar.», «Este bono ya no tiene sesiones disponibles.», «Este bono ha caducado.», «Este bono no cubre ese servicio. Un bono de cortes paga cortes, no el champú.» o «Esa venta de bono no existe en este negocio.». Dos cajas que gastan la última sesión a la vez van en fila y la segunda recibe el motivo real.

SERVICE-F22 Pagar una línea con un bono

Estado: hecho (con Ventas, SALE-F27) Actor: empleado, responsable Pantalla: Ventas: Cobro Pasos: 1. Con la clienta asignada a la cuenta, abre el cobro. En «Líneas pagadas de otra forma», cada línea de un servicio enseña «Pagar esta línea con un bono» con los bonos de esa clienta que cubren ese servicio, tienen sesiones y no han caducado (también los de un bono eliminado del catálogo y los de una ficha unida a la suya). Una línea de varias unidades se separa antes («Separar en N líneas»). 2. Viene elegido el bono que se gasta primero, con el porqué: primero uno con sesiones contadas antes que uno ilimitado, después el que antes caduca, el ya empezado, al que le quedan menos sesiones y el comprado antes. Con dos o más dice «{count} bonos válidos». Toca otra tarjeta para gastar otro. 3. Revisa «Quedan {before} sesiones · {after} después de esta» y pulsa Gastar una sesión. 4. Sale «{name}: sesión gastada. Quedan {after}.» y la línea pasa a 0,00 € con «Ya pagado»; el importe del cobro baja. Deshacer la devuelve mientras la venta no esté cobrada. 5. Cobra lo demás con su medio (SERVICE-F24). Cerrar el cobro, aparcar la cuenta o recargar la pantalla no cambia nada: la marca vive en la línea de la cuenta, así que al volver la línea sigue pagada con el bono y el hueco enseña la sesión gastada con Deshacer. Entra: la clienta, la cuenta, la línea y su servicio (Ventas); los bonos de la clienta (Servicios). Sale: una sesión Reservada para esa línea durante un día (service.session.reserved), que cuenta como usada y ya no se puede gastar en otra línea; la línea de la cuenta, pagada con el bono. No emite documento fiscal: el bono se declaró al venderlo. Si falla: si no se pueden leer los bonos, «No se han podido cargar los bonos del cliente. Inténtalo otra vez antes de cobrar el precio completo.» con Reintentar, nunca «no tiene bonos». Sin bonos: «Este cliente no tiene ningún bono que cubra este servicio.». Al gastar: «Este bono ya no tiene sesiones disponibles.», «Este bono ha caducado.», «Este bono está anulado: ya no se puede usar.» o «Este bono no cubre ese servicio…». Si otra caja gasta a la vez la última sesión, la segunda espera y recibe el motivo real. Deshacer tras cobrar: «Esa sesión del bono ya no se puede soltar: la venta está cobrada. Devolverla es una devolución.». Sin Servicios activa, o sin permiso para gastar sesiones, el hueco no aparece. Implicados: SALE-F27, CUSTOMER-F17

SERVICE-F23 Soltar la sesión si la línea o la cuenta desaparecen

Estado: hecho Actor: empleado, responsable Pantalla: Ventas: Vender, Cobro Pasos: 1. Quien cobra pulsa Deshacer en el hueco, quita de la cuenta la línea pagada con el bono, la anula si ya se envió a cocina o elimina la cuenta entera. 2. Ventas suelta la sesión reservada de esa línea en la misma operación. 3. En Movimientos la sesión sale como Liberada. Entra: la sesión reservada de la línea (la guarda la línea de la cuenta). Sale: la sesión de vuelta en el bono al momento (service.session.released). Soltar una sesión ya liberada o caducada no cambia nada. Dividir o juntar cuentas no la toca: la sesión va con su línea. Si falla: una sesión ya cobrada no se suelta (ver arriba). Si Servicios no está activa en ese momento, la línea se quita igual y la sesión vuelve sola al cabo de un día (SERVICE-F25). Implicados: SALE-F18, SALE-F20, SALE-F27

SERVICE-F24 Dar por gastadas las sesiones al cobrar

Estado: hecho (conceder los bonos vendidos en el tique, no: ver «Lo que queda fuera») Actor: empleado, responsable Pantalla: Ventas: Cobro Pasos: 1. Se cobra una cuenta (entera o unas líneas) con líneas pagadas con bono. 2. En la misma operación del cobro, Ventas da por Entregada la sesión de cada línea pagada con bono que entra en ese cobro, enlazada a la venta. Las líneas que no entran en este cobro conservan su sesión reservada para cuando se cobren (SALE-F22). 3. Desde ese momento la sesión ya no se suelta: solo vuelve con una devolución (SERVICE-F26) o anulando la venta (SERVICE-F27). Entra: las sesiones reservadas de las líneas cobradas, la venta y su clienta (Ventas). Sale: las sesiones gastadas para siempre y enlazadas a la venta (service.session.settled). Repetir el cobro con la misma clave no gasta dos veces. Si falla: nada se cobra y la cuenta sigue igual si una sesión ya no está reservada («La sesión reservada de «{name}» ya no está reservada (pasó su día o se soltó). Quita el bono de la línea y vuelve a aplicarlo.»), si la venta no es de la titular del bono («El bono «{name}» es de otro cliente: cobra la venta a nombre de su titular o quita el bono de la línea.»). Pendiente de fase 2 (activación por hub): si Servicios no está activa, tampoco se cobra; hoy la plataforma no apaga apps por hub y ese camino solo se prueba en los tests. Implicados: SALE-F01, SALE-F22, SALE-F27

SERVICE-F25 La sesión retenida que nadie cobra vuelve sola

Estado: hecho (al leer y con la tarea de cada hora, que corre el worker: base/scheduler.py, 2026-10-15) Actor: sistema Pantalla: ninguna Pasos: 1. Una sesión reservada en un cobro tiene un día de plazo para cobrarse (por ejemplo, una cuenta aparcada y olvidada). 2. Pasado el plazo deja de contar en el saldo del bono al momento; la tarea de cada hora la marca como Caducada en Movimientos. 3. Si se vuelve a esa cuenta, la línea sigue marcada, pero cobrarla se rechaza (SERVICE-F24): se deshace el bono y se vuelve a aplicar. Entra: las sesiones reservadas sin cobrar y su plazo. Sale: la sesión de vuelta en el bono (service.session.expired cuando la tarea las marca). Si falla: si la tarea no corre, la sesión vuelve igual en cuanto pasa el plazo: el saldo no la cuenta. Implicados: SALE-F17

SERVICE-F26 Devolver la sesión al devolver la venta

Estado: hecho (con Ventas, SALE-F32) Actor: responsable Pantalla: Ventas: Devolver Pasos: 1. En Ventas, pulsa Devolver en la venta (también en una pagada entera con bono, a 0,00 €). 2. En «Qué se devuelve», cada línea pagada con bono dice «Ya pagado · {name}». Márcala: «La sesión vuelve a {name}.». 3. Pulsa el botón de devolver: se puede devolver solo la sesión, sin dinero. Entra: las sesiones gastadas en esa venta (las guarda cada línea de la venta). Sale: la sesión de vuelta en el bono, con quién, cuándo y el documento de devolución (service.session.returned); en Movimientos, Devuelta. No mueve dinero ni emite documento; si el bono ya caducó, la sesión consta pero no se puede gastar hasta alargarlo (SERVICE-F18). La misma devolución repetida devuelve una sola sesión. Si falla: «Esa sesión ya se devolvió en otra devolución.». Pendiente de fase 2 (activación por hub): si Servicios no está activa, la devolución se rechaza entera; hoy la plataforma no apaga apps por hub y ese camino solo se prueba en los tests. Implicados: SALE-F31, SALE-F32

SERVICE-F27 Devolver la sesión al anular la venta

Estado: hecho (anular los bonos vendidos en ella, no: ver «Lo que queda fuera») Actor: responsable Pantalla: Ventas: Anular venta Pasos: 1. Un responsable anula en Ventas una venta cobrada (SALE-F30). 2. En la misma operación, cada sesión gastada en esa venta vuelve a su bono, aunque haya caducado. 3. En Movimientos cada una sale como Devuelta, con quien anuló, la hora y el motivo. Entra: la venta anulada, quién y el motivo; las sesiones gastadas en esa venta. Sale: las sesiones de vuelta en su bono (service.session.returned). No mueve dinero ni emite documento fiscal. Si falla: repetir la anulación no devuelve dos veces. Pendiente de fase 2 (activación por hub): si Servicios no está activa, la venta no se anula (se avisa en la ventana); hoy la plataforma no apaga apps por hub y ese camino solo se prueba en los tests. Implicados: SALE-F30

SERVICE-F28 Unir dos fichas: los bonos pasan a la que queda

Estado: servidor hecho; la entrega del aviso espera al relay del outbox (fase 2). Mientras tanto, los bonos de una clienta (SERVICE-F15) incluyen los de la ficha unida a la suya, así que ninguno queda invisible Actor: sistema Pantalla: ninguna Pasos: 1. En Clientes alguien une dos fichas de la misma persona. 2. Servicios pasa a la ficha que queda todos los bonos de la absorbida (vivos y anulados), con sus sesiones y sus ajustes. Entra: la ficha que queda y la absorbida (avisa Clientes: customer.customer.merged). Sale: los bonos apuntando a la ficha que queda (service.grant.reassigned); si dos compras son del mismo bono, quedan dos, cada una con su saldo y su caducidad. Si falla: repetir el aviso no cambia nada. Implicados: CUSTOMER-F13

SERVICE-F29 Eliminar o anonimizar una ficha: sus bonos quedan sin cliente

Estado: hecho (la lista se calcula al leer); vaciar los textos libres al anonimizar, servidor hecho, la entrega del aviso espera al relay del outbox (fase 2) Actor: sistema Pantalla: ninguna Pasos: 1. En Clientes un administrador elimina una ficha o borra sus datos personales. 2. Sus bonos vivos pasan a Bonos sin cliente (SERVICE-F30) con la fecha en que se eliminó. 3. Si se borraron sus datos personales (RGPD), Servicios vacía los textos libres de sus bonos: la nota de la compra, el motivo de una anulación, el motivo de cada ajuste y la nota y el motivo de devolución de cada sesión. Entra: la ficha eliminada o anonimizada (Clientes; al anonimizar avisa customer.customer.erased). Sale: el bono conserva la referencia de la ficha, que es lo que lo casa con la venta que lo pagó; sesiones, importes y movimientos no cambian. Al anonimizar, los textos libres vacíos (service.grant.erased). Los anulados no salen en la lista. Si falla: repetir el aviso no cambia nada. Implicados: CUSTOMER-F07, CUSTOMER-F16

SERVICE-F30 Rescatar los bonos sin cliente

Estado: hecho (la lista; pasar un bono a otra ficha no existe, ADR-0390) Actor: responsable Pantalla: Bonos y paquetes Pasos: 1. Pulsa Bonos sin cliente. 2. Sale cada bono cuya ficha se eliminó o se anonimizó, el más reciente primero (ver «Pantallas»). No hay nombre, correo ni teléfono. 3. Para devolver el dinero, busca la venta en Ventas y haz una devolución; para anular el bono si no se usó, ábrelo desde Bonos vendidos de ese bono, donde sale con su referencia. Entra: los bonos vivos de fichas eliminadas o anonimizadas. Sale: nada; solo lectura.

SERVICE-F31 Asignar un profesional a un servicio

Estado: hecho Actor: responsable, asistente Pantalla: Servicios (Editando servicio) Pasos: 1. Abre el servicio: en «Profesionales que lo hacen» sale la lista o «Nadie asignado todavía: lo puede hacer todo el equipo reservable.». 2. En «Añadir profesional…» elige a alguien de Personal (salen los que aún no lo tienen) y, si quieres, sus «Minutos (opcional)» y «Precio (opcional)» propios. 3. Pulsa Asignar. Entra: el servicio y la ficha del profesional (Personal). Sale: la asignación, activa y no principal (service.assignment.assigned). Citas la lee para filtrar los profesionales de un servicio y tomar su duración y su precio propios. Asignar otra vez a la misma persona (asistente o API) cambia sus minutos y su precio; su servicio principal solo cambia si se dice. Si falla: dentro de la sección, «Ese profesional no existe en este negocio.», un nombre que vale para varios (staff.ambiguous_member) o el importe ilegible o negativo. Implicados: STAFF-F01

SERVICE-F32 Cambiar o quitar un profesional de un servicio

Estado: hecho; quitar a quien se da de baja en Personal, servidor hecho, la entrega del aviso espera al relay del outbox (fase 2). Mientras tanto, quien está de baja ya no sale en las listas ni en «quién puede hacerlo» (SERVICE-F33) Actor: responsable, asistente Pantalla: Servicios (Editando servicio) Pasos: 1. En «Profesionales que lo hacen», cambia los minutos o el precio de una persona y guárdalo, marca la estrella («Servicio principal»; uno por persona, el anterior deja de serlo), apágalo o pulsa «Quitar». Entra: la asignación. Sale: el cambio (service.assignment.updated, service.assignment.removed). Dar de baja a una persona en Personal la quita de todos los servicios que hacía. Si falla: «Esa asignación no existe en este negocio.».

SERVICE-F33 Saber quién puede hacer un servicio

Estado: hecho Actor: sistema, asistente Pantalla: ninguna Pasos: 1. Quien reserva pregunta qué profesionales pueden hacer un servicio (service.assignment.eligible). 2. Servicios contesta con las personas Activas y Reservables con una asignación activa para ese servicio, con su duración y su precio propios, las de servicio principal primero y luego por nombre. Entra: el servicio. Sale: la lista, de solo lectura. Vacía quiere decir «nadie declarado» o «quien lo tiene no está activo y reservable»: la regla «entonces lo hace todo el equipo reservable» es de Citas.

Servicios: lo que entra y lo que sale

Todo se puede pedir por las pantallas, el asistente (por voz o por texto, con la sesión de quien habla) y la API, con las mismas reglas y los mismos permisos. Un servicio, una categoría o un bono se nombran por su id o por su nombre; un profesional, por su nombre; una clienta, por su nombre o su teléfono. Si un nombre vale para varios, se dice cuáles y se pide que elija (409 service.service_ambiguous, service.category_ambiguous, service.package_ambiguous, staff.ambiguous_member, customer.customer_ambiguous).

Lo que ofrece: consultas (leen, no cambian nada)

Todas, menos las comprobaciones, se pueden seguir en vivo.

Lo que ofrece: acciones (cambian datos)

Lo que avisa

A qué reacciona y lo que necesita de otras apps

De Impuestos lee las categorías fiscales; de Personal, las fichas (nombre, si está activa y es reservable); de Clientes, el nombre de la titular y si su ficha se eliminó.

Contrato con Ventas

Ventas no depende de Servicios (Servicios no está en sus requires): usa sus operaciones por nombre, con la sesión de quien vende, como hace con Inventario.

• Vender un servicio (F09): service.service.list_for_sale (búsqueda, category_id, páginas de hasta 100) da por servicio id, name, pricing_type, price, min_price, max_price, duration_minutes, category_id, category_name, tax_category_id, tax_category_key y needs_tax_setup (sin categoría fiscal viva: no se vende). service.service.get da uno, también archivado. Al cobrar, la categoría fiscal de la línea es la de tax_category_key.
• El bono en el cobro y en la devolución (F22–F27): Ventas llama por su nombre, con la sesión de quien cobra (su permiso y la app activa los comprueba cada operación), y en la misma transacción que su propia escritura, sin esperar a ningún aviso:
• al pagar una línea con un bono, service.session.hold (grant_id, service_id, order_line_id) y guarda en la línea la sesión que le devuelve;
• al deshacerlo, quitar la línea, anularla o eliminar la cuenta, service.session.release (id);
• al cobrar, service.session.settle (ids de las líneas cobradas, sale_id, customer_id de la venta);
• al anular la venta, service.session.return con todas sus sesiones (reference = la venta) y, al devolverla, con las de las líneas que vuelven (reference = la devolución). Para pintar el hueco, el cobro lee service.grant.tender_options (customer_id, service_id). Servicios guarda la venta y la línea de la cuenta como identificadores opacos (sale_id, order_line_id): Ventas no es requisito de Servicios ni Servicios de Ventas.

Quién puede qué

Los papeles llegan del SaaS con prefijo (hub_owner, hub_admin, hub_manager, hub_employee); el cajero del producto actual es un empleado: lo que tenía (ver, gastar y conceder) lo tiene el empleado.