Sistema de Punto de Venta

Manual Completo de Usuario

Versión: 3.0 — Cuentas por Cobrar · Roles Duales · POS Táctil

Módulos: POS · Ventas Mayorista · Cuentas por Cobrar · Caja · Devoluciones · Reportes · Admin

Fecha: Abril 2026

📋 Tabla de Contenidos

Introducción
1. Descripción del Sistema 3
2. Roles y Permisos 3
3. Acceso e Inicio de Sesión 4
Módulo POS (Punto de Venta en Caja)
4. Realizar una Venta en el POS 5
5. Pago con Efectivo 6
6. Pago con Tarjeta (Square) 6
7. POS Táctil — Teclado Numérico y Pantalla Completa 7
8. Recibo de Venta — Imprimir y Enviar por Email 8
9. Devoluciones POS 9
10. Void / Refund desde el Recibo (Admin/Supervisor) 10
11. Historial de Ventas POS 11
12. Módulo Caja 11
Módulo Ventas al Mayor
13. Crear Venta Mayorista 12
14. Devolución de Venta Mayorista 13
15. Historial de Devoluciones Mayoristas 14
Módulo Cuentas por Cobrar
16. Qué son las Cuentas por Cobrar 15
17. Crear una Cuenta por Cobrar 15
18. Registrar un Abono 16
19. Estados de la Cuenta 16
Administración
20. Productos y Categorías 17
21. Clientes 17
22. Compras / Proveedores 18
23. Reportes 18
24. Configuración del Sistema 19
25. Gestión de Usuarios 20
Referencia
26. Preguntas Frecuentes 21
27. Glosario Square Payments 22

1. Descripción del Sistema

Sistema de Punto de Venta empresarial con soporte para ventas retail (POS), ventas al mayor con crédito, cuentas por cobrar, integración Square, devoluciones con reembolso automático, reportes de cartera y administración completa.

🏪 POS (Caja)

Ventas rápidas en mostrador optimizadas para pantallas táctiles. Pago con efectivo o tarjeta Square.

📦 Ventas al Mayor

Ventas a clientes registrados con facturas PDF, crédito y seguimiento de cartera.

💰 Cuentas por Cobrar

Gestión de crédito mayorista: saldos pendientes, abonos parciales, vencimientos y cartera vencida.

↩️ Devoluciones

Devolución por producto con reembolso automático a tarjeta Square. Historial con constancia.

📊 Reportes

Ventas por período, productos más vendidos, cartera pendiente y vencida, exportación PDF/Excel.

🗃️ Caja

Reporte de caja diario con resumen de ingresos por método de pago.

2. Roles y Permisos

El sistema tiene cuatro roles de acceso. El Administrador los asigna al crear cada usuario.

Rol Módulos accesibles Restricciones
👑 Administrador Acceso total: POS, Mayoreo, Cuentas por Cobrar, Caja, Reportes, Usuarios, Configuración Ninguna
🔧 Supervisor POS, Mayoreo, Cuentas por Cobrar, Caja, Reportes, Devoluciones, Void/Refund No gestiona usuarios ni configuración del sistema
🛒 Vendedor Detalle Solo POS: realizar venta, lista de ventas POS, devoluciones POS Sin acceso a Ventas al Mayor, Cuentas por Cobrar, Caja ni Reportes
📦 Vendedor Mayoreo Ventas al Mayor, Lista Venta Mayor, Facturas, Devoluciones Mayor, Cuentas por Cobrar Sin acceso al POS de caja, Lista POS, Devoluciones POS, Caja ni Reportes
⚠️
Las operaciones de Void y Refund desde el recibo son exclusivas de Admin y Supervisor. Requieren confirmación con contraseña personal.

3. Acceso e Inicio de Sesión

  1. Abrir el navegador y acceder a la URL del sistema proporcionada por el administrador.
  2. Ingresar el nombre de usuario y contraseña asignados.
  3. Hacer clic en Ingresar.
  4. El sistema redirige automáticamente al dashboard mostrando solo los módulos del rol asignado.
💡
La sesión expira automáticamente después de 30 minutos de inactividad. El sistema pedirá iniciar sesión nuevamente.
🏪

Módulo POS — Punto de Venta en Caja

Ventas rápidas en mostrador con cobro en efectivo o tarjeta

4. Realizar una Venta en el POS

Desde el menú lateral ir a Sistema de Ventas → POS. La pantalla muestra el catálogo de productos a la izquierda y el carrito a la derecha.

Admin Supervisor Vendedor Detalle
  1. Buscar el producto en el buscador o filtrarlo por categoría haciendo clic en los chips de categoría.
  2. Tocar o hacer clic en la tarjeta del producto — se agrega al carrito.
  3. Ajustar la cantidad con los botones + / − o tocar el número para abrir el teclado numérico.
  4. Repetir para cada producto.
  5. Opcionalmente seleccionar un cliente en el campo de búsqueda del carrito.
  6. Hacer clic en Cobrar.
  7. Elegir método de pago: Efectivo, Tarjeta o Terminal.
  8. Completar el cobro según el método elegido (ver secciones 5 y 6).
💡
Si el producto no aparece en el catálogo, verificar que tenga stock mayor a 0 en el módulo de Productos.

5. Pago con Efectivo

  1. Seleccionar Efectivo en los botones de método de pago.
  2. Ingresar el monto entregado por el cliente (usando el teclado numérico o el campo de texto).
  3. El sistema calcula automáticamente el cambio.
  4. Hacer clic en Confirmar Venta.
  5. El sistema registra la venta, descuenta el stock y muestra el recibo.

6. Pago con Tarjeta (Square)

Admin Supervisor Vendedor Detalle
  1. Seleccionar Tarjeta en los botones de método de pago.
  2. Se abre el formulario seguro de Square para ingresar los datos de la tarjeta.
  3. El cliente ingresa número de tarjeta, fecha de vencimiento y CVV.
  4. Hacer clic en Pagar con Tarjeta.
  5. Square procesa el pago (3-5 segundos).
  6. Al aprobarse, el sistema registra la venta con el ID de transacción Square y muestra el recibo.
⚠️
Si Square muestra error, verificar que la tarjeta tenga fondos o intentar con otra tarjeta. El sistema no registra la venta si Square no aprueba el pago.
Tarjetas de prueba (Sandbox)Resultado
4111 1111 1111 1111✅ Aprobada
4000 0000 0000 0002❌ Declinada
CVV: cualquier 3 dígitos — Vencimiento: cualquier fecha futura

7. POS Táctil — Teclado Numérico y Pantalla Completa

El POS está optimizado para pantallas táctiles. Todos los botones tienen tamaño mínimo de 48×48px para facilitar el uso en tablets y monitores táctiles de caja.

🔢 Teclado Numérico Virtual

Tocar el número de cantidad en el carrito o el campo de Dinero Entregado abre automáticamente el teclado numérico en pantalla. No se necesita teclado físico para ingresar montos.

  1. Tocar el número de cantidad en el carrito.
  2. Ingresar el valor con el teclado en pantalla.
  3. Tocar OK para confirmar o para cancelar.

⛶ Pantalla Completa

El botón de pantalla completa (esquina superior derecha) expande el POS a fullscreen para maximizar el espacio de trabajo. También se activa automáticamente al primer toque en pantallas táctiles.

  1. Tocar el ícono de fullscreen en la barra superior.
  2. Para salir: tocar el mismo ícono o presionar Esc.

Botones de Método de Pago

En lugar de un menú desplegable, el POS muestra tres botones grandes para seleccionar el método de pago de forma táctil:

Efectivo

Pago en efectivo. El sistema solicita el monto entregado y calcula el cambio automáticamente.

Tarjeta

Pago con tarjeta de crédito/débito a través del formulario seguro de Square Web Payments.

💡
El campo de Dinero Entregado es de solo lectura — se ingresa exclusivamente con el teclado numérico en pantalla para evitar errores de tipeo en caja.

8. Recibo de Venta

Después de cada venta el sistema muestra el recibo completo. También se puede acceder desde Lista Venta POS → Ver Recibo.

Opciones de impresión

🖨️ Texto Plano (80mm)

Vista optimizada para impresoras de tickets térmicos. Es el modo por defecto.

  1. Hacer clic en Texto Plano (activo por defecto).
  2. Presionar Imprimir.
  3. Seleccionar la impresora térmica.

📄 Carta / A4

Vista formal para papel carta o A4. Incluye logo y datos de la empresa.

  1. Hacer clic en Carta/A4.
  2. Presionar Imprimir.
  3. Seleccionar la impresora de oficina.

Enviar Recibo por Email

  1. En el recibo, hacer clic en el botón Enviar por Email.
  2. Ingresar la dirección de correo del cliente.
  3. Opcionalmente personalizar el asunto y mensaje.
  4. Hacer clic en Enviar.
  5. El cliente recibe el recibo en formato HTML profesional.
💡
Si el cliente ya está registrado en el sistema con su email, el campo se pre-rellena automáticamente.

9. Devoluciones POS

Permite devolver uno o más productos de una venta POS. Si la venta fue con tarjeta, Square procesa el reembolso automáticamente.

Admin Supervisor

Cómo procesar una devolución

  1. Ir a Sistema de Ventas → Lista Devolucion POS.
  2. Buscar la venta por número, fecha o cliente.
  3. Hacer clic en Seleccionar en la venta correspondiente.
  4. Marcar los productos a devolver y especificar la cantidad.
  5. Ingresar el motivo de la devolución.
  6. Hacer clic en Procesar Devolución.
  7. El sistema descuenta el stock, registra la devolución y — si fue con tarjeta — envía el reembolso a Square.

💵 Venta con Efectivo

El reembolso se entrega en mano. El sistema registra la devolución como constancia pero no procesa movimiento electrónico.

💳 Venta con Tarjeta

Square procesa el reembolso automáticamente. El cliente recibe el dinero en 2-7 días hábiles. El sistema guarda el Square Ref ID como constancia.

💡
El botón de devolución se desactiva (gris) si la venta ya tiene una devolución procesada, evitando duplicados.

10. Void / Refund desde el Recibo

Operaciones avanzadas de anulación y reembolso directo con Square. Solo disponibles para Admin y Supervisor desde el recibo de cualquier venta POS con tarjeta.

Admin Supervisor
⚠️
Estas operaciones son irreversibles. Requieren contraseña del administrador o supervisor para confirmar.
OperaciónCuándo usarlaEfectoTiempo
Void (Anular) Mismo día, pocas horas después — cobro aún no liquidado Cancela el cobro — el cliente nunca ve el cargo Instantáneo
Refund (Reembolso) La venta ya fue liquidada por el banco Devuelve el monto total a la tarjeta del cliente 2-7 días hábiles
Partial Refund Reembolsar solo parte del monto Devuelve el monto parcial especificado 2-7 días hábiles
Void Item Eliminar un artículo específico de la venta Reembolso parcial por el valor del artículo 2-7 días hábiles

Cómo ejecutar un Void o Refund

  1. Abrir el recibo de la venta (desde Lista Venta POS → Ver Recibo).
  2. Hacer clic en Anular / Reembolso.
  3. Seleccionar el tipo de operación.
  4. Ingresar la razón (obligatorio).
  5. Ingresar la contraseña personal del Admin/Supervisor.
  6. Confirmar. Square procesa la operación en tiempo real.
  7. El sistema guarda el Square Ref ID en el historial como constancia.
🚫
Límite de seguridad: máximo 5 operaciones void/refund por cada 5 minutos por usuario para prevenir fraudes.

11. Historial de Ventas POS

Acceder desde Sistema de Ventas → Lista Venta POS.

ColumnaDescripción
ID VentaNúmero único. Badge Devuelto indica devolución procesada.
FechaFecha y hora de la venta.
TotalMonto total cobrado.
PagoTarjeta o Efectivo.
OpcionesVer Recibo · Imprimir · Devolución · Void/Refund (Admin/Supervisor)

12. Módulo Caja

Admin Supervisor

Acceder desde Sistema de Ventas → Caja. Muestra el resumen de caja del día.

📊 Reporte de Caja

  • Total de ventas del día
  • Desglose por método de pago (efectivo / tarjeta)
  • Número de transacciones
  • Total de devoluciones del día

💡 Uso recomendado

Revisar el reporte de caja al cierre del día para verificar que el total de efectivo en caja coincida con las ventas registradas en el sistema.

📦

Módulo Ventas al Mayor

Ventas a clientes registrados con facturas, crédito y seguimiento

13. Crear Venta Mayorista

Admin Supervisor Vendedor Mayoreo
  1. Ir a Sistema de Ventas → Venta al Mayor.
  2. Seleccionar el cliente de la lista desplegable.
  3. Agregar productos con sus cantidades y precios.
  4. Seleccionar el método de pago: Efectivo, Tarjeta o Crédito.
  5. Si es tarjeta, ingresar el ID de transacción Square.
  6. Si es a crédito, la venta quedará registrada en Cuentas por Cobrar.
  7. Hacer clic en Guardar Venta.
  8. El sistema genera la factura PDF automáticamente.

Listado de Ventas Mayoristas

Acceder desde Sistema de Ventas → Lista Venta Mayor. Muestra la columna Pago con Tarjeta o Efectivo. Badge Devuelto aparece si ya existe devolución.

14. Devolución de Venta Mayorista

Admin Supervisor Vendedor Mayoreo
  1. En el listado de ventas, hacer clic en ↩ Devolución.
  2. Seleccionar los productos a devolver y la cantidad.
  3. Ingresar el motivo.
  4. Hacer clic en Procesar Devolución.
  5. Si fue con tarjeta, Square procesa el reembolso y muestra el Square Ref ID.

15. Historial de Devoluciones Mayoristas

Acceder desde Sistema de Ventas → Lista Devolucion Mayor. El modal de detalle muestra: cliente, fecha, monto, tipo de acción, Square Ref ID y productos devueltos.

💰

Módulo Cuentas por Cobrar

Gestión de crédito exclusivo para ventas al mayor

16. Qué son las Cuentas por Cobrar

Las Cuentas por Cobrar registran las ventas al mayor realizadas a crédito — es decir, donde el cliente no pagó de contado y quedó con un saldo pendiente. El módulo permite hacer seguimiento de lo que cada cliente debe, registrar abonos parciales y detectar cuentas vencidas.

Admin Supervisor Vendedor Mayoreo
⚠️
Este módulo es exclusivo para ventas al mayor. Los vendedores de caja (Vendedor Detalle) no tienen acceso a este módulo.

Estados de una Cuenta

EstadoSignificado
Pendiente La cuenta tiene saldo por cobrar y aún no ha vencido la fecha límite de pago.
Vencido La fecha de vencimiento ya pasó y aún hay saldo pendiente. El sistema lo detecta automáticamente.
Pagado El saldo quedó en cero — todos los abonos cubrieron el monto total.

17. Crear una Cuenta por Cobrar

  1. Ir a Sistema de Ventas → Cuentas por Cobrar.
  2. Hacer clic en Nueva Cuenta por Cobrar.
  3. Seleccionar el cliente de la lista.
  4. Ingresar el concepto (descripción de la deuda).
  5. Ingresar el monto total a cobrar.
  6. Establecer la fecha de vencimiento.
  7. Opcionalmente vincular a una venta al mayor existente.
  8. Guardar.

18. Registrar un Abono

Cuando el cliente realiza un pago parcial o total, se registra como un abono.

  1. En el listado de Cuentas por Cobrar, hacer clic en Ver en la cuenta correspondiente.
  2. En la pantalla de detalle, encontrar la sección Registrar Abono.
  3. Ingresar el monto abonado y el método de pago.
  4. Agregar notas opcionales.
  5. Guardar. El sistema actualiza el saldo pendiente automáticamente.
  6. Si el abono cubre el saldo total, el estado cambia automáticamente a Pagado.
💡
El Dashboard muestra la card "Por Cobrar" con el total de saldo pendiente de todas las cuentas activas. Hacer clic en ella lleva directamente al listado.

19. Estados de la Cuenta — Actualización Automática

El sistema revisa automáticamente las fechas de vencimiento cada vez que se carga el listado o el detalle de una cuenta. Si la fecha pasó y aún hay saldo, el estado cambia a Vencido sin necesidad de intervención manual.

📊 Reporte Cartera Pendiente

Muestra todas las cuentas con estado Pendiente — clientes que deben pero aún están en plazo. Exportable a PDF/Excel.

⚠️ Reporte Cartera Vencida

Muestra todas las cuentas con estado Vencido — clientes que pasaron la fecha límite sin pagar. Prioridad de cobro.

⚙️

Administración

Productos, Clientes, Compras, Reportes y Configuración

20. Productos y Categorías

Admin Supervisor

Agregar Producto

  1. Ir a Productos → Nuevo Producto.
  2. Completar nombre, precio, categoría y stock inicial.
  3. Subir imagen del producto (opcional).
  4. Guardar.

Editar / Eliminar

  1. En el listado de productos, usar los botones de acción.
  2. Editar actualiza precio, stock y datos.
  3. Eliminar solo si no tiene ventas asociadas.
⚠️
Un producto con stock = 0 no aparece disponible en el POS. Reponer stock desde Productos → Reponer Stock.

21. Clientes

Admin Supervisor Vendedor Mayoreo

Desde Clientes → Nuevo Cliente registrar: nombre, email, teléfono y dirección. Los clientes registrados pueden asociarse a ventas mayoristas y recibir recibos por email automáticamente.

22. Compras / Proveedores

Admin
  1. Ir a Compras → Nueva Compra.
  2. Seleccionar proveedor y agregar los productos comprados con sus cantidades y costos.
  3. Guardar — el sistema incrementa el stock automáticamente.
💡
Si el proveedor no existe, crearlo primero en Proveedores → Nuevo Proveedor.

23. Reportes

Admin Supervisor

Acceder desde Sistema de Ventas → Reportes. Los reportes se generan en tiempo real con filtros por fecha.

ReporteMuestraRequiere Fechas
Ventas por PeríodoTotal de ventas diarias/semanales/mensuales con gráfica
Productos más VendidosRanking por cantidad y monto
IngresosDesglose por método de pago (efectivo vs tarjeta)
DevolucionesTotal reembolsado por período
InventarioStock actual, productos bajo mínimoNo
Cartera PendienteTodas las cuentas por cobrar con saldo activo no vencidoNo
Cartera VencidaCuentas por cobrar que pasaron su fecha de vencimiento sin pagoNo
💡
Los reportes pueden exportarse a PDF o Excel con los botones en la esquina superior derecha de cada reporte.

24. Configuración del Sistema

Admin

🏢 Datos de Empresa

  • Nombre y logo
  • Dirección y teléfono
  • Email de contacto
  • RUC / NIT fiscal

💳 Square Payments

  • Credenciales producción vs sandbox
  • Token de acceso OAuth
  • Moneda configurada

⚙️ Sistema

  • Idioma (Español / English)
  • Zona horaria
  • Símbolo de moneda
  • Decimales

💾 Backup

  • Descargar backup de base de datos
  • Ver historial de backups
  • Restaurar desde backup
🚫
Antes de pasar a producción con Square, cambiar las credenciales de sandbox a producción en Configuración → Square Payments. Con credenciales sandbox los cobros NO son reales.

25. Gestión de Usuarios

Admin

Acceder desde Usuarios → Listado. Solo el Administrador puede crear, editar o eliminar usuarios.

Crear Usuario

  1. Ir a Usuarios → Nuevo Usuario.
  2. Completar nombre completo, nombre de usuario y contraseña.
  3. Asignar el rol: Administrador, Supervisor, Vendedor Detalle o Vendedor Mayoreo.
  4. Guardar.
💡
La contraseña se almacena cifrada con bcrypt. El sistema nunca guarda contraseñas en texto plano.

Roles disponibles

RolColor en listadoUso típico
Administrador Rojo Dueño del negocio o gerente general
Supervisor Morado Encargado de turno, jefe de tienda
Vendedor Detalle Azul Cajero — opera exclusivamente el POS
Vendedor Mayoreo Verde Vendedor de oficina — ventas al mayor y cuentas por cobrar
AcciónDescripción
EditarCambiar nombre, usuario, rol o contraseña
EliminarElimina el usuario. No se puede eliminar el último Admin

26. Preguntas Frecuentes

¿Por qué el botón de devolución está en gris?

La venta ya tiene una devolución procesada. El sistema bloquea el botón para evitar dobles reembolsos. Para una segunda devolución parcial, contactar al administrador.

¿Cuánto tarda el reembolso en llegar a la tarjeta?

Square procesa en 1-2 días hábiles. El banco del cliente puede demorar 2-7 días adicionales. El Square Ref ID en el historial confirma que se procesó.

¿Cuál es la diferencia entre Void y Refund?

Void: cancela el cobro antes de que el banco lo liquide — el cliente nunca ve el cargo. Refund: devuelve el dinero después de que ya fue cobrado.

¿Qué pasa si Square falla durante una venta?

Si Square no aprueba, la venta no se registra y el stock no se descuenta. Intentar nuevamente o cambiar a efectivo.

¿Qué diferencia hay entre Vendedor Detalle y Vendedor Mayoreo?

El Vendedor Detalle opera la caja POS — ventas rápidas, efectivo o tarjeta. El Vendedor Mayoreo trabaja desde oficina — ventas a crédito, facturas y cobro de cartera. Cada uno solo ve su módulo correspondiente en el sistema.

¿Cuándo se marca automáticamente una cuenta como vencida?

El sistema revisa las fechas cada vez que se abre el listado o detalle de Cuentas por Cobrar. Si la fecha de vencimiento pasó y hay saldo, el estado cambia a Vencido automáticamente.

¿Se puede cambiar el idioma?

Sí. Las banderas 🇪🇸 🇺🇸 en la parte superior de cualquier pantalla permiten cambiar entre Español e Inglés. La preferencia se guarda por navegador.

¿Puedo devolver solo parte de los productos?

Sí. En la pantalla de devolución se seleccionan productos individuales y cantidades específicas. El reembolso es proporcional a los productos seleccionados.

27. Glosario — Square Payments

TérminoDefinición
Square Ref ID Identificador único de Square para cada transacción o reembolso. Permite rastrearlo en el panel de Square.
Void Anulación de un pago antes de ser liquidado por el banco. El cargo nunca aparece en el estado de cuenta del cliente.
Refund Devolución de dinero después de que el pago fue liquidado. El cliente ve el cargo original y un abono posterior.
Partial Refund Reembolso de solo una parte del monto cobrado.
Sandbox Ambiente de pruebas de Square. Los pagos son simulados — no mueven dinero real.
Producción Ambiente real de Square. Los cobros y reembolsos mueven dinero real.
OAuth Token Clave de autorización que conecta el sistema con Square. No compartir nunca.
Cartera Vencida Conjunto de cuentas por cobrar cuya fecha de vencimiento pasó sin recibir pago total.
Abono Pago parcial que reduce el saldo pendiente de una cuenta por cobrar.
Liquidación Proceso por el cual Square transfiere los fondos cobrados a la cuenta bancaria del negocio. Ocurre 1-2 días hábiles después del cobro.

Sistema de Punto de Venta — Versión 3.0

Para soporte técnico contactar al administrador del sistema

© 2026 — Todos los derechos reservados