MANUAL DE OPERACION · VERSION 0.1.17
Tu negocio,
siempre en control.
Guia de caja, catalogo, inventario, compras, recetas, farmacia, restaurante y servicios.
Portal POS: tzpos.vexialabs.world ·
Consultorio: consultoriotz.vexialabs.world
Para guardar una copia en PDF, pulsa Imprimir / Guardar PDF · Carta y en el dialogo de impresion elige Guardar como PDF. El tamaño de papel esta configurado como Carta.
1. Primeros pasos
Acceso y seguridad
- Abre la aplicacion POS de Windows/Android o el portal web e inicia sesion con la cuenta que te asigno el administrador.
- Comprueba que el nombre del negocio y los modulos disponibles correspondan a tu tienda. El menu se adapta a los permisos de tu cuenta.
- No existe una clave demo predeterminada. Usa una cuenta de prueba separada y desactivala al terminar.
POS WindowsInstala el MSI o extrae el ZIP completo. No ejecutes el EXE separado de los archivos DLL y de la carpeta data.
POS AndroidInstala el APK proporcionado por el administrador; Android solicitara confirmar la instalacion.
Preparar el negocio
- Selecciona los giros comerciales que utilizaras: tienda, farmacia, restaurante y/o servicios.
- Registra categorias, productos, precios, unidades e impuestos antes de operar.
- Asigna a cada persona solo los permisos y el perfil necesarios para su puesto.
2. Caja, ventas y turnos
- Con permiso de turno, pulsa Abrir turno e indica el fondo inicial de efectivo.
- Busca el producto por nombre o codigo de barras. Los lectores USB/Bluetooth deben enviar Enter al terminar; en Android puedes usar la camara si esta disponible.
- Agrega productos, revisa cantidades, descuentos e impuestos, y confirma el total antes de cobrar.
- Elige efectivo, tarjeta, transferencia o cuenta de cliente. La tarjeta se captura despues de aprobarla en una terminal externa: el POS no procesa ni almacena datos bancarios.
- Confirma la venta una sola vez. La app muestra el recibo y permite reimprimirlo si falla la impresora.
- Al terminar el turno, cuenta el efectivo y usa Cerrar turno.
En efectivo, el POS muestra el cambio e intenta imprimir el recibo y abrir el cajon conectado a la impresora. Una falla de impresion no anula una venta ya confirmada.
Algunas cuentas pueden vender a credito. El backend verifica que el cliente este activo y que su limite permita el cargo.
3. Modo sin conexion y sincronizacion
El modo offline permite continuar ciertas ventas cuando el dispositivo pierde temporalmente la comunicacion. La disponibilidad depende de que la sesion haya iniciado y de que el catalogo y los permisos se hayan sincronizado previamente.
- Antes de trabajar sin Internet, abre la app con conexion y espera a que carguen productos, categorias, permisos y configuracion.
- Si se pierde la red, registra solo los productos disponibles en el catalogo local y evita acciones que requieren autorizacion en linea, como modificar usuarios o precios.
- Las ventas pendientes se guardan en el dispositivo y se identifican para sincronizarse; no cierres ni desinstales la aplicacion antes de recuperar la conexion.
- Al volver la red, usa Sincronizar o actualiza la pantalla y espera la confirmacion. Si una venta se rechaza, revisa el producto, existencias y permisos antes de volver a intentarlo.
El modo offline no coordina inventario entre cajas desconectadas. Cada dispositivo trabaja con su copia local; sincroniza cuanto antes para reducir diferencias y no registres de nuevo una venta pendiente.
4. Productos, inventario y unidades
En Inventario, filtra productos por giro, busca por nombre/codigo y abre una ficha para revisar existencias, unidad, costo, lote y caducidad. Para crear o editar productos se requiere catalog.manage; recibir stock requiere inventory.manage.
Unidades compatibles
La existencia puede controlarse en una unidad y capturarse en otra dentro de la misma dimension. El POS convierte automaticamente masa (kg, g, mg) y volumen (l, ml). Para unidades discretas usa pieza u otra unidad identica.
| Conversion | Equivalencia | Ejemplo |
| Masa | 1 kg = 1,000 g; 1 g = 1,000 mg | 0.2 kg = 200 g |
| Volumen | 1 l = 1,000 ml | 0.5 l = 500 ml |
| Incompatibles | No convierte masa a volumen ni pieza a kg | g y ml no son intercambiables |
El numero siempre se expresa en la unidad visible. Si editas una receta y cambias kg por g, la cantidad tambien se convierte: de 0.2 kg a 200 g. Esto conserva el consumo; no equivale a escribir 0.2 g.
Lotes y caducidades
- Al recibir mercancia, registra cantidad, lote y fecha de caducidad para mantener trazabilidad.
- Para productos existentes, usa Recibir lote; no sobrescribas las existencias manualmente para representar una compra.
- La importacion CSV crea codigos nuevos y puede recibir stock/lotes para existentes; revisa el resumen de filas antes de repetir una importacion.
5. Abastecimiento y compras
- Registra el proveedor con nombre y datos de contacto.
- Revisa las sugerencias de compra basadas en existencias y minimos configurados o crea una orden manual.
- Para cada linea indica producto, cantidad, unidad de compra y costo por esa unidad. El sistema muestra la existencia y el costo estimado convertido.
- Al recibir, captura la cantidad realmente entregada. Se permiten recepciones parciales hasta cubrir el saldo pedido.
- Asocia lote y caducidad cuando corresponda y confirma la recepcion una sola vez.
La orden conserva cantidades en la unidad de compra. Al recibir gramos de un producto inventariado en kg, convierte la recepcion a kg y normaliza el costo para calcular el costo promedio. Unidades de dimensiones distintas se rechazan.
Ejemplo: ordena 500 g de tomate con inventario en kg y recibe 200 g. El stock aumenta 0.2 kg; los 300 g pendientes siguen en la orden.
6. Recetas, comandas y cocina
Capturar y consumir recetas
- En Recetas y costos, elige el platillo/producto y agrega cada ingrediente.
- Indica la cantidad por porcion y selecciona su unidad de receta. Puedes usar gramos aunque el inventario se controle en kg.
- Guarda la receta y revisa el costo. Para opciones diferentes del platillo, crea variantes con sus propios ingredientes, precio y cantidades.
- Al cobrar una venta o comanda, el backend convierte las cantidades a la unidad del inventario y descuenta los ingredientes. Si falta stock, indica el ingrediente insuficiente y no confirma el cobro.
Comanda y cocina
- El mesero elige la mesa, agrega articulos y envia la comanda a cocina; si ya existe una cuenta abierta, los articulos se agregan a ella.
- Cocina cambia cada partida entre Pendiente, Preparando, Listo y Entregado. Las partidas preparadas no se pueden retirar como pendientes.
- Antes de cobrar, revisa la cuenta; agrega extras, divide por persona o por consumo, y selecciona forma de pago.
- El cobro cierra la cuenta y libera la mesa. Reintentar una operacion ya completada no debe duplicar el descuento ni el pago.
Delivery
Con permiso de comanda puedes registrar pedidos propios o de plataforma, folio externo e instrucciones de entrega. Esta captura manual no importa pedidos ni concilia tarifas o reembolsos directamente con Uber Eats, DiDi u otros proveedores.
7. Farmacia y Consultorio
Farmacia en el POS
- Registra los datos del medicamento, incluyendo nombre comercial, compuesto/sustancia activa, categoria legal, presentacion, unidad, lote y caducidad.
- Utiliza la busqueda para localizar por nombre comercial o compuesto quimico; confirma la presentacion y concentracion antes de dispensar.
- Clasifica el producto conforme al grupo de control configurado para la farmacia (I a VI). La exigencia de receta, restricciones de surtido y resguardo dependen de esa clasificacion y de las normas aplicables; valida los datos con el responsable sanitario.
- Para un producto que requiere receta, registra la receta y adjunta su imagen cuando la pantalla lo solicite. Guarda el ticket asociado para archivarlo con el comprobante correspondiente.
- El fraccionamiento se permite unicamente en productos marcados como fraccionables. El sistema rechaza cantidades decimales para medicamentos que no lo permiten.
- Controla compras, lotes y caducidades desde Inventario y Abastecimiento. Revisa alertas y evita dispensar existencias vencidas.
Aplicacion independiente de Consultorio
TechZone Consultorio es distinta del POS y usa sesiones/licencias propias. El flujo clinico conecta pacientes, agenda, consulta y receta digital con la farmacia segun la configuracion del negocio. Captura solo datos necesarios, confirma la identidad del paciente y protege el acceso a expedientes. Consulta los controles disponibles en Consultorio.
La aplicacion no sustituye el criterio medico ni la verificacion de requisitos legales. La integracion con SAT, timbrado fiscal y firma electronica certificada no esta habilitada en esta version.
8. Cotizaciones, proyectos y servicios
- Registra cliente, concepto, alcance, partidas, cantidades, precios y vigencia para preparar una cotizacion.
- Antes de convertirla, confirma los datos y la aprobacion del cliente; conserva el folio para rastrear el trabajo.
- En proyectos, organiza etapas e hitos, define fechas, responsables y cobros parciales cuando el flujo este habilitado para tu cuenta.
- Registra tiempo por profesional, cliente y proyecto para consultar horas facturables.
- Captura anticipos y gastos asociados al servicio para aplicarlos o incluirlos en la cuenta final.
- Las igualas/servicios recurrentes pueden controlarse desde el modulo disponible; valida manualmente periodo, importe y recordatorios.
Los enlaces de pago, conciliacion bancaria automatica SPEI/ACH, firma digital certificada y conectores fiscales externos no estan habilitados. No informes a un cliente que un pago o contrato quedo verificado hasta confirmarlo por el canal autorizado.
9. Reportes, credito e impuestos
- Reportes y ventas: consulta ventas por periodo, partidas, pagos, impuestos y costo/margen estimados. Exportar requiere permisos financieros.
- Cuentas y abonos: el saldo cambia al confirmar cargos a credito o abonos; revisa cuenta, importe y forma de pago antes de guardar.
- Impuestos: un usuario autorizado crea IVA, IEPS o tasas personalizadas y las asigna a productos. El servidor calcula el total de la venta.
- Ofertas: define descuento, productos, compra minima, vigencia y horario. Revisa el precio final antes del cobro.
- Facturacion: el portal de demostracion registra solicitudes, pero no timbra CFDI ni genera documentos fiscales validos.
Los datos de costos y margenes son estimaciones basadas en los costos registrados. Consulta a la persona responsable antes de usarlos como cierre contable.
10. Configuracion, permisos y dispositivos
Impresora y cajon
- En Configuracion elige impresora USB o de red, escribe su IP y puerto RAW (normalmente
9100) y selecciona papel de 58 u 80 mm.
- Usa Probar impresion. El cajon se conecta al puerto RJ11 de una impresora ESC/POS compatible, nunca directamente al PC.
- El logo del ticket se carga y configura en el diseñador; es independiente del icono de la aplicacion y del logotipo del negocio.
Perfiles, modulos y licencias
El administrador configura giros habilitados y asigna permisos por usuario. POS de escritorio y Android tienen cupos de dispositivos separados; Consultorio cuenta con sesiones separadas. Verifica el limite exacto de la licencia en Administracion antes de iniciar sesion en otro equipo.
Actualizaciones
La version de escritorio comprueba actualizaciones y verifica el SHA-256 del paquete antes de mostrar la instalacion. Descarga solo desde el portal oficial y sigue el asistente de Windows/Android. No cierres el equipo durante una recepcion o sincronizacion pendiente.
11. Solucion de problemas y buenas practicas
| Problema | Que revisar |
| No aparece el modulo | Solicita al administrador revisar el giro comercial, el perfil asignado y los permisos de la cuenta. |
| No deja elegir gramos | Confirma que la unidad de inventario sea de masa (kg, g o mg), selecciona el ingrediente y vuelve a abrir la lista de unidades. |
| Cantidad cambia inesperadamente | La cantidad se convierte al cambiar unidad: 0.2 kg = 200 g. Verifica ambos unidad y cantidad antes de guardar. |
| No descuenta una receta | Revisa que la venta/comanda se haya cobrado, la receta pertenezca al producto y haya suficiente stock del ingrediente en su unidad base. |
| Compra no se recibe completa | La recepcion parcial conserva saldo por recibir; confirma la unidad y captura solo la cantidad que llego. |
| Impresora no responde | Verifica energia, conexion, IP/puerto, papel y ancho. La venta confirmada no se duplica: reimprime desde el recibo. |
| No sincroniza | Recupera Internet, actualiza la app y espera. No repitas una venta que aun aparece pendiente. |
Antes de cerrar cada turno
- Confirma que no haya ventas offline pendientes ni ordenes de compra parcialmente recibidas sin documentar.
- Revisa cancelaciones, pagos a cuenta y comandas abiertas con la persona responsable.
- Cierra el turno y compara efectivo contado con el reporte.
- No compartas contrasenas, claves SSH, tokens ni datos de pacientes por chat.
Para soporte, anota dispositivo, version, fecha/hora y folio de la operacion; no envies contrasenas, datos de tarjeta ni expedientes clinicos.