Manuales › Recargas y pago de servicios

Recargas y pago de servicios

Actualizado el 31 de octubre de 2026 · Ver en Markdown

1. ¿Qué es Comisionista?#

Es la función del Punto de Venta para cobrar, además de los productos de la tienda, dos servicios típicos de "comisionista" que ofrecen muchas tiendas de abarrotes: recargas de tiempo aire y pago de servicios (luz, agua, teléfono, etc.). En ambos casos el negocio no vende inventario: cobra al cliente el valor de la operación más una comisión, y ese dinero entra a la caja física igual que una venta en efectivo.

Quién puede usarlo: registrar una recarga o un pago de servicio en el día a día lo puede hacer cualquier empleado, igual que una venta normal. Dar de alta, editar o desactivar proveedores y sus comisiones es una acción de administrador únicamente, porque vive dentro de Configuración.

Este módulo no incluye retiro bancario (dispensación de efectivo como corresponsal): solo cubre recargas y pago de servicios, que siempre son operaciones donde el negocio recibe dinero del cliente, nunca lo entrega.

2. Configurar el catálogo de proveedores (solo administrador)#

Antes de poder cobrar una recarga o un pago de servicio, tiene que existir al menos un proveedor activo en esa categoría.

1. Ve a Configuración → sección "📱 Comisionista: Proveedores y Comisiones" (ver el manual de Configuración).
2. Llena el formulario:
   • Nombre — ej. "Telcel", "CFE (Comisión Federal de Electricidad)".
   • Categoría — Recarga Telefónica o Pago de Servicio.
   • Comisión por Defecto — el monto que se prellenará en el POS al elegir este proveedor.
   • Tipo — Monto fijo ($) (ej. siempre $2, sin importar el monto de la operación) o Porcentaje (%) (ej. 1% del monto que se está cobrando).
   • Notas — opcional.
3. Clic en ➕ Agregar Proveedor.

La tabla de abajo lista todos los proveedores, con su categoría, comisión y estado:

• ✏️ — carga el proveedor en el formulario para editarlo. El botón cambia a 💾 Guardar Cambios; Cancelar Edición descarta los cambios sin guardar.
• 🚫 Desactivar / ✅ Activar — un proveedor desactivado deja de aparecer en el selector del POS, pero no se borra: su historial de operaciones pasadas sigue intacto. Los proveedores nunca se eliminan; desactivar pide confirmación y se puede revertir con ✅ Activar.

El sistema incluye de fábrica un catálogo de ejemplo (Telcel para recargas; CFE, Agua Potable Municipal y Telmex para pago de servicios) con comisiones de muestra — ajústalas a lo que realmente cobra tu negocio.

2.1 Envío automático de recargas con Taecel (opcional)#

Por defecto una recarga solo se registra en el sistema: el saldo al cliente lo envías tú por fuera. Si tienes cuenta con Taecel, el sistema puede enviarla por su API:

1. Captura tus credenciales. En Configuración → Recargas y servicios, escribe la Llave (Key) y el NIP que Taecel te envió por correo al inscribirte (el NIP aparece oculto; marca "Mostrar contraseña" para verlo) y pulsa 💾 Probar y guardar. El sistema pide tu PIN de administrador y prueba las credenciales contra Taecel antes de guardarlas: si Taecel las rechaza (por ejemplo, un error de captura), no se guarda nada. Quitar credenciales las borra.
   • Se guardan en data/taecel.json, nunca en la base de datos ni en los respaldos, y la pantalla solo muestra los últimos 4 caracteres de la Llave. El archivo está en .gitignore.
   • Alternativa para instalaciones técnicas: las variables de entorno TAECEL_KEY, TAECEL_NIP y TAECEL_BASE_URL (esta última sirve para apuntar al ambiente de pruebas que te dé Taecel; con el archivo, agrega "baseUrl" en el JSON). Si existen ambos, manda lo capturado en la pantalla.
2. En Configuración → Recargas y servicios, edita el proveedor (ej. Telcel) y llena Código de producto Taecel con el código que Taecel te indique para ese producto. La tabla mostrará "⚡ Taecel" en la columna Envío. Un proveedor sin código sigue siendo manual.
3. En la misma sección verás el estado de la conexión y tu saldo en Taecel.

Cómo funciona al cobrar: al confirmar en el POS, el sistema envía la recarga a Taecel y espera su respuesta (unos segundos; el botón queda bloqueado para no enviarla dos veces). El número debe tener 10 dígitos.

• Exitosa: se registra la operación con el folio de Taecel y aparece "✔ Enviada".
• Rechazada: no se registra ni se cobra nada; el POS muestra el motivo.
• Pendiente (Taecel no confirmó a tiempo): se registra y ya cuenta como cobrada en caja, con "⏳ Pendiente". Usa el botón Verificar del historial para volver a consultar. Si Taecel termina cancelándola queda "✖ Fallida" y deja de sumar efectivo y comisión al Corte de Caja (devuelve el dinero al cliente).

⚠️ La conexión con Taecel se construyó sin la documentación oficial del proveedor y aún no está validada para producción. Antes de depender de ella, haz una recarga de prueba con un monto pequeño.

3. Cobrar una recarga o un pago de servicio#

1. En el Punto de Venta, clic en el botón 📱 Recargas / Servicios.
2. Elige la categoría: 📱 Recarga Telefónica o 🧾 Pago de Servicio.
3. Elige el proveedor de la lista (solo aparecen los proveedores activos de esa categoría). Al elegirlo, el campo de comisión se prellena automáticamente según lo configurado para ese proveedor (puedes ajustarlo a mano antes de confirmar, por si esta vez la comisión es distinta).
4. Captura la referencia — el número a recargar (para una recarga) o el número de cuenta/servicio (para un pago de servicio). Es obligatoria en ambos casos.
5. Captura el monto de la operación (el valor de la recarga o el importe del recibo, sin la comisión).
6. Revisa el resumen "Cobrar al cliente", que suma el monto de la operación más la comisión — es el efectivo que debe entregarte el cliente.
7. Clic en ✅ Registrar Operación.

Al confirmar se genera un recibo imprimible con folio (COM-####), categoría, proveedor, referencia, monto, comisión y total cobrado — útil como comprobante para el cliente. El botón 🖨️ Imprimir queda disponible ahí mismo.

3.1 Historial del turno#

El modal muestra las operaciones pendientes de tu turno actual (las que aún no se incluyeron en un corte cerrado): fecha, categoría, proveedor, referencia y monto cobrado. Un administrador ve las de todos los cajeros con turnos pendientes; un cajero solo ve las suyas — igual que el historial de Entradas/Salidas de Efectivo (ver manual del POS).

4. Efecto en el Corte de Caja#

Una recarga o un pago de servicio siempre suma efectivo a la caja: el monto cobrado al cliente (operación + comisión) se incorpora automáticamente al cálculo del efectivo esperado del Corte de Caja, igual que una venta en efectivo o una entrada de caja chica. Además, la comisión ganada suma directamente a la ganancia del turno, porque es ingreso puro del negocio, sin costo asociado.

Al cerrar un corte, las operaciones de comisionista de ese periodo quedan marcadas con el folio del corte, de modo que el desglose del ticket del corte siempre se pueda rastrear a las operaciones exactas que lo componen — el mismo principio que ya aplica a los movimientos de caja chica.

5. Reportes#

Las operaciones de comisionista aparecen en su propia hoja "Comisionista" dentro del reporte Excel (ver el manual de Reportes), con folio, categoría, proveedor, referencia, monto de la operación, comisión ganada, monto cobrado en efectivo, fecha y cajero que la registró.

6. Preguntas frecuentes#

¿Puedo registrar una recarga sin elegir un proveedor? No, el proveedor es obligatorio — sirve para saber con quién se hizo la operación y para prellenar la comisión correcta.

¿Qué pasa si no hay ningún proveedor activo en una categoría? El selector de proveedores aparece vacío con un aviso para que se lo pidas a un administrador — mientras tanto no se puede registrar una operación de esa categoría.

¿Puedo cambiar la comisión que trae el proveedor por defecto? Sí, el campo de comisión se prellena automáticamente pero siempre es editable antes de confirmar, por si en esa operación en particular la comisión real fue distinta.

¿Por qué no hay opción de retiro bancario? Este módulo cubre solo recargas y pago de servicios, que son operaciones donde siempre entra efectivo a la caja. Un retiro bancario (entregar efectivo al cliente) es una operación distinta, con su propio efecto en caja, y no forma parte de esta función.

¿Un cajero puede ver las operaciones de otros compañeros? No en el modal de operación del POS — ahí cada quien ve solo las pendientes de su propio turno (igual que Entradas/Salidas de Efectivo). Un administrador sí ve las de todos, y el reporte Excel siempre incluye el historial completo.

¿Desactivar un proveedor borra las operaciones que ya se le registraron? No. Desactivar solo lo quita del selector del POS para operaciones nuevas; el historial de operaciones pasadas con ese proveedor no se toca.