Cuando una recarga falla

No todas las recargas salen exitosas al primer intento, y está bien: el sistema está hecho para que ninguna falla se pierda en silencio y para que nunca cobres al cliente por saldo que no llegó. Esta página te explica cómo leer cada estado, qué hacer con el dinero del cliente, cuándo esperar y cuándo reembolsar, y qué cosas NO debes hacer nunca. Entender esto te evita dos errores caros: regalar saldo por reenviar de más, o quedarte con dinero de un servicio que no se aplicó.

Los estados de una recarga

Cada recarga es una Saldo Transaction que pasa por estos estados. Los primeros dos son temporales; los últimos cuatro son finales.

Estado	Qué significa	¿Se cobró saldo?
Pending (Pendiente)	Se creó la recarga pero todavía no sale hacia TAECEL.	No todavía
InProgress (En vuelo / En proceso)	TAECEL aceptó la petición y se está consultando el resultado.	Sí, ya hay cargo en curso
Success (Exitosa)	El saldo llegó al cliente. Estado final.	Sí, definitivo
Failed (Fallida)	TAECEL rechazó el envío ANTES de cobrar. Estado final.	No
Refunded (Fracasada / Reembolsada)	TAECEL intentó, no aplicó y devolvió el saldo solo. Estado final.	Sí, pero ya se te devolvió
Manual Review (Revisión manual)	Quedó en duda: no hay confirmación clara de TAECEL. Estado final hasta conciliar.	Incierto

Nota: Puedes ver cuántas recargas hay en cada estado desde el tablero Saldo. Ahí tienes los indicadores "Recargas En Vuelo" (InProgress), "En Revisión Manual" (Manual Review) y "Fallidas Hoy" (Failed), más los accesos rápidos "Saldo Transactions" (pendientes) y "Revisión Manual".

Qué hacer en cada caso

Recarga fallida (Failed) — "TAECEL rechazó el envío (sin cargo)"

Esto pasa cuando TAECEL rechaza la petición antes de mover un solo peso (número inválido, producto no disponible, error de datos). El cliente pagó en tu caja pero NO recibió saldo, y a ti tampoco te cobraron.

Reembolsa al cliente lo que pagó, normalmente en efectivo.
Si la venta era de una sola recarga y tu tienda tiene activada la auto-cancelación (auto_cancel_failed_saldo), el sistema cancela la factura solo y te avisa "Factura cancelada automáticamente". No tienes que hacer nada más con la factura.
Si la venta tenía otras líneas además de la recarga, el sistema NO cancela nada por su cuenta (cancelar borraría el valor de las otras líneas). Te deja un aviso y un comentario en la factura pidiéndote hacer una devolución (Sales Return) o un reembolso en efectivo manual, solo por el monto de la recarga fallida.
Si el cliente todavía quiere su recarga, corrige lo que estuvo mal (por ejemplo el número) y véndela de nuevo como una venta nueva.

Importante: "Failed" es la única falla en la que puedes reintentar tranquilo, porque NO hubo cargo. Aun así, vuelve a vender desde cero; no reutilices la venta cancelada.

Recarga fracasada / reembolsada (Refunded) — "saldo reembolsado por TAECEL"

Aquí TAECEL sí recibió la petición, pero el envío no se completó del lado de la compañía y TAECEL te devolvió el saldo en automático. El cliente no recibió su recarga.

Reembolsa al cliente lo que pagó.
No tienes que hacer ningún trámite de recuperación de saldo con TAECEL: la devolución ya la hizo el proveedor.
Si el cliente lo pide, vuelve a intentar la recarga como venta nueva.

Nota: En el comprobante impreso, este caso sale como "RECARGA FRACASADA" con la leyenda "Recarga no aplicada. Saldo reembolsado automáticamente."

Recarga en revisión manual (Manual Review) — "verificar reporte de ventas"

Este es el estado más delicado. Significa que el sistema NO pudo confirmar si el saldo llegó o no. Pasa, por ejemplo, cuando se cae el internet justo al enviar, cuando TAECEL tarda demasiado en responder, o cuando devuelve una respuesta rara. TAECEL pudo haber entregado la recarga aunque nosotros no recibimos la confirmación.

NO reembolses de inmediato y NO reenvíes la recarga. Todavía no sabes si el saldo llegó.
Espera a la conciliación. Cada madrugada (a las 02:00) el sistema compara nuestras ventas contra el reporte de ventas oficial de TAECEL (getSales) y aclara qué recargas sí se aplicaron. El resultado queda en "Reconciliación" dentro del tablero Saldo.
Revisa al día siguiente. Si la conciliación confirma que la recarga sí se aplicó, la venta se queda buena y no hay que reembolsar. Si confirma que no se aplicó, reembolsa al cliente.
Si el cliente no puede esperar, revisa directamente el reporte de ventas de TAECEL para ese número antes de decidir. Nunca reembolses y reenvíes "por si acaso": podrías terminar entregando el saldo dos veces.

Advertencia: Una recarga en revisión manual que en realidad SÍ se aplicó y tú reembolsas y reenvías = triple pérdida (saldo entregado, reembolso pagado, segunda recarga). Por eso la regla es esperar a la conciliación.

Recarga atascada en Pending o InProgress

A veces una recarga se queda "Pendiente" o "En vuelo" más de lo normal porque un proceso en segundo plano se interrumpió.

No hagas nada de inmediato: el sistema tiene un vigilante automático que corre cada minuto.
- Si una recarga lleva rato en Pending, la reencola y la vuelve a intentar, hasta 3 veces.
- Si una recarga lleva rato En vuelo, retoma la consulta de estado sola.
Si tras varios intentos el vigilante no logra contactar a TAECEL, mueve la recarga a "Revisión manual" con la nota de que se agotaron los reintentos. A partir de ahí se trata igual que cualquier revisión manual: se resuelve con la conciliación del día siguiente.
Solo un administrador (System Manager) puede forzar una consulta de estado manual sobre una recarga específica desde su ficha. [VERIFICAR: ubicación exacta del botón para forzar la consulta de estado en la ficha de Saldo Transaction.]

Lo que NO debes hacer nunca

Advertencia: Estas reglas protegen tu dinero y el del cliente. Rómpelas y pierdes saldo real.

No canceles una venta con una recarga exitosa (Success). Una recarga exitosa es final: TAECEL ya le acreditó al carrier y no admite reversa. Si el cliente tiene una queja legítima, resuélvela con un reembolso en efectivo, pero la venta se queda. El sistema de hecho te bloquea la cancelación de una factura con recargas en Pending, InProgress o Success, y te dice el detalle de cada una.
No canceles mientras una recarga esté "En vuelo" (InProgress). Podría terminar exitosa segundos después. Si cancelas antes, quemas saldo sin factura. Espera hasta 60 segundos a que llegue a un estado final y vuelve a intentar.
No reenvíes una recarga en revisión manual sin confirmar primero si el saldo llegó o no.
No subas la cantidad de una línea de recarga para "hacer varias de un jalón". Cada recarga va en su propia línea con cantidad 1. El sistema lo obliga precisamente para que no cobres de más y entregues de menos.

Cómo verificar el estado real de una recarga

Entra al tablero Saldo en Desk.
Abre "Saldo Transaction" (o usa el acceso rápido "Revisión Manual" para filtrar solo las que están en revisión).
Busca la recarga por el teléfono/referencia, el TransID, el número de ticket o el artículo.
Abre la ficha y revisa el campo Status, la Manual Review Reason (motivo de revisión), el Error Code y el Error Message si los hay. Ahí está la razón exacta de la falla. [captura: ficha de Saldo Transaction mostrando Status y el motivo de revisión]

Nota: La conciliación diaria clasifica las diferencias en tres tipos: falta el registro local (TAECEL dice que hubo venta y nosotros no la tenemos), falta el registro remoto (nosotros la marcamos exitosa y no aparece en TAECEL) o discrepancia de estado (ambos existen pero no coinciden). Todo esto queda en el registro de "Reconciliación" para que un administrador lo revise.