POS · Punto de venta

Terminal venta rápida con catálogo + ticket builder + cobro one-shot. Decremento atómico de stock + emisión NCF en una operación.

Pre-requisitos

• Módulo Inventory instalado (tablas products + stock_levels).
• Sucursal activa (al menos principal creado en provisioning).
• Secuencia NCF activa (típicamente B02 para venta cash).
• Productos con stock > 0 en la sucursal seleccionada.

Flujo cobro

1. Tenant abre <slug>.vertix.lat/pos.
2. Selecciona sucursal (default: principal).
3. Click producto del grid → agrega 1 unidad al ticket. Re-click incrementa qty. Producto sin stock queda disabled.
4. Override quantity y unitPrice por línea desde ticket (admin).
5. Cliente: Consumidor Final default. Si ncf=B01 requiere RNC.
6. Selecciona método de pago: efectivo / tarjeta / transferencia / mixto.
7. Click Cobrar → sistema:
   1. Valida stock FOR UPDATE per producto en sucursal
   2. Decrementa stock_levels.quantity
   3. Inserta stock_movements con delta negativo, reason='pos_sale'
   4. Aloca siguiente NCF
   5. Crea invoices row con status=issued, source='pos'
   6. Audit log pos.sale
8. Redirección a /billing/<id> con PDF descargable.

Garantías

• Stock check FOR UPDATE previene oversell concurrente.
• Si NCF allocator falla post-stock-decrement: error explícito con instrucción de ajuste manual (DGII no perdona doble decrement).
• Sale aparece en Billing como invoice status=issued.

Permisos

Roles owner/admin/user pueden operar POS. viewer read-only no puede vender.

Ver también

• Facturación — invoices generadas por POS
• Modules — Inventory module