Vender una recarga o pago de servicio

Con esta función vendes tiempo aire (Telcel, Movistar, AT&T y demás) y pagos de servicios (luz, agua, TV de paga, etc.) directo desde el punto de venta, sin salirte de POSAwesome. Importa porque cada recarga se despacha al proveedor TAECEL en automático, deja su propio comprobante y queda registrada como una Saldo Transaction que puedes auditar después. Si haces bien la captura del teléfono y el cobro, el saldo llega al cliente en segundos y no tienes que usar otra app aparte.

Nota: Esta función solo está activa en docomexico. Si trabajas en otra tienda del grupo, no verás los artículos de recarga en el POS.

Antes de empezar

• Necesitas tener sesión abierta en el POS con un rol permitido: System Manager, Sales User, Sales Manager o Accounts User. Sin uno de estos roles, el sistema te responde "Saldo: rol insuficiente" y no deja quemar saldo.
• El artículo de recarga debe existir y estar marcado como recarga (campo saldo_enabled activo en el Item). Si el artículo no está marcado, el POS lo trata como producto normal y NO manda nada a TAECEL.
• La tienda debe tener saldo suficiente en su bolsa TAECEL. Si la bolsa está agotada, cada venta va a terminar en "Recarga fallida". Consulta la página «Catálogo y saldo de la bolsa» para revisar esto.

Pasos para vender una recarga

1. Abre una venta nueva en el POS como siempre.

2. Agrega la recarga al carrito. Tienes dos maneras:

   • Búscala por nombre o código como cualquier producto (por ejemplo, "Telcel $50" o el código del artículo).
   • Usa el catálogo de recargas TAECEL, que te deja navegar por Categoría → Compañía (carrier) → Producto. [VERIFICAR: nombre exacto del botón que abre el catálogo TAECEL dentro del POS.] [captura: carrito del POS con un artículo de recarga agregado]

3. En cuanto agregas la recarga, se abre solo el diálogo de captura de referencia (SaldoReferenciaDialog). Ahí escribes el número de teléfono o el número de servicio del cliente.

   • El campo se autoformatea mientras escribes (por ejemplo 695 108 8777) y borra cualquier caracter que no sea número.
   • La referencia debe tener entre 2 y 32 dígitos. Para tiempo aire normalmente son los 10 dígitos del teléfono.
   • Algunas compañías validan el formato con reglas propias (largo mínimo, largo máximo, solo dígitos, alfanumérico o correo). Si te equivocas, el diálogo te marca el error antes de dejarte continuar. [captura: diálogo SaldoReferenciaDialog con un teléfono capturado]

   Importante: Verifica el número CON EL CLIENTE antes de continuar. Una recarga exitosa NO se puede cancelar ni reembolsar (regla de TAECEL). Si le pegas al número equivocado, el saldo se va a ese número y lo pierdes.

4. Si vendes un pago de servicio o una recarga de "monto libre", además del número te va a pedir el monto a pagar. Captura la cantidad exacta que va a pagar el cliente. El monto debe ser mayor a cero.

   • En el tiempo aire de catálogo (por ejemplo "Telcel $50") NO capturas monto: ya viene fijo en el producto. Solo capturas el teléfono.

5. Si tu tienda tiene activado el PIN de cajero, el POS te pide un PIN de 4 dígitos antes de dejarte mandar la recarga. Captúralo. Esto imita el candado de la app de TAECEL y evita que alguien queme saldo sin permiso. [VERIFICAR: pantalla exacta donde el POS pide el PIN de cajero.]

6. Cobra el ticket de manera normal (efectivo, tarjeta o el método que uses) y confirma la venta.

7. Al confirmar, el sistema hace dos cosas antes de cobrar:

   • Revisa que TODA línea de recarga tenga su número capturado. Si a alguna le falta, NO deja cerrar la venta y te dice exactamente qué línea corregir.
   • Revisa que cada recarga vaya en su propia línea con cantidad 1. Si una línea de recarga trae cantidad 2 o más, la venta se detiene con el mensaje de que cada recarga debe ir en su propia línea con su propio número. Esto es a propósito: una línea con cantidad 3 solo entregaría UNA recarga y cobraría tres; el sistema lo bloquea para que no pierdas dinero.

   Advertencia: Si un cliente quiere recargar tres números distintos, agrega TRES líneas de recarga, cada una con cantidad 1 y su propio teléfono. Nunca subas la cantidad de una sola línea.

8. Ya cobrado el ticket, el despacho a TAECEL arranca. El comportamiento depende del modo configurado en la tienda:

   • Modo Async (el recomendado y el más común): vuelves de inmediato a un carrito limpio y ya puedes atender al siguiente cliente. La recarga viaja a TAECEL en segundo plano.
   • Modo Inline: el POS se queda esperando entre 3 y 8 segundos hasta tener la respuesta final de TAECEL, y luego te muestra el resultado.

9. En unos segundos aparece solo el diálogo de resultado (SaldoStatusDialog) con el veredicto de la recarga:

   • Recarga exitosa → el saldo ya llegó al cliente.
   • Recarga fallida — TAECEL rechazó el envío (sin cargo) → no se cobró saldo; hay que reembolsar al cliente.
   • Recarga rechazada — saldo reembolsado por TAECEL → el proveedor intentó pero no aplicó y devolvió el saldo.
   • Recarga en revisión manual — verificar reporte de ventas → quedó en duda; se resuelve al día siguiente con la conciliación. [captura: diálogo SaldoStatusDialog mostrando "Recarga exitosa"]

   Nota: Si la recarga sale exitosa, el diálogo te deja imprimir el comprobante. Consulta el paso 10. Si sale con falla o en revisión, sigue las instrucciones de la página «Cuando una recarga falla».

10. Imprime el ticket de recarga con el botón de imprimir del diálogo de resultado. El comprobante es el formato "Saldo Recarga Ticket" (para impresora térmica de 72 mm) y trae:

    • El estado en grande (RECARGA EXITOSA / RECARGA FALLIDA / RECARGA FRACASADA).
    • La compañía (carrier) y la bolsa.
    • El monto recargado.
    • El teléfono/referencia, el Folio, el TransID de TAECEL y el operador.
    • La fecha y el número de ticket de la venta.
    • En las exitosas, la leyenda "SIN DEVOLUCIONES". [captura: ticket térmico de recarga impreso]

    Nota: Entrega el ticket al cliente. Es su comprobante de que el saldo se envió a su número. El ticket dice "Ticket no fiscal".

Qué pasa si algo se traba

• Si tu navegador bloquea la ventana de impresión, el diálogo de resultado te reabre el comprobante en la misma pestaña para que igual lo puedas imprimir.
• Si por alguna razón no aparece el diálogo de resultado (se te cerró la pestaña, se cayó el internet un momento), no vuelvas a vender la misma recarga a ciegas. Busca la venta en la lista de recargas para ver en qué estado quedó. Cada recarga queda guardada como una Saldo Transaction aunque tu pantalla se haya cerrado.
• Si intentas cancelar una venta que ya tiene una recarga en proceso o exitosa, el sistema te lo bloquea y te explica por qué. Consulta la página «Cuando una recarga falla» para saber qué hacer en cada caso.

Importante: Nunca vuelvas a mandar una recarga solo porque "no viste el resultado". Primero confirma el estado real de la venta. Reenviar a ciegas puede duplicar el saldo entregado y ese dinero no se recupera.