Valanz es el sistema de gestión de tu comercio: punto de venta, inventario, clientes, cobranzas, gastos y contabilidad en un solo lugar, pensado para la realidad venezolana — precios en dólares, cobro en bolívares a la tasa del día, IVA por alícuota (0 %, 8 %, 16 %) e IGTF del 3 % cuando el cliente paga en divisa.

Se usa desde el navegador (app.valanz.sekinsoft.com) y desde la app móvil. No hay que instalar nada en la computadora.

Valanz no le muestra lo mismo a todos los negocios. Hay dos filtros que se aplican al menú:

1. El rubro del negocio. Se elige al registrarse y determina qué módulos especializados aparecen. Un restaurante ve Mesas y Mesoneros; un taller ve Vehículos y Órdenes de trabajo; una boutique ve Temporadas. El rubro se puede corregir desde Mi perfil dentro de las primeras 72 horas del registro; después lo cambia soporte.

2. El plan contratado. Básico, Intermedio o Avanzado. Los planes son acumulativos: cada uno incluye todo lo del anterior. Si un módulo no aparece en tu menú y tampoco es de otro rubro, es porque tu plan no lo incluye — Mi plan te dice a cuál subir.

Los tres módulos que todos los negocios tienen, en todos los planes, son Vender (POS), Productos y Tasa del día. Todo lo demás se suma según rubro y plan.

Todo lo demás — Caja, Sucursales, Almacenes, Transferencias, Productos, Proveedores, Compras, Órdenes de compra, Ventas, Clientes, Cuentas por cobrar, Cotizaciones, Notas de entrega, Gastos, Cuentas por pagar, Resumen, Reportes, IVA, Bancos, Contabilidad, Perfil, Usuarios y Mi plan — es igual en los ocho rubros.

Sin tasa cargada no se puede vender, ni comprar, ni registrar un gasto, ni cobrar un abono. No es un capricho: cada operación guarda el equivalente en bolívares con la tasa del momento, y sin ese número el sistema no puede cerrar la operación.

Hay dos formas de resolverlo:

• Manual: entrás a Tasa del día y escribís los bolívares por dólar. Hay que hacerlo todos los días.
• Automática: elegís una fuente (BCV, dólar paralelo o euro oficial) y el sistema la trae solo a las 6:00 y a las 11:00. Se configura una vez y se olvida.

Si en el Dashboard la tarjeta Tasa del día muestra un guion, ya sabés qué falta.

Este es el orden que evita rehacer trabajo. Cada paso deja listo lo que el siguiente necesita.

1. Fijá la tasa del día. Preferiblemente en automático (Tasa del día → fuente BCV o paralelo). Sin esto no se puede vender.
2. Completá los datos del comercio. Mi perfil → nombre, RIF, teléfono, y subí el logo: sale impreso en todos los comprobantes PDF.
3. Creá tu sucursal. Sucursales. Cada sucursal nace con un almacén "Principal" propio. La dirección de la sucursal es la que va en los documentos.
4. Cargá el catálogo de productos. Productos. Uno por uno, o de golpe con Importar Excel (bajá primero la plantilla). Poné el stock mínimo de cada producto: es lo que enciende las alertas del Dashboard.
5. Cargá tus proveedores y tus clientes fijos. Proveedores y Clientes. Los clientes también se pueden crear al vuelo desde el POS.
6. Registrá la mercancía que ya tenés. Compras, para que el costo promedio arranque bien. Si la mercancía ya está en el depósito y no querés generar una compra, cargá el stock directamente en la ficha del producto.
7. Creá los usuarios de tu equipo. Usuarios. Cada usuario activo ocupa un asiento del plan. El rol vendedor entra directo al POS y no ve reportes.
8. Vendé. Vender (POS).

Al abrir: revisá que haya tasa del día y mirá las alertas de stock bajo en el Dashboard.

Durante el día: vendés en el POS; los clientes a crédito generan solos su cuenta por cobrar; los gastos se cargan a medida que salen.

Al cerrar: Caja → contás la gaveta, comparás contra el esperado y cerrás el día. La diferencia queda registrada con tu nombre.

Cada semana: Cuentas por cobrar (a quién llamar) y Bancos (conciliar movimientos mientras son pocos).

Cada mes: Resumen Financiero (ganaste o perdiste), IVA (los libros para el contador) y Contabilidad (que el balance cuadre).

• Borrar un producto que ya se vendió. Se desactiva en lugar de borrarse, para no romper el historial de ventas.
• Recibir una orden de compra a mano. Hay que usar la acción Recibir, que es la que suma el stock.
• Cerrar la caja dos veces el mismo día. Un cierre por fecha y por negocio.
• Desactivar tu propia cuenta ni dejar el negocio sin ningún administrador activo.
• Pagar una deuda con otra deuda. Los métodos de pago a crédito no aparecen en los selectores de abono.
• Devolver más de lo que se vendió. La columna Disponible siempre manda.

Ninguna de estas es un error del sistema: son barreras puestas a propósito para que los números sigan cuadrando seis meses después.

Para qué sirve

Es el mostrador: donde se arma la venta del día a día. Buscás la pieza o el producto, lo agregás al carrito, elegís cómo te paga el cliente y cerrás la venta; el sistema calcula IVA, IGTF y el total en bolívares con la tasa del día. Al terminar podés imprimir el comprobante en el acto.

Qué ves al entrar

La pantalla se divide en dos. A la izquierda, la tarjeta "Nueva venta": en la cabecera un selector de canal de precio (Detal / Mayorista / Distribuidor) y un chip que muestra la tasa vigente (Tasa: X Bs/$) o el aviso "Sin tasa". Debajo, la barra de filtros con el buscador ("Buscar por nombre, referencia o código…"), el selector de Categoría y el interruptor "Sin existencia". Luego la grilla de productos: tarjetas con imagen (o un ícono de paquete si no tiene), los chips de estante/ubicación, el nombre, el precio del canal activo, el IVA (o la palabra "Exento" en verde), y el stock — en rojo si está por debajo del stock de seguridad, o un chip rojo "Sin existencia" si está en cero. Se muestran de a 5 tarjetas por página con paginador y el conteo de piezas. Si el servidor devolvió la tanda completa (60), aparece una línea gris avisando que son las primeras 60 piezas y que conviene afinar la búsqueda.

A la derecha, la tarjeta "Carrito": cada renglón con nombre del producto (y la variante entre paréntesis si aplica), un campo numérico de cantidad, el subtotal del renglón y un botón de papelera. Debajo, el resumen: Subtotal, IVA, IGTF 3% (solo si el método de pago es en divisa), Total $ y Total Bs. Al final, el selector de Método de pago, el buscador de Cliente (solo si el método es a crédito), el botón Finalizar venta y, tras vender, el botón Imprimir comprobante.

Formularios / diálogos

Carrito (formulario principal de venta)

Diálogo "«Producto» — Variante"

Se abre solo cuando el producto tiene variantes. No es un formulario: es una lista con cada variante (talla / color) y su stock; al tocar una, se agrega al carrito. Botón Cerrar.

Diálogo "Nuevo cliente" (alta rápida desde el POS)

Botones: Cancelar y Crear y seleccionar (crea el cliente y lo deja elegido en la venta).

Acciones disponibles

• Clic en una tarjeta de producto: lo agrega al carrito (o abre el diálogo de variantes si tiene).
• Papelera (por renglón del carrito): quita ese producto del carrito.
• Buscar también sin existencia: enlace que aparece cuando no hay resultados con stock; enciende el interruptor.
• Crear cliente / Crear «lo que escribiste»: abre el alta rápida desde el desplegable de clientes.
• Crear cliente nuevo: misma acción, desde el pie de la lista de clientes.
• Finalizar venta: registra la venta, descuenta stock, limpia el carrito y recarga el catálogo y la tasa.
• Imprimir comprobante: abre el PDF de la última venta registrada en una pestaña nueva.
• Paginador de productos: recorre la tanda de resultados de a 5 tarjetas.

Reglas y validaciones

• No se puede vender sin tasa del día: si no hay tasa cargada, sale "Debes fijar la tasa del día antes de vender." Hay que ir a /tasa primero.
• Venta a crédito exige cliente: sin cliente seleccionado, sale "Selecciona un cliente para la venta a crédito." (el servidor también lo rechaza).
• El botón Finalizar venta está deshabilitado con el carrito vacío.
• Stock insuficiente: el servidor rechaza la venta con "Stock insuficiente para {producto}" salvo que el negocio permita stock negativo.
• Producto inactivo: no se puede vender ("Producto inactivo: {nombre}").
• El IGTF 3% se aplica solo cuando el método de pago está marcado como divisa, y se calcula sobre subtotal + IVA.
• El IVA es el que trae cada producto (0 %, 8 % o 16 %); los exentos se marcan en verde.
• La cantidad mínima por renglón es 1 y el servidor exige que sea mayor que 0.
• Al crear cliente desde el POS: el nombre es obligatorio; cédula y RIF son únicos por negocio (máx. 32 caracteres), teléfono máx. 32, dirección máx. 255.
• Si el producto tiene variantes, la variante debe pertenecer a ese producto (validado en el servidor).
• Por defecto solo se muestran productos activos y con existencia; el catálogo se pide al servidor de a 60 por búsqueda.

Tips de uso

• Buscá por referencia o código, no solo por nombre: la búsqueda alcanza también códigos equivalentes, que es como se pide un repuesto.
• Los chips azules del estante te dicen de qué anaquel sacar la pieza antes de ir al depósito. Solo salen si el producto tiene ubicación cargada, es decir en Repuestos, Ferretería y Automotriz.
• Si vendés a un mayorista, cambiá el canal antes de armar el carrito: el precio se recalcula sobre lo que ya está adentro, pero es más fácil verlo desde el principio.
• Si el cliente nuevo llega en plena venta, creálo desde el mismo desplegable: salir a la pantalla de Clientes te hace perder el carrito.

Para qué sirve

Es el cuadre del día: compara lo que el sistema dice que deberías tener en cada método de pago contra lo que realmente contaste en la gaveta. Al cerrar, deja registrado el faltante o el sobrante con tu nombre y la fecha, para que después se pueda auditar.

Qué ves al entrar

Dos pestañas: Cierre del día e Historial.

En Cierre del día: un campo de Fecha (arranca en hoy) y, si esa fecha ya fue cerrada, un chip verde "Caja cerrada" con candado. La tabla trae una fila por método de pago con las columnas: Método (con chip azul "Caja" si es efectivo), Ventas, Abonos, Gastos, Pagos prov., Esperado $, Contado $ (campo editable solo en métodos de efectivo y solo si la caja no está cerrada) y Diferencia (verde si sobra, rojo si falta). Debajo, a la derecha: Total esperado y Diferencia total. Luego el campo Notas (opcional) y el botón Cerrar caja. Si no hubo movimientos, la tabla muestra "Sin movimientos."

En Historial: tabla con Fecha, Usuario, Diferencia $ (coloreada), Notas y un botón Ver. Paginado de a 15 cierres.

Formularios / diálogos

Cierre del día

Diálogo "Cierre del {fecha}" (detalle del historial)

Solo lectura. Tabla con Método, Esperado y Contado, más la Diferencia y las Notas del cierre.

Acciones disponibles

• Cambiar la fecha: recarga el resumen de ese día.
• Cerrar caja: guarda el cierre con lo contado y las notas, y bloquea la edición de ese día.
• Ver (por fila del historial): abre el detalle del cierre en un diálogo.
• Paginador del historial: recorre los cierres más viejos.
• Cerrar la alerta de error: la X del aviso rojo.

Reglas y validaciones

• Un solo cierre por fecha y negocio: si intentás cerrar dos veces el mismo día, sale "Ya existe un cierre de caja para esa fecha."
• El campo Contado solo existe para los métodos marcados como efectivo (is_cash); en el resto la columna muestra un guion y la diferencia es 0.
• La fecha es obligatoria y debe ser una fecha válida; el monto contado debe ser numérico y no puede ser negativo.
• Las notas no pueden pasar de 2000 caracteres.
• Una vez cerrada la caja, desaparecen los campos editables y el botón de cerrar.
• El Esperado ya viene neteado: ventas + abonos − gastos − pagos a proveedor.

Tips de uso

• Contá la gaveta antes de tocar el campo Contado: viene precargado con el esperado, y si lo dejás así el cierre queda cuadrado aunque no lo esté.
• Usá las Notas para justificar diferencias en el momento; después nadie se acuerda por qué faltaban tres dólares.
• Si te olvidaste de cerrar ayer, cambiá la fecha: el cierre se puede hacer con fecha atrasada.
• La Diferencia total en verde significa sobrante y en rojo faltante; cero es lo que buscás.

Para qué sirve

Fija los bolívares por dólar que va a usar todo el sistema hoy: ventas, abonos, compras y gastos. Podés colocarla a mano o dejar que el sistema la traiga sola del BCV o del paralelo cada día. Sin tasa cargada, no se puede vender.

Qué ves al entrar

Dos tarjetas lado a lado.

Izquierda, "Tasa del día": la línea "Tasa actual: X Bs/$" (o "sin definir"), el selector Fuente de la tasa, y según lo que elijas: en modo manual, el campo Bolívares por dólar (Bs/$); en modo automático, un aviso verde con el valor en vivo de esa fuente, la fecha de actualización y la nota "Se aplicará automáticamente cada día (6:00 y 11:00)" — o un aviso amarillo si la fuente no responde. Abajo, el botón Guardar tasa / Activar tasa automática y el mensaje de confirmación.

Derecha, "Tasas del día": lista de referencia con las fuentes disponibles (BCV, paralelo, euro oficial), cada una con su nombre, la fecha de actualización, el valor en Bs y un botón Usar. En la cabecera, un botón de refrescar.

Formularios / diálogos

Tasa del día

No hay diálogos modales en esta pantalla.

Acciones disponibles

• Guardar tasa (modo manual): fija la tasa del día con el valor que escribiste.
• Activar tasa automática (modo automático): guarda la preferencia del negocio y aplica la tasa en vivo de la fuente elegida.
• Usar (por fila de la tarjeta de referencia): adopta esa fuente como la del día y la guarda de una vez.
• Refrescar (ícono en la cabecera derecha): vuelve a consultar los valores en vivo.

Reglas y validaciones

• En modo manual el valor es obligatorio (requiredValidator) y debe ser mayor que 0; si está vacío o en cero, el botón no guarda nada.
• En modo automático el valor lo trae el servidor; si la consulta en vivo falla, se usa como respaldo el valor que tenía el formulario. Si tampoco hay respaldo, el servidor responde 422 "No se pudo determinar la tasa."
• La fuente debe ser una de las válidas: manual, bcv, paralelo, euro_bcv, euro_paralelo.
• Una sola tasa por día y negocio: guardar de nuevo actualiza la del día, no crea otra.
• El euro paralelo existe en el sistema pero no se lista en la tarjeta de referencia.
• La preferencia de fuente queda guardada en el negocio y el sistema la reaplica sola dos veces al día (6:00 y 11:00).

Tips de uso

• Si vendés al cambio oficial, dejá BCV en automático y olvidate: no hay que entrar todos los días.
• El botón Usar de la tarjeta derecha es el atajo: te ahorra el selector y el guardado en dos pasos.
• Si la fuente automática no responde y necesitás vender ya, pasá a Manual y colocá el valor a mano.
• Revisá la fecha de actualización que muestra cada fuente antes de usarla: si es de ayer, la fuente está atrasada.

Para qué sirve

El historial de todo lo vendido. Sirve para consultar ventas viejas, reimprimir el comprobante de un cliente que lo perdió y registrar devoluciones cuando alguien trae la mercancía de vuelta. Cada devolución genera su nota de crédito.

Qué ves al entrar

Una sola tarjeta, "Historial de ventas (N)", donde N es el total de ventas registradas. La tabla tiene: N° (número de venta), Fecha (día y hora), Cliente, Pago (método), Items (cuántos renglones), Total $, Total Bs y una columna de botones. Se muestran 20 ventas por página con paginador abajo, centrado. Si no hay nada, dice "Aún no hay ventas."

Formularios / diálogos

Diálogo "Devolución — Venta N° X"

Tabla con una fila por producto de la venta: Producto, Vendida, Devuelta, Disponible y el campo editable A devolver.

Botones: Cerrar, Confirmar devolución y, una vez registrada, Ver nota de crédito.

Acciones disponibles

• Comprobante (por fila): abre el PDF de esa venta en una pestaña nueva.
• Devolver (por fila): abre el diálogo de devolución. Solo aparece si tu usuario tiene el permiso de reembolsos (refund sobre ventas).
• Confirmar devolución: registra la devolución, devuelve el stock y recarga el listado.
• Ver nota de crédito: abre el PDF de la nota de crédito recién generada.
• Paginador: recorre el historial completo, de a 20 ventas.

Reglas y validaciones

• "Indica al menos un producto a devolver." si todas las cantidades quedan en 0.
• "Indica el motivo de la devolución." si el motivo está vacío; el servidor también lo exige (máx. 255 caracteres).
• La cantidad a devolver no puede exceder lo disponible (lo vendido menos lo ya devuelto): "Cantidad a devolver excede lo disponible para el item X".
• Cada cantidad enviada debe ser mayor a 0 (mínimo 0,001).
• No se puede devolver contra una cuenta por cobrar ya saldada: "La cuenta por cobrar ya fue saldada. No se puede registrar la devolución automáticamente."
• La devolución se registra con fecha de hoy, así no reabre cierres de caja anteriores.
• Si la venta fue a crédito, la devolución reduce automáticamente el saldo de la cuenta por cobrar (y la cierra si llega a cero).
• El stock de los productos devueltos se reintegra al inventario.
• El botón "Devolver" está oculto para quien no tenga permiso de reembolso.

Tips de uso

• Un mismo producto se puede devolver en varias veces: la columna Disponible siempre te dice cuánto queda por devolver.
• Escribí un motivo concreto ("cauchos mal medidos", no "devolución"): es lo único que va a quedar registrado.
• Si el cliente perdió el ticket, buscá la venta por fecha y usá Comprobante: no hace falta rehacer nada.
• La nota de crédito solo se puede abrir justo después de registrar la devolución; guardá el PDF en ese momento.

Para qué sirve

La cartera de clientes del negocio. Además de los datos de contacto, te dice cuánto te ha comprado cada uno, cuándo fue la última vez y cuánto te debe. Con los filtros rápidos ubicás a los que se te están enfriando y a los que más te dejan.

Qué ves al entrar

Tarjeta "Clientes" con un buscador ("Buscar por nombre, cédula o RIF…") y el botón Nuevo cliente. Debajo, cuatro chips de filtro: Todos, Inactivos +30d, Top compradores, Sin compras. La tabla trae: Cliente (nombre en negrita y la dirección en gris debajo), Cédula / RIF, Teléfono, Compras (cantidad), Total $ (lo comprado en toda su historia), Últ. compra, Deuda (en naranja si debe algo) y tres botones de acción. Se muestran 10 clientes por página. Los nombres largos se recortan; el texto completo aparece al pasar el mouse.

Formularios / diálogos

Panel lateral "Nuevo cliente" / "Editar cliente"

Botones: Guardar y Cancelar.

Diálogo "Archivar cliente"

Sin campos. Muestra el nombre entrecomillado y avisa que el cliente dejará de aparecer en los listados pero se conserva su historial. Botones Cancelar y Archivar.

Acciones disponibles

• Nuevo cliente: abre el panel lateral en blanco.
• Ver (ojo, por fila): entra al detalle del cliente (/clientes/{id}).
• Editar (lápiz, por fila): abre el panel lateral con los datos cargados.
• Archivar (por fila, en rojo): pide confirmación y archiva al cliente.
• Chips de filtro: Todos / Inactivos +30d (sin comprar hace más de 30 días o nunca) / Top compradores (los 20 de mayor monto acumulado) / Sin compras.
• Buscador: filtra en pantalla por nombre, cédula o RIF.

Reglas y validaciones

• Nombre obligatorio (validación en el formulario y en el servidor), máx. 255 caracteres.
• Cédula y RIF son únicos por negocio: no podés tener dos clientes con la misma cédula o el mismo RIF. Si se repite, se muestra el error que devuelve el servidor.
• Largos máximos: cédula 32, RIF 32, teléfono 32, dirección 255.
• Al editar, el formulario manda el objeto completo: un campo que borres se guarda vacío.
• Archivar no borra: es un borrado suave (soft delete). El cliente sale de los listados pero se conserva todo su historial de ventas y deudas.
• El filtro Inactivos +30d considera inactivo también al que nunca compró.
• El buscador de esta pantalla filtra sobre lo ya cargado; la búsqueda del servidor alcanza además el teléfono.

Tips de uso

• Cargá RIF en los clientes jurídicos aunque tengas la cédula del dueño: es lo que va a la factura.
• Usá Inactivos +30d una vez al mes: es la lista de a quién llamar.
• La columna Deuda en naranja te muestra de un vistazo a quién no conviene seguir fiándole.
• Antes de archivar, entrá al detalle: si tiene deuda abierta, primero cobrala en Cuentas por cobrar.

Para qué sirve

La ficha completa de un cliente: cuánto te ha comprado, cada cuánto vuelve, cuánto gasta en promedio y qué productos se lleva siempre. Sirve para preparar una visita o una llamada sabiendo con quién estás hablando.

Qué ves al entrar

Arriba, el botón Volver. Luego una tarjeta con el nombre en grande, la cédula y el teléfono debajo, y a la derecha un chip rojo "Deuda $X" si tiene saldo pendiente. Después, cuatro KPIs: Total comprado, # Compras, Ticket promedio y Días sin comprar (en rojo si pasan de 60).

Si el cliente nunca compró, aparece un aviso: "Este cliente aún no tiene compras registradas." Si compró, se ven dos tablas: Historial de compras (Fecha, Total $, Ítems, Pago — las 20 ventas más recientes) y Productos favoritos (Producto, Veces, Total $ — el top 5 por monto).

Formularios / diálogos

No tiene. Es una pantalla de solo consulta; para modificar los datos del cliente hay que volver al listado y usar Editar.

Acciones disponibles

• Volver: regresa a la pantalla anterior (normalmente el listado de clientes).
• No hay acciones que modifiquen datos en esta pantalla.

Reglas y validaciones

• No hay validaciones de entrada: la pantalla solo muestra información.
• Solo se ven clientes del propio negocio; el id de otro negocio responde como si no existiera.
• El ticket promedio es el total comprado dividido entre la cantidad de compras; con cero compras se muestra 0.
• La deuda solo suma las cuentas por cobrar en estado abierto.
• El Historial de compras trae como máximo las 20 ventas más recientes, y Productos favoritos los 5 productos de mayor monto acumulado.
• Días sin comprar queda en guion si el cliente nunca compró.

Tips de uso

• Mirá Días sin comprar antes de llamar: si pasa de 60 y se pone rojo, es un cliente que estás perdiendo.
• Productos favoritos es la mejor guía para ofrecerle algo: es lo que ya sabés que compra.
• El ticket promedio te dice si conviene ofrecerle precio mayorista.
• Si aparece el chip de deuda, resolvela antes de venderle otra vez a crédito.

Para qué sirve

Para pasarle un presupuesto a un cliente antes de venderle. Armás la lista de productos con sus precios, la guardás, y le vas cambiando el estado según qué pasa (enviada, aceptada, rechazada). Si el cliente acepta, la convertís en venta con un clic y no hay que volver a cargar nada.

Qué ves al entrar

Tarjeta "Cotizaciones" con el botón Nueva cotización arriba a la derecha. La tabla trae: #, Cliente, Fecha, Válida hasta, Status (chip de color: borrador gris, enviada azul, aceptada verde, rechazada rojo, vencida naranja), Total $ y un menú de tres puntos por fila. Se muestran 10 por página. Debajo de la tabla aparecen los mensajes de éxito (en verde) o de error (en rojo).

Formularios / diálogos

Diálogo "Nueva cotización"

Datos generales:

Renglones de producto (uno o más):

Se ven en vivo el Subtotal de cada renglón y, abajo a la derecha, Subtotal, IVA y Total. Botones: Agregar renglón, la papelera por renglón, Cancelar y Guardar.

Diálogo "Convertir a venta"

Botones: Cancelar y Convertir.

Acciones disponibles

• Nueva cotización: abre el diálogo con un renglón vacío listo.
• Agregar renglón / papelera: suma o quita productos del presupuesto.
• Menú de tres puntos (por fila), según el estado:
  • Marcar enviada (solo si está en borrador)
  • Marcar aceptada (solo si está enviada)
  • Marcar rechazada (solo si está enviada)
  • Convertir a venta (solo si está aceptada)

Reglas y validaciones

• "Agrega al menos un producto." si ningún renglón tiene producto con cantidad mayor a 0.
• La fecha es obligatoria; Válida hasta debe ser igual o posterior a la fecha.
• Cantidad mínima por renglón: 0,001. Precio y IVA no pueden ser negativos.
• Las notas admiten hasta 1000 caracteres.
• Toda cotización nace en estado borrador.
• Solo se convierten en venta las cotizaciones aceptadas: "Solo se pueden convertir cotizaciones aceptadas."
• Al convertir, la cotización queda en estado aceptada (no cambia a "convertida"), y la venta se crea con el canal detal por defecto, descontando stock como cualquier venta.
• No se puede eliminar una cotización aceptada (pudo haberse convertido en venta): hay que marcarla como rechazada.
• El flujo de estados es en un solo sentido: borrador → enviada → aceptada/rechazada. No hay marcha atrás desde el menú.

Tips de uso

• Poné siempre Válida hasta: con la tasa moviéndose, un presupuesto sin vencimiento es un compromiso abierto.
• Podés pisar el precio de cualquier renglón: sirve para descuentos puntuales sin tocar la lista de precios.
• No conviertas a venta hasta tener el pago acordado: la conversión descuenta stock de una vez.
• Si una cotización quedó vieja, marcala rechazada en vez de intentar borrarla.

Para qué sirve

Para documentar el despacho de una venta: a qué dirección va, en qué estado está el envío y con qué papel viaja la mercancía. Se genera a partir de una venta ya registrada y se le va avanzando el estado hasta que se entrega.

Qué ves al entrar

Tarjeta "Notas de Entrega" con el botón Nueva nota a la derecha. La tabla trae: #, Venta #, Cliente, Fecha, Dirección, Estado (chip: Pendiente naranja, En camino azul, Entregada verde) y dos botones de acción. Se muestran 25 notas por página.

Formularios / diálogos

Diálogo "Nueva nota de entrega"

Botones: Cancelar y Crear.

Acciones disponibles

• Nueva nota: abre el diálogo y carga la lista de ventas disponibles.
• Flecha (por fila): avanza el estado al siguiente paso — de Pendiente a En camino, y de En camino a Entregada. Desaparece cuando ya está entregada.
• Descargar PDF (por fila): abre la nota de entrega en PDF en una pestaña nueva.

Reglas y validaciones

• "Selecciona una venta." si intentás crear la nota sin elegirla; el servidor también la exige y la venta debe pertenecer a tu negocio.
• La fecha es obligatoria y debe ser válida.
• Dirección máx. 255 caracteres; observaciones máx. 1000.
• Toda nota nace en estado pendiente.
• Los estados válidos son solo tres: pendiente, en_camino, entregada, y se avanzan en orden, sin retroceso desde la interfaz.
• El listado muestra como máximo las 100 notas más recientes.

Tips de uso

• Cargá la nota al momento de despachar, no al final del día: el estado es lo que te dice qué quedó en la calle.
• La dirección de entrega conviene escribirla completa con puntos de referencia: el PDF es lo que lleva el repartidor.
• Si una venta se despacha en dos viajes, creá dos notas sobre la misma venta.
• Marcá Entregada solo cuando tengas el papel firmado de vuelta.

Para qué sirve

Es la lista de lo que te deben: cada venta a crédito abre una cuenta con su saldo. Desde acá registrás los abonos que te van pagando, en dólares, y el sistema calcula automáticamente cuánto es en bolívares con la tasa del día. Cuando el saldo llega a cero, la cuenta se marca como pagada sola.

Qué ves al entrar

Una barra superior con el título "Cuentas por cobrar", un chip naranja con el Total por cobrar (la suma de todos los saldos abiertos) y, si no hay tasa cargada, un chip rojo "Sin tasa del día". La tabla trae: Cliente, Cédula, Original (el monto con que nació la deuda), Balance (lo que falta, en negrita), Estado (chip naranja "Abierta" o verde "Pagada") y el botón Abonar en las abiertas. Se muestran 10 cuentas por página.

Formularios / diálogos

Diálogo "Registrar abono"

Arriba muestra el nombre del cliente y el balance actual.

Debajo, un aviso azul con la conversión: "Cobras en Bs (tasa X): Bs Y". Botones: Pagar todo (rellena el monto con el saldo completo) y Registrar abono.

Acciones disponibles

• Abonar (por fila): abre el diálogo de abono. Solo aparece en cuentas abiertas y queda deshabilitado si no hay tasa del día.
• Pagar todo: carga el saldo completo en el campo del monto.
• Registrar abono: guarda el pago, descuenta del saldo y recarga el listado.

Reglas y validaciones

• Sin tasa del día no se puede abonar: el botón queda deshabilitado y el servidor responde "No hay tasa de cambio para hoy."
• El monto debe ser mayor a 0 y no puede exceder el balance: "El abono debe ser mayor a 0 y no exceder el balance."
• No se puede abonar sobre una deuda ya pagada: "La deuda ya está pagada."
• El método de pago es obligatorio y debe pertenecer al negocio. La lista excluye los métodos a crédito: no se puede pagar una deuda con otra deuda.
• Cuando el saldo llega a 0, la cuenta pasa automáticamente a estado pagada.
• Cada abono guarda la tasa usada y el equivalente en bolívares en el momento del cobro.
• El Total por cobrar del chip suma únicamente las cuentas abiertas.

Tips de uso

• Fijá la tasa del día antes de empezar a cobrar: sin ella la pantalla queda bloqueada.
• Registrá el abono el mismo día que te pagan: la tasa que se guarda es la del día del cobro, y cargarlo tarde distorsiona el equivalente en bolívares.
• Pagar todo es el atajo para el cliente que salda de una: evita errores de tipeo en el monto.
• Los abonos también entran al cuadre de caja, así que el método que elijas debe ser el real, no el que tengas a mano en la lista.

Para qué sirve

Es el catálogo de todo lo que vendés: acá se registran los artículos con su precio, costo, IVA, stock y ubicación en el depósito. Desde esta pantalla creás productos uno por uno, los cargás en masa desde un Excel, imprimís etiquetas de código de barras y sacás de circulación lo que ya no manejás. Es la base de la que toman datos el punto de venta, las compras y los reportes.

Qué ves al entrar

• Una tarjeta titulada Productos.
• Barra superior: un campo de búsqueda "Buscar producto…" (máx. 280 px de ancho) y, alineados a la derecha:
  • Imprimir etiquetas (N) — solo aparece cuando tenés al menos un producto tildado.
  • Importar Excel — solo si tu usuario tiene permiso de gestión sobre productos.
  • Nuevo producto — solo si tenés permiso de gestión.
• No hay KPIs ni tarjetas de resumen en esta pantalla.
• Tabla con casillas de selección (columna de selección a la izquierda) y 10 filas por página. Columnas:

• La búsqueda dispara una recarga contra el servidor cada vez que cambia el texto; no filtra solo lo que ya está en pantalla.
• Si llegás desde el buscador global con ?q=…, el término entra ya cargado en el campo de búsqueda.

Formularios / diálogos

Nuevo producto / Editar producto (panel lateral)

Variantes (dentro del mismo panel, solo rubro moda y con el interruptor encendido)

Cada renglón de variante trae un botón rojo de papelera para quitarlo, y abajo un botón Agregar variante.

Unidades de venta (bloque del panel, solo al editar un producto existente)

Muestra primero una tabla con las unidades ya cargadas (Nombre, Factor, Código, Precio $ y un botón de papelera por fila) o el texto "Sin unidades adicionales". El botón Agregar unidad abre este mini formulario:

Importar productos desde Excel (diálogo)

El diálogo trae además un botón Descargar plantilla que baja un .xlsx de ejemplo ya con encabezados y una fila modelo.

Eliminar producto (diálogo de confirmación)

Sin campos. Texto: "¿Eliminar ? Si tiene ventas o movimientos asociados, se desactivará en lugar de eliminarse." Botones Cancelar y Eliminar.

Acciones disponibles

Globales (barra superior):

• Buscar producto… — busca contra el servidor por nombre, referencia, código interno, código de barras, marca y códigos equivalentes; ignora acentos y mayúsculas; acepta varias palabras en cualquier orden.
• Imprimir etiquetas (N) — abre en otra pestaña la hoja de etiquetas con los productos tildados.
• Importar Excel — abre el diálogo de carga masiva.
• Nuevo producto — abre el panel lateral vacío.
• Descargar plantilla (dentro del diálogo de importación) — baja plantilla-productos.xlsx.

Por fila:

• Casilla de selección — marca el producto para imprimir etiquetas.
• Lápiz (editar) — abre el panel lateral con los datos cargados, más el bloque de Unidades de venta.
• Papelera (eliminar) — pide confirmación y luego elimina o desactiva.

Dentro del panel:

• Guardar — valida y envía; si falla la validación no cierra.
• Cancelar — cierra el panel sin guardar.
• Agregar variante / papelera por variante.
• Agregar unidad / Guardar / Cancelar en unidades; papelera por unidad ya guardada (borra al instante, sin confirmación).

Reglas y validaciones

• Nombre es obligatorio al crear y no puede pasar de 255 caracteres.
• Precio $ es obligatorio al crear y no puede ser negativo.
• Costo, precio mayor, precio distribuidor, stock y stock mínimo aceptan solo números iguales o mayores a cero.
• IVA solo admite 0, 8 o 16.
• La imagen debe ser un archivo de imagen y pesar como máximo 2 MB. Al reemplazarla, la anterior se borra del servidor.
• El código interno (codigo) es único dentro de tu negocio: no podés tener dos productos con el mismo.
• La categoría elegida tiene que pertenecer a tu negocio.
• Talla máx. 20 caracteres, color máx. 40, código de barras de variante máx. 64.
• Unidades de venta: nombre obligatorio (máx. 50), factor obligatorio y mayor a 0,001.
• Eliminar: si el producto tiene ventas o movimientos asociados, el sistema no lo borra, lo desactiva y te avisa con un mensaje naranja. Si no tiene movimientos, lo borra de verdad junto con la imagen local.
• Importación: si alguna fila trae errores, no se importa nada; te muestra una tabla con el número de fila y el error para que corrijas y vuelvas a subir.
• Los botones de importar, crear y editar solo aparecen si tu rol tiene permiso de gestión sobre productos. Ver la pantalla requiere permiso de lectura.
• La impresión de etiquetas admite hasta 200 productos por tanda.

Tips de uso

• Buscá por número de parte o referencia, no solo por nombre: el buscador revisa referencia OEM, código interno, código de barras, marca y códigos equivalentes en una sola pasada.
• Podés escribir varias palabras sueltas ("val bosch") y va a encontrar "Válvula Bosch Delantera" sin importar el orden.
• Antes de importar por primera vez, bajá la plantilla y llenala encima: así los encabezados coinciden exactamente y evitás el rechazo del archivo entero.
• Si un producto ya se vendió alguna vez, no insistas con eliminarlo: desactivalo y desaparece del catálogo de venta sin romper el historial.

Para qué sirve

Es la hoja de impresión de etiquetas de estantería. No se entra a mano: se abre sola en una pestaña nueva cuando tildás productos en el catálogo y tocás "Imprimir etiquetas". Muestra una grilla lista para mandar a la impresora con el nombre, el código de barras y el precio de cada artículo seleccionado.

Qué ves al entrar

Primero el texto "Cargando...". Apenas responde el servidor aparece una grilla de tarjetas de etiqueta, tres por fila en pantalla ancha y dos en pantallas de menos de 600 px. Cada tarjeta muestra, en este orden:

• Nombre del producto en negrita y en una sola línea (si es largo se corta con puntos suspensivos).
• Código de barras en tipografía monoespaciada con espaciado ancho; si el producto no tiene código, muestra ---.
• Precio en dólares, en negrita y en el tamaño más grande de la tarjeta.

No hay barra superior, ni filtros, ni botones: la ventana de impresión del navegador se abre sola medio segundo después de que termine de dibujarse la hoja.

Formularios / diálogos

Esta pantalla no tiene formularios ni diálogos propios. La única entrada es el parámetro ids de la dirección, que arma el catálogo al tildar productos.

Acciones disponibles

• Impresión automática — se dispara sola al terminar de cargar; no hay botón que apretar.
• Si cancelás el diálogo de impresión, podés volver a lanzarlo con el atajo de imprimir del navegador (Ctrl+P).
• Cerrar la pestaña te devuelve al catálogo, que quedó abierto detrás con la selección intacta.

Reglas y validaciones

• Si la dirección no trae ningún id, la pantalla se queda en "Cargando..." y no muestra nada.
• El servidor descarta cualquier valor que no sea un número entero y elimina repetidos.
• Se imprimen como máximo 200 etiquetas por tanda.
• Solo trae productos de tu propio negocio.
• En impresión, cada etiqueta lleva borde negro sólido y no se parte entre dos hojas.

Tips de uso

• Antes de imprimir, configurá en el navegador el tamaño de papel y desactivá encabezados y pies de página: la grilla está calculada para aprovechar la hoja completa.
• Si vas a etiquetar todo un estante, primero filtrá en el catálogo y después tildá: la selección se mantiene mientras no cambies de página de la tabla.
• Los productos sin código de barras salen con ---; conviene cargarles el código antes de imprimir la tanda.

Para qué sirve

Es la libreta de a quién le comprás. Acá registrás a cada proveedor con su nombre, RIF y teléfono, y de un vistazo ves cuánto le debés en total. Los proveedores que cargues acá son los que después vas a poder elegir al registrar una compra o una orden de compra.

Qué ves al entrar

• Tarjeta titulada Proveedores.
• Barra superior: campo de búsqueda "Buscar por nombre o RIF…" (máx. 300 px) y, a la derecha, el botón Nuevo proveedor.
• Si algo falla al guardar, aparece una alerta roja entre la barra y la tabla.
• Tabla de 10 filas por página, sin selección múltiple, con las columnas:

• La búsqueda filtra en el navegador sobre lo ya cargado (no recarga del servidor): compara el nombre sin distinguir mayúsculas y el RIF por coincidencia de texto.

Formularios / diálogos

Nuevo proveedor / Editar proveedor (panel lateral)

Botones: Guardar y Cancelar.

Acciones disponibles

Globales:

• Buscar por nombre o RIF… — filtra la lista en pantalla mientras escribís.
• Nuevo proveedor — abre el panel lateral vacío.

Por fila:

• Lápiz (editar) — abre el panel lateral con los datos del proveedor cargados.

Dentro del panel:

• Guardar — valida y envía; al terminar cierra el panel y recarga la lista.
• Cancelar — cierra sin guardar.

No hay acción de eliminar proveedores desde esta pantalla.

Reglas y validaciones

• Nombre es obligatorio; máximo 255 caracteres.
• RIF no puede repetirse entre proveedores del mismo negocio. Si intentás guardar uno duplicado, aparece la alerta roja con el mensaje del servidor; al editar, el RIF propio del proveedor no cuenta como duplicado.
• RIF y teléfono admiten hasta 32 caracteres cada uno.
• Toda la pantalla exige permiso de gestión sobre proveedores: si tu rol no lo tiene, no la ves.
• La Deuda total es de solo lectura: se arma sola con las compras a crédito y sus abonos, no se edita acá.

Tips de uso

• Cargá el RIF apenas des de alta al proveedor: es el dato que te va a hacer falta cuando armes el libro de compras y ya no vas a tener que volver a buscarlo.
• Si un proveedor te aparece en naranja en la columna de deuda, es que tenés cuentas por pagar abiertas con él: revisá compras a crédito antes de hacerle un pedido nuevo.
• Como la búsqueda trabaja sobre lo ya cargado, es instantánea: escribí dos o tres letras del nombre y listo.

Para qué sirve

Acá cargás la mercancía que te llegó y ya pagaste o quedaste debiendo. Al registrar la compra, el sistema suma automáticamente el stock de cada producto y recalcula su costo promedio; si la marcás a crédito, además te abre sola la cuenta por pagar al proveedor. Es la pantalla que usás con la factura del proveedor en la mano.

Qué ves al entrar

La pantalla se divide en dos columnas.

Izquierda — "Nueva compra" (ocupa 7 de 12 columnas en pantalla ancha):

• En el encabezado, un chip que muestra Tasa: en azul si hay tasa del día cargada, o Sin tasa en rojo si no la hay.
• Selector de Proveedor.
• Tabla de renglones con las columnas: Producto, Cant. (90 px), Costo $ (110 px), Total (alineado a la derecha, calculado solo) y una columna con la papelera. Arranca con un renglón vacío.
• Botón Agregar renglón.
• Línea de Total general en tamaño grande, con la suma de todos los renglones redondeada a dos decimales.
• Interruptor A crédito (cuenta por pagar).
• Selector de Método de pago — solo visible cuando el interruptor de crédito está apagado; la lista excluye los métodos que sean de tipo crédito.
• Botón ancho verde Registrar compra.
• Debajo, un mensaje de resultado: verde si dice "¡Compra registrada!", rojo en cualquier otro caso.

Derecha — "Compras recientes" (5 de 12 columnas): tabla de 8 filas por página con las columnas Fecha (solo la parte de fecha, sin hora), Proveedor, Total en dólares y Pago, esta última como chip verde Contado o naranja Crédito.

Formularios / diálogos

Nueva compra (formulario embebido en la tarjeta izquierda)

No hay diálogos emergentes en esta pantalla: el formulario está siempre a la vista.

Acciones disponibles

• Agregar renglón — suma una línea vacía con cantidad 1 y costo 0.
• Papelera por renglón — quita esa línea de la compra.
• A crédito — al encenderlo desaparece el selector de método de pago y la compra queda como cuenta por pagar.
• Registrar compra — valida, envía y, si sale bien, limpia el proveedor, deja un solo renglón vacío, apaga el crédito y recarga las listas.
• La tabla de la derecha se refresca sola después de cada compra registrada.

Reglas y validaciones

• Sin proveedor no se registra nada: "Selecciona un proveedor."
• Hace falta al menos un renglón con producto elegido y cantidad mayor a cero: "Agrega al menos un renglón con producto y cantidad."
• Sin tasa del día no se puede comprar: "Fija la tasa del día antes de comprar." El servidor también lo verifica y responde "No hay tasa de cambio para hoy."
• Cantidad tiene que ser mayor a cero; el costo unitario puede ser cero pero nunca negativo.
• El proveedor, el método de pago y cada producto tienen que pertenecer a tu negocio.
• Al registrar, el sistema suma el stock de cada producto y recalcula el costo promedio ponderado mezclando el stock previo con la entrada nueva.
• La compra guarda la tasa usada y el total en bolívares al momento del registro.
• Si no elegiste método de pago (modo crédito), se crea automáticamente una cuenta por pagar al proveedor por el total, con estado abierto.
• Los renglones que quedan sin producto o con cantidad cero simplemente se ignoran, no bloquean el registro.
• Toda la pantalla exige permiso de gestión sobre compras.

Tips de uso

• Cargá la tasa del día antes de sentarte a registrar compras: si no, el botón te va a rebotar cada intento.
• El costo que escribís acá es el que después se promedia contra el stock que ya tenías, así que poné el costo real de esa entrada y no el costo viejo del producto.
• Si te llegó mercancía sin factura pagada, marcá "A crédito": el sistema te abre la cuenta por pagar sola y no tenés que cargarla aparte.
• Podés dejar renglones vacíos de más; se descartan al registrar y no molestan.

Para qué sirve

Es el pedido formal que le mandás al proveedor antes de que llegue la mercancía. Armás la lista de lo que querés, la dejás en borrador, la marcás como enviada cuando la despachás, y recién cuando el pedido llega físicamente le das "Recibir": ahí el sistema suma el stock. Sirve para no perderle el rastro a lo que está pedido y todavía no entró.

Qué ves al entrar

• Tarjeta titulada Órdenes de Compra con el botón Nueva orden en el encabezado.
• Tabla de 10 filas por página con las columnas:

• Las órdenes vienen ordenadas por fecha, de la más reciente a la más vieja.
• Debajo de la tabla aparece un mensaje centrado: verde cuando dice "Orden recibida y stock actualizado", rojo para cualquier error.

Formularios / diálogos

Nueva orden de compra (diálogo, no se cierra tocando afuera)

Botones: Cancelar y Guardar. También hay Agregar renglón dentro del diálogo y una papelera por cada línea.

Acciones disponibles

Globales:

• Nueva orden — abre el diálogo con la fecha de hoy y un renglón vacío.

Por fila (menú de tres puntos, las opciones cambian según el estado):

• Marcar enviada — solo si la orden está en borrador. La pasa a "enviada".
• Recibir (actualizar stock) — solo si la orden está enviada. La pasa a "recibida" y suma al stock la cantidad de cada renglón.
• Cancelar — disponible mientras la orden no esté ya recibida ni cancelada.

Dentro del diálogo:

• Agregar renglón, papelera por renglón, Guardar y Cancelar.

Reglas y validaciones

• Hace falta al menos un renglón con producto y cantidad mayor a cero: "Agrega al menos un producto."
• La fecha es obligatoria y tiene que ser una fecha válida.
• La cantidad de cada renglón tiene que ser al menos 0,001; el precio no puede ser negativo.
• Las notas admiten hasta 1000 caracteres.
• Proveedor y productos tienen que pertenecer a tu negocio.
• Toda orden nueva nace en estado borrador.
• No se puede marcar una orden como "recibida" a mano: el sistema lo rechaza con el mensaje "Para marcar la orden como recibida usá la recepción (/receive), que suma el stock". La única vía es la opción "Recibir".
• No se puede recibir una orden ya recibida ("Esta orden ya fue recibida") ni una cancelada ("No se puede recibir una orden cancelada").
• No se puede eliminar una orden ya recibida, porque su stock ya entró al inventario.
• El total de la orden se calcula del lado del servidor sumando cantidad × precio de cada renglón; el IVA se guarda en cero.
• Toda la pantalla exige permiso de gestión sobre compras.

Tips de uso

• Dejá la orden en borrador mientras negociás precios: recién marcala como enviada cuando el pedido salió de verdad, así el estado te sirve de seguimiento real.
• El precio de cada renglón se autocompleta con el costo actual del producto: cambialo si el proveedor te pasó otro y así la orden refleja lo acordado.
• No uses "Recibir" hasta que la mercancía esté físicamente en el depósito: esa acción suma stock y no tiene marcha atrás.
• Si un pedido se cayó, cancelalo en vez de borrarlo: queda el registro de que se pidió y no se concretó.

Para qué sirve

Acá registrás cada local o punto de venta del negocio, con su dirección y teléfono. Cada sucursal que creás nace con un almacén "Principal" automático, así que desde el arranque podés manejarle stock propio. Sirve para saber qué tenés en cada local y para poder mover mercancía entre ellos.

Qué ves al entrar

• Tarjeta titulada Sucursales con el botón Nueva sucursal alineado a la derecha.
• Tabla de 10 filas por página, con flecha de expansión en cada fila. Columnas:

• Las sucursales vienen ordenadas con la principal primero y el resto alfabéticamente.
• Al desplegar una fila (flecha de expansión) se listan sus almacenes, cada uno con un ícono de depósito, el nombre y un chip verde Activo o gris Inactivo.

Formularios / diálogos

Nueva sucursal / Editar sucursal (diálogo)

Botones: Cancelar y Guardar.

Acciones disponibles

Globales:

• Nueva sucursal — abre el diálogo vacío.

Por fila:

• Flecha de expansión — despliega la lista de almacenes de esa sucursal.
• Lápiz (editar) — abre el diálogo con los datos cargados.
• Ojo tachado / Ojo (activar-desactivar) — invierte el estado de la sucursal al instante, sin confirmación. No aparece en la sucursal principal.

Reglas y validaciones

• Nombre es obligatorio (máximo 255 caracteres); el botón Guardar permanece deshabilitado mientras esté vacío.
• Dirección hasta 500 caracteres, teléfono hasta 50.
• Al crear una sucursal, el sistema le crea automáticamente un almacén llamado "Principal" y activo.
• Toda sucursal nueva nace activa y no principal: la marca de principal no se asigna desde esta pantalla.
• La sucursal principal no se puede desactivar: el botón directamente no se muestra en esa fila.
• No hay acción de eliminar sucursales; lo más cerca es desactivarlas.
• Solo se ven y editan sucursales de tu propio negocio.
• Ver la pantalla exige permiso de lectura sobre productos.

Tips de uso

• Antes de configurar almacenes o transferencias, creá primero todas tus sucursales: el almacén siempre cuelga de una.
• Usá el despliegue de la fila para chequear de un vistazo cuántos depósitos tiene cada local sin ir a la pantalla de Almacenes.
• Si cerrás un local temporalmente, desactivalo en vez de borrarlo: conservás todo el histórico de movimientos.
• El nombre es lo único que necesitás para dar de alta; la dirección y el teléfono podés completarlos después.

Para qué sirve

Un almacén es cada depósito físico donde guardás mercancía dentro de una sucursal: el depósito de atrás, el mostrador, la bodega alterna. Acá los creás, los asignás a una sucursal y ves cuántos productos distintos tiene cada uno en existencia. Es la base para las transferencias de stock y para el mapa de ubicaciones.

Qué ves al entrar

• Tarjeta titulada Almacenes con el botón Nuevo almacén alineado a la derecha.
• Tabla de 10 filas por página con las columnas:

• Los almacenes vienen ordenados alfabéticamente por nombre.

Formularios / diálogos

Nuevo almacén / Editar almacén (diálogo)

Botones: Cancelar y Guardar.

Acciones disponibles

Globales:

• Nuevo almacén — abre el diálogo vacío.

Por fila:

• Lápiz (editar) — abre el diálogo con el nombre y la sucursal cargados.
• Ojo tachado / Ojo (activar-desactivar) — invierte el estado del almacén al instante, sin confirmación. A diferencia de Sucursales, acá todos los almacenes tienen este botón.

Reglas y validaciones

• Nombre obligatorio, máximo 255 caracteres.
• Sucursal obligatoria y tiene que pertenecer a tu negocio.
• El botón Guardar sigue deshabilitado hasta que ambos campos estén llenos.
• Todo almacén nuevo nace activo.
• No existe acción de eliminar almacenes: solo se desactivan.
• El contador de "Productos en stock" es de solo lectura; lo arma el sistema con las filas de existencias del almacén.
• Ver la pantalla exige permiso de lectura sobre productos.

Tips de uso

• Creá un almacén por cada lugar físico real donde de verdad separás mercancía: si mezclás todo en uno, las transferencias pierden sentido.
• Recordá que cada sucursal ya viene con un almacén "Principal" creado solo: no lo dupliques, renombralo si querés otro nombre.
• Antes de desactivar un almacén, revisá la columna "Productos en stock": si tiene existencias, primero transferilas a otro depósito.
• Si moviste un almacén de sucursal, revisá también las transferencias pendientes para que no queden apuntando al local equivocado.

Para qué sirve

Sirve para mover mercancía de un almacén a otro y que el sistema lo descuente de un lado y lo sume del otro en un solo paso. Es lo que usás cuando le mandás producto de la bodega al mostrador, o de una sucursal a otra. Cada movimiento queda registrado con la fecha y el usuario que lo hizo.

Qué ves al entrar

• Tarjeta titulada Transferencias de Stock con el botón Nueva transferencia a la derecha.
• Tabla de 10 filas por página con las columnas:

• Las transferencias vienen ordenadas de la más reciente a la más vieja.
• No hay acciones por fila: la lista es solo de consulta.

Formularios / diálogos

Nueva transferencia (diálogo)

Botones: Cancelar y Transferir. Dentro del diálogo hay también Agregar producto y una papelera por renglón.

Acciones disponibles

Globales:

• Nueva transferencia — abre el diálogo con los dos almacenes vacíos y un renglón inicial.

Dentro del diálogo:

• Agregar producto — suma un renglón con cantidad 1.
• Papelera por renglón — quita esa línea. Solo aparece si hay más de un renglón: el último no se puede borrar.
• Transferir — valida, envía el movimiento y recarga la lista.
• Cancelar — cierra sin guardar.

Reglas y validaciones

• Origen y destino son obligatorios y tienen que ser distintos: la propia lista de destino ya excluye el origen, y el servidor lo verifica igual.
• Ambos almacenes tienen que pertenecer a tu negocio.
• Hace falta al menos un renglón con producto y cantidad mayor a cero; si no hay ninguno válido, el botón no hace nada.
• Cada cantidad tiene que ser al menos 0,001.
• Control de existencias antes de mover: el sistema verifica que el almacén origen tenga stock suficiente de cada producto antes de tocar nada. Si falta, rechaza toda la transferencia con un mensaje del tipo "Stock insuficiente en el almacén origen: disponible X, solicitado Y".
• El movimiento se hace en bloque: o entran todos los renglones o no entra ninguno. Las filas de stock se bloquean durante la operación para evitar que dos personas muevan lo mismo al mismo tiempo.
• Si el producto no existía en el almacén destino, se le crea la fila de existencias en cero y después se le suma.
• Toda transferencia queda con estado completada y con la fecha y hora del momento.
• Las transferencias no se editan ni se eliminan desde esta pantalla.
• Las notas admiten hasta 1000 caracteres.
• Ver la pantalla exige permiso de lectura sobre productos.

Tips de uso

• Revisá el stock del almacén origen en la pantalla de Ubicaciones antes de armar la transferencia: si un solo renglón no alcanza, se cae toda la operación.
• Agrupá en una sola transferencia todo lo que va del mismo origen al mismo destino: queda un registro más limpio que diez movimientos sueltos.
• Usá el campo Notas para dejar el motivo ("reposición mostrador", "traslado por inventario"): es lo único que te va a explicar el movimiento dentro de seis meses.
• Como no se pueden anular, revisá bien cantidades antes de tocar "Transferir"; para corregir un error hay que hacer la transferencia inversa.

Para qué sirve

Es el mapa de dónde está físicamente cada cosa dentro del depósito: en qué estante, en qué nivel, en qué zona. Sirve para que quien va a buscar una pieza sepa exactamente a qué anaquel ir, en vez de recorrer todo el almacén. Desde acá también asignás o corregís la ubicación de cualquier producto.

Qué ves al entrar

La pantalla se divide en dos paneles.

Izquierda — "Estantes" (4 de 12 columnas en pantalla ancha):

• Un selector de Almacén — solo aparece si tenés más de un almacén; si tenés uno solo, se elige solo.
• Bloque Zonas: chips con las zonas en uso; el chip de la zona filtrada se pinta de azul.
• Alerta naranja cuando hay productos sin ubicar: "N productos sin ubicación asignada." con un enlace subrayado Verlos.
• Leyenda con la cantidad de ubicaciones en uso.
• Lista desplazable (máximo 420 px de alto) con cada ubicación y, a la derecha de cada una, la cantidad de productos que tiene. La ubicación actualmente filtrada queda resaltada.

Derecha — Contenido (8 de 12 columnas). El título cambia solo según lo que estés viendo:

• "Productos sin ubicación" si tenés el filtro de sin ubicar activo.
• "Contenido de " si hay un término de búsqueda.
• "Todo el almacén" si no hay filtro.

Barra de filtros:

• Campo de búsqueda con lupa: "Estante o zona: E-28, E-28-F, MOSTRADOR…" (se puede limpiar, muestra indicador de carga mientras consulta).
• Interruptor Solo con stock.
• Interruptor Sin ubicar.

Tabla de 15 filas por página con las columnas:

Cuando no hay resultados: "Nada en «<término>»." o "Sin existencias en este almacén."

Formularios / diálogos

Ubicar <nombre del producto> (diálogo)

Debajo del campo, una nota explica el formato y avisa que se guarda normalizada. Si lo que escribiste va a cambiar al guardarse, aparece una alerta azul: "Se guardará como <ubicación normalizada>" — por ejemplo, E-7-c se muestra como E-07-C. Esta vista previa se calcula sola mientras escribís.

Botones: Cancelar y Guardar.

Acciones disponibles

Panel izquierdo:

• Selector de almacén — cambia el mapa y el contenido completo.
• Chip de zona — filtra el contenido por esa zona y apaga el filtro de "sin ubicar".
• Enlace "Verlos" de la alerta naranja — limpia la búsqueda y muestra solo los productos sin ubicar.
• Ítem de la lista de ubicaciones — filtra el contenido por esa ubicación exacta.

Panel derecho:

• Campo de búsqueda — busca por ubicación completa (E-28-F), por estante (E-28) o por zona (EXHIBIDOR). Espera 300 ms después de que dejás de escribir antes de consultar, y apaga el filtro de "sin ubicar".
• Solo con stock — deja fuera los productos con existencias en cero.
• Sin ubicar — muestra únicamente lo que no tiene ubicación asignada.
• Lápiz por fila — abre el diálogo de asignación. Solo aparece si tenés permiso de gestión sobre productos.

En el diálogo:

• Guardar — asigna o corrige la ubicación y refresca tanto el mapa de la izquierda como la tabla.
• Cancelar — cierra sin tocar nada.

Reglas y validaciones

• La ubicación admite hasta 30 caracteres y se puede dejar vacía (eso quita la ubicación del producto).
• El servidor normaliza siempre lo que escribas: pasa a mayúsculas y rellena los números a dos dígitos (E-7-c queda E-07-C). La vista previa te muestra el resultado antes de guardar.
• El producto tiene que pertenecer a tu negocio y el almacén también; si no, el sistema devuelve "no encontrado".
• Si el producto todavía no tenía fila de existencias en ese almacén, se le crea con stock en cero al asignarle la ubicación.
• La ubicación vive por almacén, no por producto: el mismo artículo puede tener un estante distinto en cada depósito, y por eso en el catálogo de Productos podés ver más de un chip de estante en la misma fila.
• El listado siempre viene ordenado por el recorrido físico del depósito (orden de picking), con desempate por identificador para que al paginar no se repitan ni se salteen filas.
• Ver la pantalla exige permiso de lectura sobre productos; asignar ubicaciones exige permiso de gestión.
• Si llegás desde el buscador global con ?q=<estante>, la pantalla abre directamente en el contenido de esa ubicación.

Tips de uso

• Usá el formato zona-estante-nivel de manera consistente desde el arranque (E-28-F): así el orden de la lista coincide con el recorrido real del depósito y armás las tandas de picking sin volver sobre tus pasos.
• Cuando termines de ubicar un lote, prendé "Sin ubicar" para ver qué te falta: la alerta naranja de la izquierda te dice el total pendiente de un vistazo.
• No te pelees con mayúsculas ni con ceros a la izquierda: escribí como te salga y mirá la alerta azul, que te muestra exactamente cómo va a quedar guardado.
• Para zonas sueltas que no son estantes (mostrador, vitrina, exhibidor) usá un nombre solo, sin guiones: quedan agrupadas como zona y se filtran con un clic en el chip.

Para qué sirve

Es donde registrás todo lo que tu negocio paga: alquiler, luz, sueldos, compras de limpieza, fletes, etc. Separa los gastos fijos (los que se repiten todos los meses, como el alquiler) de los variables (los que salen una sola vez). Así sabés cuánta plata se te va cada mes y qué pagos te quedan pendientes.

Qué ves al entrar

La pantalla tiene dos bloques apilados.

Bloque 1 — Gastos (arriba):

• Título "Gastos" y un selector de tipo a la izquierda con las opciones: Todos, Fijos, Variables. Filtra la tabla en el momento (no recarga del servidor).
• A la derecha, un chip rojo "Sin tasa del día" que solo aparece cuando el negocio no tiene cargada la tasa de cambio de hoy.
• Botón Agregar gasto (ícono +). Queda deshabilitado si no hay tasa del día.
• Tabla con 10 filas por página y columnas: Fecha, Nombre, Tipo (chip azul "fijo" / gris "variable"), Monto $, Estado (chip verde "pagado" / naranja "pendiente") y una columna final sin título para las acciones.

Bloque 2 — Gastos fijos (plantillas) (abajo):

• Título "Gastos fijos (plantillas)" y botón Nuevo gasto fijo (ícono +).
• Tabla de 10 filas por página con columnas: Nombre, Categoría, Monto $, Día pago, Activa (chip verde "Sí" / gris "No") y columna de acciones con un ícono de lápiz.

Formularios / diálogos

Diálogo "Agregar gasto" (gasto variable)

Botón: Guardar gasto (verde, ancho completo, con indicador de carga).

Diálogo "Pagar gasto" (para gastos pendientes)

Arriba muestra el nombre del gasto y su monto en dólares como texto fijo (no editable).

Además muestra un aviso azul informativo: "Pagas Bs X (tasa Y)", calculado como monto en dólares × tasa del día. Es solo informativo, no se edita.

Botón: Registrar pago (verde, ancho completo).

Panel lateral "Nuevo gasto fijo" / "Editar gasto fijo"

Se abre desde la derecha (pantalla completa en celular, 400 px en escritorio).

Botones: Guardar y Cancelar (rojo).

Acciones disponibles

Globales:

• Filtro de tipo (Todos / Fijos / Variables): filtra la tabla de gastos.
• Agregar gasto: abre el diálogo para cargar un gasto variable ya pagado.
• Nuevo gasto fijo: abre el panel lateral para crear una plantilla recurrente.

Por fila (tabla de gastos):

• Pagar: solo aparece en gastos con estado pendiente. Abre el diálogo de pago. Se deshabilita si no hay tasa del día.

Por fila (tabla de plantillas):

• Ícono de lápiz (editar): abre el panel lateral cargado con los datos de esa plantilla para modificarla.

Reglas y validaciones

• Sin tasa del día no se puede registrar nada. El botón "Agregar gasto" y los botones "Pagar" quedan bloqueados, y el sistema responde "No hay tasa de cambio para hoy." si igual se intenta.
• El formulario de gasto variable exige nombre y monto mayor a 0 antes de enviar; si falta algo muestra "Nombre y monto requeridos."
• En el servidor: nombre obligatorio (máx. 255), categoría opcional (máx. 255), monto numérico mayor a 0, y el método de pago debe pertenecer a tu negocio.
• Un gasto variable se guarda directamente como "pagado" — no queda pendiente.
• Los gastos fijos se crean como "pendientes" a partir de las plantillas, con la fecha del día de pago configurado.
• Al pagar se congela la tasa usada y se calcula el monto en bolívares en ese momento.
• Un gasto ya pagado no se puede volver a pagar: el sistema responde "El gasto ya está pagado."
• El día de pago está limitado a 1–28 tanto en el formulario como en el servidor.
• Los métodos de pago de tipo crédito no aparecen en ninguno de los selectores de esta pantalla.

Tips de uso

1. Cargá primero la tasa del día; sin ella la pantalla queda prácticamente de solo lectura.
2. Usá plantillas de gasto fijo para todo lo que se repite mes a mes: se generan solas como pendientes y las vas pagando desde la tabla de arriba.
3. Poné siempre una categoría consistente (misma palabra, mismo criterio): después el Resumen Financiero y la Contabilidad te lo agradecen.
4. Si un gasto fijo dejó de existir (cambiaste de local, cancelaste un servicio), no lo borres: apagá el interruptor Activa y conservás el historial.

Para qué sirve

Lleva la cuenta de lo que le debés a tus proveedores. Cada deuda muestra cuánto era originalmente y cuánto te falta por pagar, y te permite ir abonando de a poco hasta saldarla. Es la forma de no perder de vista a quién le debés y cuánto.

Qué ves al entrar

• Título "Cuentas por pagar" con un chip naranja "Total por pagar: $X" que suma el balance de todas las deudas abiertas (redondeado a 2 decimales).
• A la derecha, un chip rojo "Sin tasa del día" cuando no hay tasa cargada.
• Tabla de 10 filas por página con columnas: Proveedor (nombre del proveedor, o "—" si no tiene), Original (monto inicial de la deuda en $), Balance (lo que falta, en negrita), Estado (chip naranja "Abierta" / verde "Pagada") y columna de acciones.

Formularios / diálogos

Diálogo "Registrar abono"

Arriba muestra, como texto fijo, el nombre del proveedor y el balance pendiente.

Además incluye:

• Botón Pagar todo al lado del monto: rellena el campo con el balance completo.
• Aviso azul: "Pagas en Bs (tasa X): Bs Y", calculado como monto × tasa del día y redondeado a 2 decimales.

Botón: Registrar abono (verde, ancho completo, con ícono de check).

Acciones disponibles

Globales:

• No hay botón de crear deuda desde esta pantalla: las cuentas por pagar se generan desde las compras a proveedores.

Por fila:

• Abonar: solo en deudas con estado Abierta. Abre el diálogo de abono. Se deshabilita si no hay tasa del día.

Dentro del diálogo:

• Pagar todo: llena el monto con el balance completo, para saldar la deuda de una vez.
• Registrar abono: guarda el pago y actualiza el balance.

Reglas y validaciones

• Sin tasa del día no se puede abonar: el botón queda deshabilitado y el servidor responde "No hay tasa de cambio para hoy."
• El abono debe ser mayor a 0 y no puede exceder el balance; si te pasás, el sistema responde "El abono debe ser mayor a 0 y no exceder el balance."
• No se puede abonar a una deuda ya pagada: responde "La deuda ya está pagada."
• El monto se redondea a 2 decimales antes de aplicarse.
• Cuando el balance llega a 0 (o menos), la deuda pasa automáticamente a estado "Pagada" y el balance se fija en 0.
• Cada abono guarda la tasa usada y el equivalente en bolívares del momento; si abonás en distintos días, cada pago queda con su tasa.
• El método de pago debe pertenecer a tu negocio.
• El "Total por pagar" del chip suma solo las deudas abiertas.

Tips de uso

1. Antes de abonar verificá que la tasa del día esté cargada: sin ella el botón "Abonar" no funciona.
2. Usá Pagar todo cuando saldás la deuda completa, así evitás dejar centavos sueltos por redondeo.
3. Mirá el chip naranja del encabezado como semáforo diario: es tu deuda total con proveedores en dólares.
4. Registrá los abonos el mismo día que pagás; la tasa que se congela es la de hoy, y si lo cargás después, el equivalente en bolívares queda distinto al real.

Para qué sirve

Es la foto de cómo te fue en un período: cuánto vendiste, cuánto te costó esa mercancía, cuánto gastaste y con cuánto te quedaste realmente. En una sola pantalla te dice si estás ganando o perdiendo plata, y te avisa qué gastos fijos están por vencer.

Qué ves al entrar

Pantalla dividida en dos columnas (se apilan en celular).

Columna izquierda — tarjeta "Resumen Financiero" con dos selectores de fecha en el encabezado (desde / hasta), y una cascada de cifras:

• Ingresos (ventas netas) — en $
• − Costo de ventas — en $
• = Utilidad bruta — en $, con el % de margen al lado en verde
• − Gastos — en $
• = Utilidad neta — resaltada en un bloque de color: verde si es 0 o positiva, roja si es negativa

Columna derecha:

• Tarjeta "Gastos del período": el total de gastos en grande y, debajo, el desglose "Fijos $X · Variables $Y".
• Tarjeta "Gastos fijos por vencer": lista con ícono de campana naranja por cada gasto fijo pendiente que vence pronto, mostrando nombre, fecha de vencimiento y monto. Si no hay ninguno, dice "Sin gastos por vencer."

Formularios / diálogos

Esta pantalla no tiene modales ni formularios de carga. Solo tiene los dos controles de rango de fechas en el encabezado de la tarjeta principal.

Filtro de período (en línea, encabezado de la tarjeta)

Acciones disponibles

• Cambiar "Desde" o "Hasta": recalcula todo el resumen automáticamente, sin botón de aplicar.
• No hay acciones por fila ni botones de creación: la pantalla es solo de consulta.

Reglas y validaciones

• Ambas fechas se validan como fechas válidas en el servidor; si no se envían, se asume el mes actual completo.
• El período por defecto es del primer al último día del mes en curso.
• Utilidad bruta = Ingresos − Costo de ventas. Utilidad neta = Utilidad bruta − Gastos.
• El bloque de utilidad neta se pinta verde cuando es mayor o igual a 0, y rojo cuando es negativa.
• La lista "Gastos fijos por vencer" muestra únicamente gastos de tipo fijo, en estado pendiente, con fecha dentro de los próximos 7 días (o ya vencidos), ordenados por fecha. No depende del rango de fechas elegido arriba.
• Toda la pantalla queda en blanco hasta que el resumen termina de cargar.

Tips de uso

1. Revisá esta pantalla al cerrar cada mes: es el chequeo más rápido de si el negocio ganó o perdió.
2. Si la utilidad bruta se ve bien pero la neta sale roja, el problema está en los gastos, no en los precios; abrí el desglose "Fijos / Variables" para ver de dónde viene.
3. Compará meses cambiando el rango de fechas: el margen bruto en % es lo mejor para comparar períodos con volúmenes distintos.
4. Usá la lista de "por vencer" como recordatorio de pagos; esos gastos ya están contados como pendientes, no como pagados.

Para qué sirve

Muestra cómo van tus ventas en gráficos fáciles de leer: cuánto vendiste en el período, qué días vendiste más, cuáles son tus productos estrella y por qué método de pago te está entrando la plata. Es la pantalla para entender el comportamiento del negocio, no para cargar datos.

Qué ves al entrar

• Tarjeta "Reportes de ventas" con los filtros: Desde, Hasta y botón Aplicar (con indicador de carga).
• Fila de 4 KPIs (2 por fila en celular, 4 en escritorio):
  • Total ventas: monto en $ y, debajo en letra chica, el equivalente en Bs.
  • # Ventas: cantidad de ventas del período.
  • Ticket promedio: promedio por venta en $.
  • Valor inventario: cuánto vale tu inventario actual en $.
• Tarjeta "Ventas por día": gráfico de línea suavizada (color turquesa), con las fechas del período en el eje horizontal. Si no hay datos, muestra "Sin ventas en el período."
• Tarjeta "Productos más vendidos": gráfico de barras horizontales por cantidad vendida. Si no hay datos, muestra "Sin datos."
• Tarjeta "Ventas por método de pago": gráfico de dona con el monto en $ por cada método. Si no hay datos, muestra "Sin datos."

Formularios / diálogos

Esta pantalla no tiene modales. Su único formulario es la barra de filtros.

Filtros "Reportes de ventas"

Acciones disponibles

Globales:

• Aplicar: recarga los KPIs y los tres gráficos con el rango de fechas elegido. A diferencia del Resumen Financiero, acá el cambio de fechas no recarga solo — hay que apretar el botón.
• Los gráficos tienen la barra de herramientas de exportación desactivada: no hay descarga de imagen ni de datos desde acá.

No hay acciones por fila (no hay tablas en esta pantalla).

Reglas y validaciones

• Los datos se cargan una vez al entrar, con el mes actual completo como período por defecto.
• Cada gráfico se dibuja solo si tiene datos; si el arreglo viene vacío, se muestra el mensaje de "sin datos" en lugar de un gráfico vacío.
• Los KPIs y los tres gráficos vienen todos del mismo período: no se pueden filtrar por separado.
• El Valor inventario es un dato del momento actual, no del período (es cuánto vale tu stock hoy).
• El gráfico de dona usa una paleta fija de 5 colores; si tenés más métodos de pago, los colores se repiten.

Tips de uso

1. Acordate de apretar Aplicar después de cambiar las fechas: si no, seguís viendo el período anterior.
2. Mirá "Ventas por día" para detectar tus días fuertes y flojos, y ajustar horarios o personal en consecuencia.
3. El ticket promedio es el número que más rápido te dice si estás vendiendo más caro o solo más veces.
4. Cruzá "Productos más vendidos" (que va por cantidad) con el total en $: lo que más sale no siempre es lo que más plata deja.

Para qué sirve

Genera los libros de IVA que exige el SENIAT: el Libro de Ventas (lo que cobraste de IVA a tus clientes) y el Libro de Compras (el IVA que pagaste a tus proveedores), más un resumen que te dice cuánto IVA te toca pagar o si te quedó crédito a favor. Además podés exportar cada libro a Excel para tu contador.

Qué ves al entrar

Tres pestañas arriba: Libro de Ventas, Libro de Compras, Resumen del período.

Barra de controles (común a las tres pestañas): Desde, Hasta, botón Consultar (con indicador de carga) y, a la derecha, botón Exportar Excel (solo visible en las pestañas de libros, no en Resumen).

Pestaña Libro de Ventas — tabla con columnas: Fecha, N°, RIF/CI, Cliente, Exenta, Grav.8%, Grav.16%, Déb.8%, Déb.16%, IGTF, Total $. Al pie, una fila de TOTALES en negrita. Si no hay operaciones, muestra "Sin operaciones en el período."

Pestaña Libro de Compras — tabla con columnas: Fecha, N°, RIF Prov., Proveedor, Exenta, Grav.8%, Grav.16%, Créd.8%, Créd.16%, Total $. También con fila de TOTALES.

En ambos libros, cuando hay más de 25 operaciones aparece abajo un paginador circular y una leyenda: "N operaciones en el período · los totales son del período completo".

Pestaña Resumen del período — tres tarjetas:

• Débito fiscal (ventas) en $
• Crédito fiscal (compras) en $
• IVA a pagar (en rojo) o Crédito a favor (en verde), según el resultado, siempre mostrado en valor absoluto.

Debajo, el período consultado en formato de fecha venezolano.

Formularios / diálogos

Esta pantalla no tiene modales. Su único formulario es la barra de consulta.

Filtros de período

Acciones disponibles

Globales:

• Cambiar de pestaña (Ventas / Compras / Resumen): recarga automáticamente los datos de esa pestaña con el período vigente.
• Consultar: recarga la pestaña activa con las fechas elegidas.
• Exportar Excel: abre en una pestaña nueva la descarga del libro activo (ventas o compras) para el período seleccionado. Solo aparece en las pestañas de libros.
• Paginador: en cada libro, navega entre páginas de 25 filas. Es paginación de pantalla: los datos ya están todos cargados.

No hay acciones por fila: los libros son de solo lectura.

Reglas y validaciones

• "Desde" y "Hasta" son obligatorias en el servidor, y "Hasta" debe ser igual o posterior a "Desde".
• El tipo de libro solo acepta ventas o compras; la exportación solo acepta el formato excel.
• Los totales son siempre del período completo, no de la página que estás viendo. La paginación es solo visual, justamente para no volver parciales los totales.
• Cambiar el período reinicia la paginación a la página 1 en ambos libros, para no quedar parado en una página que el libro nuevo puede no tener.
• La fila de TOTALES solo se muestra cuando hay al menos una operación.
• El Excel se genera con el libro entero del período, no con la página visible.
• En el resumen: si el débito fiscal supera al crédito, el estado es "a pagar" (rojo); si no, es "crédito a favor" (verde). El monto siempre se muestra en positivo.
• Las fechas se muestran en formato venezolano (dd/mm/aaaa).
• El IGTF solo aparece en el Libro de Ventas.

Tips de uso

1. Consultá siempre por mes calendario completo (es el período fiscal): las fechas por defecto ya vienen así.
2. Para tu contador, exportá el Excel: trae todas las operaciones más las columnas de tasa usada y total en Bs que no se ven en pantalla.
3. No te guíes por los subtotales de la página que estás viendo — la fila TOTALES es la que vale, y siempre es del período entero.
4. Revisá la pestaña Resumen antes de declarar: te dice de una si te toca pagar o si arrastrás crédito a favor.

Para qué sirve

Acá registrás tus cuentas de banco y todos los movimientos de plata que entran y salen de ellas. Después vas marcando cada movimiento como "conciliado" cuando confirmás que también aparece en el estado de cuenta del banco. Sirve para que el saldo que muestra el sistema coincida con el saldo real de tu banco.

Qué ves al entrar

Fila superior con 3 KPIs:

• Total en bancos (ícono de banco, azul): suma del saldo de todas las cuentas activas, en $.
• Conciliados (ícono de check, verde): cantidad de movimientos ya conciliados.
• Sin conciliar (ícono de alerta, naranja): cantidad de movimientos pendientes de conciliar.

Debajo, dos paneles lado a lado:

Panel izquierdo — "Cuentas bancarias" con botón Nueva (+). Es una lista compacta; cada cuenta muestra su nombre, "banco · número de cuenta" y, a la derecha, el saldo actual en $ y la cantidad de movimientos. La cuenta seleccionada queda resaltada. Si no hay ninguna: "No hay cuentas registradas."

Panel derecho — "Movimientos" (el título incluye el nombre de la cuenta seleccionada). Si no elegiste cuenta: "Selecciona una cuenta para ver sus movimientos."

Con una cuenta seleccionada aparece:

• Barra de filtros: Desde, Hasta, casilla "Solo sin conciliar" y botón Filtrar.
• Botón Nuevo movimiento (+) en el encabezado.
• Tabla de 15 filas por página con columnas: Fecha, Tipo (chip verde "Ingreso" / rojo "Egreso"), Descripción, Monto (alineado a la derecha), Referencia, Conciliado (check verde o guion gris) y columna de acciones. Sin datos muestra "Sin movimientos."

Los avisos de éxito aparecen como notificación verde abajo, por 2 segundos.

Formularios / diálogos

Diálogo "Nueva cuenta bancaria"

Botones: Cancelar y Guardar (con indicador de carga).

Diálogo "Nuevo movimiento"

Botones: Cancelar y Guardar (con indicador de carga).

Acciones disponibles

Globales:

• Nueva (cuentas): abre el diálogo de cuenta bancaria. Al guardar, recarga la lista de cuentas y los KPIs.
• Nuevo movimiento: solo disponible con una cuenta seleccionada. Al guardar, recarga movimientos, cuentas y KPIs.
• Filtrar: aplica el rango de fechas y la casilla "Solo sin conciliar" a la lista de movimientos.

Por fila (cuentas):

• Clic sobre la cuenta: la selecciona y carga sus movimientos en el panel derecho.

Por fila (movimientos):

• Conciliar: botón verde que aparece solo en movimientos no conciliados. Los marca como conciliados y actualiza los KPIs. Muestra su propio indicador de carga mientras trabaja.

Reglas y validaciones

• Cuenta bancaria: nombre, banco, número de cuenta y saldo inicial son todos obligatorios; el saldo inicial no puede ser negativo. Cada uno tiene su mensaje de error en español.
• Toda cuenta nueva se crea activa y con el saldo inicial como saldo actual.
• Movimiento: tipo obligatorio y solo puede ser ingreso o egreso; descripción obligatoria (máx. 500); monto obligatorio y mínimo 0,01; fecha obligatoria; referencia opcional (máx. 100).
• Al registrar un movimiento, el saldo de la cuenta se ajusta automáticamente: suma si es ingreso, resta si es egreso. Todo dentro de una transacción, así que o se guarda todo o no se guarda nada.
• Todo movimiento nace sin conciliar.
• Conciliar es de una sola vía: no hay botón para desconciliar desde esta pantalla.
• Los movimientos se listan del más reciente al más antiguo.
• Solo podés ver y tocar cuentas y movimientos de tu propio negocio; cualquier otro intento devuelve "no encontrado".
• El KPI "Total en bancos" cuenta solo las cuentas activas.

Tips de uso

1. Cargá el saldo inicial exactamente como está hoy en tu banco: todo lo que sigue se calcula a partir de ahí.
2. Usá la casilla "Solo sin conciliar" cuando te sentás con el estado de cuenta: te deja únicamente lo que falta revisar.
3. Poné siempre la referencia de la transferencia; es lo que te va a permitir encontrar el movimiento cuando el banco y el sistema no cuadren.
4. Conciliá seguido (semanal, no mensual): mientras menos movimientos acumulados, más fácil es encontrar la diferencia.

Para qué sirve

Es la contabilidad formal del negocio, armada automáticamente a partir de tus ventas, compras y gastos. Te muestra el plan de cuentas con sus saldos, el detalle de cada asiento contable, el balance general (qué tenés, qué debés y cuánto es tuyo) y el estado de resultados (si ganaste o perdiste). Es la pantalla que le vas a mostrar a tu contador.

Qué ves al entrar

Cuatro pestañas: Plan de cuentas, Libro diario, Balance general, Estado de resultados. Arranca en Plan de cuentas.

Pestaña Plan de cuentas — tabla compacta sin paginación (muestra todas las cuentas de golpe), con columnas: Código (indentado según el nivel: cada punto en el código suma 20 px de sangría, así se ve el árbol), Nombre, Tipo (chip de color: verde Activo, rojo Pasivo, azul Capital, primario Ingreso, naranja Costo, gris Gasto) y Saldo en $ alineado a la derecha. Código, Nombre y Tipo son ordenables.

Pestaña Libro diario — filtros Desde / Hasta y botón Aplicar. Los asientos se muestran como paneles desplegables: cerrado se ve un chip con la fecha y la descripción; abierto se ve una tabla con Cuenta (código — nombre), Debe y Haber (los ceros se muestran vacíos). Abajo, paginador de 15 asientos por página. Si no hay nada: "Sin asientos en el período."

Pestaña Balance general — filtro Hasta y botón Aplicar. Tres tarjetas lado a lado: Activo (borde verde), Pasivo (borde rojo) y Capital (borde azul), cada una con el listado de cuentas y su Total en negrita al pie. Debajo, un aviso de cuadre: verde con "=" si el balance cuadra, rojo con "≠" si no, mostrando Activo vs. Pasivo + Capital.

Pestaña Estado de resultados — filtros Desde / Hasta y botón Aplicar. Una tabla en cascada con secciones resaltadas: Ingresos (con sus cuentas y Total Ingresos), Costos (con Total Costos), Utilidad Bruta (verde si es positiva, roja si es negativa), Gastos (con Total Gastos), y al final, separada por una línea, la Utilidad Neta en tamaño grande, también verde o roja.

Formularios / diálogos

Esta pantalla es de solo consulta: no tiene modales ni formularios de carga. Los únicos controles son los filtros de fecha de cada pestaña.

Filtros "Libro diario"

Filtro "Balance general"

Filtros "Estado de resultados"

Acciones disponibles

Globales:

• Cambiar de pestaña: carga los datos de esa pestaña. El Plan de cuentas se carga una sola vez (no vuelve a pedirlo si ya lo tiene); las otras tres se recargan cada vez que entrás.
• Aplicar (una por pestaña, salvo Plan de cuentas): recarga los datos con las fechas elegidas. Cada botón muestra su indicador de carga solo cuando su pestaña está activa.

Por fila:

• Plan de cuentas: ordenar por Código, Nombre o Tipo haciendo clic en el encabezado. No hay edición de cuentas desde acá.
• Libro diario: clic en un asiento para desplegarlo y ver sus líneas de Debe y Haber. Solo se abre un asiento a la vez (modo acordeón).
• Balance general y Estado de resultados: sin acciones por fila, son reportes de lectura.

Reglas y validaciones

• Toda la pantalla es de solo lectura: no se crean ni editan cuentas ni asientos manualmente. Los asientos los genera el sistema a partir de la operación del negocio.
• El plan de cuentas se muestra completo sin paginar, y la sangría del código refleja la jerarquía (un nivel por cada punto en el código).
• El libro diario pagina de a 15 asientos contra el servidor; el paginador solo aparece cuando hay más asientos que los ya cargados.
• El balance general es a una fecha de corte (acumulado), mientras que el libro diario y el estado de resultados van por rango de fechas.
• El cuadre del balance se valida con una tolerancia de 0,01: si la diferencia entre Activo y (Pasivo + Capital) es menor a un centavo, se considera cuadrado y el aviso sale verde; si no, sale rojo. Un balance descuadrado es señal de un problema contable que hay que revisar.
• En el libro diario, los montos en cero no se muestran (la celda queda vacía), como es la convención contable.
• Utilidad Bruta = Ingresos − Costos. Utilidad Neta = Utilidad Bruta − Gastos. Ambas se pintan verdes si son 0 o positivas, rojas si son negativas.
• Todos los montos se formatean en estilo venezolano con 2 decimales.

Tips de uso

1. Si el aviso del Balance general sale rojo, no sigas: hay un asiento mal armado y todo lo demás queda en duda.
2. Usá el Libro diario para investigar: cuando una cifra del balance no te cuadra, ahí ves exactamente qué asiento la movió.
3. El Estado de resultados de esta pantalla y el Resumen Financiero deberían contar la misma historia; si difieren mucho, hay operaciones sin asentar.
4. Para tu contador, filtrá el libro diario por el mes cerrado completo: es la vista más parecida a lo que él espera recibir.

Para qué sirve

Sirve para armar las "fórmulas" de lo que usted prepara o fabrica: qué ingredientes lleva un plato o un producto elaborado y en qué cantidad. Con eso el sistema le calcula automáticamente cuánto le cuesta producir cada unidad y, cuando usted produce, descuenta solo los ingredientes del inventario y suma el producto terminado. También le queda un registro de todas las producciones que hizo.

Qué ves al entrar

• Tarjeta principal "Recetas y Produccion" con el botón Nueva receta arriba a la derecha (solo visible si tiene permiso de administrar productos).
• Tabla de recetas con las columnas: Nombre, Producto resultante, Ingredientes (cantidad de ingredientes), Costo estimado ($), Rendimiento y Acciones. Muestra 10 filas por página.
• Debajo, una segunda tarjeta "Ordenes de produccion" con el historial: Receta, Cantidad, Usuario (quién produjo), Fecha y Estado. El estado se ve como etiqueta de color: verde para completada, roja para cancelada y amarilla para cualquier otro.
• No hay filtros ni buscador en esta pantalla; el listado se carga completo.

Formularios / diálogos

Diálogo "Nueva receta" / "Editar receta"

Bloque "Ingredientes" (una fila por ingrediente, con botón Agregar para sumar filas):

Diálogo "Producir"

Debajo del campo, el diálogo muestra una tabla informativa de solo lectura con Ingrediente, Necesita (cantidad × veces a producir) y Stock actual, más una línea que anticipa cuántas unidades del producto resultante se van a producir (rendimiento × cantidad).

Acciones disponibles

• Nueva receta (barra superior): abre el formulario vacío con un ingrediente en blanco.
• Producir (icono de play, por fila): abre el diálogo de producción, cargando el detalle completo de la receta.
• Editar (icono de lápiz, por fila): recarga la receta con sus ingredientes y abre el formulario.
• Eliminar (icono de papelera rojo, por fila): pide confirmación con el nombre de la receta y la borra.
• Confirmar producción (dentro del diálogo Producir): ejecuta la producción y refresca recetas, órdenes de producción y productos.
• Imprimir/Cancelar en cada diálogo para cerrar sin guardar.

Reglas y validaciones

• No se guarda la receta si falta el nombre o el producto resultante.
• No se guarda si no hay al menos un ingrediente con producto seleccionado y cantidad mayor a cero; los ingredientes vacíos se filtran solos.
• No se puede borrar la última fila de ingrediente: el botón de quitar queda deshabilitado cuando solo queda una.
• Al producir, si el servidor rechaza la operación (por ejemplo, por falta de stock de un ingrediente) sale un aviso con el mensaje del sistema.
• Todas las acciones de esta pantalla (incluso solo ver el listado) requieren permiso de administrar productos.
• El costo estimado se recalcula en vivo mientras arma la receta, tomando el costo actual en dólares de cada producto.

Tips de uso

• Use Fabricar para lo que produce por adelantado (panes, salsas, embutidos) y Vender para platos que se arman al momento del pedido; así el inventario se descuenta cuando realmente corresponde.
• Si su receta rinde varias porciones, ponga el rendimiento real (ej. 12 porciones) en lugar de 1: el costo por unidad le va a salir correcto.
• Antes de confirmar una producción, revise la columna Stock actual del diálogo: es la forma más rápida de detectar que le falta un insumo.
• Mantenga la unidad de cada ingrediente igual a la unidad con la que compra ese producto, para que el costo no se le distorsione.

Para qué sirve

Le permite registrar por lote la mercancía perecedera: qué producto es, con qué número de lote entró, cuándo se produjo y cuándo vence. La pantalla le avisa de un vistazo qué está por vencerse y qué ya se venció, para que saque a promoción o retire del anaquel a tiempo.

Qué ves al entrar

• Tres tarjetas de indicadores arriba: Total lotes (cuántos lotes tiene cargados), Próximos a vencer (30 días) (en amarillo) y Ya vencidos (en rojo).
• Tarjeta "Lotes y Vencimientos" con el botón Nuevo lote a la derecha (solo si tiene permiso de administrar productos).
• Tabla con las columnas: Producto, Lote, F. Producción, F. Vencimiento, Cantidad y Costo ($). Muestra 15 filas por página.
• Las filas vienen coloreadas: fondo rojo tenue si el lote ya venció, fondo amarillo tenue si vence dentro de los próximos 30 días.
• Las fechas y el costo vacíos se muestran como guion.

Formularios / diálogos

Diálogo "Nuevo lote"

Acciones disponibles

• Nuevo lote (barra superior): abre el formulario en blanco.
• Guardar: crea el lote y recarga tanto la tabla como los contadores de alertas.
• Cancelar: cierra sin guardar.
• No hay acciones por fila: esta pantalla es de registro y consulta, no permite editar ni eliminar lotes desde la interfaz.

Reglas y validaciones

• No se guarda si falta el producto o el código de lote.
• Fechas y costo son opcionales: si se dejan en blanco se envían como nulos.
• El semáforo de colores usa el día de hoy a las 00:00 como referencia: rojo si la fecha de vencimiento ya pasó, amarillo si cae dentro de los 30 días siguientes.
• Ver el listado requiere permiso de leer productos; para crear lotes hace falta administrar productos.

Tips de uso

• Cargue el lote apenas recibe la mercancía, con la fecha de vencimiento que trae el empaque: es lo único que alimenta las alertas.
• Revise el contador amarillo al abrir el día: son los lotes candidatos a promoción o a rotación rápida.
• Si maneja el mismo producto con vencimientos distintos, créelo como lotes separados; no sume todo en uno solo.
• Registrar el costo por lote le sirve después para saber cuánto dinero está perdiendo en lo que se venció.

Para qué sirve

Le permite agrupar sus productos por temporada o colección (Verano 2026, Navidad, Escolar) y saber qué está vigente y qué salió de temporada. Sirve para organizar el catálogo, planificar liquidaciones y ver rápido cuántas piezas tiene asignadas a cada colección.

Qué ves al entrar

• Tarjeta "Temporadas y Colecciones" con el botón Nueva temporada a la derecha.
• Tabla compacta con las columnas: Nombre, Fecha inicio, Fecha fin, Activa (interruptor encendido/apagado), Productos (etiqueta con el conteo, se puede pulsar) y Acciones.
• Las fechas vacías se muestran como raya.
• Abajo aparece un aviso verde temporal (2,5 segundos) confirmando la operación: "Temporada creada", "Temporada actualizada" o "Productos actualizados".

Formularios / diálogos

Diálogo "Nueva temporada" / "Editar temporada"

Diálogo "Productos — "

Es una vista de solo lectura: lista cada producto asignado con su nombre y su precio en dólares. Si no hay ninguno, muestra "Sin productos asignados". No tiene campos editables.

Diálogo "Asignar productos a temporada"

Acciones disponibles

• Nueva temporada (barra superior): abre el formulario en blanco.
• Editar (icono de lápiz, por fila): abre el formulario cargado con los datos de esa temporada.
• Ver (icono de ojo, por fila) o pulsar la etiqueta de conteo de productos: abre el detalle con los productos asignados.
• Interruptor "Activa" (por fila): activa o desactiva la temporada de inmediato, sin abrir formulario.
• Asignar productos (dentro del detalle): abre el selector múltiple.
• Guardar en el diálogo de asignación: reemplaza la lista completa de productos de esa temporada y recarga el conteo.
• Cerrar / Cancelar: salen sin guardar.

Reglas y validaciones

• El nombre es obligatorio (validación "Requerido" en el campo).
• Al guardar la asignación, se envía la lista completa de productos seleccionados: lo que usted desmarque queda desvinculado de la temporada.
• El interruptor de activa invierte el valor actual y guarda al instante.
• Si el servidor devuelve un error al guardar, se muestra su mensaje; si no hay mensaje, aparece "Error al guardar".
• La pantalla requiere permiso de leer productos.

Tips de uso

• Cargue fecha de inicio y fin aunque sean opcionales: le sirven de referencia para saber cuándo liquidar.
• Desactive la temporada cuando termine en lugar de borrarla, así conserva el histórico de qué se vendió en cada colección.
• Use el diálogo de asignación de una sola vez por temporada: como reemplaza toda la lista, es más seguro revisar primero el detalle y luego marcar.
• Nombre las temporadas con año incluido ("Verano 2026") para no confundirlas al año siguiente.

Para qué sirve

Es la agenda del negocio: registra las citas de sus clientes con fecha, hora, servicio y notas, y le permite ir marcando si están confirmadas, completadas o canceladas. Tiene dos formas de verla: como lista para trabajarla y como agenda día por día para saber cómo viene la semana.

Qué ves al entrar

• Dos pestañas: Lista y Agenda, con el botón Nueva cita siempre visible a la derecha.
• Pestaña Lista: tabla con las columnas Fecha, Hora (muestra hora inicio – hora fin), Servicio, Cliente, Status (etiqueta de color) y Acciones. 15 filas por página. Los colores del status: amarillo pendiente, azul confirmada, verde completada, rojo cancelada. Si la cita no tiene cliente, muestra raya.
• Pestaña Agenda: dos filtros de fecha, Desde y Hasta (por defecto de hoy a dentro de 7 días), y debajo un bloque por cada día del rango con sus citas en tarjetas: etiqueta de estado, franja horaria, servicio y nombre del cliente. Los días sin citas dicen "Sin citas".
• Abajo del todo, mensajes de error en rojo cuando algo falla.

Formularios / diálogos

Diálogo "Nueva cita" / "Editar cita"

Acciones disponibles

• Nueva cita (barra superior): abre el formulario con la fecha de hoy y horario 09:00–10:00.
• Editar (menú de tres puntos de la fila): abre la cita cargada para modificarla.
• Confirmar (menú de la fila, solo si está pendiente): pasa la cita a confirmada.
• Completar (menú de la fila, solo si está confirmada): pasa la cita a completada.
• Cancelar (menú de la fila, solo si está pendiente o confirmada): pasa la cita a cancelada.
• Filtros Desde / Hasta (pestaña Agenda): recargan la agenda automáticamente al cambiar cualquiera de los dos.
• Cancelar / Guardar en el diálogo.

Reglas y validaciones

• Si el campo Servicio está vacío, se bloquea el guardado con el mensaje "El servicio es requerido."
• El menú de acciones cambia según el estado: una cita ya completada o cancelada no ofrece más transiciones.
• La agenda se recarga sola cada vez que cambian las fechas del filtro y también al entrar a la pestaña Agenda.
• Los errores del servidor se muestran tal cual llegan; si no traen mensaje aparece "Error al guardar." o "Error al actualizar."
• La pantalla requiere permiso de leer ventas.

Tips de uso

• Trabaje la pestaña Agenda a primera hora: es la vista que le muestra el día ordenado por horario.
• Confirme las citas apenas el cliente responde; así el color amarillo le queda reservado a lo que falta por confirmar.
• Escriba el servicio siempre con la misma redacción para poder identificarlo después en la lista.
• Amplíe el rango "Hasta" a 15 o 30 días cuando necesite ver la carga de trabajo del mes.

Para qué sirve

Le permite armar el presupuesto y la orden de un trabajo de servicio, mezclando en un mismo documento la mano de obra y los productos o repuestos que se usan. Va llevando la orden por sus etapas (borrador, en proceso, completada) y al completarla el sistema hace el cierre correspondiente.

Qué ves al entrar

• Tarjeta "Órdenes de Servicio" con el botón Nueva orden en la esquina superior derecha.
• Tabla con las columnas: # (número de orden), Cliente, Fecha, Items (cantidad de ítems, centrado), Total $ (alineado a la derecha), Status (etiqueta de color) y Acciones. 10 filas por página.
• Colores de estado: gris borrador, azul en_proceso, verde completada, rojo cancelada.
• Debajo de la tabla aparece un mensaje: verde si dice "Orden completada.", rojo para cualquier error.

Formularios / diálogos

Diálogo "Nueva orden de servicio" — Cabecera

Diálogo "Nueva orden de servicio" — Tabla de ítems (una fila por renglón)

Al pie de la tabla se muestra el Total de la orden, que suma todos los subtotales redondeados.

Acciones disponibles

• Nueva orden (barra superior): abre el diálogo con un ítem en blanco de tipo Servicio.
• Agregar ítem (dentro del diálogo): suma un renglón más.
• Papelera (por renglón): elimina ese renglón.
• Iniciar (menú de la fila, solo si está en borrador): pasa la orden a en_proceso.
• Completar (menú de la fila, si está en borrador o en_proceso): llama al cierre de la orden en el servidor y muestra "Orden completada."
• Cancelar (menú de la fila, si está en borrador o en_proceso): pasa la orden a cancelada.
• Cancelar / Guardar en el diálogo.

Reglas y validaciones

• Solo se envían los renglones que tengan descripción y cantidad mayor a cero.
• Si después de ese filtro no queda ningún renglón, se bloquea el guardado con "Agrega al menos un ítem."
• El campo Producto solo se envía cuando el tipo del renglón es "Producto"; en los renglones de servicio se manda nulo.
• Los totales se calculan con redondeo a 2 decimales en cada subtotal antes de sumar, para evitar diferencias de centavos.
• La pantalla solo permite crear órdenes nuevas y cambiar estados; no hay edición de una orden ya creada desde esta vista.
• Requiere permiso de leer ventas.

Tips de uso

• Cargue primero los renglones de tipo Producto: al seleccionar el producto se le llenan solos la descripción y el precio, y sobre eso puede ajustar.
• Use la cantidad con decimales para cobrar fracciones de hora de mano de obra (por ejemplo 1,5).
• Deje la orden en borrador mientras la negocia con el cliente y páse la a en_proceso recién cuando arranque el trabajo.
• Anote en Notas todo lo que no debe ir en el presupuesto que ve el cliente.

Para qué sirve

Es el corazón del salón: un mapa de mesas donde toma la orden, la manda a cocina y cobra. Cada mesa muestra su estado (disponible, ocupada, reservada) y, si está ocupada, cuántos ítems tiene pedidos. La pestaña Cocina le da al personal de barra o cocina la lista viva de qué falta preparar. El cobro arma la venta con IVA, IGTF, propina y mesonero asignado.

Qué ves al entrar

• Dos pestañas: Mesas (icono de silla) y Cocina (icono de gorro de chef).
• Pestaña Mesas: botón Nueva mesa arriba a la derecha y una cuadrícula de tarjetas, una por mesa. Cada tarjeta muestra un ícono grande de color según el estado (verde disponible, amarillo ocupada, azul reservada), el nombre de la mesa, su capacidad, una etiqueta con el estado y, si hay orden activa, la línea "N items en orden". Abajo de cada tarjeta hay un ícono de lápiz para editarla.
• Pestaña Cocina: una tarjeta por orden, con el nombre de la mesa y el número de orden. Dentro, la lista de ítems con nombre del producto, cantidad, notas del pedido, etiqueta de estado (amarillo pendiente, azul preparando, verde lista) y el botón de avance. Si no hay nada pendiente, muestra "No hay items pendientes en cocina." Esta pestaña se refresca sola cada 15 segundos mientras esté abierta.
• Los mensajes de error salen en rojo arriba del contenido.

Formularios / diálogos

Diálogo "Nueva mesa" / "Editar mesa"

Diálogo "Nueva orden — " (se abre al pulsar una mesa que no está ocupada)

Diálogo "Orden activa — " (se abre al pulsar una mesa ocupada con orden)

Arriba, sección de solo lectura "Items actuales": cada ítem con producto, cantidad, notas y etiqueta de estado de cocina. Abajo, sección "Agregar items" con los mismos campos que la orden nueva:

Diálogo "Cobrar — "

Arriba muestra el detalle de consumo de solo lectura (producto × cantidad y su importe) y luego los totales calculados: Subtotal, IVA, IGTF 3% (estimado) —solo si hay pagos en divisa— y Total estimado.

Acciones disponibles

• Nueva mesa (pestaña Mesas): abre el formulario de mesa en blanco con capacidad 4.
• Editar mesa (lápiz en la tarjeta): abre el formulario cargado. No dispara la apertura de orden.
• Pulsar una tarjeta de mesa: si está ocupada y tiene orden activa abre el diálogo de orden activa; en cualquier otro caso abre el diálogo de orden nueva.
• Agregar producto (en los diálogos de orden): suma un renglón.
• Papelera (por renglón): quita el renglón.
• Enviar a cocina: crea la orden nueva, o agrega los ítems adicionales a la orden ya abierta.
• Anular (en la orden activa): cancela la orden completa, previa confirmación.
• Cobrar (en la orden activa): cierra el diálogo de orden y abre el de cobro.
• Dividir (en el cobro): agrega otra fila de pago para pagos mixtos o cuentas divididas.
• Cobrar $X (botón verde del cobro): confirma el cobro y genera la venta.
• Imprimir (aparece después de cobrar): abre el PDF de la venta generada en una pestaña nueva.
• Preparar / Lista (pestaña Cocina, por ítem): avanza el ítem de pendiente a preparando, y de preparando a lista. Al avanzar, refresca cocina y mesas.

Reglas y validaciones

• No se puede enviar una orden (nueva o adicional) sin al menos un producto seleccionado: sale "Agrega al menos un producto."
• Al anular, aparece la confirmación "¿Anular esta orden? No se cobrará ni se descontará inventario."
• En el cobro se exige al menos un pago con método y monto mayor a cero.
• La suma de los pagos debe igualar la base (subtotal + IVA) con tolerancia de un centavo. Si no coincide, se muestra en rojo "Suma de pagos: $X (debe ser $Y)" y el botón de cobrar queda deshabilitado.
• El IGTF de 3% se estima solo sobre los pagos hechos con métodos marcados como divisa, y se suma al total estimado (no a la base que deben cubrir los pagos).
• La propina va aparte: no entra en la base ni en la validación de la suma de pagos.
• Si el servidor devuelve advertencias al cobrar (por ejemplo, sobre stock), el diálogo no se cierra y muestra las advertencias en un recuadro amarillo; ahí queda disponible el botón Imprimir y el botón pasa a decir "Listo".
• Los selectores de producto solo listan productos activos; los de mesonero, solo mesoneros activos.
• La pestaña Cocina abre y cierra su auto-refresco al entrar y salir; también se limpia al salir de la pantalla.
• Requiere permiso de crear ventas y que la función de gastronomía esté habilitada en el negocio.

Tips de uso

• Use el buscador de producto en la orden nueva antes de abrir el selector: con un menú largo le ahorra muchísimo tiempo.
• Todo lo que el cliente pida distinto ("sin picante", "para llevar") escríbalo en Notas: es lo que ve cocina en su tarjeta.
• Para cuentas separadas use Dividir y reparta los montos entre métodos; recuerde que la suma tiene que dar exacta la base.
• Asigne siempre el mesonero al cobrar: es la única forma de que después le cuadre el reparto de propinas.
• Si aparece una advertencia al cobrar, no cierre el diálogo sin leerla: la venta ya se generó y el botón Imprimir le da el comprobante.

Para qué sirve

Es el registro del personal de salón. Aquí da de alta a sus mesoneros para poder asignarlos al momento de cobrar una mesa, y los desactiva cuando ya no trabajan con usted sin perder el histórico de lo que atendieron.

Qué ves al entrar

• Tarjeta "Mesoneros" con el botón Nuevo mesonero a la derecha.
• Si hay un error, aparece un texto rojo arriba de la tabla.
• Tabla con las columnas: Nombre, Estado (etiqueta verde "Activo" o gris "Inactivo") y Acciones. 10 filas por página.

Formularios / diálogos

Diálogo "Nuevo mesonero" / "Editar mesonero"

Acciones disponibles

• Nuevo mesonero (barra superior): abre el formulario en blanco, con el estado activo por defecto.
• Editar (icono de lápiz, por fila): abre el formulario cargado, mostrando además el interruptor de activo.
• Activar / Desactivar (icono de usuario, por fila): invierte el estado al instante; el tooltip indica cuál acción va a ejecutar.
• Cancelar / Guardar en el diálogo.

Reglas y validaciones

• No se guarda si el nombre está vacío o solo tiene espacios.
• Al crear, solo se envía el nombre: el estado activo lo asigna el sistema. El interruptor no se muestra en creación.
• Al editar, se envían nombre y estado juntos.
• Los errores del servidor se muestran; si no traen mensaje sale "Error al guardar mesonero." o "Error al actualizar."
• Requiere permiso de crear ventas y la función de gastronomía habilitada.

Tips de uso

• Desactive en lugar de intentar borrar: los mesoneros inactivos dejan de aparecer en el cobro pero conservan sus ventas asociadas.
• Registre a cada mesonero con el nombre con que lo conocen en el salón, para que quien cobra lo identifique rápido.
• Revise esta lista al inicio de cada temporada alta: es donde se acumula personal viejo que ya no está.

Para qué sirve

Lleva el control de las reservas del restaurante: quién reservó, para cuándo, cuántas personas y en qué mesa. Le muestra de un vistazo cuántas reservas tiene para hoy y le permite ir confirmando, completando o cancelando cada una.

Qué ves al entrar

• Encabezado "Reservaciones" con una etiqueta azul "Hoy: N" que cuenta las reservas de la fecha actual.
• Filtro Filtrar por fecha (campo de fecha, arranca en hoy) y botón Nueva a la derecha.
• Tabla compacta con las columnas: Fecha, Hora, Cliente, Teléfono, Personas (centrado), Mesa, Estado (etiqueta de color) y Acciones.
• Colores de estado: amarillo pendiente, azul confirmada, verde completada, rojo cancelada. Si no hay mesa asignada muestra raya.
• Aviso verde temporal (2,5 segundos) al crear o actualizar.

Formularios / diálogos

Diálogo "Nueva reservación" / "Editar reservación"

Acciones disponibles

• Nueva (barra superior): abre el formulario con fecha de hoy, hora 12:00, 2 personas y estado pendiente.
• Filtrar por fecha: al cambiar el campo, recarga la tabla con las reservas de ese día. Si lo deja vacío, trae todas.
• Editar (icono de lápiz, por fila): abre el formulario cargado, incluyendo el selector de estado.
• Confirmar (menú de tres puntos, solo si está pendiente): pasa a confirmada.
• Completar (menú de tres puntos, solo si está confirmada): pasa a completada.
• Cancelar (menú de tres puntos, disponible mientras no esté ya cancelada): pasa a cancelada.
• Cancelar / Guardar en el diálogo.

Reglas y validaciones

• El nombre del cliente es obligatorio (validación "Requerido").
• El campo Personas tiene mínimo 1.
• El selector de Estado solo se muestra en edición: al crear, la reserva nace como pendiente.
• El contador "Hoy" cuenta sobre las reservaciones cargadas cuya fecha es igual al día actual.
• Si el servidor devuelve error se muestra su mensaje; si no, "Error al guardar".
• Requiere permiso de leer ventas.

Tips de uso

• Deje el filtro en la fecha de mañana al cerrar el día: le muestra de una vez la carga de reservas para preparar el salón.
• Pida siempre el teléfono: es lo que le permite recuperar la mesa cuando el cliente no llega.
• Asigne la mesa recién cuando confirme; así no bloquea mesas por reservas que se caen.
• Marque como completada a la llegada del cliente para distinguir las que efectivamente se cumplieron de las que quedaron colgando.

Para qué sirve

Sirve para llevar el control unitario de equipos con número de serie: televisores, celulares, laptops. Cada unidad queda registrada con su serial, su estado (disponible, vendido, en garantía, devuelto), hasta cuándo tiene garantía y en qué venta salió. Es lo que le permite responder al instante cuando un cliente vuelve con un equipo en la mano.

Qué ves al entrar

• Tarjeta "Numeros de Serie" con un buscador "Buscar serial..." (lupa, con botón de limpiar), un botón Buscar y, a la derecha, el botón Agregar seriales (solo si tiene permiso de administrar productos).
• Tabla con las columnas: Serial, Producto, Estado (etiqueta de color), Garantía hasta y Venta #. 15 filas por página.
• Colores de estado: verde disponible, azul vendido, amarillo en_garantia, rojo devuelto.
• La garantía y el número de venta vacíos se muestran como guion.
• Si hizo una búsqueda, la tabla muestra los resultados de la búsqueda; si no, el listado completo.

Formularios / diálogos

Diálogo "Agregar numeros de serie"

Acciones disponibles

• Buscar (o pulsar Enter en el campo de búsqueda): consulta seriales por número. Si el campo está vacío, limpia los resultados y vuelve al listado completo.
• Limpiar (la X del buscador): borra los resultados de la búsqueda.
• Agregar seriales (barra superior): abre el diálogo de carga masiva.
• Guardar: registra todos los seriales del área de texto y recarga la tabla.
• Cancelar: cierra sin guardar.
• No hay acciones por fila: el estado de cada serial lo cambia el sistema al vender o procesar garantías, no se edita a mano desde aquí.

Reglas y validaciones

• No se guarda si falta el producto o si el área de seriales está vacía (o solo con espacios).
• Los seriales se envían tal cual, en bloque de texto: el servidor los separa por línea.
• La fecha de garantía es opcional y se aplica igual a todos los seriales de esa carga.
• Ver el listado requiere permiso de leer productos; cargar seriales requiere administrar productos.

Tips de uso

• Cargue los seriales por lote de compra, en una sola pegada desde la lista del proveedor: un serial por línea y listo.
• Si el lote entero tiene la misma garantía, ponga la fecha en la carga; le ahorra registrarla equipo por equipo.
• Use el buscador cuando llegue un cliente con un equipo: le dice de una vez si está vendido, en qué venta y si la garantía sigue vigente.
• No mezcle modelos distintos en una misma carga: la fecha de garantía y el producto se aplican a todo el bloque.

Para qué sirve

Es el fichero de los vehículos de sus clientes: placa, marca, modelo, año, color, VIN y a quién pertenece. Al abrir un vehículo ve todo su historial de órdenes de trabajo, así sabe qué se le hizo antes, cuándo y cuánto se cobró.

Qué ves al entrar

• Encabezado "Vehículos" con un buscador "Buscar por placa, marca o modelo..." y el botón Nuevo a la derecha.
• Tabla con las columnas: Placa, Marca, Modelo, Año, Color, Cliente y Acciones. Los campos vacíos se muestran como raya.
• Las filas resaltan al pasar el mouse y pulsar cualquier parte de la fila abre el detalle del vehículo.

Formularios / diálogos

Diálogo "Nuevo vehículo" / "Editar vehículo"

Diálogo de detalle " (<Año>)"

Solo lectura. Muestra Placa, Color, VIN, Cliente y, si las hay, las Notas. Debajo, la sección "Historial de Órdenes de Trabajo" con una tabla de Número, Fecha (formato dd/mm/aaaa), Estado (etiqueta de color) y Total $. Si el vehículo no tiene órdenes, dice "Sin órdenes de trabajo registradas."

Colores de estado en el historial: azul recibido, amarillo en proceso, verde completado, azul primario entregado, rojo cancelado.

Acciones disponibles

• Nuevo (barra superior): abre el formulario en blanco.
• Buscador: recarga la lista desde el servidor a medida que escribe, y además filtra la tabla localmente.
• Editar (icono de lápiz, por fila): abre el formulario con los datos del vehículo. No abre el detalle.
• Ver (icono de ojo, por fila) o pulsar la fila: consulta el vehículo con su historial y abre el detalle.
• Cancelar / Guardar en el formulario; Cerrar en el detalle.

Reglas y validaciones

• Marca y Modelo son obligatorios: el botón Guardar queda deshabilitado hasta que ambos tengan contenido.
• Placa, color, VIN y notas se envían como nulos cuando están vacíos, para no guardar cadenas en blanco.
• Las fechas del historial se formatean en UTC para que no se corran un día en zonas horarias negativas como Venezuela.
• Requiere permiso de leer clientes para ver el listado (la escritura exige administrar clientes).

Tips de uso

• Registre siempre placa y VIN: la placa es lo que busca todo el mundo, el VIN es lo que resuelve las dudas cuando hay dos vehículos parecidos.
• Vincule el vehículo a su cliente: al crear una orden de trabajo, el sistema le rellena el cliente automáticamente.
• Antes de presupuestar, abra el detalle y revise el historial: le dice qué se le hizo antes y evita cobrar dos veces lo mismo.
• Use el campo Notas para lo que no cabe en los campos fijos (motor cambiado, golpes previos, preferencias del dueño).

Para qué sirve

Le permite decir qué repuesto sirve para qué vehículo y en qué rango de años. Así, cuando llega un cliente diciendo "necesito algo para un Corolla 2015", usted busca por marca, modelo y año y le sale de una vez qué tiene, a qué precio y cuánto stock le queda.

Qué ves al entrar

• Encabezado "Compatibilidad de Repuestos" con el botón Agregar a la derecha.
• Fila de filtros: Marca (lista desplegable con opción de escribir libremente: Toyota, Chevrolet, Ford, Hyundai, Kia, Dodge, Jeep, Mitsubishi, Nissan, Renault, Chery, Fiat), Modelo (texto libre), Año (numérico) y el botón Buscar.
• Tabla de resultados con las columnas: Producto, Marca, Modelo, Desde, Hasta, Precio $ y Stock. Los valores vacíos se muestran como raya.
• Al entrar, la búsqueda se ejecuta sin filtros y trae todo el listado.

Formularios / diálogos

Diálogo "Nueva compatibilidad"

Acciones disponibles

• Agregar (barra superior): carga la lista de productos y abre el diálogo de nueva compatibilidad.
• Buscar: consulta con los filtros que estén llenos (los vacíos se omiten).
• Guardar (en el diálogo): registra la compatibilidad y refresca la búsqueda.
• Cancelar: cierra sin guardar.
• No hay acciones por fila: la tabla es de consulta.

Reglas y validaciones

• El botón Guardar queda deshabilitado hasta que estén llenos Producto, Marca y Modelo.
• Los filtros de búsqueda son acumulativos y opcionales: solo se envían los que tengan valor.
• Los años (desde/hasta) son opcionales; si los deja vacíos, la compatibilidad se entiende sin límite en ese extremo.
• Requiere permiso de leer productos.

Tips de uso

• Cargue un mismo repuesto varias veces si sirve para varias marcas o modelos: cada combinación es un registro aparte.
• Use el rango de años en lugar de cargar año por año: "desde 2010 hasta 2018" cubre nueve modelos con un solo registro.
• Si el repuesto sigue aplicando a los modelos nuevos, deje "Año hasta" vacío y no tiene que actualizarlo cada año.
• La columna Stock de los resultados le evita ir al módulo de productos: busque y responda al cliente en la misma pantalla.

Para qué sirve

Es la orden del taller: registra qué vehículo entró, de qué cliente, cuál es el diagnóstico y qué mano de obra y repuestos lleva el trabajo. La orden avanza por etapas (recibido, en proceso, completado, entregado) y al completarla usted decide si descuenta o no el stock de los repuestos. Se puede imprimir en PDF para entregar al cliente.

Qué ves al entrar

• Encabezado "Órdenes de Trabajo" con tres controles a la derecha: filtro Estado (con opción "Todos"), buscador "Buscar número o placa..." y el botón Nueva OT.
• Tabla con las columnas: Número, Vehículo (muestra placa – marca modelo), Cliente, Fecha, Entrega, Estado (etiqueta de color con nombre legible), Total $ y Acciones. Las filas resaltan al pasar el mouse.
• Colores y etiquetas de estado: azul "Recibido", amarillo "En proceso", verde "Completado", azul primario "Entregado", rojo "Cancelado".
• Las fechas se muestran en formato dd/mm/aaaa; las vacías, como raya.

Formularios / diálogos

Diálogo "Nueva Orden de Trabajo" — Cabecera

Diálogo "Nueva Orden de Trabajo" — Ítems (una fila por renglón)

Al pie se muestra el Total en vivo, que suma todos los renglones.

Diálogo de detalle "OT <número>"

Solo lectura. Muestra la etiqueta de estado, Vehículo, Cliente, Fecha, Entrega, Total, el Diagnóstico (si lo hay) y una tabla de ítems con Tipo, Descripción, Cant., Precio $ y Subtotal $. Al final, las Notas si existen.

Diálogo "Completar Orden"

Sin campos. Pregunta: "¿Desea descontar el stock de los repuestos utilizados?" y ofrece tres botones: Cancelar, Sin descontar y Descontar stock.

Acciones disponibles

• Nueva OT (barra superior): carga vehículos, clientes y productos, y abre el formulario con un ítem de mano de obra en blanco.
• Filtro Estado y buscador: recargan la lista desde el servidor automáticamente al cambiar.
• Agregar ítem (en el formulario): suma un renglón.
• X roja (por renglón): quita el renglón.
• Ver (icono de ojo, por fila): consulta la orden completa y abre el detalle.
• Iniciar (icono de play amarillo, solo si está recibido): pasa la orden a en_proceso.
• Completar (icono de check verde, solo si está en_proceso): abre la pregunta sobre descuento de stock.
• Entregar (icono de camión, solo si está completado): pasa la orden a entregado.
• Imprimir (icono de impresora, en cada fila y dentro del detalle): abre el PDF de la orden en una pestaña nueva.
• Sin descontar / Descontar stock: completan la orden con o sin movimiento de inventario.
• Crear OT / Cancelar en el formulario; Cerrar en el detalle.

Reglas y validaciones

• El botón Crear OT queda deshabilitado si no hay vehículo seleccionado o si no hay ningún ítem.
• Al elegir un vehículo con cliente registrado, el campo Cliente se rellena automáticamente.
• El campo Producto solo se muestra y se usa cuando el renglón es de tipo "Repuesto"; el autollenado de descripción y precio solo dispara en ese caso.
• Fecha de entrega, diagnóstico y notas se envían como nulos cuando están vacíos.
• El flujo de estados es lineal y cada botón de acción solo aparece en el estado que le corresponde: recibido → en proceso → completado → entregado.
• Al completar es obligatorio decidir entre descontar stock o no: no hay opción por defecto.
• Las fechas se formatean en UTC para que no se corran un día.
• Esta pantalla solo crea órdenes nuevas y cambia estados; no permite editar una orden ya creada.
• Requiere permiso de leer ventas.

Tips de uso

• Empiece siempre eligiendo el vehículo: le trae el cliente solo y evita que quede una OT huérfana.
• Cargue los repuestos como renglones de tipo "Repuesto" y no como mano de obra: es lo único que permite descontar el inventario al completar.
• Elija "Sin descontar" cuando el cliente trajo sus propios repuestos o cuando el stock ya se descontó por una venta aparte.
• Imprima la OT al recibir el vehículo y al entregarlo: el PDF es el respaldo del diagnóstico y del monto acordado.
• Use el filtro de estado en "En proceso" para saber en un segundo qué tiene el taller trabado dentro.

Para qué sirve

Es la pantalla de arranque de la app: resume cómo va el negocio hoy y en el mes. Muestra ventas, tasa, cuentas por cobrar y por pagar, utilidad y alertas de inventario en un solo golpe de vista. Es a donde cae todo usuario que no sea vendedor al iniciar sesión (el vendedor cae en el POS).

Qué ves al entrar

• Arriba, dos banners condicionales: "Tu pago se está verificando" (amarillo, cuando el plan quedó en pending_payment) y "Verifica tu correo electrónico" (amarillo, si la cuenta no tiene el correo confirmado). También aparece el banner global de estado del plan.
• Si vienes de confirmar tu correo, salta un aviso verde arriba: "Tu correo ha sido verificado ✓".
• Una fila de 7 tarjetas con icono de color:
  • Ventas hoy ($)
  • Ventas hoy (Bs)

  • Ventas hoy

  • Tasa del día
  • Por cobrar
  • Por pagar
  • Utilidad del mes (verde si es positiva, roja si es negativa)
• Tarjeta "Productos con stock bajo (N)": lista de productos con su stock actual y el mínimo configurado, de a 5 por página con paginador. Si no hay nada, dice "Sin alertas de stock."
• Un segundo bloque de KPIs: Ventas del mes, Ingresos del mes, Utilidad / Gastos y CxC vencidas (con chip del monto total vencido si hay alguna).
• Tarjeta "Productos más vendidos del mes" con ranking numerado y unidades vendidas.
• Tarjeta grande de Cuentas por cobrar vencidas con la cantidad y el monto, o "No hay cuentas vencidas" en verde.

Formularios / diálogos

No tiene. Es una pantalla de solo lectura.

Acciones disponibles

Reglas y validaciones

• La página exige el permiso read sobre reports; un usuario con rol vendedor no la ve y es redirigido al POS.
• Los datos vienen de dos llamadas paralelas: resumen del día y KPIs del mes. No hay refresco automático: hay que recargar la pantalla.
• El banner de pago pendiente consulta el estado cada 30 segundos por su cuenta y desaparece solo cuando el plan pasa a activo.
• El banner de notificaciones de la barra superior se refresca cada 60 segundos.
• La lista de stock bajo usa el safety_stock (stock mínimo) definido en cada producto.

Tips de uso

• Si "Tasa del día" muestra un guion, no hay tasa cargada hoy: nadie puede vender en bolívares bien hasta que la cargues (o la traiga la fuente automática configurada en el perfil).
• Usá la tarjeta de stock bajo como lista de compra: los productos que aparecen ahí son los que ya rozan su mínimo.
• Si "Utilidad del mes" está en rojo, cruzá con la tarjeta "Utilidad / Gastos" para ver cuánto pesa el gasto del mes.
• Las CxC vencidas son plata que ya debiste cobrar: entrá a Cuentas por cobrar desde el módulo correspondiente para gestionarlas.

Para qué sirve

Es el centro de configuración de tu cuenta y de tu negocio. Desde acá cambiás tus datos personales y tu contraseña, y si sos administrador también editás los datos del comercio, el logo que sale en los comprobantes, el rubro del negocio y las preferencias de crédito y tasa.

Qué ves al entrar

• Una tarjeta de identidad arriba: avatar, tu nombre, tu correo, y tres chips: rol + plan (ej. "Administrador · Plan Avanzado"), estado del correo ("Correo verificado" en verde o "Correo sin verificar" en amarillo) y el nombre del negocio. A la derecha, botones "Mi plan" y "Usuarios" (este último solo para admin).
• Debajo, tarjetas en dos columnas:
  • Datos personales (todos los usuarios)
  • Seguridad — Cambiar contraseña (todos los usuarios)
  • Datos del comercio + sección Rubro del negocio (solo admin)
  • Logo del negocio (solo admin)
  • Preferencias del negocio, a lo ancho (solo admin)
• Cada guardado exitoso muestra un aviso verde abajo a la derecha.

Formularios / diálogos

Datos personales

Si cambiás el correo aparece una advertencia amarilla: al cambiarlo hay que verificarlo de nuevo y no podés usar Valanz hasta confirmarlo.

Seguridad — Cambiar contraseña

Aviso permanente: al cambiar la contraseña se cierran tus sesiones en otros dispositivos (por ejemplo la app móvil); esta sesión sigue abierta.

Datos del comercio (solo admin)

Nota fija: la dirección no se edita acá — vive en cada sucursal y es la que sale en los documentos; se edita en Sucursales.

Rubro del negocio (solo admin, y solo dentro de la ventana de 72 horas)

Al elegir un rubro distinto, antes de poder confirmar aparece un recuadro con: los módulos que dejarás de ver (y cuántos registros de cada uno quedan inaccesibles), los módulos que se habilitan, y la aclaración de que no se borra nada. Vencida la ventana, el campo queda en solo lectura con un aviso de que el cambio lo hace soporte.

Logo del negocio (solo admin)

Aviso: el logo sale en el encabezado de los comprobantes PDF (ventas, notas de entrega, notas de crédito y órdenes de trabajo).

Preferencias del negocio (solo admin)

Acciones disponibles

Reglas y validaciones

• Los botones de guardar se mantienen apagados mientras no haya cambios reales respecto a lo guardado.
• El correo debe ser único entre usuarios; el propio correo actual se ignora en esa validación (reenviar el mismo no falla).
• Contraseña nueva: mínimo 8 caracteres y confirmación idéntica. La confirmación se chequea primero en el navegador ("Las contraseñas no coinciden.").
• El logo se valida dos veces: en el navegador (tipo imagen y ≤ 2 MB) y en el servidor (image, máximo 2048 KB).
• Los campos plan, plan_status, vertical y demás datos sensibles no se aceptan por este formulario aunque se envíen: se descartan del lado del servidor.
• El cambio de rubro exige confirmación explícita y solo se permite dentro de la ventana de 72 horas desde el registro; pasada esa ventana el servidor responde 422 con la fecha en que venció y la sección pasa a solo lectura.
• Un módulo compartido entre dos rubros (por ejemplo Recetas entre Alimentos y Gastronomía) no se pierde al cambiar entre ellos.
• Las secciones de comercio, rubro, logo y preferencias solo se muestran a quien tenga permiso de gestión de usuarios (rol Administrador).

Tips de uso

• Antes de tocar el rubro, mirá el recuadro de impacto: te dice exactamente cuántos registros van a dejar de verse. Nada se borra, pero el menú cambia entero.
• Si querés la tasa sin trabajo manual, poné una fuente automática en Preferencias y olvidate de cargarla todos los días.
• Subí el logo apenas arranques: aparece en todos los PDF que le entregás al cliente.
• Cambiá la contraseña si prestaste el acceso a alguien: eso además desloguea la app móvil de todos lados.

Para qué sirve

Sirve para dar de alta a la gente que va a trabajar en el sistema, asignarle un rol y activarla o desactivarla. Cada usuario activo ocupa un asiento del plan contratado.

Qué ves al entrar

• Tarjeta "Usuarios". Arriba a la derecha, un chip con el consumo de asientos: "2 / 5 usados" (rojo si llegaste al tope) o "Usuarios ilimitados" en verde si tu plan no tiene límite. Al lado, el botón "Nuevo usuario".
• Si llegaste al límite, un aviso amarillo explica cuántos usuarios activos permite tu plan y ofrece dos salidas: desactivar a alguien o mejorar el plan (enlace a Mi plan).
• Tabla con columnas Nombre, Email, Rol (desplegable editable en la misma fila), Estado (chip Activo/Inactivo) y Acciones.
• Si no hay nadie, la tabla dice "Sin usuarios."
• Los errores del servidor aparecen en un aviso rojo cerrable arriba de la tabla.

Formularios / diálogos

Diálogo "Nuevo usuario"

Acciones disponibles

Reglas y validaciones

• La página exige el permiso manage sobre users: solo el administrador entra.
• El correo debe ser único en todo el sistema.
• La contraseña temporal debe tener al menos 8 caracteres.
• Roles válidos: admin, gerente, vendedor — no hay otros.
• No podés desactivar tu propia cuenta: el servidor lo rechaza con "No puedes desactivar tu propia cuenta."
• Siempre debe quedar al menos un administrador activo: si intentás bajarle el rol al último admin o desactivarlo, el servidor responde "Debe quedar al menos un administrador activo."
• Solo cuentan como asientos los usuarios activos. Crear un usuario nuevo o reactivar uno inactivo dispara la verificación del límite; si lo superás, el servidor responde con el mensaje "Tu plan permite hasta N usuarios activos. Mejora a un plan superior para agregar más."
• El contador del chip se calcula sobre la lista cargada en pantalla, así que refleja el cambio apenas activás o desactivás a alguien.
• Si el servidor rechaza un cambio de rol o de estado, la lista se recarga para volver al estado real.

Tips de uso

• Cuando alguien se va del negocio, desactivalo en vez de intentar borrarlo: liberás el asiento y conservás su historial de ventas.
• Dejá siempre dos administradores activos si podés; si el único admin pierde acceso, hay que llamar a soporte.
• Elegí bien el rol: el vendedor entra directo al POS y no ve reportes ni el dashboard.
• La contraseña temporal la ves solo vos al crearla: pasásela a la persona y pedile que la cambie desde Mi perfil.

Para qué sirve

Muestra qué plan tenés contratado, en qué estado está (prueba, activo, vencido o suspendido), cuándo vence y qué funciones te habilita. También trae la comparativa de los tres planes y los datos de contacto para cambiar de plan o renovar.

Qué ves al entrar

• Si llegaste acá porque intentaste abrir un módulo que tu plan no incluye, un aviso azul te dice qué función pediste y qué plan la habilita.
• Si tu plan está suspendido, un aviso rojo: "Tu plan está suspendido por falta de pago. Renueva para volver a usar Valanz."
• Tarjeta "Tu plan actual" con un chip de estado (Prueba / Activo / Pago vencido / Suspendido) y:
  • El nombre del plan en grande, el precio mensual y el ciclo de facturación (Mensual / Semestral / Anual)
  • Si estás en prueba, un aviso con los días que te quedan de prueba en Avanzado
  • La fecha de vencimiento, formateada en español
  • Los usuarios incluidos (o "Ilimitados")
  • Los chips de todas las funciones activas de tu plan
• Comparativa de los tres planes en columnas. Cada tarjeta muestra el precio por mes y su lista de beneficios; como los planes son acumulativos, cada uno arranca con "Todo lo del <plan anterior>" y luego lista solo lo que suma. El plan que tenés hoy queda resaltado con el chip "Actual".
• Debajo, una línea con los descuentos vigentes por ciclo y la duración de la prueba gratis.
• Tarjeta final de contacto con el correo de soporte y el WhatsApp.

Formularios / diálogos

No tiene formularios. El cambio de plan no es autoservicio: se gestiona por contacto.

Acciones disponibles

Reglas y validaciones

• La página está marcada como pública dentro de la app: se puede abrir aun con el plan suspendido, justamente para poder resolver el pago.
• El precio, las funciones, los descuentos y los días de prueba salen del catálogo real del servidor, no están escritos a mano en la pantalla.
• Los planes son acumulativos: cada uno incluye todo lo del anterior más lo suyo.
• El banner de estado del plan que se ve en el resto de la app no aparece en esta página (acá ya está todo explicado).
• El banner global avisa cuando quedan 7 días o menos de prueba, o 7 días o menos para que venza un plan pagado; se pone rojo si el pago está vencido o la cuenta suspendida.

Tips de uso

• Si te topás con un módulo bloqueado, el aviso azul de esta página te dice exactamente a qué plan tenés que subir.
• Pagando semestral o anual te ahorrás 20% y 30% respectivamente: conviene si ya sabés que vas a seguir.
• Revisá la fecha de vencimiento antes de que el banner se ponga rojo; una vez suspendido, la app queda limitada.
• Los chips de "Funciones activas" son la lista real de lo que podés usar hoy: si algo no está ahí, no está habilitado.

Para qué sirve

Es la puerta de entrada a Valanz. Ingresás con el correo y la contraseña de tu usuario y el sistema te lleva a la pantalla que corresponde a tu rol.

Qué ves al entrar

Pantalla partida en dos. A la izquierda (solo en pantallas medianas o grandes) una ilustración. A la derecha, la tarjeta con el saludo "¡Bienvenido a Valanz! 👋🏻", el subtítulo "Inicia sesión en tu cuenta para comenzar" y el formulario. Arriba a la izquierda, el logo de Valanz enlazado al inicio.

Formularios / diálogos

Formulario de acceso

Acciones disponibles

Reglas y validaciones

• Correo: obligatorio y con formato válido. Contraseña: obligatoria. Ambas se validan antes de enviar.
• Si las credenciales no coinciden, el servidor devuelve "Credenciales inválidas." bajo el campo de correo.
• Si tu cuenta fue desactivada por un administrador, no entrás: "Tu cuenta está desactivada. Contacta al administrador."
• Hay límite de 6 intentos por minuto por combinación de correo + IP. Al pasarse: "Demasiados intentos. Intenta de nuevo en un minuto."
• La página solo es accesible para quien no tiene sesión abierta.
• Tras un login exitoso se regenera la sesión (protección contra fijación de sesión).

Tips de uso

• Si te aparece "Demasiados intentos", esperá un minuto exacto en vez de seguir probando: cada intento reinicia el reloj de la queja.
• Si sospechás que te desactivaron la cuenta, el mensaje te lo dice explícito: llamá al admin del negocio, no a soporte.
• Si el sistema te devuelve al POS y esperabas el dashboard, es porque tu rol es vendedor.

Para qué sirve

Crea el negocio y su usuario administrador. Ofrece dos caminos: arrancar con 14 días gratis sin tarjeta, o pagar ahora un plan directamente desde el banco con confirmación por código (OTP).

Qué ves al entrar

• Ilustración a la izquierda (fija mientras el formulario scrollea) y la tarjeta "Crea tu negocio 🚀" a la derecha.
• Un selector de modo con dos botones: "14 días gratis" y "Pagar ahora". Debajo, una aclaración: en modo prueba, "Sin tarjeta. Al terminar el trial bajas a Básico hasta que renueves desde el panel."; en modo pago, "Pago directo con tu banco. Recibirás un código OTP para confirmar."
• En modo prueba el formulario pide solo negocio + administrador.
• En modo pago el formulario se numera en cuatro pasos: 1) elegí tu plan (tres tarjetas clickeables con precio y usuarios), 2) ciclo de facturación (Mensual / Semestral -20% / Anual -30%), un recuadro azul con el total en USD y su equivalente en bolívares a tasa BCV en vivo, 3) datos del negocio, 4) datos para pagar.
• Al enviar en modo pago se abre un diálogo modal para confirmar el código del banco.
• Si el landing te mandó con un plan preseleccionado, ya viene marcado.

Formularios / diálogos

Datos del negocio y del administrador (ambos modos)

Selección de plan y pago (solo modo "Pagar ahora")

Datos para pagar (solo modo "Pagar ahora")

Aclaración en pantalla: debe ser una cuenta a tu nombre; el banco te enviará un código por SMS o por su app.

Diálogo "Confirma con tu banco" (solo modo pago)

El diálogo muestra el monto exacto a debitar en bolívares, su equivalente en dólares y la tasa aplicada. Es persistente: no se cierra al hacer clic afuera.

Acciones disponibles

Reglas y validaciones

• Todos los campos del bloque de negocio son obligatorios; el correo debe ser único entre usuarios.
• Contraseña: mínimo 8 caracteres y confirmación idéntica (se valida en pantalla y en el servidor).
• El rubro debe ser uno de los ocho válidos.
• El casillero de política de privacidad se valida aparte: si no está marcado aparece "Debes aceptar la política de privacidad."
• El campo trampa oculto debe llegar vacío; si tiene algo, la respuesta es un genérico "Solicitud rechazada."
• Cédula, teléfono de pago y código de banco tienen validación de formato con mensajes propios ("Cédula inválida (formato V-12345678).", "Teléfono inválido (debe ser un móvil VE: 0412/0414/0416/0424/0426).", "Código de banco inválido (4 dígitos).").
• El código del banco debe ser numérico, de 4 a 8 dígitos.
• El total se calcula como precio mensual × meses del ciclo × (1 − descuento), redondeado a dos decimales.
• Estados del cobro y qué pasa en cada uno:
  • Esperando respuesta del banco: el banco recibió la solicitud pero no decidió. Se consulta cada 3 segundos hasta 60 segundos, con contador visible. No hay que cerrar la ventana.
  • Tiempo agotado (más de 60 s): aparece "Tu pago se está procesando". No se crea ninguna cuenta hasta que el banco confirme; cuando confirme, se crea y te llega el acceso por correo. El aviso insiste: no vuelvas a pagar.
  • Rechazado: el sistema aclara que si el banco te debitó hay que pedir la reversa al banco, pero que en la mayoría de los casos un rechazo significa que no debitó y se puede reintentar con otro código.
  • Expirado: se acabó el tiempo para confirmar; hay que cancelar y volver a intentar.
  • Confirmado: se muestra el enlace a la factura y, una sola vez, las credenciales del portal de facturas de Klienz. Con credenciales en pantalla no hay redirección automática: tenés que apretar "Continuar a mi dashboard" después de copiarlas.
  • Ya provisionado: si el registro ya se había completado, te manda al login en vez de duplicar la cuenta.
• Mientras corre la confirmación hay un chequeo de fondo cada 5 segundos por si el banco responde por otro camino.
• La página solo es accesible para quien no tiene sesión abierta.

Tips de uso

• Elegí bien el rubro: define qué módulos vas a ver. Podés corregirlo desde Mi perfil, pero solo dentro de las primeras 72 horas.
• Si vas a pagar, tené el teléfono a mano: el código del banco llega por SMS o por la app y tiene tiempo limitado.
• Si el banco tarda y aparece "Tu pago se está procesando", cerrá tranquilo y esperá el correo: pagar de nuevo te va a cobrar dos veces.
• Si te muestran las credenciales del portal de facturas, copiá la contraseña antes de continuar: solo se ven esa vez (aunque también se pueden recuperar por correo).
• Semestral y anual salen 20% y 30% más baratos, y el total en bolívares se muestra en vivo antes de confirmar.

Para qué sirve

Sirve para pedir un enlace de restablecimiento cuando no te acordás de tu contraseña. El enlace llega al correo de tu usuario y te lleva a la pantalla donde ponés la clave nueva.

Qué ves al entrar

Pantalla partida igual que el login: ilustración a la izquierda, tarjeta a la derecha con el título "Forgot Password? 🔒" y una sola casilla de correo. Al enviar, aparece debajo un mensaje verde de confirmación.

Formularios / diálogos

Solicitud de enlace

Acciones disponibles

Reglas y validaciones

• El correo es obligatorio y debe tener formato válido; se valida antes de enviar.
• La respuesta es siempre la misma, exista o no el correo: "Si el correo existe, recibirás instrucciones para restablecer tu contraseña." Esto es a propósito: evita que alguien use la pantalla para averiguar qué correos están registrados.
• Límite de 3 solicitudes por minuto por combinación de correo + IP. Al pasarse: "Demasiados intentos. Intenta de nuevo en un minuto."
• El enlace es de un solo uso. Al restablecer la contraseña se exige mínimo 8 caracteres y confirmación, y se revocan todos los tokens móviles de esa cuenta.
• La página solo es accesible para quien no tiene sesión abierta.

Tips de uso

• El mensaje de éxito no confirma que el correo exista: si no llega nada en unos minutos, probá con otra dirección o preguntale al admin cuál quedó registrada.
• Revisá la carpeta de correo no deseado antes de pedir un segundo enlace: solo se aceptan 3 por minuto.
• Después de restablecer, la app móvil te va a pedir iniciar sesión de nuevo: es normal, se revocaron los accesos viejos.
• Si ya estás dentro de la app, no uses esta pantalla: cambiá la clave desde Mi perfil, que además pide la contraseña actual.

La barra superior está presente en todas las pantallas internas (no en login, registro ni recuperación de contraseña) y tiene, de izquierda a derecha:

Botón de menú — Solo en pantallas chicas (móvil y tablet). Abre el menú lateral superpuesto.

Buscador global — Ocupa todo el ancho libre de la barra. Placeholder: "Buscar productos, estantes o módulos…". Se enfoca con Ctrl+K (o ⌘K en Mac), y el atajo se muestra a la derecha del campo cuando está vacío.

• Sin escribir nada, ofrece accesos frecuentes: POS, Productos, Ubicaciones, Clientes, Ventas y Caja (solo los que tu rol y tu plan permiten).
• Al escribir, los resultados se agrupan en tres secciones: Módulos (filtrado instantáneo, sin ir al servidor), Productos y Ubicaciones (se consultan al servidor con 300 ms de espera tras dejar de tipear).
• Cada producto muestra referencia, código y stock; si tiene ubicación asignada, el estante aparece primero como chip azul (hasta dos estantes, con "…" si hay más).
• La búsqueda ignora acentos.
• Los módulos listados respetan el rubro del negocio, las funciones de tu plan y tus permisos: no aparece nada que te lleve a un muro de 403.
• Si no hay coincidencias muestra "Nada coincide con «…»".

Cambio de tema — Botón que alterna entre tres modos: Claro (sol), Oscuro (luna) y Sistema (sigue la configuración del equipo).

Accesos rápidos — Menú con atajos a los módulos más usados, filtrados por permiso, rubro y plan: Vender (POS), Caja (cierre del día), Productos (inventario), Por cobrar, Gastos y Reportes. "Por cobrar" y "Reportes" solo aparecen si tu plan incluye esas funciones.

Notificaciones — Campana con un contador rojo de pendientes. Al abrirla se despliega la lista de alertas accionables del negocio, cada una con icono de color según la severidad (error, advertencia o informativa) y un clic te lleva directo al módulo correspondiente. Si no hay nada, dice "Todo al día, sin pendientes". Se refresca sola cada 60 segundos y nunca rompe la barra si falla la consulta.

Menú de usuario — Avatar a la derecha. Muestra tu nombre y tu rol, y ofrece:

• Mi perfil (todos los usuarios)
• Usuarios (solo administradores)
• Cerrar sesión (en rojo) — cierra la sesión y te devuelve al login

Menú lateral — Se arma dinámicamente: los módulos se filtran por el rubro del negocio y por las funciones de tu plan, y el encabezado de la sección toma el nombre del rubro (por ejemplo "Gastronomía"). Cuando el admin cambia el rubro desde Mi perfil, el menú se refiltra al instante sin recargar la página. El personal de Valanz (super administradores) ve además una sección "Admin Valanz" con acceso a Negocios.

Selector de sucursal: no existe como control en la barra superior. Las sucursales se administran desde el módulo Sucursales, y es la dirección de cada sucursal la que sale impresa en los documentos.

Los planes son acumulativos: cada uno incluye todo lo del anterior más lo suyo.

Descuentos por ciclo de facturación

Prueba gratuita: 14 días al registrarte, con las funciones del plan Avanzado. Al terminar la prueba la cuenta baja a Básico hasta que se contrate un plan.

Notas importantes sobre los límites:

• Solo los usuarios activos consumen asientos del plan. Desactivar a alguien libera su asiento de inmediato.
• El límite se verifica al crear un usuario nuevo y al reactivar uno inactivo.
• El cambio de plan no es autoservicio: se pide por correo a soporte@valanz.sekinsoft.com o por WhatsApp al 0422-5050631.
• Los módulos que ves además dependen del rubro del negocio, que es independiente del plan. Por ejemplo, Mesas y Mesoneros pertenecen a Gastronomía; Vehículos a Automotriz y Repuestos; Citas y Órdenes de servicio a Servicios; Seriales a Electrónica; Temporadas a Moda; y Recetas y Lotes son compartidos entre Alimentos y Gastronomía.