Catálogo y saldo de la bolsa

Para poder vender recargas necesitas dos cosas: un catálogo con las compañías y los montos disponibles, y saldo en tu bolsa para surtir cada venta. Esta página te explica qué es cada pieza del catálogo, cómo se mantiene al día solo, y —lo más importante para el día a día— cómo funciona el aviso de saldo bajo y a quién avisar para recargar la cuenta antes de que se agote. Si la bolsa se queda sin fondos, cada venta va a salir "fallida", así que conviene entender bien esta parte.

Qué es el catálogo

El catálogo es el espejo local de lo que SALDO ofrece. Se arma con estas piezas:

• Compañía / Carrier (Saldo Carrier): la empresa que da el servicio (Telcel, Movistar, AT&T, y también los pagos de servicios como luz o TV). Cada compañía sabe qué datos pedirte y cómo validarlos (largo del número, si es solo dígitos, etc.).
• Producto (Saldo Product): cada opción vendible de una compañía, con su código TAECEL y su monto. Por ejemplo, "Telcel $50" es un producto con monto fijo de 50 pesos.
• Bolsa (Saldo Bolsa): la agrupación con la que TAECEL organiza el saldo (por ejemplo "Tiempo Aire"). Aquí es donde vive el dinero prepagado con el que se surten las recargas.
• Categoría (Saldo Categoria): la agrupación visual para navegar el catálogo (Tiempo Aire, Servicios, etc.).

Hay dos clases de producto según cómo se cobra:

• Catálogo (monto fijo): el monto ya viene definido. El cajero solo captura el teléfono. Ejemplo: tiempo aire de $20, $50, $100.
• Monto libre: el cajero captura el monto a pagar. Se usa sobre todo para pagos de servicios, donde cada recibo tiene un importe distinto.

Nota: Un producto solo se puede vender si tiene un artículo (Item) creado y ligado. En el catálogo del POS, los productos sin artículo aparecen deshabilitados o no aparecen. Si falta un producto que deberías poder vender, avisa a Marco para que lo materialice.

Cómo ver y navegar el catálogo

1. Entra al tablero Saldo en Desk. En la sección "Catálogo SALDO" tienes accesos a Compañías (Saldo Carrier), Productos (Saldo Product), Bolsas (Saldo Bolsa) y Categorías (Saldo Categoria). [captura: tablero Saldo con la sección Catálogo SALDO]
2. Abre "Saldo Product" para ver todos los productos, su compañía, su monto y si están habilitados (Enabled).
3. Desde el POS, el catálogo se navega estilo árbol: primero eliges la Categoría, luego la Compañía, y al final el Producto. Los productos de monto libre aparecen aunque no tengan montos predefinidos, para que captures la cantidad. [VERIFICAR: nombre y ubicación exactos del botón de catálogo SALDO dentro del POS.]

Cómo se mantiene al día el catálogo

No tienes que capturar el catálogo a mano. Una vez al día, el sistema se sincroniza y actualiza las compañías y los productos disponibles con sus montos y vigencias. Por eso a veces aparecen productos nuevos o cambian precios sin que nadie los toque.

Importante: La sincronización del catálogo corre una vez al día, NO en cada recarga. Si SALDO saca un producto nuevo hoy en la mañana, puede tardar hasta la siguiente sincronización en aparecerte. No es una falla.

Nota: Habilitar o deshabilitar un producto (Enabled) y crear los artículos vendibles son tareas de administración. Si necesitas que un producto deje de venderse o que aparezca uno nuevo, pídelo a Marco; no cambies el catálogo tú por tu cuenta.

El saldo de la bolsa y el aviso de saldo bajo

Cada recarga que vendes consume saldo de la bolsa SALDO de tu tienda. Ese saldo es prepagado: se deposita por adelantado y se va gastando venta por venta. Cuando se acaba, SALDO rechaza los envíos y tus recargas empiezan a salir "fallidas".

Para que esto no te agarre en frío, el sistema vigila el saldo solo:

1. Cada hora consulta el saldo de las bolsas en SALDO y guarda una foto del estado.
2. Compara cada bolsa contra el umbral mínimo configurado (low_balance_threshold, por defecto 500 pesos).
3. Si alguna bolsa cae por debajo del umbral, dispara una alerta de saldo bajo.

La alerta hace tres cosas:

• Deja un registro durable en el sistema (una Comunicación en Desk), para que quede rastro.
• Manda un correo a los destinatarios configurados (low_balance_notify_to), si hay alguno.
• Registra la medición para el monitoreo interno.

Nota: La alerta tiene un periodo de enfriamiento de 4 horas por bolsa. O sea, aunque el saldo siga bajo, no te va a spamear un correo cada hora; te avisa una vez y espera. La fecha de la última alerta y cuántas se han mandado quedan guardadas en la configuración.

El correo de aviso trae una tabla con cada bolsa baja, su saldo actual, el umbral y la diferencia, más la advertencia de recargar la cuenta antes de que se agote.
[captura: correo de aviso de saldo bajo con la tabla de bolsas]

A quién avisar y qué hacer cuando el saldo está bajo

1. Cuando llegue el aviso de saldo bajo, avisa a Marco (dueño de la cuenta SALDO) para que haga un depósito y recargue la bolsa. En docomexico, la cuenta SALDO es la cuenta principal y él es quien la fondea.
2. Mientras la bolsa esté baja, ten en cuenta que las ventas grandes de recarga podrían empezar a fallar. Prioriza recargar la cuenta pronto.
3. Si ves que TODAS las recargas están saliendo "fallidas", es muy probable que la bolsa ya se haya agotado por completo. Deja de vender recargas y avisa de inmediato para el depósito.

Advertencia: Sin saldo en la bolsa, cada recarga que intentes vender va a salir "Recarga fallida — TAECEL rechazó el envío (sin cargo)". El cliente no recibe saldo. No sigas intentando venta tras venta; recarga la cuenta primero.

Cómo revisar el saldo actual sin esperar el aviso

1. Entra al tablero Saldo en Desk.
2. Abre "Saldo Settings" (Configuración).
3. Revisa el campo Last Balance Snapshot (last_balance_json), que guarda la última foto del saldo de cada bolsa, y Last Balance Check (last_balance_at), con la fecha de esa consulta. [captura: sección de diagnóstico de Saldo Settings con el último saldo]

Nota: Ese saldo es la última foto tomada por la revisión automática (cada hora), no un dato en vivo al segundo. Para el día a día es suficiente para saber si vas bien o si ya urge recargar.

Importante: El umbral de aviso y los correos de destinatarios se configuran en Saldo Settings, pero eso es tarea de administración. Si quieres cambiar el umbral (por ejemplo, que te avise antes, a 800 pesos en vez de 500) o agregar a alguien al correo de aviso, pídelo a Marco.