Guía de Uso del Formulario de Pago
(PayForm)
El formulario PayForm es una interfaz diseñada para procesar pagos de ventas en el sistema
HFA_POS. Permite seleccionar el tipo de pago, ingresar el monto pagado, calcular el vuelto y,
en el caso de pagos QR, mostrar un código QR para escanear. Este formulario se abre desde
SalesForm después de confirmar una venta.
Requisitos Previos
· Venta Iniciada: Debe existir una venta activa con artículos registrados en SalesForm.
· Turno Abierto: Un turno activo es necesario para procesar la venta.
· Acceso al Sistema: El usuario debe estar autenticado con una sesión válida.
· Conexión a Servicios (para QR): Para pagos con QR, el sistema debe tener acceso al
servicio de MercadoPago para generar códigos QR.
Controles Principales
El formulario contiene los siguientes controles interactivos:
Control Descripción
Etiqueta que muestra el subtotal de la venta (sin impuestos ni
lblSubtotal
descuentos).
lblImpuesto Etiqueta que muestra el monto de impuestos de la venta.
lblDescuento Etiqueta que muestra el monto de descuentos aplicados.
lblTotal Etiqueta que muestra el total final de la venta.
lblVuelto Etiqueta que muestra el vuelto calculado (monto pagado - total).
txtMontoPagado Campo de texto para ingresar el monto pagado por el cliente.
Lista desplegable para seleccionar el tipo de pago: "Efectivo",
paymentOptionsListBox
"Tarjeta", "Transferencia" o "QR Payment".
Botón para validar y procesar el pago, guardando la venta en la base
btnValidatePayment
de datos.
Formulario Auxiliar: QRDisplayForm
Cuando se selecciona "QR Payment", se abre un formulario adicional (QRDisplayForm) con los
siguientes controles:
Control Descripción
Control que muestra el código QR generado para el pago con
qrCodeControl
MercadoPago.
Etiqueta que muestra mensajes de error si falla la generación del código
errorLabel
QR.
Atajos de Teclado
El formulario soporta atajos de teclado para seleccionar el tipo de pago y procesar el pago:
Atajo Acción
F1 Selecciona "Efectivo" en paymentOptionsListBox.
F2 Selecciona "Tarjeta" en paymentOptionsListBox.
F3 Selecciona "Transferencia" en paymentOptionsListBox.
F4 Selecciona "QR Payment" en paymentOptionsListBox.
Ejecuta la acción de btnValidatePayment (valida y procesa el
Enter
pago).
Cómo Usar el Formulario
1. Iniciar el Formulario
1. Abrir el Formulario: PayForm se abre desde SalesForm al hacer clic en
btnConfirmSale, btnCash, btnCard o btnTransfer. La factura (subtotal, impuestos,
descuentos, total) se carga automáticamente.
2. Verificar Detalles:
o Los campos lblSubtotal, lblImpuesto, lblDescuento y lblTotal muestran
los detalles financieros de la venta.
o El campo txtMontoPagado se inicializa con el total de la venta y se selecciona
automáticamente para edición.
o La lista paymentOptionsListBox muestra las opciones de pago, con "Efectivo"
seleccionado por defecto.
2. Seleccionar el Tipo de Pago
1. Usar la Lista Desplegable:
o Selecciona un tipo de pago en paymentOptionsListBox: "Efectivo", "Tarjeta",
"Transferencia" o "QR Payment".
o Alternativamente, usa los atajos F1, F2, F3 o F4 para seleccionar rápidamente.
1. Pago con QR:
o Si seleccionas "QR Payment", se abre QRDisplayForm mostrando un código QR
generado por [Link].
o Escanea el código QR con un dispositivo móvil para procesar el pago a través de
MercadoPago.
o Si el monto pagado cambia, el código QR se actualiza automáticamente.
o Si falla la generación del código QR, se muestra un mensaje de error en
QRDisplayForm y una notificación en PayForm.
3. Ingresar el Monto Pagado
1. Editar Monto Pagado:
o Ingresa el monto pagado por el cliente en txtMontoPagado.
o El campo se selecciona automáticamente al abrir el formulario o al hacer clic (con
Enter).
o Si el monto es válido, lblVuelto se actualiza para mostrar el vuelto (monto
pagado - total).
o Si el monto no es válido (por ejemplo, texto no numérico), el vuelto se establece
en 0 y, si está abierto, QRDisplayForm se cierra.
1. Actualización de QR:
o Si el tipo de pago es "QR Payment" y cambias el monto en txtMontoPagado, el
código QR en QRDisplayForm se actualiza automáticamente para reflejar el
nuevo monto.
4. Procesar el Pago
1. Validar el Pago:
o Haz clic en btnValidatePayment o presiona Enter para procesar el pago.
o El sistema verifica que el monto pagado sea suficiente (igual o mayor al total de la
factura).
o Si el monto es insuficiente, se muestra una notificación de error ("El monto
pagado es insuficiente").
1. Guardar la Venta:
o Si el pago es válido, la factura se guarda en la base de datos (HfaPosDbContext),
actualizando el stock de los artículos vendidos.
o Se muestra una notificación de éxito ("Pago procesado correctamente").
o Se ejecutan las acciones onPaymentSuccess (por ejemplo, reiniciar SalesForm) y
onSaleSaved (por ejemplo, actualizar SalesListForm).
o El formulario se cierra automáticamente.
1. Errores:
o Si hay un problema al guardar la venta (por ejemplo, fallo en la base de datos), se
muestra una notificación de error con el mensaje correspondiente.
5. Cerrar el Formulario
· Cierre Manual: Cierra PayForm usando el botón de cierre de la ventana. Si
QRDisplayForm está abierto, se cerrará automáticamente.
· Cierre Automático: Ocurre tras un pago exitoso.
· Cerrar QR: Si cambias el tipo de pago desde "QR Payment" a otro, QRDisplayForm se
cierra automáticamente.
Notificaciones
El formulario utiliza ToastNotification para mostrar mensajes al usuario:
· Éxito: Color verde suave (por ejemplo, "Pago procesado correctamente").
· Error: Color rojo suave (por ejemplo, "Error al procesar el pago" o "No se pudo generar
el código QR").
· Las notificaciones tienen una duración de 3 segundos y bordes redondeados para un
diseño moderno.
Consejos
· Atajos de Teclado: Usa F1-F4 para cambiar rápidamente el tipo de pago y Enter para
procesar el pago sin usar el mouse.
· Monto Pagado: Ingresa el monto exacto para pagos en efectivo o el monto esperado para
pagos QR, ya que afecta el código QR generado.
· QR Payment: Asegúrate de que el cliente escanee el código QR rápidamente, ya que está
ligado al monto ingresado.
· Verifica el Total: Revisa lblTotal y lblVuelto antes de confirmar para evitar errores
en el cambio.
· Logs: Si encuentras problemas (especialmente con pagos QR), revisa los logs generados
por CustomLogger para diagnosticar errores.
Limitaciones
· Validación de Monto: No se permite procesar pagos con montos inferiores al total de la
factura.
· QR Payment: Requiere conexión a MercadoPago y un identificador válido
("[Link]"). Fallos en la conexión generan errores.
· Sin Edición de Factura: No se pueden modificar los detalles de la factura (subtotal,
impuestos, descuentos) desde PayForm.
· Sin Cancelación Parcial: No hay opción para cancelar el proceso de pago sin cerrar el
formulario; se debe completar o cerrar manualmente.
Contacto
Si necesitas asistencia adicional o encuentras problemas con el formulario, contacta al equipo de
soporte técnico del sistema HFA_POS.
