Mostrador (POS)

El POS cobra en el mostrador: arma la venta, la cobra, descuenta stock y cuadra la caja del turno. Su clave es pos. En el catálogo está marcado como no implementado, así que el panel lo muestra como «Próximamente»; el ciclo de venta, eso sí, está construido y probado, y el módulo viene en el plan Pro.

Qué hace

• Venta en dos pasos: crear el borrador y después cobrar. En medio, pagos divididos (efectivo, tarjeta, transferencia) cuya suma cubre el total; no se exige que cada línea lo cubra sola.
• Caja. Una sola abierta por sitio. Fondo inicial, entradas y salidas de efectivo que no son venta, y cierre con arqueo: la diferencia es lo contado menos lo esperado.
• Solo cuenta la caja que miras. El efectivo esperado suma las ventas en efectivo de esa sesión y deja fuera las de otra caja y las de tarjeta o transferencia.
• Stock. Al completar se descuenta de las líneas de producto; las de servicio no lo tocan, y devolver un servicio no reingresa nada.
• Devoluciones. Solo de una venta completada, y nunca más de lo vendido contando las devoluciones anteriores.
• Documento fiscal. Cada venta y cada nota de crédito dejan uno pendiente, y se avisa por webhook a la app fiscal del negocio.

De qué depende

• El módulo pos y tu perfil: un cajero vende y cierra caja; solo un manager devuelve; el perfil de bodega no tiene mostrador.
• Una caja abierta para vender: sin ella, la petición se corta antes de crear nada.
• El precio: manda el de mostrador; si no hay, el de catálogo; si no hay ninguno de los dos, se rechaza nombrando el producto.
• El catálogo, para saber qué línea es producto. Se consulta en vivo, no es una columna de la línea.
• Una app fiscal externa para que el documento salga de verdad. Hoy no hay ninguna conectada.

Qué pasa cuando se apaga

• Vender, cobrar, abrir caja y devolver dan 403 con {"module": "pos"}.
• El índice de ventas sale vacío, para que el panel pinte la compuerta sin un error de red.
• El turno abierto se queda como está: no se puede operar ni cerrar.

Límites y trampas

• El dinero sale como número, no como texto de dos decimales. Es la única superficie del contrato así, y no tiene una prueba de contrato que la vigile.
• No hay endpoint para listar devoluciones. Se crea una y se devuelve en la respuesta; el historial de una venta no se consulta.
• La línea no guarda el tipo. Si un producto se convierte en servicio después de venderlo, la devolución usa el tipo actual, no el que tenía al vender.
• Nada se emite de verdad: sin app externa, el documento se queda pendiente para siempre.
• El movimiento de stock no guarda autor, así que “quién vendió” se sabe por la caja y no por el libro.
• Quién abrió la caja es una referencia suelta, sin clave foránea que la respalde.
• El tipo de documento se decide por el total y por si la venta lleva cliente identificado.
• El umbral de facturación es una constante del código, no un ajuste por sitio.

Ver también

• Pedidos
• Inventario
• Pagos