Appearance
Reconciliación de Pagos del Portal
Módulo: Portal de Clientes / CtaCte Tipo: Process Estado: Implementado Fecha: 2026-04-23
Descripción
Los pagos que los clientes realizan a través del portal de clientes son aprobados por el gateway de pago externo (PayPerTIC o MercadoPago), pero ese reconocimiento externo no tiene valor contable dentro del ERP hasta que un operador lo formaliza. Sin esta etapa, un pago online aprobado no se refleja en la cuenta corriente del cliente ni queda vinculado a las facturas que lo originaron.
La reconciliación de pagos es el proceso mediante el cual un operador del ERP convierte un pago online aprobado en un recibo de cuenta corriente, acreditando el monto al cliente y dejando trazabilidad del vínculo entre el pago digital y las facturas correspondientes.
Valor para el negocio:
- Permite reconocer contablemente los pagos online que los clientes realizan desde el portal
- Brinda trazabilidad completa entre cada pago digital y los comprobantes de cuenta corriente
- Evita que pagos aprobados queden sin efecto en el estado de cuenta del cliente
- Centraliza el control de pagos pendientes de reconocimiento en una vista unificada
Contexto:
- Esta vista es parte de la Fase 5 del Portal de Clientes
- Los pagos online son iniciados por los clientes desde el portal y aprobados por el gateway externo; el ERP los recibe pero no los registra contablemente de forma automática
- El proceso de reconciliación es siempre iniciado por un operador del ERP — nunca por el cliente del portal
Funcionalidad
Vista Principal — Pagos Portal
La vista se presenta dentro del módulo CtaCte del ERP y organiza los pagos online en dos pestañas:
Pestaña Pendientes
Muestra todos los pagos online aprobados por el gateway que aún no tienen recibo generado en el ERP. Para cada pago, el operador visualiza:
- Nombre del cliente
- Monto del pago
- Gateway de pago utilizado (PayPerTIC o MercadoPago)
- Fecha de aprobación del pago por el gateway
Desde esta pestaña el operador puede iniciar la acción de generar recibo sobre cualquier fila.
Pestaña Historial
Muestra los pagos que ya fueron reconciliados, es decir, aquellos que ya tienen un recibo de cuenta corriente generado. Permite auditoría y seguimiento posterior por parte del equipo operativo.
Acción — Generar Recibo
Al seleccionar "Generar Recibo" sobre un pago pendiente, el operador confirma la acción. El sistema entonces:
- Obtiene automáticamente el siguiente número de recibo correlativo según el numerador de comprobantes de tipo Recibo
- Crea el recibo en cuenta corriente, acreditando el monto al cliente
- Vincula el recibo con las facturas que el cliente seleccionó al pagar desde el portal
- Registra el pago como conciliado, asociándolo al recibo generado
- Informa al operador el número de recibo asignado
El número de recibo es asignado por el sistema — el operador no lo ingresa manualmente.
Reglas de Negocio
RN-001: Unicidad de la conciliación
- Descripción: Un pago online solo puede ser reconciliado una única vez. Si dos operadores intentan conciliar el mismo pago de forma simultánea, únicamente el primero en confirmar tiene éxito. El segundo operador recibe un mensaje de error indicando que el pago ya fue conciliado.
- Ejemplo: El operador A y el operador B visualizan el mismo pago pendiente. El operador A confirma la generación del recibo. Cuando el operador B intenta confirmar, el sistema le informa que ese pago ya fue procesado.
RN-002: Filtro por sucursal activa
- Descripción: La vista solo muestra pagos que corresponden a la sucursal activa del operador que inició sesión. No es posible ver ni conciliar pagos de otras sucursales.
- Ejemplo: Un operador que trabaja en la sucursal Centro solo visualiza pagos de clientes de esa sucursal.
RN-003: Numeración automática del recibo
- Descripción: El número de comprobante (recibo) es generado automáticamente por el sistema a partir del numerador configurado para el tipo de comprobante Recibo. El operador no puede asignar ni modificar este número.
RN-004: Solo pagos aprobados son reconciliables
- Descripción: Únicamente los pagos con estado "aprobado" por el gateway aparecen en la pestaña Pendientes y pueden ser reconciliados. Los pagos rechazados, cancelados o pendientes de aprobación no son visibles en esta vista.
RN-005: Datos del pago son inmutables durante la conciliación
- Descripción: El cliente y el monto asociados a un pago online no pueden modificarse durante el proceso de reconciliación. Son datos originados en el portal y reconocidos por el gateway — el operador solo confirma su registro contable.
Casos de Uso
UC-001: Conciliar un pago online pendiente
Actor: Operador del ERP con permisos de CtaCte
Precondiciones:
- El operador tiene sesión activa en el ERP con permisos de CtaCte
- Existe al menos un pago online aprobado por el gateway que no tiene recibo generado, correspondiente a la sucursal activa
Flujo principal:
- El operador accede a la vista "Pagos Portal" dentro del módulo CtaCte
- El sistema muestra la pestaña Pendientes con los pagos online aprobados sin recibo
- El operador identifica el pago que desea conciliar y selecciona "Generar Recibo"
- El sistema solicita confirmación de la acción
- El operador confirma
- El sistema genera el recibo de cuenta corriente con el número correlativo siguiente, acredita el monto al cliente, vincula el recibo con las facturas correspondientes y marca el pago como conciliado
- El sistema informa al operador el número de recibo generado
- El pago deja de aparecer en la pestaña Pendientes y pasa al Historial
Flujos alternativos:
- 5a. El operador cancela la confirmación → el pago permanece en estado pendiente sin cambios
- 6a. Otro operador ya concilió el mismo pago de forma simultánea → el sistema muestra un error informando que el pago ya fue conciliado; el pago desaparece de la lista de pendientes
Postcondiciones:
- El recibo queda registrado en cuenta corriente con el monto acreditado al cliente
- El pago online queda marcado como conciliado con referencia al recibo generado
- El recibo queda vinculado a las facturas que el cliente pagó desde el portal
UC-002: Consultar el historial de pagos reconciliados
Actor: Operador del ERP con permisos de CtaCte
Precondiciones:
- El operador tiene sesión activa en el ERP con permisos de CtaCte
- Existen pagos previamente conciliados en la sucursal activa
Flujo principal:
- El operador accede a la vista "Pagos Portal" dentro del módulo CtaCte
- El operador selecciona la pestaña Historial
- El sistema muestra los pagos ya conciliados con sus datos (cliente, monto, gateway, fecha, número de recibo generado)
Postcondiciones:
- El operador puede verificar qué pagos fueron reconciliados y en qué momento
Roles y Permisos
| Rol | Acción permitida |
|---|---|
| Operador CtaCte | Ver pagos pendientes, generar recibos, consultar historial |
| Cliente del portal | Sin acceso — esta vista es exclusiva del ERP |
Dependencias
Módulos internos
- Cuenta Corriente (CtaCte): El recibo generado se crea directamente en la cuenta corriente del cliente dentro del módulo CtaCte
- Comprobantes: La numeración del recibo proviene del numerador configurado para el tipo de comprobante Recibo
Servicios externos
- Gateway de pago (PayPerTIC / MercadoPago): El gateway es la fuente de los pagos aprobados que alimentan la pestaña Pendientes; la reconciliación no interactúa con el gateway — solo lee su resultado
Criterios de Aceptación
- [ ] Dado que existen pagos online aprobados sin recibo en la sucursal activa, cuando el operador accede a la pestaña Pendientes, entonces el sistema muestra solo esos pagos con nombre del cliente, monto, gateway y fecha de aprobación
- [ ] Dado que el operador selecciona "Generar Recibo" y confirma, cuando el sistema procesa la acción, entonces se crea un recibo en cuenta corriente con número correlativo autogenerado y el pago queda marcado como conciliado
- [ ] Dado que el recibo fue generado, cuando el operador consulta la pantalla, entonces el sistema informa el número de recibo asignado
- [ ] Dado que el pago fue conciliado, cuando el operador vuelve a la pestaña Pendientes, entonces ese pago ya no aparece en la lista
- [ ] Dado que el pago fue conciliado, cuando el operador accede a la pestaña Historial, entonces el pago aparece con sus datos y el número de recibo asociado
- [ ] Dado que dos operadores intentan conciliar el mismo pago simultáneamente, cuando ambos confirman, entonces solo el primero tiene éxito y el segundo recibe un error indicando que el pago ya fue conciliado
- [ ] Dado que el operador pertenece a una sucursal, cuando accede a la vista, entonces solo visualiza pagos de esa sucursal
- [ ] Dado que un pago tiene estado rechazado, cancelado o pendiente de aprobación del gateway, cuando el operador accede a la pestaña Pendientes, entonces ese pago no aparece en la lista
- [ ] Dado que el operador selecciona "Generar Recibo" y luego cancela la confirmación, cuando vuelve a la lista, entonces el pago permanece en estado pendiente sin modificaciones
Notas Adicionales
- Esta funcionalidad corresponde a la Fase 5 del Portal de Clientes
- La vista es exclusiva para operadores internos del ERP — los clientes del portal no tienen acceso a ella ni visibilidad sobre el estado de la reconciliación desde el ERP
- El vínculo entre el recibo generado y las facturas que el cliente pagó proviene de la información registrada en el portal al momento del pago