La pantalla Nueva venta es el corazón del módulo Ventas. Tiene formato POS (punto de venta) de dos columnas: a la izquierda el catálogo de productos con búsqueda en vivo, a la derecha el carrito con el cliente y los datos de cobro. Está pensada para que registres una venta en menos de 30 segundos.

El flujo es simple: (1) buscas o agregas al cliente, (2) clickeas productos del catálogo para sumarlos al carrito, (3) eliges método de pago y comprobante, (4) confirmas. Si el producto tiene variantes (tallas, colores, presentaciones), se abre un modal para que elijas cuál.

Hay dos modos de cierre: «Guardar como borrador» (deja la venta sin afectar caja ni stock, para terminar después) o «Confirmar y emitir comprobante» (asienta todo + emite boleta/factura/nota de venta en el mismo paso). El comprobante es opcional — si solo necesitas registrar la venta para tu control interno, eliges «Sin comprobante».

El sistema calcula automáticamente el subtotal por línea, el IGV (si tu régimen lo aplica) y el total general en tiempo real mientras agregas o quitas ítems. También valida que el cliente cumpla los requisitos de cada tipo de comprobante (ej. factura requiere RUC válido de 11 dígitos).

Manual completo

Las dos columnas del POS

Columna izquierda — Catálogo (grilla POS)

Muestra todos los productos visibles del catálogo del MYPE (los que marcaste como visibles en el catálogo). Cada tarjeta tiene foto, nombre, precio aplicado (con oferta si corresponde) y stock disponible. Hasta 60 productos por carga; usa la búsqueda para filtrar más.

• Búsqueda en vivo: el input arriba filtra por nombre, código (SKU) o código de barras del producto. La grilla se actualiza al instante.
• Cuadrícula ⇄ lista: el conmutador arriba de la grilla alterna entre cuadrícula (tarjetas con foto) y lista (filas compactas). Tu elección se recuerda por dispositivo; el punto de partida se configura en Configuración de Gestión → «Vista de productos en Nueva venta y Nueva cotización».
• Click en una card: agrega 1 unidad al carrito. Si el producto tiene variantes, se abre un modal para elegir cuál.
• Indicador de oferta: si el producto tiene oferta vigente, se muestra el precio tachado + el precio de oferta en color.
• Stock: las tarjetas de productos con stock 0 (y con el control de stock activado) se muestran deshabilitadas.

Columna derecha — Carrito

Es donde armas la venta. Tres bloques:

1. Cliente arriba — typeahead que busca contactos registrados + campos manuales (DNI/RUC/CE/Pasaporte/Otros) + botón de consulta SUNAT/RENIEC.
2. Ítems — cada producto agregado aparece como una fila con cantidad editable (botones +/-), precio unitario, subtotal y botón eliminar. Puedes agregar una nota corta por línea (ej. «sin tomate»).
3. Resumen y cierre abajo — subtotal, IGV (si aplica), total. Método de pago, tipo de comprobante, notas internas y los 2 botones de acción.

El bloque Cliente

Campo	Obligatorio	Cómo se usa
Buscar cliente (typeahead)	Opcional	Escribe nombre o documento. Si el cliente ya está registrado en Contactos, aparece en sugerencias. Click → se autocompleta.
Tipo de documento	Sí	DNI, RUC, CE (Carné de Extranjería), Pasaporte u Otros. Determina las validaciones del comprobante.
Número de documento	Opcional (sí para factura)	Sin guiones. DNI: 8 dígitos. RUC: 11 dígitos.
🔍 Buscar en SUNAT	Acción	Si el tipo es RUC o DNI, consulta la API de Migo y autocompleta Razón social y Dirección.
Razón social / Nombre	Sí	Si quedó vacío al confirmar, el sistema asigna «Varios» con doc-type «OTROS» (cliente genérico).
Dirección, Email, WhatsApp	Opcionales	Para factura electrónica conviene tener email del cliente (recibe el XML).

💡 «Varios» es el cliente genérico que el sistema usa cuando no llenas ningún dato y confirmas la venta. Sirve para boletas y notas de venta de mostrador. NO sirve para factura — la factura siempre exige RUC del cliente.

El bloque Ítems del carrito

Cada ítem agregado al carrito guarda:

Campo	Origen	Editable
Producto (nombre + variante)	Del catálogo, no editable	No
SKU	Del producto, no editable	No
Cantidad	Default 1, botones +/-	Sí (también número directo)
Precio unitario	Del catálogo (con oferta si aplica)	No
Nota	Texto libre máx 200 chars	Sí
Subtotal	cantidad × precio calculado	Auto

⚠️ El precio unitario NO se edita desde aquí — viene del catálogo. Si necesitas un precio especial para un cliente, cambia el precio del producto en el catálogo o aplica una oferta vigente antes de hacer la venta.

El modal de variantes

Si el producto tiene variantes (talla S/M/L, color rojo/azul, etc.), al hacer click en su card se abre un modal listando todas las variantes no-default con su precio, SKU y stock. Eliges una → se agrega al carrito. El modal solo aparece si el producto tiene variantes configuradas y existe al menos una variante además de la predeterminada.

Métodos de pago

Valor	Cuándo se usa
Efectivo	Default para venta de mostrador.
Yape	Wallet móvil más usada en Perú.
Plin	Alternativa a Yape (BBVA, Interbank).
Transferencia	Bancaria — el cliente paga después.
POS	Tarjeta de crédito/débito por terminal Visa/Mastercard.
Crédito (solo en «Confirmar y emitir comprobante»)	Venta al fiado — entra a Cuentas por cobrar y no afecta caja al confirmar.

Los 4 tipos de comprobante

Tipo	Para quién	Requisitos	Plan requerido
Sin comprobante	Registro interno solamente	Ninguno	Gratuito y Pro
Nota de venta	Comprobante interno (no SUNAT). Útil cuando aún no quieres emitir boleta pero necesitas un papel.	Ninguno	Gratuito y Pro (con cap mensual del plan)
Boleta electrónica	Consumidores finales (cliente con DNI/CE/Pasaporte/Otros).	Plan con facturación electrónica activa (Pro o gratuito según gate).	Pro
Factura electrónica	Empresas (cliente con RUC de 11 dígitos).	RUC válido del cliente + régimen tributario que permita factura.	Pro

⚠️ Los comprobantes deshabilitados aparecen tachados con el motivo: «Tu plan no incluye facturación electrónica», «Llegaste al cap del plan (X/Y)», «El cliente debe tener RUC válido», etc.

Los 2 botones de cierre

Acción	Qué hace
Guardar como borrador	Guarda la venta como borrador. No afecta caja, stock ni reportes. Quedas en el detalle de la venta para editarla o confirmarla después.
Confirmar y emitir comprobante	Crea + confirma la venta (asienta caja, descuenta stock) + emite el comprobante elegido (si no es «sin»). Si el comprobante falla, la venta queda confirmada igual y te avisa el error.

Flujos completos

Venta mostrador rápida (boleta a cliente genérico)

1. No tocas el bloque cliente (queda vacío).
2. Buscas/clickeas 2-3 productos del catálogo.
3. Eliges «Efectivo» y «Boleta electrónica».
4. Click «Confirmar y emitir comprobante».
5. → cliente «Varios» se asigna automático, boleta sale a SUNAT, redirige al detalle.

Factura a empresa (cliente nuevo)

1. Escribes el RUC en el bloque cliente → click en 🔍 → autocompleta razón social y dirección.
2. Agregas productos.
3. Eliges «Transferencia» y «Factura electrónica».
4. Click «Confirmar y emitir comprobante».
5. → factura sale a SUNAT, redirige al detalle.

Venta al crédito (sin comprobante todavía)

1. Eliges cliente registrado del typeahead.
2. Agregas productos.
3. Eliges «Crédito» como método de pago + «Sin comprobante».
4. Click «Confirmar y emitir comprobante».
5. → venta confirmada, entra a Cuentas por cobrar. Caja NO se afecta.

Casos comunes

«El producto que necesito no aparece en la grilla» Verifica que esté en el catálogo (menú «Catálogo › Productos») y marcado como visible. Si tiene stock 0 y el control de stock activado, su tarjeta aparece deshabilitada. Si tiene variantes pero todas sin stock, el modal va a estar vacío.

«Quiero hacer una venta con un descuento puntual» El precio unitario NO se edita aquí. Opciones: (1) crea una oferta de producto temporal antes de la venta, (2) usa el campo «nota» en cada línea para anotar el motivo del descuento (informativo, no descuenta), o (3) crea un producto «Descuento» con precio negativo en el catálogo y agrégalo al carrito.

«Quiero emitir factura pero el botón está tachado» Lee el mensaje debajo. Lo más común: el cliente no tiene RUC de 11 dígitos. Cambia el tipo de documento a RUC, llena el número correcto, haz click en 🔍 para validar contra SUNAT. Si dice «Tu régimen tributario solo permite boletas», cambia el régimen en Configuración de Gestión (NRUS no permite factura).

«Confirmé la venta pero el comprobante falló» La venta queda confirmada igual — el stock y la caja se actualizan. Te aparece un mensaje rojo con el motivo del error. Desde el detalle de la venta puedes reintentar la emisión del comprobante.

Cosas que NO puedes hacer

• Editar el precio unitario desde el carrito (viene del catálogo).
• Mezclar productos de distintos negocios (cada venta pertenece al negocio del sitio actual).
• Emitir factura sin RUC válido del cliente (el botón queda deshabilitado).
• Emitir boleta o factura si tu plan es gratuito y NO tienes facturación electrónica activa (solo «Sin comprobante» y «Nota de venta» están disponibles).
• Saltarse el cliente completamente — si dejas la razón social vacía, el sistema asigna «Varios» pero no permite la venta sin ningún dato.