Saltar al contenido principal

POS — los servicios de la clínica también se buscan y se cobran

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

El POS solo vendía artículos con existencias. Los servicios de la clínica (consulta, peluquería, vacunación…) viven en el catálogo veterinario (vete_cortes), no en el inventario, así que nunca aparecían en el buscador y no había forma de cobrarlos desde caja.

Ahora se buscan junto a los productos y se cobran con la tarifa elegida, sin descontar inventario.

Qué cambió​

  • Buscador unificado. El POS consulta productos y, además, los servicios activos del catálogo veterinario (vete_cortes) por nombre o tipo. Los servicios se listan aunque el filtro «Ver productos con stock» esté activo (no tienen stock) y muestran la etiqueta «Servicio» en vez de existencias.
  • Tarifa explícita. El catálogo guarda un precio base y, opcionalmente, tarifas por talla (S/M/L/XL) y por kilo. Al agregar un servicio con varias tarifas se abre el diálogo «Tarifa del servicio»; la elegida queda en la línea («Baño · Talla M») y puede cambiarse desde el carrito. Con por kilo la cantidad se escribe en kilos (admite decimales).
  • El precio lo pone el servidor. POST /api/pos/ventas acepta idServicio + servicioVariante y resuelve el precio en vete_cortes; una tarifa inexistente o un servicio inactivo rechazan la venta. El cliente nunca envía importes.
  • Sin inventario ni trazabilidad. Los servicios no exigen lote ni serie, no descuentan stock_almacen y no generan movimiento de kardex; al anular la venta no hay nada que devolver al stock.
  • Base de datos: pos_venta_items.id_producto pasa a ser opcional y se añaden id_servicio (FK a vete_cortes, RESTRICT) y servicio_variante, con un CHECK que impide una línea sin artículo o con los dos (migración 1792730422555).
  • IVA por servicio: nueva columna vete_cortes.impuesto_porcentaje (0–100, por defecto 0) editable en Veterinaria › Catálogo › Opciones; el POS la aplica al armar la línea y el backend la recalcula al cobrar (migración 1792730422556).
  • Sin precio no hay venta: al agregar un producto o servicio con precio 0 el POS avisa que no está configurado; el cobro también lo rechaza. La cantidad de una línea nunca baja de 1 (0.1 en servicios por kilo).

Archivos clave​

  • ccf-almacen-api/src/domains/pos/pos.service.ts — búsqueda de servicios, resolución de tarifas, cobro sin stock y anulación sin reversa.
  • ccf-almacen-api/src/domains/pos/dto/crear-venta.dto.ts — idServicio y servicioVariante.
  • ccf-almacen-api/src/database/migrations/1792730422555-PosServicios.ts.
  • ccf-almacen-web/src/utils/pos-carrito.ts — identidad por artículo, topes, validación y payload para servicios.
  • ccf-almacen-web/src/pages/pos.tsx — resultados con «Servicio», diálogo de tarifa y línea del carrito con la tarifa elegida.

Cómo verificarlo​

  1. Abre POS › Caja con la caja abierta y escribe el nombre de un servicio.
  2. Pulsa + (o Agregar al carrito): si tiene varias tarifas, elige una.
  3. Comprueba que la línea no descuenta stock y que el total incluye el servicio.
  4. Cobra la venta: no aparece movimiento de inventario en el kardex. Anula la venta y el stock sigue intacto.