Manual PSICOLE

Bienvenido al manual de usuario del sistema PSICOLE — plataforma de gestión integral del Colegio de Psicólogos.

¿Qué es PSICOLE?

PSICOLE es el sistema centralizado para la gestión de matrículas, finanzas, cursos de capacitación y autogestión de profesionales matriculados. Permite a los operadores del Colegio y a los propios profesionales realizar todos sus trámites de forma digital.

¿Por dónde empiezo?

Elegí tu perfil para ir directo a la guía de inicio rápido:

• Administrador

  ---

  Gestión completa del sistema, usuarios y configuración.

  Guía del Administrador

• Operador de Matrículas

  ---

  Alta, seguimiento y validación de solicitudes de matrícula.

  Guía del Operador de Matrículas

• Operador de Finanzas

  ---

  Gestión de pagos, recibos, cuotas y conciliación bancaria.

  Guía del Operador de Finanzas

• Operador de Cursos

  ---

  Alta y gestión de cursos de capacitación continua.

  Guía del Operador de Cursos

• Operador de Trámites

  ---

  Procesamiento de solicitudes y trámites administrativos.

  Guía del Operador de Trámites

• Supervisor de Trámites

  ---

  Supervisión y aprobación de trámites del equipo.

  Guía del Supervisor de Trámites

• Colegiado

  ---

  Portal de autogestión para profesionales matriculados.

  Guía del Colegiado

• Prestador

  ---

  Envío de órdenes de obras sociales y seguimiento de liquidaciones.

  Guía del Prestador

• Aspirante

  ---

  Solicitantes de matrícula que aún no están matriculados.

  Guía del Aspirante

Módulos del sistema

Referencia rápida

• Glosario de términos
• Matriz de permisos por rol
• Preguntas frecuentes
• Errores comunes y soluciones

🖥 Escritorio Panel de administración general del sistema

📱 Móvil Panel de administración general del sistema

Guía de Inicio Rápido — Administrador

¿Qué es este rol?

El Administrador es el rol con mayor nivel de acceso en PSICOLE. Tiene control total sobre la configuración del sistema, la gestión de usuarios y permisos, y la supervisión de todos los módulos. Es responsable de mantener la integridad operativa de la plataforma, crear y desactivar cuentas de operadores, configurar parámetros globales y auditar el comportamiento del sistema.

Este rol está reservado para el personal técnico o directivo del Colegio de Psicólogos con responsabilidad sobre la administración TI del sistema.

Acceso al sistema

• URL de login: https://psicole.app/login (o la URL interna asignada por el Colegio)
• Credenciales: proporcionadas por el equipo técnico durante la puesta en marcha; se recomienda cambiar la contraseña en el primer ingreso
• Dashboard: al ingresar verás el panel de administración con métricas globales: total de colegiados activos, matrículas pendientes, recaudación del mes, trámites en curso y estado de los jobs automáticos (CRON). Desde las tarjetas de KPIs podés saltar en un clic a los módulos clave (solicitudes de matrícula, tickets sin asignar, beneficios, mensajes internos) y desde el bloque de Acciones rápidas al Kanban de tickets, Padrón, Finanzas y Auditoría.

Capturas auditadas del inicio administrativo

El dashboard administrativo fue recapturado en escritorio y celular para validar que KPIs, accesos rápidos, buscador y barra lateral mantengan jerarquía sin solapamientos en monitores chicos y teléfonos.

Tus tareas principales

1. Crear y gestionar usuarios del sistema

La tarea más frecuente del Administrador es dar de alta o de baja a operadores del Colegio.

1. Ingresá a Administración → Usuarios.
2. Hacé clic en + Nuevo usuario.
3. Completá: nombre completo, correo electrónico institucional, contraseña temporal y rol (elegí uno de los 9 roles disponibles).
4. Asigná los permisos específicos si el rol lo requiere (los permisos se expresan como triplets modulo/accion/recurso, por ejemplo FINANZAS/CREATE/PAYMENT).
5. Guardá. El usuario recibirá un correo de bienvenida con instrucciones para activar su cuenta.

Para desactivar un usuario: buscalo en la lista, hacé clic en los tres puntos (⋮) y seleccioná Desactivar cuenta. El usuario pierde acceso inmediatamente pero sus datos históricos se conservan.

Super Admins y promoción segura

La vista de Super Admins también fue recapturada para documentar el comportamiento responsive del listado y del flujo de promoción. En celular, el botón principal ocupa el ancho disponible y el modal de confirmación queda contenido en la pantalla.

2. Configurar parámetros globales del sistema

1. Ingresá a Administración → Configuración.
2. Desde allí podés ajustar:
3. Tarifario mensual de cuotas, manteniendo CUOTA_MENSUAL como concepto oficial y cargando importes por periodo en Dinero -> Configuración -> Tarifario mensual.
4. Pasarelas de pago: actualizá credenciales, modo sandbox/producción y URLs de retorno o webhook.
5. CRON jobs: habilitá o deshabilitá las tareas automáticas (generación mensual de cuotas, envío de notificaciones de vencimiento, conciliación automática).
6. Parámetros de PDF: logotipo, datos del Colegio que aparecen en recibos y certificados.
7. Antes de ejecutar o habilitar la generación mensual, verificá que CUOTA_MENSUAL sea el único concepto mensual activo y que el período esté cargado en el Tarifario mensual.
8. Si está habilitado el CRON de lote CBU, verificá que use la misma regla que la generación manual: solo adhesiones BANK_DEBIT con CBU verificado y Debt.finalAmount como importe a debitar.
9. Guardá cada sección por separado. Los cambios críticos de pasarelas pueden requerir reinicio o redeploy según el entorno.

3. Auditar el sistema y revisar logs

1. Ingresá a Administración → Auditoría.
2. Filtrá por fecha, usuario o módulo para ver el registro de acciones.
3. Cada entrada muestra: fecha/hora, usuario, acción realizada (CREATE, UPDATE, DELETE), módulo afectado y detalle del objeto modificado.
4. Podés exportar los logs en formato CSV para reportes de auditoría interna.

4. Supervisar los CRON jobs automáticos

1. Ingresá a Administración → Tareas Automáticas.
2. Verás el estado de cada job: último tiempo de ejecución, próxima ejecución, cantidad de registros procesados y si hubo errores.
3. Si un job falló, podés relanzarlo manualmente con el botón Ejecutar ahora.
4. Los jobs críticos incluyen: generación de cuotas mensuales, recordatorios de vencimiento por e-mail y conciliación bancaria nocturna.
5. El job de lote CBU no debe ejecutarse si las cuotas del período no fueron generadas o si hay diferencias entre el lote y Debt.finalAmount.

Lo que NO podés hacer con este rol

• Operar módulos de negocio directamente como si fueras un operador (aunque técnicamente tenés acceso, el rol Admin está pensado para configuración, no para carga operativa diaria).
• Eliminar registros históricos de pagos, matrículas o trámites (el sistema no lo permite por integridad contable; solo podés anular con trazabilidad).
• Modificar el código fuente desde el panel (la configuración es a nivel de parámetros, no de código).

Flujos de trabajo típicos

Escenario 1: Alta de un nuevo operador de finanzas

1. El jefe administrativo solicita dar de alta a un nuevo empleado para el área de finanzas.
2. Ingresás a Administración → Usuarios → + Nuevo usuario.
3. Asignás el rol OPERADOR_FINANZAS y los permisos FINANZAS/CREATE/PAYMENT, FINANZAS/READ/RECEIPT, FINANZAS/UPDATE/CUOTA.
4. El operador recibe el correo de activación y puede ingresar al sistema.

Escenario 2: Actualización de claves de pasarela tras renovación anual

1. El proveedor notifica el vencimiento de credenciales.
2. Ingresás a Dinero → Configuración o Parámetros del Sistema, según el parámetro.
3. Reemplazás las credenciales con los nuevos valores obtenidos del panel del proveedor.
4. Guardás y reiniciás el servicio de pagos online desde Administración → Servicios.
5. Realizás un pago de prueba desde una cuenta colegiado de test para confirmar que la integración funciona.

Recursos relacionados

• Módulo de Administración de Usuarios
• Configuración Global del Sistema
• Tareas Automáticas (CRON)
• Auditoría y Logs
• Pagos Online y Pasarelas

🖥 Escritorio Bandeja de solicitudes de matrícula

📱 Móvil Bandeja de solicitudes de matrícula

Guía de Inicio Rápido — Operador de Matrículas

¿Qué es este rol?

El Operador de Matrículas es el responsable de gestionar el ciclo de vida de las matrículas profesionales en el Colegio. Revisa las solicitudes de nuevos aspirantes, valida la documentación presentada, aprueba o rechaza inscripciones, emite credenciales y mantiene actualizado el padrón de colegiados. Es el nexo entre los aspirantes que solicitan matricularse y la habilitación formal para ejercer la profesión.

Acceso al sistema

• URL de login: https://psicole.app/login
• Dashboard: al ingresar verás un resumen de solicitudes pendientes de revisión, matrículas vencidas por renovar y alertas de documentación incompleta. El panel principal muestra una cola de trabajo priorizada por antigüedad de solicitud.

Tus tareas principales

1. Revisar y procesar solicitudes de matrícula

Esta es la tarea central del rol. Las solicitudes llegan desde el portal del Aspirante.

1. Ingresá a Matrículas → Solicitudes Pendientes.
2. La lista muestra cada solicitud con: nombre del aspirante, fecha de solicitud, estado de la documentación y días en cola.
3. Hacé clic en una solicitud para abrir el expediente digital.
4. Revisá cada documento adjunto (título universitario, DNI, foto, constancia de CUIL, comprobante de pago del arancel de inscripción):
5. Tildá cada documento como Verificado si es legible y válido.
6. Si un documento está incompleto o ilegible, usá Solicitar corrección para enviar un mensaje automático al aspirante indicando qué debe reenviar.
7. Una vez que todos los documentos estén verificados, habilitá el botón Aprobar solicitud.
8. Al aprobar, el sistema genera automáticamente:
9. Número de matrícula (correlativo).
10. Credencial digital con código QR.
11. Notificación por e-mail al nuevo colegiado.
12. Primera cuota de matrícula anual (en coordinación con el módulo de Finanzas).

2. Gestionar el padrón de colegiados activos

1. Ingresá a Matrículas → Padrón de Colegiados.
2. Podés buscar por nombre, apellido, número de matrícula o DNI.
3. Desde la ficha de cada colegiado podés:
4. Actualizar datos personales (domicilio, teléfono, e-mail) a pedido del profesional.
5. Registrar un cambio de categoría (por ejemplo, de matrícula provisoria a definitiva).
6. Suspender o dar de baja una matrícula por resolución del Colegio (requiere ingresar el número de expediente resolutivo).
7. Emitir una nueva credencial si la anterior fue extraviada o venció.

3. Controlar vencimientos y renovaciones

1. Ingresá a Matrículas → Vencimientos.
2. El sistema muestra un calendario con las matrículas que vencen en los próximos 30, 60 y 90 días.
3. Podés lanzar un envío masivo de notificaciones a todos los colegiados con vencimiento próximo desde el botón Notificar seleccionados.
4. Para procesar una renovación: buscá al colegiado, verificá que esté al día con sus cuotas (el indicador de deuda aparece en la ficha) y hacé clic en Renovar matrícula. El sistema actualizará la fecha de vigencia automáticamente.

Lo que NO podés hacer con este rol

• Registrar o modificar pagos — eso es exclusivo del Operador de Finanzas.
• Acceder a los expedientes de trámites (habilitaciones, certificados) — eso lo gestiona el Operador de Trámites.
• Crear usuarios del sistema — es función del Administrador.
• Aprobar o rechazar devoluciones de cuotas — requiere permisos de Finanzas.
• Ver información financiera consolidada del Colegio (reportes de recaudación global).

Flujos de trabajo típicos

Escenario 1: Aspirante que completó su solicitud online

1. Recibís una notificación en el dashboard: "Nueva solicitud de matrícula — García, María José".
2. Abrís el expediente en Matrículas → Solicitudes Pendientes.
3. Revisás los 5 documentos requeridos. El título universitario está escaneado con baja resolución.
4. Hacés clic en Solicitar corrección → seleccionás "Título universitario" → escribís: "Por favor, reenvíe el título con mejor resolución (mínimo 300 DPI)".
5. El aspirante recibe el correo, reenvía el documento actualizado y la solicitud vuelve a tu cola.
6. Verificás el nuevo documento, tildás todos como válidos y hacés clic en Aprobar solicitud.
7. El sistema genera la matrícula N° 4821 y envía la credencial digital a la aspirante.

Escenario 2: Colegiado solicita duplicado de credencial

1. El colegiado llama indicando que perdió su credencial.
2. Buscás la matrícula en Matrículas → Padrón de Colegiados.
3. Verificás que la matrícula esté vigente y sin deudas.
4. Hacés clic en Emitir duplicado de credencial.
5. El sistema genera un PDF con código QR actualizado que podés descargar e imprimir o enviar por e-mail.

Recursos relacionados

• Módulo de Solicitud de Matrícula
• Gestión de Matrículas
• Credenciales y Códigos QR
• Flujo del Aspirante

🖥 Escritorio Panel de cobro de cuotas y deudas

📱 Móvil Panel de cobro de cuotas y deudas

Guía de Inicio Rápido — Operador de Finanzas

¿Qué es este rol?

El Operador de Finanzas gestiona todo el ciclo económico del Colegio: emisión y seguimiento de cuotas, registro de pagos manuales, emisión de recibos, conciliación bancaria y control de deudas. Trabaja en coordinación con DINERO, pasarelas de pago y Liquidaciones para distribuir fondos de prestadores.

Es el rol responsable de mantener la salud financiera del padrón: que cada colegiado tenga sus cuotas generadas, que los pagos estén correctamente imputados y que los recibos sean emitidos con datos válidos.

Acceso al sistema

• URL de login: https://psicole.app/login
• Dashboard: al ingresar verás indicadores clave: recaudación del mes en curso, cantidad de cuotas vencidas sin pagar, pagos online pendientes de conciliación y alertas de discrepancias bancarias. El resumen financiero se actualiza en tiempo real.

Tus tareas principales

1. Registrar un pago manual

Cuando un colegiado paga en la sede del Colegio o por un medio externo:

1. Ingresá a Finanzas → Pagos → Registrar pago manual.
2. Buscá al colegiado por nombre, DNI o número de matrícula.
3. El sistema mostrará automáticamente las cuotas adeudadas ordenadas por vencimiento.
4. Seleccioná la/s cuota/s que el colegiado está pagando.
5. Completá:
6. Monto recibido (puede incluir intereses por mora si corresponde).
7. Medio de pago (efectivo, transferencia, cheque).
8. Número de comprobante (si aplica, ej: número de transferencia bancaria).
9. Fecha de pago (por defecto es hoy, pero podés retroceder si el pago fue procesado con demora).
10. Hacé clic en Confirmar pago. El sistema imputará el pago a las cuotas seleccionadas y generará automáticamente el recibo.
11. Podés descargar el recibo en PDF para entregar al colegiado o enviarlo por e-mail con el botón Enviar recibo.

2. Gestionar cuotas del padrón

1. Ingresá a Dinero → Operaciones → Cuotas.
2. Podés filtrar por: colegiado, período, estado (pagada/vencida/pendiente/en mora).
3. Antes del RUN mensual, verificá que el tipo mensual oficial CUOTA_MENSUAL esté activo y que el período tenga el importe aprobado en el Tarifario mensual.
4. Usá Previsualizar para revisar cantidad de profesionales, cuotas a generar, importe base, descuentos por método de pago y monto total.
5. Ejecutá Generar solo cuando el total sea consistente. La generación crea deudas y cargos de cuenta corriente; no significa que el dinero ya fue cobrado.
6. Si vas a operar debito automatico, revisá que las deudas del período tengan finalAmount correcto antes de generar o enviar el lote CBU.
7. Para aplicar un descuento o bonificación: ingresá a la cuota, hacé clic en Modificar monto e ingresá el justificativo (este cambio queda registrado en la auditoría).
8. Para dar de baja una cuota por error (por ejemplo, se generó duplicada): seleccioná la cuota y usá Anular cuota. Solo podés anular cuotas que no tengan pagos imputados.

2.1 Preparar lote CBU

1. Ingresá a Dinero → Operaciones → Débito automático.
2. Revisá adhesiones BANK_DEBIT activas, CBU verificado y cuenta activa.
3. Generá el lote del período o abrí el lote creado por CRON.
4. Controlá que el total del lote sea la suma de Debt.finalAmount de las cuotas incluidas.
5. Si el total no cuadra, no descargues ni envíes el COELSA: revisá descuentos, beneficios, método de cobro y deudas del período.
6. Descargá el archivo y envialo al banco por el canal operativo acordado.
7. Al recibir la devolución, cargá aprobados y rechazados.

En un rechazo CBU, el sistema revierte solo el descuento por débito directo. Si el profesional tenía jubilación, beneficio parental u otro beneficio aprobado, ese beneficio queda vigente en el saldo pendiente.

3. Conciliación bancaria

La conciliación bancaria permite cruzar los movimientos del extracto bancario con los pagos registrados en el sistema.

1. Ingresá a Finanzas → Conciliación Bancaria.
2. Importá el extracto bancario en formato CSV o TXT (según el formato del banco).
3. El sistema intentará matchear automáticamente cada movimiento bancario con un pago registrado, usando el monto, la fecha y el número de referencia.
4. Para cuotas mensuales, revisá que el movimiento coincida con la deuda final generada o con un ajuste contable aprobado por aumento mensual.
5. Los movimientos no identificados aparecen en la sección Pendientes de conciliación.
6. Para cada pendiente: buscá manualmente el pago correspondiente usando el buscador lateral o marcalo como Ingreso no identificado para revisión posterior.
7. Al finalizar, generá el Informe de conciliación en PDF.

3.1 Certificar un RUN mensual contra banco

Para cerrar un periodo de cuotas, trabajá con el denominador estricto: tarjeta aceptada + CBU cobrado. Usá recibos, padrones, caja y listados de prestadores como evidencia de contraste, no como movimientos nuevos si representan el mismo cobro.

1. Separá rechazos bancarios de cobros reales.
2. Validá que cada cobro tenga deuda del periodo, operación PAY, recibo y cuenta corriente.
3. Para CBU, aplicá solo si hay una transacción bancaria exacta y no vinculada a otra operación.
4. Si el match depende solo de nombre, monto parecido o padrón histórico, dejalo en cola manual.
5. Documentá el cierre con cantidad, monto, tasa de conciliación y lista de bloqueos.

En la certificación SANDBOX de mayo/junio 2026 se conciliaron 5.697 de 5.986 eventos aceptados/cobrados. Los 360 eventos sueltos originales quedaron tratados al 100%, pero 289 permanecieron sin destino estricto por falta de desempate seguro.

4. Emitir y gestionar recibos

1. Ingresá a Finanzas → Recibos.
2. Podés buscar recibos por colegiado, número de recibo, período o fecha.
3. Para reemitir un recibo (si el colegiado lo perdió): buscá el pago, hacé clic en Reemitir recibo. El sistema genera un PDF idéntico con marca de agua "DUPLICADO".
4. Para anular un recibo: ingresá el número de recibo, clic en Anular e ingresá el motivo. La anulación queda registrada y el pago vuelve al estado "pendiente de imputación".

Lo que NO podés hacer con este rol

• Aprobar o rechazar solicitudes de matrícula — es función del Operador de Matrículas.
• Acceder al panel de administración de usuarios del sistema.
• Modificar credenciales de pasarelas de pago — eso lo hace el Administrador.
• Gestionar cursos o inscripciones — es función del Operador de Cursos.
• Aprobar trámites — es función del Operador o Supervisor de Trámites.

Flujos de trabajo típicos

Escenario 1: Colegiado paga en ventanilla con efectivo

1. El colegiado se presenta en la sede y entrega $15.000 en efectivo por 2 cuotas adeudadas.
2. Ingresás a Finanzas → Pagos → Registrar pago manual.
3. Buscás al colegiado por DNI: "28.741.963".
4. El sistema muestra 3 cuotas vencidas. Seleccionás las primeras 2 (las más antiguas, por orden de vencimiento).
5. Ingresás monto $15.000, medio "Efectivo", fecha de hoy.
6. El sistema calcula que las 2 cuotas suman $14.200 y el excedente de $800 se registra como adelanto para la próxima cuota.
7. Se genera el recibo N° 000847. Lo imprimís y se lo entregás al colegiado.

Escenario 2: Detectar y resolver una discrepancia en conciliación

1. Al importar el extracto bancario del viernes, el sistema deja 3 movimientos sin identificar.
2. Ingresás a Finanzas → Conciliación Bancaria → Pendientes.
3. Uno de los movimientos de $7.500 no matchea. Revisás la descripción: "TRANSFERENCIA GONZALEZ PEDRO".
4. Buscás en operaciones y encontrás un pago por pasarela de ese colegiado por el mismo monto registrado el mismo día.
5. Asociás el movimiento bancario a la operación PAY y lo marcás como conciliado.
6. Los otros 2 movimientos son depósitos propios del Colegio; los marcás como "Operación interna".

Recursos relacionados

• Módulo de Finanzas — Cuotas y Pagos
• Pagos Online y Pasarelas
• Conciliación Bancaria
• Módulo de Liquidaciones
• Emisión de Recibos y PDFs

🖥 Escritorio Gestión de cursos de capacitación

📱 Móvil Gestión de cursos de capacitación

Guía de Inicio Rápido — Operador de Cursos

¿Qué es este rol?

El Operador de Cursos administra la oferta de capacitación y formación continua del Colegio. Es responsable de crear y publicar cursos, gestionar las inscripciones de los colegiados, controlar la asistencia, emitir certificados de aprobación y manejar los aranceles asociados a cada capacitación.

Este rol trabaja de forma coordinada con el módulo DINERO cuando los cursos son arancelados, ya que el pago de la inscripción se procesa a través del sistema de cuotas o una pasarela habilitada.

Acceso al sistema

• URL de login: https://psicole.app/login
• Dashboard: al ingresar verás un resumen de cursos activos, inscripciones de la semana, próximas fechas de inicio y alertas de cursos con cupo casi completo. También aparece una bandeja de solicitudes de inscripción pendientes de confirmación.

Tus tareas principales

1. Crear y publicar un nuevo curso

1. Ingresá a Cursos → Gestión de Cursos → + Nuevo curso.
2. Completá el formulario:
3. Nombre del curso y descripción detallada.
4. Modalidad: presencial, virtual o híbrida.
5. Fechas: fecha de inicio, fecha de fin y fechas de cada clase si es un curso con múltiples encuentros.
6. Cupo máximo: cantidad de inscriptos permitidos.
7. Arancel: si es gratuito o arancelado (en ese caso, ingresá monto y método de cobro: pasarela, débito automático o pago en sede).
8. Instructor/Disertante: nombre y datos del responsable del curso.
9. Puntaje de actualización: si el curso otorga créditos de formación continua, ingresá la cantidad de horas o puntos.
10. Subí el material de difusión (imagen de portada, programa del curso en PDF).
11. Hacé clic en Guardar como borrador para revisarlo antes de publicar.
12. Una vez conforme, hacé clic en Publicar. El curso aparecerá disponible en el portal de autogestión de los colegiados.

2. Gestionar inscripciones

1. Ingresá a Cursos → Inscripciones.
2. Seleccioná el curso para ver su lista de inscriptos.
3. Las inscripciones pueden venir de dos fuentes:
4. Online: el colegiado se inscribió desde su portal de autogestión. Aparece con estado "Pendiente de confirmación".
5. Manual: un colegiado solicitó inscripción por teléfono o presencialmente. Usá + Inscribir manualmente, buscá al colegiado por matrícula o DNI y confirmá.
6. Para confirmar una inscripción online: revisá si el curso es arancelado y si el pago fue registrado. Si todo está en orden, hacé clic en Confirmar inscripción. El colegiado recibe un e-mail de confirmación con los datos del curso.
7. Para cancelar una inscripción: seleccioná al inscripto y hacé clic en Cancelar. Si corresponde devolución de arancel, coordiná con el Operador de Finanzas.
8. Si el cupo se completó, el sistema cierra automáticamente las inscripciones. Podés habilitar una lista de espera desde la configuración del curso.

3. Registrar asistencia y emitir certificados

Registro de asistencia:

1. Ingresá a Cursos → Asistencia.
2. Seleccioná el curso y la fecha del encuentro.
3. Para cada participante de la lista, marcá Presente, Ausente o Tardanza.
4. Guardá la asistencia. El sistema acumula el porcentaje de asistencia por participante.

Emisión de certificados:

1. Una vez finalizado el curso, ingresá a Cursos → Certificados.
2. El sistema lista a todos los inscriptos con su porcentaje de asistencia.
3. Marcá como Aprobados a quienes cumplieron el mínimo de asistencia requerido (configurable por curso, generalmente 75%).
4. Hacé clic en Generar certificados masivos. El sistema crea un PDF personalizado para cada aprobado, firmado digitalmente con el logo y datos del Colegio.
5. Los certificados quedan disponibles para descarga en el portal de autogestión de cada colegiado y podés enviarlos masivamente por e-mail desde el mismo módulo.

Lo que NO podés hacer con este rol

• Registrar pagos de aranceles — los pagos los gestiona el Operador de Finanzas.
• Aprobar matrículas o trámites del Colegio.
• Acceder a información financiera global del Colegio (recaudación, deudas del padrón).
• Crear o modificar usuarios del sistema.
• Gestionar prestadores ni órdenes de obras sociales.

Flujos de trabajo típicos

Escenario 1: Puesta en marcha de un curso de posgrado arancelado

1. El área académica confirma que se dictará "Terapia Cognitivo Conductual — Módulo Avanzado", 4 sábados, arancel $8.000, cupo 20 personas.
2. Creás el curso en Cursos → + Nuevo curso con todos los datos, configurás el cobro por pasarela o deuda y publicás.
3. En los siguientes días, llegán 18 inscripciones online. Revisás que cada una tenga el pago confirmado desde Cursos → Inscripciones.
4. Dos inscripciones están sin pago; enviás un recordatorio automático con el botón Notificar pago pendiente.
5. Al completarse el primer encuentro, registrás asistencia: 17 presentes, 1 ausente justificado.
6. Al finalizar el cuarto módulo, generás los 16 certificados de aprobación (17 asistentes menos 1 que no alcanzó el 75% de asistencia).

Escenario 2: Gestión de un curso gratuito con lista de espera

1. Publicás un webinar gratuito con cupo de 50 personas.
2. En 2 horas se completa el cupo. Activás la lista de espera desde Cursos → Configuración del curso.
3. Una semana antes del curso, 5 inscriptos cancelan. El sistema automáticamente notifica a los primeros 5 de la lista de espera para que confirmen.
4. Confirmás los nuevos inscriptos y el cupo queda completo nuevamente.

Recursos relacionados

• Módulo de Cursos
• Emisión de Certificados
• Integración de Pagos de Aranceles
• Autogestión del Profesional — Inscripción a Cursos

🖥 Escritorio Bandeja de tickets y trámites asignados

📱 Móvil Bandeja de tickets y trámites asignados

Guía de Inicio Rápido — Operador de Trámites

¿Qué es este rol?

El Operador de Trámites gestiona los tickets y solicitudes formales que los colegiados presentan al Colegio. Recibe tickets asignados automáticamente por el sistema, los atiende dentro del plazo (SLA) establecido, y puede pedir documentación adicional, pausar, resolver o derivar al supervisor.

Al ingresar al sistema, el operador llega directamente a su Dashboard Personal — una vista de bienvenida con todas sus tareas organizadas por urgencia.

Acceso al sistema

• URL: https://psicole.app/login
• Redirección automática: al ingresar, el sistema te lleva directo a /operator/dashboard — sin pasos extra.

Mi Dashboard Personal

Ruta: /operator/dashboard

Al entrar verás un panel con encabezado en degradado que muestra tu nombre, fecha y rol, seguido de los indicadores clave de tu trabajo.

KPIs en tiempo real

Los indicadores en el encabezado muestran de un vistazo:

• Pendientes — tickets que todavía no tomaste
• En progreso — tickets que ya estás atendiendo
• Resueltos hoy — completados en el día
• Vencidos — tickets cuyo SLA ya expiró

Alerta de tickets vencidos

Si tenés tickets con SLA vencido, aparece un banner rojo al tope del dashboard para que no se te escapen.

Tickets agrupados por urgencia

Los tickets están organizados en grupos con color en el borde izquierdo:

Vista en mobile:

Kanban de Tickets

Ruta: /operator/tickets

Vista estilo tablero con columnas por estado. Cada columna muestra los tickets que corresponden a ese estado y el semáforo SLA (verde / naranja / rojo).

Vista mobile:

Detalle de un Ticket

Hacé clic en cualquier ticket (en el dashboard o en el kanban) para abrir el detalle completo.

Desde el detalle podés:

• Ver todos los datos del solicitante y la categoría
• Leer el historial de comentarios y acciones
• Cambiar el estado del ticket (tomar, avanzar, pausar, resolver)
• Agregar comentarios internos o públicos
• Si la categoría tiene un trámite vinculado, aparece el botón "Ver servicio relacionado" para ir directamente al módulo

Vista mobile:

Ciclo de vida de un ticket

PENDIENTE → ASIGNADO → EN PROGRESO → [PAUSADO] → RESUELTO → CERRADO

El semáforo SLA en cada ticket indica: - 🟢 Verde — dentro del plazo - 🟠 Naranja — menos del 25% del tiempo restante - 🔴 Rojo — SLA vencido

Alertas y notificaciones

Cuando se te asigna un ticket nuevo, recibís una notificación en la campana del header. Haciendo clic en la notificación llegás directamente al ticket.

Vista mobile:

Flujo diario típico

1. Entrás al sistema → aterrizás en Mi Dashboard
2. Revisás el banner rojo (si hay tickets vencidos, atendelós primero)
3. Revisás el grupo En Advertencia (naranja) — son los que están por vencerse
4. Trabajás los tickets En Progreso
5. Tomás tickets Pendientes según disponibilidad
6. Al resolver, cambiás el estado a Resuelto — el sistema notifica al solicitante automáticamente

Recursos relacionados

• Sistema completo de Tickets y Soporte
• Gestión del Supervisor de Trámites

🖥 Escritorio Panel de supervisión de trámites y SLA

📱 Móvil Panel de supervisión de trámites y SLA

Guía de Inicio Rápido — Supervisor de Trámites

¿Qué es este rol?

El Supervisor de Trámites tiene visibilidad completa sobre la operación: ve los tickets de todos los operadores, puede reasignar, cerrar y monitorear el cumplimiento de SLA. Además accede al dashboard de métricas con KPIs globales y a la vista kanban por operador.

Acceso al sistema

• URL: https://psicole.app/login
• Menú: Tickets → Métricas / Tickets → Gestión de Tickets

Dashboard de Métricas

Ruta: /supervisor/metrics

Vista ejecutiva con KPIs del estado completo de la operación: tickets por estado, tiempos de resolución promedio y carga por operador.

Vista mobile:

Los indicadores clave incluyen: - Total de tickets activos en el sistema - Tickets por estado (pendiente, en progreso, resueltos, vencidos) - Distribución por operador y área de trabajo - Semáforo SLA global

Kanban por Operador

Ruta: /supervisor/tickets → Tab "Por operador"

Vista kanban que agrupa todos los tickets por operador para visualizar la carga de trabajo de cada uno. Desde acá podés detectar desbalances y reasignar tickets.

Reasignar un ticket

1. Abrís el detalle del ticket
2. Clic en Reasignar
3. Seleccionás el nuevo operador disponible
4. El operador anterior y el nuevo reciben notificación automática

Semáforo SLA

El semáforo es visible en todas las vistas:

El sistema puede generar alertas automáticas al supervisor cuando se supera el SLA (configurado en Tareas Programadas).

Cerrar un ticket

Como supervisor podés cerrar definitivamente un ticket resuelto: 1. Abrís el detalle del ticket (estado RESOLVED) 2. Clic en Cerrar ticket 3. El ticket pasa a estado CLOSED — acción irreversible

El cierre automático ocurre a los 7 días de resolución (configurable en Parámetros del Sistema).

Configuración del módulo

La configuración de categorías, áreas de trabajo y parámetros es responsabilidad del Administrador. Ver:

• Categorías de Tickets
• Áreas de Trabajo
• Parámetros del Sistema — Sección TICKETS

Recursos relacionados

• Sistema completo de Tickets y Soporte
• Guía del Operador de Trámites

🖥 Escritorio Portal de autogestión del profesional

📱 Móvil Portal de autogestión del profesional

Guía de Inicio Rápido — Colegiado

¿Qué es este rol?

El Colegiado es el profesional psicólogo matriculado en el Colegio que accede al portal de autogestión para gestionar sus asuntos de manera autónoma: consultar y pagar sus cuotas, descargar recibos y certificados, solicitar trámites, inscribirse a cursos y actualizar sus datos. Este rol tiene acceso exclusivamente a su propia información — nunca puede ver ni modificar datos de otros colegiados.

Es el rol de mayor cantidad de usuarios en el sistema, ya que representa a todos los profesionales matriculados activos.

Acceso al sistema

• URL de login: https://psicole.app/login (o el subdominio personalizado del Colegio, por ejemplo matriculas.cpacf.org.ar)
• Credenciales: número de matrícula como usuario y la contraseña establecida durante la activación de la cuenta. Si es el primer ingreso, usá el link de activación enviado por e-mail cuando fue aprobada tu matrícula.
• Dashboard: al ingresar verás un resumen de tu situación: estado de la matrícula (vigente/vencida), cuotas adeudadas, próximos cursos a los que estás inscripto y trámites en curso. En el panel superior se muestra además una miniatura de tu credencial digital — al hacer clic se abre un modal con el QR ampliado y atajos para descargar, compartir o ver la credencial completa.

Tus tareas principales

1. Consultar y pagar tus cuotas online

1. Ingresá a Mi cuenta → Cuotas y pagos.
2. Verás el historial completo de cuotas: las pagas con fecha de pago y número de recibo, y las pendientes con su fecha de vencimiento y monto.
3. Para pagar online, seleccioná la/s cuota/s que querés abonar (podés seleccionar varias a la vez).
4. Hacé clic en Pagar deuda. Serás redirigido al checkout de la pasarela habilitada.
5. Elegí el medio disponible en el proveedor: tarjeta, QR, billetera u otro instrumento configurado.
6. Completá el pago. Al volver al portal, el sistema actualizará automáticamente el estado de las cuotas (puede demorar hasta 2 minutos en reflejarse si el banco tarda en confirmar).
7. El recibo digital quedará disponible inmediatamente en Mi cuenta → Mis recibos.

2. Descargar recibos y comprobantes

1. Ingresá a Mi cuenta → Mis recibos.
2. Los recibos se muestran ordenados por fecha. Podés filtrar por año o período.
3. Hacé clic en Descargar PDF sobre cualquier recibo para obtener el comprobante oficial del Colegio con número de recibo, datos del pago y código QR de verificación.
4. El código QR del recibo permite que terceros (obras sociales, empleadores, juzgados) verifiquen la autenticidad del documento accediendo a https://psicole.app/verificar.

3. Solicitar un trámite

1. Ingresá a Trámites → Nueva solicitud.
2. Seleccioná el tipo de trámite que necesitás del menú desplegable (por ejemplo: "Constancia de matrícula vigente", "Certificado de buena conducta", "Habilitación de consultorio").
3. Completá el formulario con los datos requeridos y adjuntá la documentación solicitada (el sistema indica qué documentos son obligatorios para cada tipo de trámite).
4. Si el trámite tiene arancel, el sistema te solicitará el pago antes de confirmar la solicitud.
5. Hacé clic en Enviar solicitud. Recibirás un número de expediente y un correo de confirmación.
6. Podés seguir el estado del trámite en tiempo real desde Trámites → Mis trámites. Si el operador te solicita documentación adicional, recibirás una notificación y podrás adjuntarla desde el mismo expediente.

4. Inscribirte a un curso

1. Ingresá a Cursos → Oferta de cursos.
2. Explorá los cursos disponibles. Podés filtrar por modalidad, fecha o temática.
3. Hacé clic en un curso para ver el detalle: descripción, programa, disertante, fechas, cupo disponible y arancel.
4. Si querés inscribirte, hacé clic en Inscribirme.
5. Si el curso es gratuito, la inscripción se confirma de inmediato.
6. Si el curso es arancelado, el sistema te redirigirá a la pasarela habilitada. Una vez confirmado el pago, tu inscripción queda registrada.
7. Recibirás un e-mail de confirmación con todos los detalles del curso (links de acceso si es virtual, dirección si es presencial).

5. Actualizar tus datos personales y profesionales

1. Ingresá a Mi cuenta → Mis datos.
2. Podés actualizar: domicilio particular, domicilio profesional, teléfono de contacto y e-mail.
3. Importante: algunos cambios (como el cambio de nombre por razones legales) requieren documentación respaldatoria y se procesan como un trámite formal.
4. Guardá los cambios. Los datos actualizados se reflejan en los próximos certificados y constancias que solicites.

Lo que NO podés hacer con este rol

• Ver información de otros colegiados — el sistema te muestra exclusivamente tu propia información.
• Modificar el monto de tus cuotas ni solicitar exenciones de pago directamente (debés solicitarlo como un trámite formal).
• Acceder a los módulos administrativos (matrículas, finanzas, cursos, trámites) en su versión operativa.
• Descargar recibos de pagos que no te correspondan.
• Aprobar o rechazar ningún tipo de solicitud.

Flujos de trabajo típicos

Escenario 1: Pagar las cuotas atrasadas y descargar un certificado para una obra social

1. Tu obra social requiere una constancia de matrícula vigente y de estar al día con las cuotas del Colegio.
2. Ingresás a Mi cuenta → Cuotas y pagos: tenés 2 cuotas vencidas.
3. Seleccionás ambas cuotas y pagás online con tu tarjeta a través de la pasarela habilitada.
4. Una vez confirmado el pago, ingresás a Trámites → Nueva solicitud → "Constancia de matrícula vigente".
5. Enviás la solicitud. En minutos recibís el PDF por e-mail y también está disponible en Trámites → Mis trámites.
6. Descargás el PDF y lo adjuntás en el formulario de la obra social.

Escenario 2: Inscripción a un curso con cupo limitado

1. Ves publicado el curso "Neuropsicología Clínica" con solo 5 lugares disponibles.
2. Ingresás a Cursos → Oferta de cursos, buscás el curso y hacés clic en Inscribirme.
3. El curso tiene arancel de $5.000. Pagás con tu tarjeta a través de la pasarela habilitada.
4. Recibís la confirmación: "Tu inscripción al curso Neuropsicología Clínica fue confirmada. Fecha de inicio: 15 de abril."
5. El certificado de aprobación estará disponible automáticamente en tu portal al finalizar el curso.

Recursos relacionados

• Autogestión del Profesional — Guía completa
• Pagos Online y Pasarelas
• Tipos de Trámites disponibles
• Oferta de Cursos
• Verificación de Documentos con QR

🖥 Escritorio Portal de carga de órdenes de obra social

📱 Móvil Portal de carga de órdenes de obra social

Guía de Inicio Rápido — Prestador

¿Qué es este rol?

El Prestador es el profesional psicólogo matriculado que, además de su membresía como colegiado, está registrado como prestador de servicios de salud mental para una o más obras sociales y/o prepagas. A través de este rol gestiona sus órdenes de atención, las presenta al Colegio para su procesamiento, administra su agenda de consultorio y cobra sus honorarios mediante el sistema de liquidaciones.

Acceso al sistema

• URL de login: https://psicole.app/login
• Dashboard: resumen de actividad — órdenes del período, monto acumulado, órdenes pendientes, alertas de órdenes rechazadas y turnos del día.

Tus tareas principales

1. Consultorio — Agenda de turnos

El Consultorio es tu agenda de sesiones. Podés programar turnos vinculados a pacientes de tu libreta y, al marcarlos como realizados, crear la orden de prestación en un clic.

1. Ir a Mis Órdenes → Consultorio.
2. Hacé clic en + Nuevo turno.
3. Completá los datos:
4. Paciente (autocomplete desde tu libreta — o ingresá el nombre libremente).
5. Obra social (se autocompleta si el paciente tiene OOSS en la libreta).
6. Fecha y hora, duración (default: 50 min), modalidad (Presencial / Virtual) y notas.
7. Al finalizar la sesión, hacé clic en ✓ Completar en la card del turno. Si el turno tenía obra social, el sistema te propone crear la orden de prestación con los datos pre-llenados.
8. Exportá tu agenda a Google Calendar con el botón Exportar .ics (cabecera de la página).

2. Cargar órdenes de atención

1. Ir a Mis Órdenes → Mis Órdenes → + Nueva Orden.
2. El campo Paciente tiene autocomplete desde tu libreta: al seleccionar un paciente se auto-completan DNI, obra social y número de afiliado.
3. Completá fecha de atención, sesiones, diagnóstico y tratamiento (los campos de diagnóstico y tratamiento sugieren valores usados anteriormente para agilizar la carga).
4. Adjuntá la orden física (JPG, PNG o PDF).
5. Guardá.

3. Libreta de pacientes

La libreta centraliza los datos de tus pacientes para agilizar la carga de órdenes.

1. Ir a Configuración → Pacientes.
2. Buscar por nombre, apellido o DNI (campo de búsqueda con resultados en tiempo real).
3. Nuevo paciente → formulario con:
4. Nombre, apellido, DNI.
5. Obras sociales (podés agregar múltiples): obra social + Nº afiliado + plan (opcional).
6. Datos de contacto: teléfono, email, fecha de nacimiento, dirección, notas.
7. Importar desde órdenes: si ya tenés órdenes cargadas, el sistema puede crear automáticamente los pacientes de tu historial. Aparece un banner de importación cuando tenés pocos pacientes registrados — hacé clic en Ver preview para ver qué se importaría antes de confirmar.

4. Generar rendición mensual

Al cerrar el mes, presentá tus órdenes validadas al Colegio:

1. En Mis Órdenes, aparece un banner verde cuando tenés órdenes validadas listas para rendir: "Tenés X órdenes validadas listas para rendir este período."
2. Hacé clic en Generar rendición.
3. Revisá el resumen por obra social (cantidad de órdenes y subtotal por cada una).
4. Adjuntá tu factura en PDF e ingresá el monto de la factura.
5. Hacé clic en Enviar rendición al Colegio.
6. Seguí el estado de tus rendiciones desde Liquidaciones.

5. Consultar liquidaciones

1. Ir a Liquidaciones.
2. Cada liquidación muestra: período, estado (chip de color), cantidad de órdenes, monto, fecha de envío y link a la factura.
3. Cuando el Colegio aprueba una liquidación y genera el comprobante, podés descargarlo desde Ver detalle → Descargar comprobante (PDF válido como constancia contable).

6. Gestionar tu perfil de prestador

1. Ir a Configuración → Obras Sociales para ver y gestionar las obras sociales habilitadas.
2. Ir a Configuración → Datos Bancarios para actualizar tu CBU de acreditación.
3. Ir a Mi Perfil Público para actualizar lo que ven los pacientes en el directorio (bio, foto, especialidades, OOSS, modalidad de atención).

Flujos de trabajo típicos

Escenario 1: Cierre mensual con agenda de consultorio

1. Durante el mes cargaste los turnos en Consultorio.
2. Al marcar cada turno como "Completado", el sistema te propone crear la orden de prestación con los datos pre-llenados.
3. Al fin del mes ves el banner verde en Mis Órdenes: "Tenés 28 órdenes validadas listas para rendir."
4. Generás la rendición, adjuntás tu factura y la enviás al Colegio.

Escenario 2: Importación inicial de pacientes

1. Ingresás al sistema por primera vez con historial de órdenes.
2. En Configuración → Pacientes aparece un banner: "Importar pacientes desde tus órdenes históricas".
3. Hacés clic en Ver preview — el sistema te muestra 35 pacientes únicos detectados en tus órdenes.
4. Confirmás la importación. Los pacientes quedan en tu libreta con sus obras sociales y números de afiliado.

Escenario 3: Rendición de factura y descarga de comprobante

1. El Colegio procesó tu liquidación de marzo 2026 por $99.750 neto.
2. En Liquidaciones ves el aviso: "Factura pendiente de subir".
3. Subís el PDF de tu Factura. El sistema confirma la carga.
4. El operador revisa y cierra la operación. Recibís notificación.
5. Descargás el PDF del comprobante y lo enviás a tu contador.

Lo que NO podés hacer con este rol

• Ver las órdenes ni liquidaciones de otros prestadores.
• Aprobar tus propias órdenes.
• Modificar una orden ya liquidada (requiere trámite de rectificación formal).
• Acceder a los módulos operativos del Colegio.

Recursos relacionados

• Módulo de Prestadores
• Sistema de Liquidaciones
• Directorio Público
• Autogestión del Profesional

🖥 Escritorio Formulario de solicitud de matrícula

📱 Móvil Formulario de solicitud de matrícula

Guía de Inicio Rápido — Aspirante

¿Qué es este rol?

El Aspirante es el profesional que completó su formación universitaria y desea matricularse en el Colegio de Psicólogos para ejercer legalmente la profesión. Es un rol temporal: existe únicamente durante el proceso de solicitud de matrícula. Una vez que la solicitud es aprobada, el usuario pasa a ser Colegiado automáticamente.

El Aspirante tiene acceso muy acotado al sistema: puede crear su cuenta, completar el formulario de solicitud de matrícula, adjuntar la documentación requerida, pagar el arancel de inscripción y hacer seguimiento del estado de su solicitud.

Acceso al sistema

• URL de registro: https://psicole.app/registro (no es el mismo link que el login de colegiados)
• Credenciales: las creás vos mismo al registrarte con tu dirección de e-mail y una contraseña.
• Dashboard: al ingresar verás exclusivamente el estado de tu solicitud de matrícula: documentos entregados, documentos pendientes, estado general del expediente y mensajes del área de matrículas.

Tus tareas principales

1. Registrarse y crear la solicitud de matrícula

Si todavía no tenés cuenta en el sistema:

1. Ingresá a https://psicole.app/registro.
2. Completá el formulario de registro inicial:
3. Nombre completo (tal como figura en tu DNI).
4. Número de DNI.
5. Número de CUIL.
6. Correo electrónico (será tu medio de comunicación con el Colegio durante todo el proceso).
7. Contraseña (mínimo 8 caracteres, al menos una mayúscula y un número).
8. Recibirás un correo de verificación. Hacé clic en el link para activar tu cuenta.
9. Una vez activada, ingresás con tu e-mail y contraseña.
10. El sistema te llevará directamente al formulario de Solicitud de Matrícula.

2. Completar el formulario de solicitud

El formulario de solicitud tiene varias secciones. Podés guardarlo como borrador y completarlo en varias sesiones.

Sección 1: Datos personales - Nombre completo, fecha de nacimiento, domicilio particular, teléfono de contacto. - Foto de perfil (formato JPG o PNG, fondo blanco, mínimo 400x400 px).

Sección 2: Datos profesionales - Universidad de egreso. - Título obtenido (Licenciado/a en Psicología, Doctor/a, etc.). - Año de egreso. - Domicilio profesional (dirección donde ejercerás, puede ser el mismo que el particular).

Sección 3: Adjuntar documentación

Esta sección es crítica. Los documentos requeridos son:

• Hacé clic en + Adjuntar al lado de cada documento y seleccioná el archivo desde tu computadora o celular.
• El sistema indica con un tilde verde cada documento correctamente cargado.

Sección 4: Pago del arancel de inscripción

1. Una vez completadas las secciones anteriores, el sistema mostrará el monto del arancel de inscripción.
2. Hacé clic en Pagar arancel de inscripción para ser redirigido al checkout de la pasarela habilitada.
3. Podés pagar con los medios que el proveedor tenga configurados para el Colegio.
4. Una vez confirmado el pago, quedará registrado automáticamente en tu solicitud.

Envío final:

1. Revisá que todas las secciones estén completas (el sistema señalará en rojo las incompletas).
2. Hacé clic en Enviar solicitud. Recibirás un número de expediente y un correo de confirmación.

3. Hacer seguimiento de tu solicitud

1. Ingresá al portal con tu e-mail y contraseña.
2. En el dashboard verás el estado actual de tu expediente:
3. Recibida: el Colegio recibió tu solicitud, está en cola de revisión.
4. En revisión: un operador está verificando tu documentación.
5. Documentación incompleta: el operador te solicita que corrijas o reenvíes algún documento. Recibirás un correo con el detalle.
6. Aprobada: tu matrícula fue aprobada. Recibirás un correo con tu número de matrícula y las instrucciones para acceder al portal como Colegiado.
7. Rechazada: la solicitud fue rechazada con el motivo indicado (podés subsanar el problema y presentar una nueva solicitud si corresponde).

4. Responder a una solicitud de corrección de documentación

Si el operador de matrículas detecta un problema con tu documentación:

1. Recibirás un e-mail con el asunto: "Solicitud de corrección — Expediente N° XXXX".
2. Ingresá al portal y en tu dashboard aparecerá un aviso naranja con el detalle de lo que debés corregir.
3. Hacé clic en Ver solicitud de corrección para leer el mensaje del operador.
4. Reemplazá el documento observado: hacé clic en Reenviar documento al lado del documento indicado y adjuntá el nuevo archivo.
5. Una vez que hayas corregido todo lo indicado, hacé clic en Confirmar corrección. El expediente volverá a la cola de revisión del operador.

Lo que NO podés hacer con este rol

• Acceder a ningún módulo del Colegio más allá de tu propia solicitud de matrícula.
• Ver el estado de las solicitudes de otros aspirantes.
• Solicitar trámites, inscribirte a cursos ni pagar cuotas — esas funciones estarán disponibles una vez que seas Colegiado.
• Modificar el arancel de inscripción ni solicitar exenciones (debés contactar al Colegio por los canales institucionales antes de iniciar la solicitud).
• Reutilizar el mismo e-mail para crear múltiples solicitudes simultáneas.

Flujos de trabajo típicos

Escenario 1: Primera solicitud de matrícula desde cero

1. Te graduaste en marzo 2026 y querés matricularte.
2. Ingresás a https://psicole.app/registro, creás tu cuenta y activás el e-mail.
3. Completás el formulario: datos personales, datos de la UBA (tu universidad), subís los 5 documentos requeridos.
4. Pagás el arancel de $12.000 con tu tarjeta de crédito.
5. Enviás la solicitud. Recibís el correo: "Solicitud recibida — Expediente N° 2026-0847".
6. A los 3 días hábiles, el operador detecta que el título subido está en baja resolución.
7. Recibís el correo de corrección. Reescaneás el título a 300 DPI y lo reenvíás desde el portal.
8. A los 2 días hábiles siguientes recibís: "Tu matrícula N° 5312 fue aprobada. Bienvenido/a al Colegio de Psicólogos."
9. Tu acceso cambia automáticamente al rol Colegiado y podés usar todas las funciones del portal.

Escenario 2: Consultar el estado de una solicitud demorada

1. Enviaste la solicitud hace 10 días hábiles y no recibiste novedades.
2. Ingresás al portal: el estado dice "En revisión". No hay alertas de corrección pendiente.
3. Revisás si llegó algún correo a la carpeta de spam — no hay ninguno.
4. Usás el botón Contactar área de Matrículas (disponible en tu dashboard) para enviar un mensaje interno al Colegio preguntando el estado.
5. Al día siguiente el operador responde: "Su expediente fue asignado a revisión, en 2 días hábiles tendrá respuesta."

Recursos relacionados

• Módulo de Solicitud de Matrícula
• Documentación requerida para matricularse
• Preguntas frecuentes del Aspirante
• Qué pasa después de ser aprobado — Guía del Colegiado

🖥 Escritorio Pantalla de inicio de sesión en PSICOLE

📱 Móvil Pantalla de inicio de sesión en PSICOLE

Autenticación y Permisos

Descripción

El módulo de Autenticación y Permisos gestiona el acceso seguro a PSICOLE mediante un esquema de doble token JWT y un modelo de control de acceso basado en roles (RBAC). Cada sesión emite un access token de 15 minutos (firmado con JWT_SECRET) y un refresh token de 7 días (firmado con JWT_REFRESH_SECRET) que se persiste en la base de datos, lo que permite invalidarlo en forma explícita en el logout o al detectar uso indebido.

El sistema implementa 9 roles fijos: ADMIN, OPERADOR_MATRICULAS, OPERADOR_FINANZAS, OPERADOR_CURSOS, OPERADOR_TRAMITES, SUPERVISOR_TRAMITES, COLEGIADO, PRESTADOR y ASPIRANTE. Cada rol lleva asociado un conjunto de permisos expresados como tripletas módulo / acción / recurso (por ejemplo, FINANZAS / CREATE / PAYMENT). El middleware authenticate verifica y decodifica el access token en cada request; requireRole y requirePermission aplican la regla de autorización antes de que el controlador procese la solicitud.

La impersonación de administrador permite al rol ADMIN iniciar sesión visual como cualquier otro usuario (excepto otros ADMIN) para diagnóstico y soporte. La sesión de impersonación es estrictamente de solo lectura: el middleware blockIfImpersonating() bloquea todas las operaciones de escritura. Cada inicio y fin de impersonación queda registrado en el AuditLog con IP, User-Agent, usuario origen y usuario destino.

Roles con acceso

Flujo principal

Login

1. El usuario ingresa su email (normalizado a minúsculas) y contraseña en el formulario de login (POST /api/v1/auth/login).
2. El sistema busca el usuario en la base de datos e incluye el rol con todos sus permisos y los módulos operador asignados.
3. Si el usuario no existe o la contraseña no coincide (verificada con bcrypt.compare), devuelve 401 Credenciales inválidas sin revelar cuál campo es incorrecto.
4. Si el usuario existe pero está inactivo (isActive = false), devuelve 403 Usuario inactivo.
5. Ante login exitoso, se generan el access token (15 min) y el refresh token (7 días). El refresh token se persiste en la tabla refresh_tokens con fecha de expiración.
6. Se actualiza lastLogin del usuario y se incrementan las métricas de Prometheus correspondientes.
7. La respuesta incluye accessToken, refreshToken y el objeto user completo (id, nombre, rol, permisos, datos del profesional si corresponde, módulos operador activos).

Renovación de token (Refresh)

1. El cliente (frontend con Axios) detecta una respuesta 401 con el access token expirado.
2. El interceptor de Axios llama automáticamente a POST /api/v1/auth/refresh enviando el refresh token almacenado en memoria.
3. El backend verifica la firma del refresh token, lo busca en la base de datos y comprueba que no haya expirado y que el usuario siga activo.
4. Si todo es válido, devuelve un nuevo access token. El refresh token existente no se rota (solo se genera uno nuevo al hacer login o al detener impersonación).
5. El interceptor reintenta automáticamente el request original con el nuevo token. Si el refresh falla, redirige al login.

Logout

1. El usuario hace clic en Cerrar Sesión en el menú de usuario.
2. El frontend envía POST /api/v1/auth/logout con el refresh token.
3. El backend elimina el registro del refresh token de la tabla refresh_tokens, invalidándolo para futuros intentos de renovación.
4. El frontend borra el estado de autenticación en Zustand (authStore) y redirige al login.

Impersonación de usuario (solo ADMIN)

1. El administrador navega a Usuarios → [usuario objetivo] → Iniciar Vista Como.
2. El frontend llama a POST /api/v1/auth/impersonate/:userId.
3. El sistema verifica que el solicitante sea ADMIN y que el objetivo no sea otro ADMIN.
4. Se genera un access token especial con los campos isImpersonating: true e impersonatedBy: <adminId>. No se emite refresh token para las sesiones de impersonación.
5. El audit log registra la acción IMPERSONATE_USER con IP y User-Agent.
6. El frontend muestra un banner visual de advertencia ("Estás viendo como [nombre del usuario]") durante toda la sesión.
7. Todas las peticiones de escritura (POST, PUT, DELETE) son bloqueadas por blockIfImpersonating() con 403 read-only.
8. Para terminar, el administrador hace clic en Volver a mi cuenta (POST /api/v1/auth/stop-impersonation). El sistema genera tokens normales para el admin y registra STOP_IMPERSONATION en el audit log.

Cambio de contraseña

1. El usuario autenticado navega a Mi Perfil → Cambiar Contraseña.
2. Ingresa la contraseña actual y la nueva contraseña (mínimo 8 caracteres).
3. El sistema verifica la contraseña actual con bcrypt.compare antes de actualizar.
4. El hash de la nueva contraseña se genera con bcrypt (rondas configurables, por defecto 10).

Campos y validaciones

Reglas de negocio

Estados y transiciones

stateDiagram-v2
    [*] --> Anónimo
    Anónimo --> Autenticado : login exitoso
    Autenticado --> Anónimo : logout / token expirado sin refresh válido
    Autenticado --> Renovando : access token expirado
    Renovando --> Autenticado : refresh válido → nuevo access token
    Renovando --> Anónimo : refresh inválido o expirado
    Autenticado --> Impersonando : ADMIN inicia impersonación
    Impersonando --> Autenticado : stop-impersonation (vuelve al admin)
    Impersonando --> Anónimo : access token expirado (sin refresh)

Errores frecuentes

Preguntas frecuentes

¿Qué pasa si el access token expira mientras el usuario está usando el sistema? El interceptor de Axios detecta la respuesta 401 y llama automáticamente al endpoint de refresh con el refresh token almacenado. Si el refresh es válido, el usuario no nota la interrupción. Si el refresh también venció (pasaron más de 7 días sin actividad), el usuario es redirigido al login.

¿Los refresh tokens se invalidan al cambiar la contraseña? No de forma automática en la implementación actual. Si se sospecha una sesión comprometida, el administrador puede desactivar el usuario (isActive = false) para forzar el cierre de todas las sesiones activas.

¿Qué información queda registrada en el audit log? Cada impersonación registra: ID del admin, email del admin, ID del usuario objetivo, email del objetivo, IP de origen y User-Agent del navegador. Las acciones IMPERSONATE_USER y STOP_IMPERSONATION son rastreables en Administración → Audit Log.

¿Puede un operador tener acceso a varios módulos? Sí. Un operador con rol genérico puede recibir asignaciones de módulos (OperatorModuleAssignment) que le otorgan acceso a EPICs específicos. El middleware requireModuleAccess verifica estas asignaciones en tiempo real contra la base de datos.

¿Cómo se crean los usuarios iniciales? El seed de base de datos (npm run db:seed) crea los roles del sistema y un usuario ADMIN inicial. Los demás usuarios se crean desde Administración → Usuarios o, en el caso de aspirantes, mediante el registro público en el formulario de solicitud de matrícula.

🖥 Escritorio Formulario multi-paso de solicitud de matrícula

📱 Móvil Formulario multi-paso de solicitud de matrícula

Solicitud de Matrícula

Descripción

El módulo de Solicitud de Matrícula implementa el proceso de onboarding de nuevos profesionales (UC-1.1). Un aspirante que desea colegiarse puede completar todo el trámite de forma digital, sin necesidad de concurrir físicamente al Colegio en la etapa inicial. El proceso está estructurado en un formulario multi-paso de 5 pasos con guardado automático de progreso: el aspirante puede cerrar la sesión y retomar desde el punto en que quedó.

El flujo comienza con la creación de una cuenta de usuario con rol ASPIRANTE y la verificación del email mediante un token de 24 horas. A continuación, el aspirante completa sus datos personales, académicos, carga los documentos requeridos (DNI frente/dorso, título universitario, analítico), firma la declaración jurada y abona el arancel de inscripción para enviar la solicitud. El sistema asigna un número de solicitud único con formato SOL-YYYY-XXXXXXXX.

Una vez enviada la solicitud, su estado pasa a PENDING_REVIEW y queda disponible en la bandeja de trabajo de los operadores de matrículas para su revisión. El aspirante puede consultar el estado de su solicitud en cualquier momento desde su portal de autogestión y recibe notificaciones por email ante cada cambio de estado.

Roles con acceso

Flujo principal

Paso 0 — Registro de cuenta y verificación de email

1. El aspirante accede a la URL pública de registro (/registro) e ingresa email, contraseña (mínimo 8 caracteres), nombre y apellido.
2. El sistema crea el usuario con rol ASPIRANTE y la solicitud en estado DRAFT en paso 1.
3. Se envía un email con un enlace de verificación válido por 24 horas.
4. El aspirante hace clic en el enlace (GET /api/v1/enrollment-application/verify-email/:token).
5. El sistema marca emailVerified = true y emite tokens de acceso (access + refresh) para que el aspirante continúe directamente al formulario.
6. Si el enlace venció, el aspirante puede solicitar uno nuevo desde la pantalla de login con "Reenviar verificación".

Paso 1 — Datos personales

1. El aspirante completa los datos personales obligatorios: nombre, apellido, DNI (tipo: DNI/LC/LE/Pasaporte), CUIT/CUIL, teléfono, fecha de nacimiento, género, nacionalidad y domicilio completo (calle, número, piso, departamento, código postal, ciudad, provincia).
2. El sistema valida el dígito verificador del CUIT/CUIL con el algoritmo oficial argentino.
3. Se verifica la unicidad de DNI y CUIT/CUIL contra todos los usuarios existentes.
4. El aspirante puede declarar el tipo de solicitud: PROVISORIA (título en trámite de legalización) o DEFINITIVA (título ya legalizado).
5. Al guardar, el paso avanza a 2 y los datos quedan persistidos aunque el aspirante cierre la sesión.

Paso 2 — Datos académicos

1. El aspirante ingresa: nombre de la universidad, fecha de egreso, título obtenido (ej: Licenciado en Psicología) y especialidades (selección múltiple).
2. Todos los campos son obligatorios excepto especialidades.
3. El sistema actualiza el paso a 3 al guardar exitosamente.

Paso 3 — Carga de documentos

1. El aspirante sube los archivos requeridos. Formatos aceptados: PDF, JPEG, PNG. Tamaño máximo operativo compartido: 13 MB por archivo.
2. Documentos obligatorios (sin estos no se puede enviar la solicitud):
   • DNI_FRONT — Frente del DNI
   • DNI_BACK — Dorso del DNI
   • UNIVERSITY_DEGREE — Título universitario o constancia de tramitación
   • ACADEMIC_TRANSCRIPT — Analítico de materias aprobadas
3. Documentos opcionales:
   • CRIMINAL_RECORD — Certificado de antecedentes penales
   • GOOD_CONDUCT — Certificado de buena conducta
   • PHOTO — Foto tipo carnet
   • OTHER — Documentación adicional
4. Cada documento subido queda asociado a la solicitud con su tipo, nombre original, tamaño y fecha de carga.
5. La pantalla muestra el estado de cada documento requerido (subido / pendiente) y resalta los faltantes.

Paso 4 — Declaración jurada y consentimiento

1. El sistema muestra el texto vigente de la declaración jurada de veracidad de datos y la política de privacidad.
2. El aspirante debe tildar explícitamente los checkboxes de aceptación antes de continuar.
3. Se registra la fecha y hora de aceptación.

El mismo texto se comparte con Renovación de Matrícula y puede ser actualizado desde la operación administrativa sin tocar código.

Paso 5 — Pago del arancel y envío

1. El sistema calcula el arancel de inscripción según el tipo de solicitud y muestra una boleta con número único (BOL-YYYYMM-XXXXXX).
2. El aspirante puede abonar online mediante la pasarela habilitada o presencialmente; en ese caso un operador confirmará el pago manualmente.
3. Una vez confirmado el pago, el estado de la solicitud cambia a PENDING_REVIEW y el aspirante recibe un email de confirmación con el número de solicitud.
4. La solicitud queda disponible en la bandeja de trabajo de los operadores de matrículas.

Consulta de estado (vista del aspirante)

1. El aspirante autenticado accede a Mi Solicitud desde su panel.
2. Ve el estado actual, el número de solicitud, la fecha de envío y el historial de cambios de estado con comentarios del operador.
3. Si el estado es REQUIRES_CHANGES, puede ver las observaciones del operador y subir los documentos corregidos.

Campos y validaciones

Reglas de negocio

Estados y transiciones

stateDiagram-v2
    [*] --> DRAFT : registro exitoso
    DRAFT --> DRAFT : completando pasos 1-4
    DRAFT --> PENDING_PAYMENT : formulario completo, esperando pago
    PENDING_PAYMENT --> PENDING_REVIEW : pago confirmado (online o manual)
    PENDING_REVIEW --> UNDER_REVIEW : operador toma la solicitud
    UNDER_REVIEW --> REQUIRES_CHANGES : operador solicita correcciones
    REQUIRES_CHANGES --> UNDER_REVIEW : aspirante sube documentos corregidos
    UNDER_REVIEW --> INTERNALLY_APPROVED : aprobación interna → matrícula provisoria
    UNDER_REVIEW --> REJECTED : rechazo definitivo
    INTERNALLY_APPROVED --> PENDING_MINISTRY : se eleva al Ministerio de Salud
    PENDING_MINISTRY --> APPROVED : aprobación ministerial → colegiado definitivo
    PENDING_MINISTRY --> REJECTED : rechazo ministerial

Errores frecuentes

Preguntas frecuentes

¿Puedo modificar los datos después de enviar la solicitud? Una vez enviada (estado PENDING_REVIEW), los datos ya no se pueden modificar directamente. Si el operador detecta un error, puede cambiar el estado a REQUIRES_CHANGES para que el aspirante corrija los documentos. Los datos personales solo se modifican mediante una solicitud formal al operador.

¿Qué significa solicitud de tipo PROVISORIA vs DEFINITIVA? PROVISORIA es para quienes tienen el título pero aún no han completado el trámite de legalización ante el Ministerio de Salud. DEFINITIVA es para quienes ya tienen el título debidamente apostillado o legalizado. Ambas pueden presentarse; la diferencia afecta el flujo de aprobación ministerial posterior.

¿Cuánto tiempo tengo para completar el formulario? No hay límite de tiempo para completar los pasos del formulario (la solicitud permanece en DRAFT indefinidamente). El único vencimiento es el token de verificación de email (24 horas) y la preferencia de pago online si se genera (24 horas).

¿Cómo sé si mi solicitud fue recibida correctamente? Recibirás un email de confirmación con el número de solicitud (SOL-YYYY-XXXXXXXX) cuando el pago sea confirmado y la solicitud pase a PENDING_REVIEW. También podés consultar el estado en cualquier momento desde tu portal.

¿Puedo subir más de un archivo por tipo de documento? No. Cada tipo de documento admite un solo archivo. Si necesitás reemplazar un documento ya subido, deberás subir el nuevo archivo para el mismo tipo, que sobreescribirá el anterior.

🖥 Escritorio Gestión y revisión de solicitudes de matrícula

📱 Móvil Gestión y revisión de solicitudes de matrícula

Gestión de Matrículas

Descripción

El módulo de Gestión de Matrículas (UC-1.2) es el espacio de trabajo de los operadores y administradores para revisar, aprobar, rechazar y administrar las matrículas de los psicólogos colegiados. Centraliza el ciclo de vida completo de la matrícula: desde la solicitud inicial enviada por el aspirante hasta la emisión del certificado ministerial y la credencial digital con QR.

El proceso de aprobación tiene dos fases diferenciadas: una interna del Colegio (revisión documental y aprobación con asignación de número de matrícula provisoria) y una externa (presentación ante el Ministerio de Salud y aprobación de la matrícula definitiva). La fase interna habilita al profesional a ejercer con matrícula provisoria; la fase externa le otorga la matrícula definitiva con número correlativo definitivo. Ambas fases generan documentación oficial en PDF.

Adicionalmente, el módulo gestiona modificaciones de datos solicitadas por colegiados, suspensiones y reactivaciones de matrícula, y el historial completo de cambios de estado con auditoría. La credencial digital del profesional (generada con QRCode y verificable en una URL pública) se emite automáticamente al completar la matrícula definitiva.

Roles con acceso

Flujo principal

Revisión de solicitudes (bandeja de trabajo)

1. El operador accede a Matrículas → Solicitudes Pendientes. La bandeja muestra todas las solicitudes en estado PENDING_REVIEW y UNDER_REVIEW, ordenadas por fecha de envío.
2. Cada fila muestra: número de solicitud, nombre del aspirante, tipo de solicitud (PROVISORIA / DEFINITIVA), fecha de envío y días transcurridos.
3. El operador abre la solicitud haciendo clic en su número para ver el detalle completo: datos personales, datos académicos, documentos adjuntos y estado del pago del arancel.
4. Si toma la solicitud para revisión, el estado cambia a UNDER_REVIEW y queda asociada a ese operador.
5. El operador visualiza cada documento en el visor integrado (PDF inline o previsualización de imagen).

Vista auditada desktop y mobile

La bandeja de Solicitudes de Matrícula fue recapturada luego de ajustar cabecera, acciones y modal de documentos. En móvil, las acciones superiores se organizan en grilla, el modal usa el ancho disponible y la carga de documentos evita desbordes laterales.

Carga manual administrativa de solicitud

Cuando una solicitud debe iniciarse desde administración, el operador puede usar Cargar solicitud manual dentro de Matrículas → Solicitudes.

El sistema crea:

• usuario aspirante verificado;
• solicitud en estado PENDING_REVIEW;
• historial de acción administrativa;
• registro de auditoría MANUAL_ADMIN_CREATED.

La solicitud manual no saltea el circuito de revisión. Luego continúa por aprobación interna, correcciones, rechazo o aprobación definitiva según corresponda.

Aprobación interna — Matrícula Provisoria (Fase 1)

1. Luego de revisar la documentación, el operador hace clic en Aprobar Internamente.
2. El sistema genera automáticamente un número de matrícula provisoria (provisionalNumber) con formato correlativo.
3. El estado de la solicitud pasa a INTERNALLY_APPROVED y el estado del profesional a PROVISIONAL.
4. Se genera el certificado para el Ministerio de Salud en PDF (usando PDFKit) con los datos del profesional y el número de matrícula provisoria.
5. El operador descarga el PDF ministerial para presentarlo ante el organismo correspondiente.
6. Se envía un email al aspirante notificando que su solicitud fue aprobada internamente y que se encuentra en trámite ante el Ministerio.

Solicitud de correcciones

1. Si la documentación es incompleta o incorrecta, el operador hace clic en Solicitar Correcciones.
2. Ingresa un comentario detallando qué documentos o datos deben corregirse.
3. El estado cambia a REQUIRES_CHANGES y se envía un email al aspirante con las observaciones.
4. El aspirante puede subir los documentos corregidos desde su portal. Al hacerlo, el estado vuelve a UNDER_REVIEW.

Rechazo de solicitud

1. Si la solicitud no cumple los requisitos y no es subsanable, el operador hace clic en Rechazar.
2. Ingresa el motivo del rechazo (obligatorio).
3. El estado cambia a REJECTED y se envía un email al aspirante con el motivo.
4. El arancel abonado queda registrado para gestión de devolución manual (no se devuelve automáticamente).

Aprobación definitiva — Matrícula Definitiva (Fase 2 — respuesta del Ministerio)

1. Una vez recibida la resolución ministerial de aprobación, el operador registra la respuesta en el sistema.
2. Ingresa el número de matrícula definitivo asignado por el Ministerio de Salud.
3. El sistema actualiza el estado de la solicitud a APPROVED y el estado del profesional a APPROVED.
4. Se genera la credencial digital del profesional:
   • Se crea un código QR único (PSICOLE-XXXXXXXXXXXXXXXX) asociado al profesional.
   • El QR apunta a la URL pública de verificación: {FRONTEND_URL}/verificar/{qrCode}.
   • El PDF de credencial digital se genera con PDFKit incluyendo foto, datos, número de matrícula y QR.
5. El profesional recibe un email con el enlace para descargar su credencial y con acceso a su portal de colegiado.
6. El rol del usuario cambia de ASPIRANTE a COLEGIADO y se habilita su acceso completo al sistema.

Verificación pública de credencial (QR)

1. Cualquier persona puede escanear el QR de la credencial del profesional con su teléfono.
2. Es redirigido a la URL pública {FRONTEND_URL}/verificar/{qrCode} (no requiere autenticación).
3. El sistema verifica el código QR y muestra los datos públicos del profesional: nombre, número de matrícula, estado (activo / suspendido), especialidades declaradas y fecha de vencimiento si aplica.

Gestión de profesionales matriculados

1. El operador accede a Matrículas → Profesionales para ver el padrón completo.
2. Puede filtrar por estado de matrícula, tipo (colegiado / prestador / aspirante), estado de pago y búsqueda por nombre, DNI o número de matrícula.
3. Desde el detalle de cada profesional puede:
   • Ver su ficha completa (datos personales, académicos, financieros).
   • Suspender la matrícula (estado SUSPENDED) por sanción o deuda.
   • Reactivar una matrícula suspendida.
   • Registrar el fallecimiento (estado DECEASED) para casos migrados del sistema legacy.
   • Iniciar el proceso de baja voluntaria (DISCHARGED).

Padrón profesional auditado

La lista de profesionales se validó como parte del barrido visual para asegurar que búsqueda, filtros y acciones no queden fuera del viewport en pantallas chicas.

Aprobación de solicitudes de modificación de datos

1. Cuando un colegiado solicita un cambio de datos desde su portal (dirección, teléfono, especialidades, etc.), el operador recibe una notificación en Matrículas → Modificaciones Pendientes.
2. El operador revisa los datos actuales vs. los datos propuestos.
3. Puede aprobar (los datos se actualizan en el sistema) o rechazar con un comentario.
4. El colegiado recibe un email con la resolución.

Campos y validaciones

Reglas de negocio

Estados y transiciones

stateDiagram-v2
    [*] --> PENDING : solicitud enviada y pagada
    PENDING --> PROVISIONAL : aprobación interna del Colegio
    PENDING --> REJECTED : rechazo definitivo
    PROVISIONAL --> APPROVED : aprobación ministerial + número definitivo
    PROVISIONAL --> REJECTED : rechazo ministerial
    APPROVED --> SUSPENDED : suspensión por sanción o deuda
    SUSPENDED --> APPROVED : reactivación por operador
    APPROVED --> DISCHARGED : baja voluntaria o definitiva
    SUSPENDED --> DISCHARGED : baja estando suspendido
    APPROVED --> DECEASED : fallecimiento (legacy)

Leyenda de estados del profesional:

Errores frecuentes

Preguntas frecuentes

¿Cuánto tiempo queda en estado PROVISORIA una matrícula? No hay un límite de tiempo automático. El estado PROVISIONAL persiste hasta que el operador registre la respuesta del Ministerio de Salud (positiva o negativa). El tiempo real depende del trámite ministerial, que puede extenderse varias semanas o meses.

¿Un profesional con matrícula PROVISORIA puede pagar cuotas? Sí. Las cuotas se generan automáticamente para todos los profesionales con estado PROVISIONAL o APPROVED según la configuración del tipo de cuota. El tipo de cuota a aplicar (mensual novel, mensual plena) depende de los atributos del profesional configurados en el FeeType.

¿Qué datos son públicos en la verificación por QR? La URL de verificación pública muestra únicamente: nombre completo, número de matrícula, estado de la matrícula, especialidades declaradas y, si aplica, fecha de vencimiento. No muestra DNI, CUIT, dirección ni datos financieros.

¿Puede el aspirante subir más documentos después de que el operador solicite correcciones? Sí. Cuando el estado es REQUIRES_CHANGES, el aspirante puede subir nuevos archivos para los tipos de documentos observados. Al guardar, el estado vuelve automáticamente a UNDER_REVIEW y el operador recibe una notificación.

¿Cómo se maneja una baja voluntaria? El operador inicia el proceso desde Profesionales → [profesional] → Registrar Baja. Se registra la fecha de baja, el motivo y el estado pasa a DISCHARGED. Las deudas pendientes al momento de la baja quedan registradas para gestión de cobro posterior. El usuario conserva acceso al sistema solo para consultar su historial.

Renovación de Matrícula

Las matrículas profesionales tienen una vigencia de 5 años. Al aproximarse la fecha de vencimiento, el sistema notifica automáticamente al colegiado para que inicie el trámite de renovación. El proceso es digital, con firma de Declaración Jurada y adjunto de documentación opcional.

Flujo completo

Colegiado inicia solicitud
       ↓
Firma Declaración Jurada (obligatorio)
       ↓
Adjunta documentos (opcional)
       ↓
Envía al Colegio → PENDING_REVIEW
       ↓
Operador revisa
    ↙         ↘
APPROVED    REQUIRES_CHANGES / REJECTED
    ↓               ↓
Nueva fecha     Colegiado corrige
de vencimiento  y reenvía

Vista del Colegiado

Acceso desde Mi Cuenta → Renovación de Matrícula (/my-matricula-renewal).

Verificar elegibilidad

Al ingresar, la pantalla muestra el estado de la matrícula:

Paso 1 — Declaración Jurada

El colegiado debe:

1. Leer el texto vigente de la Declaración Jurada.
2. Marcar el checkbox "Leí y acepto la Declaración Jurada".
3. Hacer clic en "Firmar y continuar".

El texto de esta Declaración Jurada es compartido con la Solicitud de Matrícula inicial y se administra desde la operación interna del Colegio.

Paso 2 — Documentación

Se pueden adjuntar (opcional):

• DNI frente — imagen (JPG/PNG) o PDF, hasta 13 MB.
• DNI dorso — imagen (JPG/PNG) o PDF, hasta 13 MB.

Paso 3 — Confirmación y envío

Muestra un resumen antes de enviar:

Al hacer clic en "Enviar al Colegio" la solicitud pasa a estado PENDING_REVIEW.

Estados de la solicitud

Si el operador solicita correcciones:

El colegiado recibe un email con las observaciones. Al ingresar, la pantalla muestra el mensaje del operador y habilita los campos para corregir y reenviar.

Panel Administrativo

Acceso desde Matrículas → Renovaciones de Matrícula (/admin/matricula-renewal).

Estadísticas

El encabezado muestra:

Filtros

Acciones del operador

Desde el panel lateral de detalle de cada solicitud:

Notificaciones automáticas

El sistema envía emails automáticos en los siguientes eventos:

Los templates de email son editables desde Administración → Notificaciones → Templates.

Débito Automático

El módulo de Débito Automático permite registrar un método de cobro mensual para las cuotas: CBU / COELSA o tarjeta de crédito. El descuento depende del método activo:

Las tarjetas de débito pueden existir como dato histórico, pero no se habilitan para nuevas adhesiones.

Vista del Colegiado

Acceso desde Mi Cuenta → Débito Automático (/my-direct-debit).

Vista en dispositivo móvil:

Adherirse al débito automático

1. Ingresar en "Mi Cuenta → Débito Automático".
2. Hacer clic en "Solicitar adhesión".
3. Completar el formulario:

1. Confirmar los datos y enviar.
2. La solicitud queda pendiente de activación por el Colegio.

Estados de la adhesión

Cambiar o cancelar el CBU

Para modificar el CBU: la pantalla permite ingresar uno nuevo. Esto genera una nueva solicitud de adhesión mientras el anterior permanece activo hasta que el nuevo sea procesado.

Para cancelar el débito: hacer clic en "Cancelar débito automático". Al cancelar, el descuento por método de cobro deja de aplicarse en el próximo período.

Panel Administrativo

Acceso principal desde Dinero → Operaciones → Débito Automático (/admin/dinero/operaciones?tool=debito).

Debito automatico en Operaciones de Dinero

La pantalla separa la gestión bancaria por CBU de la gestión de tarjetas:

Al seleccionar una adhesión, el panel de detalle muestra el profesional, matrícula, método registrado, CBU o tarjeta asociada, estado operativo, descuento aplicado y última vinculación técnica con la pasarela cuando corresponde.

CBU y archivo COELSA

Para débitos por CBU, el flujo es bancario:

1. Revisar adhesiones CBU / COELSA activas con cuenta verificada.
2. Confirmar que las cuotas del periodo ya fueron generadas y estan pendientes o vencidas.
3. Crear el lote del período manualmente o revisar el lote creado por la tarea programada.
4. Revisar cantidad de transacciones y total del lote antes de descargar.
5. Descargar el archivo COELSA desde Lotes de Débito.
6. Enviar el archivo al banco por el canal operativo acordado.
7. Cargar la devolución del banco.
8. Conciliar aprobados y rechazados.

Los lotes COELSA no incluyen tarjetas.

Importe incluido en el lote

La generación manual y la tarea programada usan la misma regla:

El lote no recalcula descuentos sobre el importe original. Toma el saldo final de la deuda ya generada para evitar que un beneficio acumulado quede duplicado o perdido.

Ejemplo operativo:

Si el colegiado es jubilado, el ejemplo cambia: cuota original $1.000, jubilacion 50%, importe final $500. Ese caso no entra como doble descuento CBU+jubilacion.

Tarjetas y pasarela de pago

Las tarjetas de crédito no se mezclan con el lote bancario CBU. La adhesión del profesional conserva el método de cobro elegido, y la vinculación técnica con la pasarela queda separada para poder cambiar de proveedor sin rehacer la adhesión.

Hoy la pasarela puede ser NAVE, pero el diseño permite registrar otra pasarela manteniendo la adhesión del profesional y su trazabilidad.

Cambios administrativos de metodo de cobro

Los perfiles autorizados de Dinero o Administración pueden corregir el método de cobro desde la ficha profesional cuando corresponde. El cambio no queda moderado por el usuario final, pero debe quedar:

• visible para el profesional en su perfil;
• registrado en historial y auditoría;
• asociado al operador que lo realizó;
• notificado cuando corresponda.

¿Qué puede hacer el operador?

Filtros disponibles

• Por estado (PENDING / ACTIVE / SUSPENDED / CANCELLED)
• Búsqueda por nombre, DNI, matrícula o CBU

Flujo de activación

1. Colegiado solicita adhesión → estado PENDING.
2. Operador descarga el archivo de adhesiones pendientes para el banco.
3. Banco procesa el archivo.
4. Operador recibe confirmación del banco.
5. Operador activa las adhesiones en PSICOLE → estado ACTIVE.
6. En el próximo ciclo de facturación, las cuotas se generan con el descuento correspondiente al método: CBU 20% o tarjeta de crédito 30%.

Descuento por método de cobro automático

El descuento se aplica automáticamente al generar las cuotas de cada mes para todos los colegiados con método de cobro en estado ACTIVE, siempre que el tipo de cuota mensual permita ese descuento.

El porcentaje del descuento forma parte de la configuracion del concepto mensual y de la adhesion operativa. Para cambios masivos, validar el impacto en la previsualizacion de cuotas antes de ejecutar el RUN mensual.

Rechazos bancarios

Cuando el banco rechaza un debito, PSICOLE conserva la trazabilidad del intento y la cuota queda pendiente para gestion administrativa. En ese caso se revierte solo el descuento de debito directo. Los beneficios ajenos al CBU, como jubilacion, beneficio parental o ajustes aprobados, se mantienen.

Siguiendo el ejemplo anterior, si el banco rechaza un debito de $800 con CBU 20%, la cuota vuelve a $1.000 salvo que exista otro beneficio no CBU aprobado. Si el colegiado es jubilado, no debio entrar al lote con doble descuento; debe conservar solo la cuota final de jubilacion.

El operador debe revisar:

• motivo informado por el banco;
• estado de la adhesion y cantidad de rechazos consecutivos;
• importe que queda pendiente luego del rechazo;
• si corresponde mantener, revertir o ajustar beneficios distintos del debito;
• si el rechazo debe suspender la adhesion por acumulacion de rechazos consecutivos.

Los rechazos pueden suspender automaticamente la adhesion si superan el umbral configurado.

Preguntas frecuentes

¿Cuándo se hace efectivo el débito? La fecha de débito coincide con la fecha de vencimiento de la cuota, configurada en el tipo de cuota correspondiente.

¿Qué pasa si el débito falla (fondos insuficientes)? El sistema registra el intento fallido. La cuota queda como pendiente y el operador puede gestionarla manualmente. No se aplican recargos por mora automáticos en el primer intento fallido.

¿El descuento aplica a todas las cuotas? Solo a las cuotas de tipo "regular" (cuota mensual). Los aranceles por trámites, cursos u otras cuotas extraordinarias no tienen descuento por débito.

🖥 Escritorio Operaciones de dinero con trazabilidad única

📱 Móvil Operaciones de dinero con trazabilidad única

Módulo DINERO

DINERO concentra el ciclo económico completo de PSICOLE: cuotas, pagos online, caja, conciliación bancaria, transferencias, planes de pago, débitos automáticos, liquidaciones, reintegros y auditoría. La regla operativa es simple: todo movimiento económico relevante debe poder abrirse como una operación única trazable.

Acceso

Menú admin: Dinero → Operaciones
Ruta principal: /admin/dinero/operaciones
Roles: ADMIN, operadores con módulo financiero habilitado.

Las rutas históricas de cobranza, caja, conciliación, transferencias, planes y débito redirigen a esta vista para evitar pantallas duplicadas.

Vista auditada desktop y mobile

La vista vigente de Dinero → Operaciones fue auditada en escritorio y celular. Los submódulos mantienen navegación horizontal controlada en móvil, las alertas operativas quedan dentro del viewport y las acciones principales se apilan sin superponerse.

Submódulos

Filtros operativos de beneficios, planes y conceptos externos

Cuando el RUN mensual usa reglas persistentes, Dinero debe permitir aislar cada causa económica sin mezclarla con pagos comunes:

Estos filtros son de control y auditoría. Si muestran reglas históricas, importes fuera de rango, cuotas de plan pagadas por planilla sin PAY o conceptos esperados sin profesional asociado, el caso debe quedar en revisión antes de conciliarse automáticamente.

Facturar cuotas, servicios AFIP y cola fiscal

La facturación fiscal post-pago se gestiona desde el circuito activo de Dinero. Las pantallas legacy de facturación fueron retiradas o redirigidas hacia Dinero → Configuración y Gobernanza del dinero para evitar duplicar operaciones.

Este apartado cubre EPIC-02UC-2.4 Facturar Cuotas (AFIP) y EPIC-08UC-8.4 Servicios AFIP: generación de comprobantes fiscales posterior al cobro, cola de reintentos, procesamiento manual controlado y alertas cuando AFIP no está disponible o no está configurado.

El flujo vigente separa dos conceptos:

Flujo operativo AFIP

1. Un pago queda aprobado y se materializa operación, pago y recibo.
2. PSICOLE encola un trabajo AfipInvoiceJob asociado al recibo o pago correspondiente.
3. La tarea programada o el botón Procesar AFIP toma trabajos QUEUED.
4. Si AFIP está configurado y disponible, el trabajo intenta obtener autorización fiscal.
5. Si falta configuración o AFIP no responde, el trabajo queda en reintento o FAILED con error visible.
6. El operador revisa la alerta y decide reintentar, corregir configuración o gestionar el comprobante por fuera según el procedimiento institucional.

Estados de la cola

Evidencia visual

La operación diaria se controla desde Gobernanza del dinero, donde aparecen la tarjeta Cola AFIP, el botón Procesar AFIP y las alertas activas.

Flujo mensual de cuotas, lote y conciliacion

El ciclo mensual de dinero se controla en cuatro momentos: valor vigente, generacion de deuda, cobro o debito, y corroboracion bancaria. El objetivo es que el importe aprobado por el Colegio llegue a una deuda concreta, a una operacion de dinero y finalmente a un movimiento bancario conciliado.

1. Definir el valor vigente. El administrador valida que CUOTA_MENSUAL este activo y que el periodo exista en el Tarifario Mensual de Cuotas. El importe base, los finales por medio de cobro y los beneficios salen de MONTHLY_FEE_TARIFF_POLICY.
2. Previsualizar la generacion. En Dinero -> Operaciones -> Cuotas, el operador selecciona tipo de cuota y periodo. La previsualizacion permite revisar cantidad de profesionales, cuotas a generar y monto total antes del RUN.
3. Ejecutar el RUN mensual. La generacion crea una deuda por profesional, periodo y tipo. Esa deuda queda con amount, discount y finalAmount; tambien se registra el cargo en cuenta corriente. Esta accion no representa dinero cobrado todavia.
4. Cobrar o preparar lote. Los pagos manuales, online, transferencias y debito automatico aplican contra las deudas abiertas. En CBU / COELSA, tanto la generacion manual como la tarea programada toman Debt.finalAmount como importe a debitar. Las tarjetas no entran al archivo COELSA.
5. Corroborar con extracto. Al cargar la extraccion bancaria, la conciliacion confirma que el dinero efectivamente ingresado o debitado coincide con una operacion PSICOLE. Si hay una diferencia aprobada por aumento mensual, se registra como ajuste contable trazable; si no, queda para revision humana.

Valores certificados mayo/junio 2026

Reglas certificadas:

• CBU / Caja de ahorro: 20% de descuento.
• Tarjeta de credito: 30% de descuento.
• Jubilados: 50% de descuento.
• Jubilacion excluye CBU/tarjeta: no se permite doble descuento sobre la cuota mensual.
• Los importes finales se redondean al multiplo operativo de $0,50.
• El valor junio 2026 se carga como importe oficial fijo de $16.021. No debe inferirse como incremento de 2,1% sobre mayo, porque ese porcentaje no produce ese monto.

Control especifico de lote CBU

El lote de debito por CBU no es una nueva liquidacion de descuentos. Es una foto operativa de deudas ya generadas.

Si un profesional tiene una cuota original de $1.000 y CBU activo, el RUN deja una deuda final de $800 y ese es el importe del lote. Si el banco rechaza el debito, la deuda vuelve a $1.000 salvo que exista otro beneficio no CBU compatible. Si el profesional es jubilado, el RUN deja $500 por jubilacion y no aplica CBU/tarjeta sobre esa misma cuota.

RUN mensual auditable de conciliacion

El cierre mensual de cuotas debe registrarse como un RUN auditable antes de aplicar conciliaciones masivas. El RUN no reemplaza las sesiones de conciliacion bancaria: las agrupa por periodo y deja constancia de fuentes, decisiones, metricas y pendientes.

Desde la aplicacion se opera en Dinero -> Operaciones -> Conciliacion -> RUN mensual. El panel permite crear un RUN PREVIEW, seleccionar el periodo, registrar extractos ya procesados como fuentes, simular decisiones y recalcular metricas. Es un panel de auditoria y control: no aplica pagos por si mismo, no modifica deudas y no envia comunicaciones.

El RUN mensual guarda:

Estados operativos:

• DRAFT: RUN creado, todavia sin decisiones completas.
• PREVIEWED: fuentes y decisiones previsualizadas, sin aplicar pagos.
• APPLIED: reglas estrictas aplicadas con idempotencia.
• CLOSED: cierre administrativo del mes.
• CANCELLED: RUN descartado sin usar como fuente de cierre.

Reglas de seguridad:

• Todo archivo debe tener tipo, rol, periodo, cantidad, monto y hash cuando exista.
• Las fuentes primarias son las que representan eventos individuales de dinero cobrado o rechazado, por ejemplo CBU y tarjeta. Extractos generales, recibos, padrones y listados de prestadores sirven como evidencia auxiliar o contraste, no como dinero nuevo por si solos.
• Un re-run debe reutilizar eventKey, marker e idempotencyKey para no duplicar operaciones.
• En SANDBOX el RUN puede previsualizar y clasificar sin enviar correos ni notificaciones.
• La accion Simular PREVIEW escribe solo MonthlyReconciliationDecision: AUTO_APPLY_STRICT, ALREADY_CLOSED, MANUAL_REVIEW, BLOCKED o EXCLUDED. No crea PaymentOperation, no emite recibos y no cambia Debt.status.
• Las PaymentOperation aprobadas por re-runs anteriores pueden cerrar un evento como ALREADY_CLOSED si existe evidencia unica por periodo, archivo, referencia y monto. Si hay ambiguedad, el evento queda BLOCKED.
• En la pantalla, Eventos tratados incluye tambien los EXCLUDED. La tasa de exito se calcula sobre eventos elegibles, es decir, tratados menos excluidos. Pendiente auditable corresponde a revision manual + bloqueados, no a todos los tratados.
• Los ajustes por aumento mensual salen de Dinero -> Configuracion -> Ajustes conciliacion (MONTHLY_FEE_RECONCILIATION_ADJUSTMENTS), no de codigo hardcodeado.
• Cuando se registra un extracto general como Galicia, el PREVIEW lo clasifica antes de matchear: cuota mensual, ajuste de periodo anterior, tramite/arancel, curso, liquidacion institucional, transferencia a clasificar o movimiento no acreditado. Solo la ruta de cuota mensual puede seguir al motor estricto de deudas; liquidaciones institucionales y egresos quedan excluidos del denominador de cuota, y tramites/cursos pasan a revision manual del concepto correspondiente.

Certificacion SANDBOX mayo/junio 2026

La certificacion de cuotas de mayo y junio 2026 se hizo en SANDBOX con fuentes primarias de tarjeta y CBU, mas recibos, padrones, caja y listados de contraste. El objetivo fue probar el flujo completo RUN -> deuda -> lote/cobro -> operacion PAY -> recibo -> cuenta corriente -> banco -> conciliacion sin enviar correos ni avisos.

Resultado operativo de la prueba:

Tratamiento del remanente original de 360 eventos:

Los 71 aplicados usaron el marcador SANDBOX_REMAINING_360_CBU_PENDING_79_20260623. La verificacion exigio deuda PAID, operacion aprobada, recibo activo, pago aprobado, movimiento de cuenta corriente, asiento contable, links documentales y transaccion bancaria MANUAL_MATCHED. El replay idempotente no creo objetos nuevos.

Los 289 restantes no deben aplicarse por inferencia debil: requieren desempate de banco/emisor, migracion formal de profesional, generacion de deuda faltante o una regla operativa aprobada.

Definicion de cuota mensual certificada

En la version certificada en sandbox, la definicion de cuota mensual queda controlada por el concepto oficial, el tarifario mensual y la deuda que genera el RUN:

Si para un mes nuevo se aprueba otro valor, se agrega el periodo al tarifario mensual. El RUN genera la deuda con ese importe base y los descuentos aplicables; el lote CBU toma luego el Debt.finalAmount, no vuelve a calcular el valor desde cero.

Cobro desde ficha profesional y caja

Cuando el operador necesita registrar un cobro manual a un profesional, puede iniciar el circuito desde la lista o ficha de profesionales.

En Profesionales, la acción con ícono de maletín abre el flujo de Caja para ingresar el pago correspondiente. Desde allí se registra el cobro, se imputa contra la deuda o concepto que corresponda y queda asociado a una operación de dinero trazable.

Uso operativo:

1. Buscar al profesional.
2. Abrir la acción de cobro/caja desde la fila o ficha.
3. Confirmar concepto, importe, medio de pago y caja responsable.
4. Registrar el pago.
5. Revisar que quede emitido el recibo o movimiento asociado.

Este flujo se usa para cobros manuales presenciales o administrativos. Los pagos online y débitos automáticos siguen sus propios circuitos.

Operación única de dinero

Cada pago, cobro, depósito, reversa o conciliación importante se representa con una PaymentOperation. Su número visible tiene formato:

PAY-2026-000001

Ese número es el punto de entrada para soporte, auditoría, conciliación y comunicación con el usuario. Desde la single se debe poder ver:

• Estado en español amable: Aprobada, Pendiente, Rechazada, Revertida.
• Canal: NAVE, transferencia bancaria, efectivo, caja, FIXED_POS, débito automático, obra social u otro.
• Propósito: cuota de matrícula, curso, trámite, plan, liquidación, cobro particular o reintegro.
• Origen e idempotencia: proveedor, referencia externa, clave idempotente y registro origen.
• Vínculos: deuda, pago, recibo, profesional, lote, caja, extracto o conciliación.
• Eventos: creación, aprobación, recibo creado, conciliación, reversa, usuario responsable y fecha.
• Impacto contable: asiento o vínculo a libro diario cuando corresponda.

Exportaciones de operaciones

Desde Dinero → Operaciones las exportaciones deben respetar los filtros activos de la vista: período, estado, canal, propósito, profesional, texto de búsqueda y demás criterios aplicados.

El botón de Excel/CSV exporta el conjunto completo que coincide con esos filtros, no solo la página visible. Si no hay movimientos para exportar, la UI debe avisarlo antes de descargar un archivo vacío.

Uso operativo:

1. Aplicar los filtros necesarios en Dinero → Operaciones.
2. Revisar el total de resultados.
3. Exportar a Excel o CSV.
4. Usar el archivo como soporte de auditoría, conciliación o análisis operativo.

Pagos y recibos

PSICOLE distingue tres conceptos:

El dato documental autoritativo es Receipt.receiptNumber. Si un registro legado de pago conserva receiptNumber, se considera dato histórico y no debe presentarse como numeración principal.

Una operación puede vincular uno o más pagos y uno o más recibos según el caso operativo: pago de varias cuotas, curso más recargo, reversa parcial o regularización manual.

Pasarelas y conciliación

Los pagos por NAVE u otra pasarela habilitada no reemplazan la conciliación bancaria. Se relacionan así:

1. El usuario inicia un pago desde Pagar deuda.
2. La pasarela crea una solicitud externa con referencia única.
3. PSICOLE registra o actualiza la operación PAY.
4. Cuando la pasarela aprueba, PSICOLE materializa pago, recibo y eventos.
5. Luego la pasarela liquida el dinero en una cuenta bancaria.
6. La conciliación cruza la liquidación de la pasarela y el extracto del banco.

La idempotencia evita cobrar o registrar dos veces: se controla por proveedor, referencia externa, operación interna, monto, fecha y clave idempotente del lote o extracto.

Reintegros, reversas y pagos por error

Las devoluciones no deben borrar el pago original. Se registra una operación compensatoria vinculada a la operación original.

La configuración de políticas se administra desde Dinero → Configuración, con motivo obligatorio y auditoría.

Contabilidad y libro diario

La trazabilidad del dinero no termina en el cobro. Cuando el circuito lo requiere, la operación debe dejar preparado o vinculado su impacto contable:

• cuenta o rubro operativo;
• fecha contable;
• asiento de libro diario o pendiente de generación;
• relación entre operación PAY, recibo, conciliación y contrapartida.

La regla práctica es que una conciliación correcta no debe romper la relación entre operación económica y libro diario.

Criterios de calidad operativa

• Todo estado visible debe estar en español amable.
• Toda fila de pago debe abrir una single canónica.
• Todo recibo debe abrir su documento o su operación asociada si todavía no existe vista documental separada.
• Toda conciliación debe mostrar si el dinero proviene de pasarela, banco, caja, débito o transferencia directa.
• Toda reversa debe conservar el vínculo con el movimiento original.
• Toda operación conciliada debe poder rastrearse hasta su salida contable o su pendiente contable.

🖥 Escritorio Módulo de cobro de cuotas y finanzas

📱 Móvil Módulo de cobro de cuotas y finanzas

Finanzas

Finanzas es la vista operativa del dinero diario: deudas, pagos, recibos, caja y conciliación. Para el circuito completo y la single de trazabilidad, ver Módulo DINERO.

Principios

• Un pago no debe quedar aislado: debe vincularse a una operación PAY.
• Un recibo se identifica por REC y es el documento autoritativo.
• Caja, transferencias y pasarelas deben conciliarse sin duplicar ingresos.
• Los estados se muestran en español amable.

Cobranza

La cobranza permite registrar pagos manuales o revisar obligaciones pendientes. Cuando se registra un cobro:

1. Se selecciona profesional y deuda.
2. Se informa canal: efectivo, transferencia, caja, débito, NAVE u otro.
3. Se valida que no exista una operación equivalente.
4. Se crea la operación de dinero.
5. Se emite recibo cuando corresponde.

Recibos

El recibo es el comprobante documental del cobro. Su número se genera en la entidad Receipt y no debe confundirse con identificadores internos de pago.

Caja

Caja controla sesiones diarias de ingreso y egreso. Cada apertura, movimiento y cierre queda vinculado al responsable. Si el movimiento genera pago, también debe crear operación trazable.

Flujo operativo de caja

1. Abrir una sesión de caja con responsable, caja física y saldo inicial.
2. Registrar ingresos o egresos indicando concepto, importe, medio y profesional cuando corresponda.
3. Imputar pagos contra deudas abiertas o dejar el movimiento como operación de caja identificada.
4. Emitir recibo cuando el movimiento documenta un cobro.
5. Cerrar la caja al final de la jornada con arqueo, diferencia y observación obligatoria si no cuadra.

Conciliación

La conciliación bancaria cruza tres capas:

1. Operaciones internas de PSICOLE.
2. Liquidaciones de pasarelas o lotes de débito.
3. Extractos bancarios reales.

Una transferencia directa que no pasó por pasarela también puede conciliarse; si corresponde a deuda, curso o trámite, se imputa desde la operación.

Reversas y reintegros

Los reintegros no borran recibos ni pagos históricos. Crean una operación compensatoria con motivo obligatorio y vínculo al movimiento original.

Reporte financiero

Los reportes financieros permiten revisar ingresos, egresos, métodos de pago, cuotas, caja y evolución mensual sin modificar datos. Sirven para control administrativo, auditoría y preparación de información contable.

Este apartado cubre EPIC-04UC-4.1 Reporte Financiero: acceso a reportes, extracción de datos consistentes y lectura cruzada con caja, pasarelas, recibos y conciliación.

Ruta operativa: /admin/financial-reports o Administración → Reportes financieros.

Flujo operativo

1. Elegir período o rango de fechas.
2. Seleccionar vista: recaudación, métodos de pago, evolución mensual, caja o balance.
3. Revisar totales y desgloses.
4. Comparar contra caja, pasarelas y conciliación cuando haya diferencias.
5. Exportar el reporte si se requiere soporte externo.

Reglas de lectura

🖥 Escritorio Panel de pagos online del colegiado

📱 Móvil Panel de pagos online del colegiado

Pagos Online y Pasarelas

Pagos Online permite que colegiados, prestadores o usuarios asistidos paguen deudas desde el portal. El checkout online operativo actual se canaliza por NAVE. PSICOLE nunca almacena datos de tarjeta.

Flujo de pago

1. El usuario ingresa a Pagar deuda.
2. Selecciona una o más cuotas, cursos, trámites u obligaciones pendientes.
3. Confirma el total.
4. PSICOLE crea una solicitud en la pasarela habilitada.
5. El usuario completa el pago en el checkout externo.
6. Al volver o al refrescar estado, PSICOLE consulta la pasarela.
7. Si el pago fue aprobado, se materializan operación, pago, recibo y eventos de auditoría.

Capturas auditadas desktop y mobile

La pantalla de pagos fue recapturada en escritorio y celular para validar selección de deuda, acciones de pago y lectura de estados sin corrimientos laterales. Estas capturas reflejan la superficie vigente para el usuario final.

NAVE y otros proveedores

La pasarela visible depende de la configuración de Dinero → Configuración. En sandbox se trabaja en modo demo o entorno inerte.

Operación y recibo

Al aprobarse un pago:

• Se crea o actualiza una operación PAY-YYYY-NNNNNN.
• Se imputan las deudas incluidas.
• Se emite recibo REC-YYYY-NNNNNN cuando corresponde.
• Se registran eventos: pago aprobado, operación creada, recibo creado y usuario responsable.

El recibo documenta el cobro; la operación explica todo el recorrido.

Pagos impersonados o asistidos

Un administrador puede asistir a un usuario en el proceso de pago cuando el modo de impersonación lo permite. La pantalla debe mostrar claramente que se está actuando como otra persona y registrar:

• Administrador actuante.
• Usuario representado.
• Operación creada.
• Resultado de la pasarela.

Recuperación de pagos

Si el usuario completa el checkout pero la vuelta al sistema falla, el operador puede recuperar el estado desde la referencia externa. El sistema debe evitar duplicados usando la clave idempotente de la operación y la referencia del proveedor.

Errores frecuentes

🖥 Escritorio Conciliación bancaria y matching de pagos

📱 Móvil Conciliación bancaria y matching de pagos

Conciliación Bancaria

Descripción

La conciliación bancaria es el proceso mediante el cual el sistema compara los movimientos registrados en el extracto bancario con los pagos registrados en PSICOLE, identificando correspondencias y detectando diferencias. Este módulo permite importar extractos en formato CSV o Excel directamente desde el banco, reduciendo la carga manual y el riesgo de errores.

El motor de matching automático analiza cada transacción del extracto y busca pagos pendientes de conciliar utilizando criterios configurables: monto exacto, referencia de comprobante, fecha y datos del titular. Las transacciones que no puedan asociarse automáticamente quedan en estado "pendiente" para resolución manual por parte del operador de finanzas.

Cada proceso de conciliación se organiza en sesiones de conciliación, que agrupan un extracto importado junto con todos los emparejamientos (automáticos y manuales) realizados sobre él. Las sesiones quedan auditadas con fecha, usuario y justificación de cada decisión.

Roles con acceso

Flujo principal

1. Importar extracto bancario

1. Ir a Finanzas → Conciliación Bancaria → Nueva Sesión.
2. Seleccionar el banco de origen en el desplegable (ej. Banco Nación, Santander, Galicia).
3. Hacer clic en Subir Archivo y seleccionar el archivo .csv o .xlsx exportado desde el homebanking.
4. El sistema valida el formato del archivo; si hay errores de estructura, se muestra el detalle de las filas con problemas.
5. Confirmar el período del extracto (fecha desde / fecha hasta) y hacer clic en Importar.
6. El sistema crea la sesión de conciliación con estado ABIERTA y lista todas las transacciones importadas.

2. Matching automático

1. Desde la sesión abierta, hacer clic en Ejecutar Matching Automático.
2. El sistema procesa cada transacción del extracto y aplica las reglas de matching configuradas (ver sección de Reglas de Negocio).
3. Al finalizar, se muestra un resumen: cantidad de transacciones emparejadas, monto total conciliado y cantidad de transacciones sin match.
4. Las transacciones emparejadas automáticamente quedan en estado CONCILIADO_AUTO y el pago asociado en PSICOLE se marca como confirmado.
5. Revisar el resumen y avanzar al matching manual para las restantes.

2.1 Corroboracion del RUN mensual de cuotas

La conciliacion no genera cuotas ni modifica el tarifario. Su funcion en el ciclo mensual es corroborar que el dinero que figura en el banco coincide con lo que PSICOLE genero y cobro.

Para cuotas mensuales, el sistema revisa:

• identidad fuerte del pagador o referencia bancaria;
• deuda abierta del periodo correspondiente;
• coincidencia entre el movimiento bancario y finalAmount de la deuda;
• pagos de varias cuotas acumuladas en un mismo movimiento;
• ajustes contables aprobados cuando el pago bancario refleja un importe anterior al aumento mensual.

Si la diferencia de monto no corresponde a una regla aprobada, el movimiento queda para revision manual. La decision debe documentar si se trata de ajuste, redondeo, pago parcial, descuento no configurado, saldo a favor o ingreso no identificado.

2.2 Corroboracion de lotes CBU / COELSA

Cuando la sesion incluye movimientos relacionados con debito automatico, el operador debe cruzar tres piezas:

Para aprobados, el importe conciliado debe coincidir con debitAmount del lote. Para rechazados, no debe crearse ingreso bancario ni recibo; el sistema conserva el intento y actualiza la deuda quitando solo el descuento por debito directo. Beneficios no CBU se mantienen.

Si el movimiento bancario agrupa varios debitos, el motor puede sugerir el lote como candidato por importe agregado. Antes de confirmarlo, revisar que la cantidad de registros aprobados y rechazados coincida con la respuesta del banco.

2.3 Auditoria cruzada SANDBOX mayo/junio 2026

Para certificar un RUN mensual de cuotas, Finanzas puede ejecutar una auditoria cruzada en SANDBOX antes de replicar reglas en produccion. La prueba de mayo/junio 2026 uso como fuentes primarias:

• detalle de presentacion de tarjetas de credito de mayo;
• detalle de presentacion de tarjetas de credito de junio;
• reportes de cobros CBU de mayo y junio;
• recibos generados por el sistema, padron, caja, profesionales y listados de prestadores como contraste.

La medicion contable principal no suma todas las fuentes como si fueran movimientos nuevos, porque algunas son vistas del mismo hecho economico. El denominador estricto es: tarjeta aceptada + CBU cobrado. Los rechazos no representan dinero cobrado y se analizan aparte.

Resultado certificado en SANDBOX:

El remanente original de 360 eventos quedo tratado al 100%: 71 se aplicaron en SANDBOX, 123 ya estaban cerrados/no-PENDING, 152 quedaron como cola manual por identidad o destino insuficiente, 6 no tenian deuda PENDING compatible y 8 fueron bloqueados por regla bancaria estricta.

Regla de aplicacion segura para CBU:

1. Identidad oficial fuerte.
2. Deuda mensual PENDING del periodo y monto compatible.
3. Una unica BankTransaction exacta por referencia, CBU, credito aceptado, importe y estado PENDING.
4. Marker de SANDBOX e idempotency key por deuda + transaccion bancaria.
5. Verificacion posterior de deuda PAID, operacion aprobada, pago, recibo, asiento, cuenta corriente y links documentales.

Si falta cualquiera de esas condiciones, el movimiento queda en cola manual. No se debe crear un pago por similitud de nombre, monto aproximado o padron historico sin fuente de desempate.

2.4 RUN mensual auditable

Para conciliaciones mensuales de cuotas, el operador puede organizar la evidencia en un RUN mensual auditable. Este registro agrupa las fuentes del periodo y permite medir la tasa de conciliacion sin aplicar pagos por inferencia debil.

El panel esta dentro del flujo existente: Dinero -> Operaciones -> Conciliacion -> RUN mensual. No es una ruta separada ni reemplaza las sesiones de conciliacion; funciona como tablero de cierre por periodo.

El RUN mensual se usa para:

1. Declarar fuentes primarias y auxiliares del periodo.
2. Registrar hash, cantidad y monto por archivo o fuente.
3. Ejecutar una simulacion PREVIEW sobre fuentes registradas ya procesadas, incluyendo auxiliares como extractos Galicia.
4. Clasificar eventos en AUTO_APPLY_STRICT, ALREADY_CLOSED, MANUAL_REVIEW, BLOCKED o EXCLUDED.
5. Medir tasa de exito por eventos y por monto, separando evidencia auxiliar del denominador.
6. Dejar una cola manual con motivo y proximo paso.

En esta capa, AUTO_APPLY_STRICT significa que el evento cumple condiciones para ser aplicado por el motor seguro; no habilita por si solo una aplicacion si falta idempotencia, deuda abierta compatible, transaccion bancaria unica o consentimiento operativo.

Uso del panel:

1. Seleccionar el periodo mensual.
2. Crear un RUN en modo PREVIEW.
3. Registrar los extractos procesados del periodo como fuentes del RUN.
4. Usar Simular PREVIEW para generar decisiones auditadas sin aplicar pagos.
5. Recalcular metricas para ver fuentes, eventos tratados, monto aplicado/cerrado, cola manual y bloqueos.
6. Usar el detalle de fuentes y decisiones como evidencia del cierre mensual o como cola de investigacion.

El boton Registrar extractos solo vincula archivos ya cargados y procesados en conciliacion bancaria. No crea pagos, no modifica deudas, no cambia estados profesionales y no envia correos.

El boton Simular PREVIEW clasifica las fuentes registradas. Si una transaccion ya esta vinculada a una operacion, queda como ALREADY_CLOSED; si existe una PaymentOperation aprobada de un re-run previo con evidencia unica por periodo, archivo, referencia y monto, tambien queda ALREADY_CLOSED sin crear pagos nuevos; si existe un match estricto con deuda abierta del periodo y monto compatible, queda como AUTO_APPLY_STRICT; si requiere decision humana, queda como MANUAL_REVIEW; si no tiene destino suficiente, queda como BLOCKED; y si la fuente informa rechazo o exclusion, queda como EXCLUDED.

Antes de intentar un match de deuda, el RUN asigna una ruta operativa a cada movimiento. Esta clasificacion evita que el extracto bancario general se trate como un unico lote de cuotas.

Las resoluciones de re-run se incorporan al RUN mensual como evidencia de cierre, no como aplicacion nueva. El sistema exige que la operacion aprobada tenga pago aprobado, deuda del periodo y metadata o link documental de origen. Si aparecen varias operaciones compatibles, el evento sigue bloqueado para desempate humano.

Como leer el resultado despues de Simular PREVIEW:

Ejemplo SANDBOX junio 2026: un RUN con 2 fuentes registradas y 3.605 eventos tratados muestra 2.937 cerrados/aplicables, 74 bloqueados, 0 en revision manual y 594 excluidos. La tasa de eventos 97,54% se calcula sobre el denominador conciliable: 3.605 eventos menos 594 excluidos = 3.011 elegibles; 2.937 cerrados sobre 3.011 elegibles. El monto pendiente auditable es $898.788,00 y corresponde a los bloqueados que todavia no tienen destino unico.

Para revisar los bloqueados:

1. Entrar a Dinero -> Operaciones -> Conciliacion -> RUN mensual.
2. Seleccionar el periodo, por ejemplo 2026-06.
3. Elegir el RUN del historial, por ejemplo MRC-2026-06-A0C2CA4F.
4. En Decisiones auditadas, cambiar el filtro a Bloqueadas.
5. Usar Exportar CSV para descargar el listado completo del filtro activo, no solo los primeros eventos visibles. El archivo incluye operationalRoute, operationalBucket y operationalDisposition para depurar por naturaleza del movimiento.
6. Revisar cada evento por fuente, monto, referencia y motivo. Si el motivo dice Sin operacion, pago o match compatible, falta un destino unico en PSICOLE. Si dice Multiples operaciones aprobadas compatibles, requiere desempate humano antes de cerrar.
7. En bloqueados con movimiento bancario, usar Abrir matching para ir a conciliacion rapida con esa transaccion preseleccionada.

Para depurar rechazados, cambiar el filtro a Excluidas y descargar el CSV. Esos eventos conservan estado, motivo, referencia, titular y CBU de la fuente, pero no se abren para aplicar match porque el banco o la tarjeta los informo como rechazados.

Los ajustes mensuales aprobados para diferencias de cuota se administran desde Dinero -> Configuracion -> Ajustes conciliacion. El motor de candidatos lee MONTHLY_FEE_RECONCILIATION_ADJUSTMENTS, de modo que un nuevo periodo no requiere cambiar codigo para reconocer una diferencia aprobada.

2.5 Reglas operativas persistentes para reruns

Los reruns mensuales pueden usar reglas persistentes para explicar por qué una deuda tiene descuento o por qué un movimiento bancario debe salir del flujo de cuota mensual. Esta capa no reemplaza la conciliacion; prepara destinos auditables para que el motor no dependa de heuristicas sueltas.

El modelo operativo separa cuatro piezas:

Uso recomendado:

1. Importar las fuentes nuevas siempre primero en SANDBOX.
2. Resolver identidad con DNI, matricula, CUIT o match curado. Si la fuente solo trae nombre y apellido, no aplicar automaticamente cuando hay ambiguedad.
3. Guardar la regla con vigencia real. Una regla vencida puede verse en listados historicos, pero no debe descontar mayo/junio ni generar snapshots del periodo.
4. Recalcular o previsualizar deudas para que el descuento quede como snapshot. El monto final de la deuda es lo que luego usan CBU, tarjeta, caja y conciliacion.
5. Ejecutar rerun PREVIEW y separar resultados automáticos de cola manual.
6. Revisar outliers, especialmente importes de conceptos externos con formato regional o valores muy superiores a la mediana del archivo.

Controles mínimos antes de automatizar:

Indicadores para monitoreo mensual:

• tasa de éxito y tasa tratada del rerun;
• cantidad y monto en NO_DESTINATION_PREVIEW;
• eventos en revisión por monto incompatible;
• reglas activas vencidas o sin deuda impactada;
• conceptos externos esperados sin profesional local;
• cuotas de plan pagadas por planilla sin operación;
• snapshots por tipo de beneficio y periodo;
• diferencia entre planes cargados, cuotas pendientes, cuotas pagadas y cuotas vinculadas a PAY.

En la revisión SANDBOX del 30/6/2026 para mayo/junio quedaron incorporados 86 planes, reglas jubilatorias, reglas de primera matrícula, conceptos del Curso de Salud Colectiva y filtros operativos. El rerun PREVIEW confirmó 8015 eventos, 6600 conciliables, 6002 success, 403 manuales y 195 sin destino. Las reglas nuevas agregaron destinos automáticos acotados: 1 concepto externo y 6 cuotas de plan, todos en mayo. El resultado valida el enfoque, pero no autoriza asignar los 195 restantes por nombre/monto débil.

3. Matching manual

1. En la sesión, filtrar por estado PENDIENTE para ver las transacciones sin match automático.
2. Seleccionar una transacción del extracto; el panel derecho mostrará los pagos candidatos sugeridos por similitud.
3. Revisar los candidatos y hacer clic en Emparejar junto al pago correcto.
4. Si no existe un pago en el sistema para esa transacción, seleccionar una de las acciones alternativas:
5. Marcar como No Identificado: la transacción queda registrada pero sin pago asociado.
6. Crear Pago Manual: genera un nuevo pago en el sistema vinculado a la transacción.
7. Ignorar / Excluir: excluye la transacción de la conciliación (ej. comisiones bancarias).
8. En todos los casos se requiere ingresar una justificación en el campo de texto obligatorio.
9. Repetir hasta resolver todas las transacciones pendientes.

4. Cerrar sesión de conciliación

1. Una vez resueltas todas las transacciones (o decidido ignorar las irresolubles), hacer clic en Cerrar Sesión.
2. El sistema muestra el resumen final: total importado, total conciliado, total no identificado, diferencia.
3. Si la diferencia es cero o está dentro del umbral configurado, confirmar el cierre.
4. La sesión pasa a estado CERRADA y queda disponible en el historial con todos sus datos de auditoría.
5. Se genera automáticamente el informe de cierre descargable en PDF.

5. Consultar auditoría

1. Ir a Finanzas → Conciliación Bancaria → Historial de Sesiones.
2. Seleccionar la sesión a auditar y hacer clic en Ver Detalle.
3. La vista de auditoría muestra: usuario que realizó cada acción, timestamp, estado anterior y nuevo, y justificación ingresada.
4. Usar los filtros por usuario, fecha o tipo de acción para acotar resultados.
5. Exportar el log de auditoría en CSV si se requiere para revisión externa.

Campos y validaciones

Reglas de negocio

Errores frecuentes

Preguntas frecuentes

¿Qué formatos de archivo se soportan? Se soportan archivos .csv (separado por coma o punto y coma) y .xlsx. El sistema reconoce automáticamente el formato según el banco seleccionado. Si el banco no está en la lista, contactar al administrador para configurar un nuevo perfil de importación.

¿Qué pasa si el mismo pago aparece en dos extractos? El sistema detecta la transacción como duplicada durante la importación y la bloquea. Solo puede existir un emparejamiento por pago en PSICOLE. Si se requiere corregir un emparejamiento previo, el ADMIN debe revertirlo desde la sesión original.

¿Puedo conciliar pagos de pasarelas como NAVE? Sí. El pago aprobado por la pasarela crea la operación y el recibo; luego la liquidación de la pasarela debe cuadrar contra el extracto bancario. El sistema evita duplicados con referencias externas, operación PAY, monto, fecha y claves idempotentes.

¿Se puede reabrir una sesión cerrada? Solo el ADMIN puede reabrir una sesión cerrada, siempre que no existan sesiones posteriores para el mismo banco que dependan de ella. La reapertura queda auditada.

¿Qué significa "No Identificado"? Una transacción marcada como "No Identificado" es un ingreso o egreso en el extracto que no tiene correspondencia con ningún pago en PSICOLE. Debe ser investigada manualmente con el banco para determinar su origen.

🖥 Escritorio Consultorio, pacientes y agenda del profesional

📱 Móvil Consultorio, pacientes y agenda del profesional

Consultorio

Consultorio es la agenda operativa del psicólogo dentro de PSICOLE. Puede usarlo un psicólogo colegiado aunque no sea prestador, y también un prestador cuando trabaja con órdenes de obras sociales.

Acceso

Menú: Órdenes → Consultorio
Ruta: /consultorio
Roles: COLEGIADO, PRESTADOR.

Activación

El módulo puede estar activo o desactivado por profesional.

La activación no obliga a ser prestador. Un colegiado puede usarlo de forma autónoma para agenda, pacientes y cobros particulares. Si además es prestador, puede generar órdenes PSICOLE desde una sesión.

Flujo principal

1. Crear o elegir paciente.
2. Agendar turno con fecha, hora, modalidad y notas internas.
3. Configurar recordatorios y, si corresponde, exportar agenda .ics.
4. Completar sesión.
5. Generar orden de obra social o cobro particular.

Pacientes

La libreta de pacientes permite reutilizar datos en turnos y órdenes:

• Nombre y documento.
• Contacto.
• Obra social, si existe.
• Tratamientos o sesiones previas.
• Historial de órdenes y cobros asociados.

Al crear una nueva orden, el sistema debe sugerir pacientes y tratamientos ya utilizados para reducir carga manual.

Prestadores y obras sociales

Cuando el profesional es prestador, Consultorio puede terminar una sesión como orden PSICOLE. En ese caso se aplican las reglas de prestadores:

• Obra social habilitada.
• Datos de afiliado.
• Diagnóstico y nomenclador cuando corresponda.
• Adjuntos y autorización.
• Rendición posterior ante la obra social.

Si el profesional no trabaja con obras sociales cargadas en PSICOLE, puede usar Consultorio de forma autónoma con pacientes, turnos, cobros particulares y recordatorios.

Cobros particulares

Los cobros particulares forman parte del ciclo de dinero. Cuando se registran, deben crear operación trazable y, si corresponde, recibo.

El cobro no debe mezclarse con una orden de obra social salvo que el flujo indique expresamente copago, diferencia o cargo complementario.

Buenas prácticas

• Mantener un paciente único por persona para evitar duplicados.
• Registrar el turno antes de la sesión y completarlo al finalizar.
• Usar notas internas solo para gestión profesional; no incluir datos innecesarios en comprobantes.
• Revisar la agenda semanalmente para detectar turnos sin cerrar.

Cursos y Capacitación

Descripción

El módulo de Cursos y Capacitación gestiona la oferta formativa del Colegio: talleres, jornadas, seminarios y cursos de actualización profesional. Soporta tres modalidades —presencial, virtual e híbrida— con configuración independiente de cupos, aula/link de videoconferencia y cronograma de encuentros.

Las inscripciones incluyen un sistema de lista de espera automática: cuando se completan los cupos, los nuevos interesados quedan en lista y son promovidos en orden cuando se libera un lugar o se amplía el cupo. El módulo también gestiona prerequisitos (cursos anteriores o condición de matrícula activa), materiales descargables y la emisión de certificados digitales con código QR verificable públicamente.

El pago puede ser en un solo desembolso o en cuotas, con vencimientos y recargos configurables por curso. Los certificados se emiten automáticamente cuando el colegiado completa la asistencia mínima requerida y tiene el pago al día.

Roles con acceso

Flujo principal

1. Crear un nuevo curso

1. Ir a Cursos → Gestión de Cursos (/admin/courses) y usar Nuevo Curso.
2. Completar los datos generales: nombre, descripción, modalidad (presencial / virtual / híbrido), fechas de inicio y fin, cupo máximo y cupo mínimo (por debajo del cual el curso puede cancelarse).
3. En la sección Encuentros, agregar cada sesión con fecha, hora, duración y aula o link de videoconferencia.
4. En Prerequisitos, seleccionar los cursos previos requeridos y/o marcar si se requiere matrícula activa.
5. En Aranceles, configurar si el pago es único o en cuotas, ingresando monto, cantidad de cuotas y fecha de cada vencimiento.
6. En Materiales, subir los archivos que serán accesibles a los inscriptos (PDF, video, enlace externo).
7. Hacer clic en Guardar como Borrador o Publicar para que quede visible en el catálogo del colegiado.

2. Gestionar inscripciones

1. Ir a Cursos → Gestión de Cursos (/admin/courses) y abrir el curso correspondiente.
2. La lista muestra todos los inscriptos con estado (Confirmado, Pendiente de Pago, Lista de Espera, Baja).
3. Para inscribir manualmente a un colegiado: clic en Agregar Inscripto, buscar por apellido o número de matrícula, seleccionar y confirmar.
4. El sistema verifica automáticamente los prerequisitos y rechaza la inscripción si no se cumplen, indicando el motivo.
5. Si el cupo está completo, el sistema ofrece agregar al interesado a la lista de espera.
6. Para dar de baja a un inscripto: seleccionarlo, clic en Dar de Baja, indicar el motivo y si aplica reembolso.

3. Administrar lista de espera

1. En la pestaña Lista de Espera del curso, se visualizan los interesados en orden de anotación (posición 1, 2, 3…).
2. Cuando se libera un cupo (baja de inscripto o ampliación de cupo), el sistema notifica automáticamente por email al primero en la lista.
3. El interesado tiene un plazo configurable (por defecto 48 horas) para confirmar su inscripción y abonar.
4. Si no confirma en el plazo, pasa al final de la lista y se notifica al siguiente.
5. El operador puede mover manualmente a un interesado dentro de la lista ingresando justificación.

4. Registrar asistencia

1. En Cursos → Gestión de Cursos (/admin/courses), abrir el curso y seleccionar Asistencia para el encuentro del día.
2. La lista muestra todos los inscriptos confirmados con checkbox de presente/ausente.
3. Marcar la asistencia y hacer clic en Guardar Asistencia.
4. El sistema calcula automáticamente el porcentaje de asistencia acumulado de cada participante.
5. Al alcanzar la asistencia mínima configurada (ej. 75%), el participante queda habilitado para recibir su certificado.

5. Emitir certificados digitales con QR

1. Ir a Cursos → Gestión de Cursos (/admin/courses), abrir el curso y seleccionar Certificados.
2. El sistema lista los participantes que cumplen los requisitos de asistencia y pago.
3. Hacer clic en Emitir Certificados para procesarlos en lote, o en Emitir en la fila de un participante específico.
4. El certificado se genera en PDF con los datos del colegiado, nombre del curso, fecha, horas de capacitación y un código QR único.
5. El QR apunta a una URL pública de verificación donde cualquier persona puede confirmar la autenticidad del certificado.
6. El certificado queda disponible en el portal de autogestión del colegiado para su descarga.

6. Cargar y gestionar materiales

1. En Cursos → Gestión de Cursos (/admin/courses), abrir el curso y seleccionar Materiales.
2. Elegir el tipo: archivo subido (PDF, DOCX, PPTX, video) o enlace externo.
3. Ingresar el nombre del material y, opcionalmente, el número de encuentro al que corresponde.
4. Configurar la visibilidad: Libre (visible antes de inscribirse) o Solo Inscriptos.
5. Los inscriptos confirmados con pago al día pueden descargar los materiales desde su portal de autogestión.

7. Desinscripción y reembolso

Desde Mis Cursos, el usuario puede abrir el detalle de una inscripción y solicitar desinscripción cuando el curso y la política vigente lo permiten.

El sistema distingue:

La política de reembolso se configura desde Dinero → Configuración. Toda devolución debe quedar vinculada a la operación de pago original para conservar trazabilidad.

Campos y validaciones

Reglas de negocio

Errores frecuentes

Preguntas frecuentes

¿Puede un colegiado inscribirse en varios cursos simultáneamente? Sí, no hay límite de inscripciones simultáneas. Sin embargo, si dos cursos tienen encuentros en el mismo horario, el sistema muestra una advertencia (no bloquea la inscripción).

¿Cómo se manejan las cuotas vencidas? Las cuotas vencidas generan una deuda en la cuenta corriente del colegiado. Después de X días de mora (configurable), se suspende el acceso a los materiales del curso. El certificado no se emite mientras haya cuotas impagas.

¿Se puede inscribir a alguien en lista de espera directamente? Sí, el operador puede agregar manualmente a una persona en lista de espera incluso cuando hay cupos disponibles (ej. si el interesado quiere esperar por razones económicas). En ese caso queda al final de la lista con estado EN_ESPERA_VOLUNTARIA.

¿El QR del certificado funciona sin conexión a internet? No. El QR apunta a una URL del sistema PSICOLE. Para verificar la autenticidad del certificado se requiere conexión. El PDF del certificado puede descargarse y compartirse offline, pero la verificación del QR es siempre online.

¿Cómo se comunica a los inscriptos cuando se cancela un curso? Al confirmar la cancelación, el sistema envía automáticamente un correo a todos los inscriptos (incluyendo lista de espera) y procesa los reembolsos configurados. No requiere acción manual adicional del operador.

🖥 Escritorio Portal de prestadores y órdenes de obra social

📱 Móvil Portal de prestadores y órdenes de obra social

Prestadores y Órdenes de Servicio

Descripción

El módulo de Prestadores gestiona la relación entre el Colegio y los psicólogos matriculados que atienden pacientes de obras sociales. Las obras sociales derivan pacientes a los profesionales; cada atención genera una orden de prestación que el prestador carga en el sistema, presenta mensualmente al Colegio y cobra a través del proceso de liquidación.

El flujo completo cubre: carga de órdenes → validación por el operador → rendición mensual del prestador → aprobación y liquidación por el Colegio → acreditación al prestador.

Roles con acceso

Módulos del portal del prestador

Consultorio — Agenda de turnos

El prestador gestiona su agenda de sesiones desde Mis Órdenes → Consultorio.

Vista semanal con turnos agrupados por día y ordenados por hora. Cada card muestra: - Hora y duración de la sesión. - Nombre del paciente. - Chip de obra social (si aplica). - Estado: Programado (azul) · Completado (verde) · Cancelado (gris) · Ausente (naranja).

Crear turno:

1. Hacé clic en + Nuevo turno.
2. Seleccioná el paciente con autocomplete desde la libreta (o ingresá el nombre libremente).
3. Completá fecha y hora, duración (default 50 min), modalidad (Presencial / Virtual) y notas.
4. Si el paciente tiene obras sociales en la libreta, el campo OOSS se muestra automáticamente.
5. Guardá.

Completar turno:

Al marcar un turno como Completado, si tenía obra social asociada el sistema propone crear la orden de prestación con los datos pre-llenados (paciente, DNI, afiliado, OOSS, fecha). El prestador confirma o ajusta los datos y guarda la orden con un clic.

Exportar agenda:

El botón Exportar .ics descarga un archivo RFC 5545 importable en Google Calendar, Apple Calendar o cualquier cliente de calendario compatible. Cada turno se exporta como evento con título, horario y descripción.

Libreta de pacientes

Repositorio personal del prestador para centralizar los datos de sus pacientes habituales y agilizar la carga de órdenes.

Funciones:

Importar desde órdenes:

Cuando el prestador tiene pocos pacientes registrados (menos de 5) y ya tiene órdenes históricas, aparece un banner de importación:

1. Hacé clic en Ver preview — el sistema analiza todas las órdenes del prestador y muestra los pacientes únicos que se crearían, con sus obras sociales detectadas.
2. Si el resultado es correcto, hacé clic en Confirmar importación.
3. El sistema reporta: X creados · Y actualizados · Z sin cambios.

Integración con órdenes:

Al crear o editar una orden, el campo Paciente tiene autocomplete desde la libreta. Al seleccionar un paciente: - Se auto-completan DNI, obra social y número de afiliado. - Si el paciente tiene múltiples obras sociales, aparece un dropdown para elegir cuál usar en la orden. - Los campos diagnóstico y tratamiento sugieren valores históricos del prestador.

Órdenes de prestación

1. Ir a Mis Órdenes → + Nueva Orden.
2. Campo Paciente con autocomplete desde la libreta.
3. Completar datos clínicos: fecha, sesiones, diagnóstico, tratamiento, adjunto (JPG/PNG/PDF).
4. Guardar.

Estados de una orden:

Rendición mensual

Al cerrar el mes, el prestador presenta sus órdenes validadas al Colegio.

Banner de alerta:

Cuando hay órdenes con estado Validada sin rendición asignada, aparece un banner verde en Mis Órdenes:

"Tenés X órdenes validadas listas para rendir este período."

Generar rendición:

1. Hacer clic en Generar rendición.
2. Revisar el resumen por obra social: cantidad de órdenes y subtotal por cada una.
3. Adjuntar la factura en PDF e ingresar el monto.
4. Hacer clic en Enviar rendición al Colegio.

Seguimiento:

En Liquidaciones se listan todas las rendiciones con: período, estado (chip), fecha de envío, monto y link a la factura adjunta.

Estados de una rendición:

Flujo completo: del turno a la acreditación

PRESTADOR                         SISTEMA                        OPERADOR_FINANZAS
    │                                │                                   │
    │── Agenda turno ──────────────► │                                   │
    │── Completa turno ────────────► │ propone crear orden               │
    │── Confirma orden ────────────► │ crea ProviderOrder (PENDING)      │
    │                                │                                   │
    │                                │ ◄── valida órdenes del período ── │
    │                                │ ──► ordenes → VALIDATED ─────────►│
    │                                │                                   │
    │── banner: "X órdenes listas" ──│                                   │
    │── genera rendición + factura ─►│ crea ProviderSubmission (PENDING) │
    │                                │                                   │
    │                                │ ◄── revisa rendición ─────────── │
    │                                │ ──► APPROVED ───────────────────►│
    │                                │                                   │
    │ ◄── acreditación bancaria ────│ ──── genera liquidación ──────────►│
    │── descarga comprobante ───────►│                                   │

Flujo de revisión del operador (Rendiciones)

El OPERADOR_FINANZAS gestiona las rendiciones desde Operador → Prestadores → Rendiciones.

1. Tabla de rendiciones pendientes con: prestador, período, cantidad de órdenes, monto, fecha de envío y link a la factura.
2. Acciones por rendición:
3. Aprobar — cambia estado a APROBADA y dispara el proceso de liquidación.
4. Observar — abre un modal para ingresar una nota; el prestador ve la observación en su portal.
5. Rechazar — requiere motivo; el prestador debe corregir y reenviar.

Panel del operador auditado

El panel operativo de prestadores fue recapturado en escritorio y celular para validar que pestañas, filtros, KPIs, tablas y acciones no se superpongan en resoluciones bajas. En móvil, las pestañas se desplazan horizontalmente y el contenido operativo conserva lectura vertical.

Lotes mensuales y facturacion manual ARCA OOSS

El circuito Colegio → Obra Social se revisa desde Prestadores → Lotes mensuales. Cada lote agrupa una Obra Social y un período, y permite controlar las órdenes antes de preparar la factura real en ARCA.

Control previo de ordenes

Al abrir un lote mensual, el operador puede generar el PDF del lote para revisar:

• Obra Social y período.
• Profesionales incluidos, ordenados alfabéticamente.
• Matrícula del prestador.
• Paciente, DNI y número de afiliado.
• Número de orden.
• Fecha, sesiones, valor unitario e importe.
• Subtotal por prestador y total del lote.

Este PDF sirve para auditoría interna del lote. No es una factura.

Modelo interno para carga manual en ARCA

La acción Modelo factura ARCA OOSS genera un PDF de apoyo para que el operador copie los datos y complete la factura real manualmente en el sitio de ARCA.

El modelo prepara:

• Emisor: Colegio.
• Receptor: Obra Social.
• CUIT, domicilio fiscal y condición IVA del receptor, cuando estén cargados.
• Período facturado.
• Detalle por profesional y orden.
• Cantidad, precio unitario, importe y total.
• Campos pendientes de completar en ARCA, como punto de venta, número de comprobante, CAE y vencimiento del CAE.

Factura del prestador al Colegio

La factura que el prestador entrega al Colegio pertenece a otro circuito. Se adjunta en la rendición o liquidación del prestador y no se genera desde los lotes de Obra Social.

No deben mezclarse:

• Colegio → Obra Social: modelo interno para cargar manualmente la factura del Colegio en ARCA.
• Prestador → Colegio: factura real del prestador, adjuntada sobre su rendición o liquidación.

Importación masiva de pacientes (Admin)

El Administrador puede importar los pacientes de cualquier prestador desde el historial completo de órdenes:

• Endpoint: POST /api/v1/operator/provider-patients/bulk-import
• Body: { "professionalId": "...", "importAllHistory": true }
• Resultado: { created, updated, skipped, total }
• Para lotes grandes (más de 200 órdenes), el proceso corre en background y registra el resultado en el log de auditoría.

Directorio público del prestador

El prestador controla su presencia en el directorio público desde Mi Perfil Público:

• Activar/desactivar el perfil público.
• Completar bio, especialidades, obras sociales aceptadas, modalidad de atención, horarios y datos de contacto públicos.
• Subir foto de perfil.

Los cambios aplican de inmediato (respetando el TTL de caché del directorio: 2 minutos).

API pública del directorio

Ver documentación completa en Directorio Público.

Reglas de negocio

Errores frecuentes

Preguntas frecuentes

¿Puede un prestador tener pacientes con múltiples obras sociales? Sí. La libreta soporta múltiples OOSS por paciente, cada una con su número de afiliado y plan. Al crear una orden, el prestador elige cuál OOSS usar.

¿Qué pasa si el turno no tiene paciente de la libreta? El turno puede crearse con nombre libre (sin vincularlo a la libreta). Al completarlo, el sistema igualmente permite crear la orden aunque el paciente no esté registrado.

¿Cómo funciona la notificación al paciente? Si el paciente tiene email registrado en la libreta y el prestador activó la opción "Notificar al paciente" al crear el turno, el sistema envía un email automático de confirmación con fecha, hora y modalidad de la sesión.

¿Puede el prestador ver órdenes observadas? Sí. Las órdenes observadas aparecen con el motivo visible en el portal del prestador, para que pueda informar a su obra social la corrección necesaria.

🖥 Escritorio Panel de liquidaciones y comisiones a prestadores

📱 Móvil Panel de liquidaciones y comisiones a prestadores

Liquidaciones y Comisiones

Descripción

El módulo de Liquidaciones y Comisiones cubre el ciclo completo de distribución de fondos entre el Colegio y los psicólogos que operan como prestadores de obras sociales. Una vez que el operador aprueba un lote mensual de órdenes de servicio, el sistema calcula automáticamente la comisión del Colegio para cada tipo de prestación y genera los documentos de liquidación individuales.

Las comisiones son totalmente configurables: pueden definirse como porcentaje o monto fijo, diferenciadas por obra social, por tipo de prestación y con vigencias temporales (ej. una tarifa que rige solo desde el 1 de enero). Esto permite reflejar los acuerdos comerciales vigentes sin necesidad de desarrollo adicional.

La etapa final es la generación de lotes de pago: el sistema agrupa las liquidaciones aprobadas, genera la orden de transferencia bancaria consolidada y registra cada pago efectuado para su posterior conciliación. El historial de liquidaciones y los comprobantes están disponibles tanto para el operador como para el prestador desde su portal de autogestión.

Roles con acceso

Flujo principal

1. Configurar comisiones

1. Ir a Administración → Liquidaciones → Configuración de Comisiones.
2. Seleccionar la obra social para la cual se define la comisión.
3. Hacer clic en Nueva Regla de Comisión.
4. Configurar los parámetros:
5. Tipo de aplicación: porcentaje sobre el monto de la orden o monto fijo por orden.
6. Tipo de prestación: aplicar a todas las prestaciones o a un tipo específico (consulta, evaluación, informe, etc.).
7. Vigencia desde: fecha a partir de la cual aplica esta regla.
8. Vigencia hasta: opcional; si no se especifica, la regla rige indefinidamente.
9. Guardar. El sistema muestra el historial de reglas con sus vigencias para auditoría.
10. Para una obra social con múltiples reglas, el sistema aplica siempre la regla más específica vigente al momento del cierre del lote.

2. Revisión automática de liquidaciones generadas

1. Al aprobar un lote mensual desde el módulo de Prestadores, el sistema genera automáticamente una liquidación por cada prestador del lote.
2. Ir a Liquidaciones → Pendientes de Revisión.
3. Cada liquidación muestra: prestador, obra social, período, total de órdenes, monto bruto, comisión aplicada, monto neto a transferir.
4. El operador puede expandir el detalle para ver el cálculo orden por orden y verificar que la comisión se aplicó correctamente.
5. Si el cálculo es correcto, cambiar el estado a APROBADA. Si hay discrepancias, cambiar a EN_REVISION y agregar un comentario.

Facturas de prestadores y liquidaciones

La factura que emite el prestador al Colegio se gestiona dentro de su rendición o liquidación. No se genera desde el modelo de factura de Obra Social.

El flujo correcto es:

1. Validar las órdenes del período.
2. Generar o asociar la liquidación del prestador.
3. Cargar la factura real del prestador como adjunto de esa liquidación.
4. Revisar que el monto facturado coincida con la liquidación.
5. Aprobar o observar la liquidación.

Si una orden figura pagada pero todavía no aparece una liquidación asociada, debe regularizarse desde el circuito de liquidaciones antes de cargar la factura. El sistema no debe permitir cargar una factura del prestador sobre una orden suelta sin liquidación formal.

3. Generar lote de pago

1. Ir a Liquidaciones → Lotes de Pago → Nuevo Lote.
2. Seleccionar el período y las liquidaciones aprobadas que se incluirán en el lote (se puede filtrar por obra social, período o prestador).
3. El sistema muestra el resumen del lote: cantidad de liquidaciones, monto total a transferir, detalle por prestador con CBU/CVU destino.
4. Revisar y hacer clic en Generar Lote.
5. El lote queda en estado GENERADO. Descargar el archivo de transferencias bancarias en el formato requerido por el banco (SEPA, TXT Bancario, etc.).
6. Procesar la transferencia desde el homebanking. Una vez acreditada, regresar al lote y hacer clic en Marcar como Pagado, adjuntando el comprobante bancario.
7. El lote pasa a estado PAGADO y cada liquidación incluida queda en estado LIQUIDADA.

4. Conciliación mensual de liquidaciones

1. Ir a Liquidaciones → Conciliación Mensual.
2. Seleccionar el mes a conciliar.
3. El sistema cruza las liquidaciones pagadas contra los débitos registrados en la cuenta bancaria del Colegio (importados desde el módulo de Conciliación Bancaria).
4. Las transferencias que coincidan quedan marcadas como CONCILIADA. Las que no coincidan quedan como PENDIENTE_CONCILIACION.
5. Resolver manualmente las pendientes, adjuntando evidencia del pago si es necesario.
6. Al cerrar la conciliación mensual, se genera el informe de cierre con los totales por obra social.

5. Consulta del historial de liquidaciones

1. En Liquidaciones → Historial, filtrar por período, prestador, obra social o estado.
2. Seleccionar una liquidación para ver su detalle completo: cada orden incluida con código de prestación, monto, comisión aplicada y monto neto.
3. Descargar el comprobante de liquidación en PDF (disponible también para el prestador en su portal).
4. El historial es permanente e inmutable: las liquidaciones cerradas no pueden editarse, solo anularse con nota de crédito si corresponde.

Campos y validaciones

Reglas de negocio

Errores frecuentes

Preguntas frecuentes

¿Se puede tener comisiones diferentes para la misma obra social según el tipo de prestación? Sí. Se pueden configurar tantas reglas como tipos de prestación existan. Por ejemplo: 10% para consultas, 8% para evaluaciones y $500 fijo por informes periciales. El sistema aplica la regla más específica vigente.

¿Cómo se maneja un error en el monto de una liquidación ya aprobada? No se puede editar una liquidación aprobada. El procedimiento correcto es anular la liquidación (genera un registro de anulación en el historial) y generar una nueva liquidación corregida. Si el lote ya fue pagado, la corrección se realiza mediante nota de crédito/débito en el próximo período.

¿El prestador recibe algún aviso cuando se genera su liquidación? Sí. Al aprobarse el lote mensual que incluye sus órdenes, el sistema envía automáticamente un email al prestador con el resumen de su liquidación y un link para descargar el comprobante desde su portal.

¿Cómo afecta el cambio de CUIT de una obra social a las liquidaciones históricas? El cambio de CUIT no modifica liquidaciones pasadas. Las liquidaciones históricas conservan el CUIT que tenía la obra social al momento del cierre del lote. El nuevo CUIT aplica solo para liquidaciones futuras.

¿Se puede liquidar a un prestador en cuotas? No. Cada liquidación mensual se paga en una única transferencia. Las cuotas no aplican al mecanismo de liquidación a prestadores, que está diseñado para pagos únicos mensuales.

🖥 Escritorio Portal de autogestión: cuenta corriente y credencial

📱 Móvil Portal de autogestión: cuenta corriente y credencial

Autogestión del Profesional

Descripción

El portal de Autogestión es la interfaz propia del psicólogo matriculado para interactuar con el Colegio sin intermediación administrativa. Disponible las 24 horas desde cualquier dispositivo, permite consultar la cuenta corriente, pagar deudas por una pasarela habilitada, descargar recibos y mantener datos personales actualizados.

El módulo está diseñado para reducir la carga operativa de las ventanillas físicas y agilizar trámites que históricamente requerían turno presencial. Los documentos generados (recibos, certificados, credencial digital) tienen validez oficial y están firmados digitalmente por el sistema.

Las solicitudes de modificación de datos (cambio de domicilio, teléfono, CUIT, especialidad declarada, etc.) no se aplican de forma inmediata sino que generan un flujo de aprobación interno: un operador de matrículas revisa los cambios y los aprueba o rechaza con un comentario. Esto garantiza la integridad del padrón de matriculados.

Roles con acceso

Flujo principal

1. Ver estado de cuenta y deudas

1. Al iniciar sesión, el panel principal muestra un resumen de la cuenta corriente: saldo deudor, próximo vencimiento y últimos movimientos.
2. Ir a Mi Cuenta → Estado de Cuenta para ver el detalle completo.
3. La vista lista todas las cuotas y conceptos adeudados con fecha de vencimiento, monto original, recargos por mora acumulados y total a pagar.
4. Usar los filtros por período, tipo de cuota o estado (vigente, vencida, pagada) para acotar la consulta.
5. Las cuotas próximas a vencer (dentro de los 7 días configurables) se destacan con una alerta visual.

2. Pagar online por pasarela habilitada

1. Desde el estado de cuenta, marcar las cuotas o conceptos a pagar con el checkbox correspondiente.
2. Hacer clic en Pagar Seleccionados. El sistema muestra el resumen del pago con el total que se procesará.
3. Confirmar y continuar hacia la pasarela habilitada, por ejemplo NAVE.
4. Completar los datos de pago en la interfaz externa del proveedor. PSICOLE no almacena datos de tarjeta.
5. Al recibir o consultar la confirmación aprobada, el sistema registra la operación PAY, imputa la deuda y genera el recibo REC.
6. El colegiado es redirigido al portal de PSICOLE con la confirmación del pago y el enlace para descargar el recibo.

3. Descargar recibos

1. Ir a Mi Cuenta → Mis Recibos.
2. Se lista el historial de todos los pagos realizados, con fecha, concepto, monto y número de recibo.
3. Hacer clic en Descargar en el recibo deseado para obtener el PDF oficial con membrete del Colegio y firma digital del sistema.
4. El recibo incluye un código de verificación que permite confirmar su autenticidad en el portal público del Colegio.
5. Los recibos están disponibles para descarga indefinidamente desde el historial.

4. Descargar certificados

1. Ir a Mi Cuenta → Mis Certificados.
2. El sistema lista los certificados disponibles por tipo:
3. Certificado de Matrícula Vigente: acredita que la matrícula está activa al día de la fecha.
4. Certificado de Libre Deuda: acredita que no existen deudas pendientes con el Colegio.
5. Certificados de Cursos: emitidos al completar los cursos de capacitación (con QR verificable).
6. Para certificados con validez temporal (matrícula, libre deuda), hacer clic en Generar Nuevo para obtener uno con la fecha actual. Los certificados anteriores quedan archivados.
7. Descargar el PDF. El certificado tiene validez de 30 días (configurable) y muestra la fecha de emisión.

5. Ver y usar la credencial digital QR

El colegiado tiene dos puntos de acceso a su credencial: la MiniCredencial del dashboard (vista rápida con QR y acciones principales) y la página completa en /credential (con todas las opciones de compartición y verificación pública).

1. Desde el Dashboard, hacer clic en la miniatura de credencial para abrir el modal de vista ampliada con botones rápidos (PDF, Copiar enlace, Compartir, Ver completa).

1. Para la vista completa, ir a Mi Cuenta → Mi Credencial Digital (/credential).
2. La credencial digital muestra la foto del profesional, nombre completo, número de matrícula, especialidad y estado de la matrícula. Incluye la fecha de vigencia y el código QR que apunta al verificador público.
3. Desde la barra de acciones se puede Descargar PDF, Exhibir (modo pantalla completa), Copiar enlace de verificación, Email o Compartir por redes/WhatsApp.
4. La credencial se actualiza automáticamente al cambiar el estado de la matrícula; si el colegiado tiene cuotas vencidas o la matrícula está suspendida, la credencial sigue siendo consultable pero las opciones de descarga/compartir quedan deshabilitadas y se muestra un banner de aviso.

6. Solicitar modificación de datos personales

1. Ir a Mi Perfil → Editar Datos.
2. Visualizar los datos actuales registrados en el sistema: domicilio, teléfono, email, CUIT, especialidades declaradas, banco y CBU para liquidaciones.
3. Modificar los campos que se deseen actualizar. Los campos editables están marcados; algunos datos (como el número de matrícula) no son modificables por el usuario.
4. Subir la documentación de respaldo requerida según el tipo de dato a cambiar (ej. servicio de luz para cambio de domicilio, constancia AFIP para cambio de CUIT).
5. Hacer clic en Enviar Solicitud de Modificación. La solicitud queda en estado PENDIENTE.
6. Un operador de matrículas revisará la solicitud y la aprobará o rechazará con un comentario.
7. El colegiado recibirá un email con el resultado. Si se aprueba, los datos se actualizan automáticamente en el padrón. Si se rechaza, se indica el motivo y el colegiado puede reenviar la solicitud con la corrección.

7. Consultar el historial de solicitudes

1. Ir a Mi Perfil → Mis Solicitudes.
2. Se listan todas las solicitudes de modificación enviadas con su estado (Pendiente, Aprobada, Rechazada) y la fecha de resolución.
3. Hacer clic en una solicitud para ver el detalle: datos solicitados, documentación adjuntada, comentario del operador.
4. Si una solicitud fue rechazada, desde esta vista se puede clonar y reenviar con correcciones.

Campos y validaciones

Reglas de negocio

Errores frecuentes

Preguntas frecuentes

¿Puedo pagar con tarjeta de crédito en cuotas? Depende de la pasarela y los acuerdos vigentes del Colegio. La pantalla externa del proveedor muestra las opciones disponibles.

¿Mis recibos son válidos para presentar ante AFIP u otros organismos? Sí. Los recibos generados por PSICOLE tienen validez oficial como comprobante de pago interno del Colegio. Sin embargo, para fines impositivos consultar con el área de Finanzas del Colegio si se requiere una factura o comprobante adicional.

¿Cuánto tiempo tarda en aprobarse una solicitud de modificación de datos? El SLA interno es de 3 días hábiles. Si la solicitud supera ese plazo sin resolución, se genera automáticamente un ticket de escalamiento al supervisor. El colegiado puede consultar el estado desde Mis Solicitudes.

¿Puedo ver las cuotas de mis cursos en el portal de autogestión? Sí. Las cuotas de cursos aparecen en el estado de cuenta junto con las cuotas de matrícula y otros conceptos. Se identifican por el tipo de cuota ("Curso: [nombre del curso]") y pueden pagarse online de la misma manera.

¿El certificado de matrícula vigente tiene algún costo? No. La generación de certificados de matrícula vigente y libre deuda es gratuita para el colegiado. Solo los certificados de cursos específicos pueden tener un costo asociado al procesamiento, según la configuración del Colegio.

¿Qué pasa si pagué de más por error? El sistema conserva el pago original y el operador de finanzas registra una reversa o reintegro vinculado a la operación original, según la política configurada.

🖥 Escritorio Avisos, emails y outbox transaccional

📱 Móvil Avisos, emails y outbox transaccional

Comunicaciones

Comunicaciones centraliza avisos, correos, notificaciones internas y eventos transaccionales. El objetivo es que cada mensaje importante tenga trazabilidad, estado y motivo de fallo si no pudo enviarse.

Canales

Eventos documentados

• Alta de usuario y envío de datos de acceso.
• Reset de contraseña desde administración.
• Notificaciones de pagos aprobados, recibos creados y operaciones registradas.
• Solicitudes de corrección de trámites.
• Avisos de cursos, inscripción, desinscripción o reembolso.
• Recordatorios de consultorio cuando estén habilitados.

Entorno inerte

En sandbox o test, los mensajes no deben salir a destinatarios reales. El sistema debe registrar el intento, mostrar estado amable y permitir auditar el contenido sin generar impacto externo.

Cuando un registro aparece como Bloqueado en la auditoría, significa que el evento se generó pero una compuerta operativa evitó el envío real. El mensaje debe seguir siendo visible para soporte, auditoría y diagnóstico.

Auditoría

Cada comunicación relevante debe indicar:

• Usuario destinatario.
• Evento origen.
• Canal.
• Estado.
• Fecha.
• Error amable si falló.
• Vínculo al objeto relacionado: trámite, pago, recibo, usuario o curso.

Vista auditada desktop y mobile

La pantalla Super Admin → Comunicaciones fue recapturada luego del ajuste responsive. En escritorio conserva la tabla completa con filtros, dominios y desglose por evento; en móvil prioriza lectura vertical, controles contenidos en el ancho disponible y tablas con desplazamiento horizontal explícito cuando corresponde.

Mensajes internos auditados

La vista de mensajes internos fue incluida en el barrido para confirmar que bandejas, estados y acciones mantengan lectura correcta tanto en escritorio como en teléfono.

Beneficios para Matriculados

PSICOLE gestiona beneficios económicos para los profesionales matriculados, incluyendo maternidad/adopción, jubilación y bonificaciones operativas como primera matrícula. Todos reducen cuotas sólo cuando existe una regla vigente o una solicitud aprobada para el periodo correspondiente.

Beneficio por Jubilación (50% de descuento)

¿Qué es?

Los profesionales que alcanzan los 60 años de edad son elegibles para un descuento permanente del 50% en sus cuotas. El sistema detecta automáticamente a los elegibles mediante un proceso programado y los notifica por email.

Vista del Colegiado

Los colegiados acceden a su beneficio desde Mi Cuenta → Beneficio por Jubilación (/my-retirement-benefit).

La pantalla muestra:

Acciones disponibles:

• Rechazar el beneficio — si el profesional no desea el descuento, puede rechazarlo voluntariamente. Se solicita un motivo opcional.

Panel Administrativo

Los operadores acceden desde Trámites → Beneficios por Jubilación (/admin/retirement-benefits).

Vista en dispositivo móvil:

Estadísticas del módulo

El encabezado muestra KPIs en tiempo real:

Estados del beneficio

Acciones del operador

Detección automática:

El CRON ejecuta la detección diariamente y notifica automáticamente a los nuevos elegibles. Para ejecutarla manualmente:

1. Hacer clic en "Ejecutar detección manual".
2. El sistema busca profesionales que cumplan 60 años y no tengan beneficio registrado.
3. Envía email de notificación automático.
4. Los nuevos registros aparecen en estado PENDING_NOTIFICATION.

Acciones sobre un beneficio individual:

Beneficio por Maternidad / Adopción

¿Qué es?

Las profesionales que atraviesan una licencia por maternidad o adopción pueden solicitar una reducción temporal en sus cuotas durante el período de licencia. El colegio revisa y aprueba la solicitud con documentación respaldatoria.

Vista del Colegiado

Acceso desde Mi Cuenta → Beneficio por Maternidad (/my-parental-benefit).

El flujo de solicitud incluye:

1. Verificar elegibilidad — el sistema valida que no exista una solicitud activa.
2. Completar formulario — tipo de licencia (maternidad / adopción), fecha de inicio y fin estimada, descripción.
3. Adjuntar documentación — certificado médico o documentación de adopción.
4. Enviar al Colegio — queda en estado PENDING_REVIEW.

Estados de la solicitud:

Panel Administrativo

Los operadores acceden desde Trámites → Beneficios por Maternidad (/admin/parental-benefits).

Acciones del operador

Desde el detalle de cada solicitud el operador puede:

Bonificación por Primera Matrícula

Cuando una matrícula se emite por primera vez, las primeras cuotas pueden quedar bonificadas al 100% según la fecha de emisión:

La regla se registra sobre el profesional, con vigencia desde el inicio del mes emitido hasta el cierre del último periodo bonificado. Cuando el RUN mensual genera o revaloriza la deuda, el descuento debe quedar explicado por un snapshot de beneficio aplicado a esa deuda.

Reglas persistentes y auditoría

Los beneficios pueden venir de una solicitud dentro de PSICOLE o de una fuente externa validada por Finanzas. En ambos casos deben conservar:

• profesional asociado;
• tipo de beneficio;
• vigencia desde/hasta;
• porcentaje o importe fijo de descuento;
• fuente, archivo, hoja y fila cuando proviene de planilla;
• deuda impactada cuando el beneficio se aplica efectivamente.

Una regla vencida puede mantenerse visible como antecedente, pero no debe descontar periodos posteriores. Si una planilla histórica informa maternidad/paternidad sin vigencia para el mes del RUN, el caso se lista para revisión y no se usa para cerrar pagos automáticamente.

Los filtros operativos de Profesionales y Dinero deben permitir aislar beneficios vigentes, beneficios históricos, descuentos aplicados a deuda y casos pendientes de revisión.

Preguntas frecuentes — Beneficios

¿El descuento se aplica retroactivamente? No. Al aprobar o aplicar un beneficio, el descuento rige desde el próximo período de facturación. Las cuotas ya generadas no se modifican automáticamente.

¿Puedo tener activos ambos beneficios al mismo tiempo? Sí, son independientes. Un profesional puede tener activo el descuento por jubilación y una licencia por maternidad simultáneamente; en ese caso los descuentos se combinan.

¿Qué pasa si se cambia el beneficio después de generar cuotas? Las cuotas generadas antes del cambio no se modifican. Los cambios rigen para cuotas futuras. Si se necesita ajustar una cuota ya emitida, debe hacerse manualmente desde el módulo de Finanzas.

Certificados de Ética Profesional

El Colegio emite certificados de ética que acreditan que un profesional matriculado no registra antecedentes disciplinarios. Son documentos oficiales solicitados habitualmente para concursos, empleos, acreditaciones académicas o trámites ante organismos.

Flujo completo

Colegiado solicita certificado
           ↓
Sistema verifica elegibilidad
(sin deudas vencidas, matrícula activa)
           ↓
Solicitud creada → PENDING
           ↓
Colegiado confirma pago del arancel
     (sube referencia de transferencia)
           ↓
Estado → PENDING_REVIEW
           ↓
Operador revisa documentación y pago
       ↙               ↘
  APPROVED           REJECTED
       ↓                 ↓
Genera PDF           Email con
descargable            motivo

Vista del Colegiado

Acceso desde Mi Cuenta → Certificado de Ética (/my-ethics-certificate).

Verificar elegibilidad

Antes de mostrar el formulario, el sistema valida automáticamente:

Solicitar certificado

1. Completar el campo "Motivo / uso del certificado" (opcional — ej.: concurso docente, presentación en obra social).
2. Hacer clic en "Solicitar certificado".
3. El sistema muestra el arancel vigente y las instrucciones de pago por transferencia.

Confirmar pago

Una vez realizada la transferencia bancaria:

1. Hacer clic en "Confirmar pago".
2. Ingresar el número de referencia / comprobante de la transferencia.
3. El estado pasa a PENDING_REVIEW y el Colegio recibe una notificación.

Descargar el certificado

Una vez aprobado, el botón "Descargar PDF" queda habilitado. El PDF incluye:

• Datos del profesional (nombre, matrícula, DNI)
• Declaración de ausencia de antecedentes disciplinarios
• Fecha de emisión y vigencia
• Firma del presidente del Colegio
• Código QR de verificación de autenticidad

Estados de la solicitud

Panel Administrativo

Acceso desde Trámites → Certificados de Ética (/admin/ethics-certificates).

Columnas de la tabla

Filtros disponibles

• Por estado: PENDING / AWAITING_PAYMENT / PENDING_REVIEW / APPROVED / REJECTED / CANCELLED
• Búsqueda libre: por nombre del profesional, número de matrícula o número de solicitud

Revisar una solicitud

Al hacer clic en una solicitud se abre el panel de detalle:

El panel muestra:

Acciones del operador

Preguntas frecuentes — Certificados de Ética

¿Cuánto tiempo tarda el proceso? Depende del colegio, pero el flujo típico es: solicitud → confirmación de pago → revisión en 24–48 horas hábiles → descarga del PDF.

¿El certificado tiene vencimiento? Sí, en general los certificados tienen validez de 6 meses desde la emisión. La fecha de vencimiento figura en el propio PDF.

¿Puedo solicitar varios certificados? Solo puede haber una solicitud activa por vez. Una vez descargado el certificado aprobado, la solicitud pasa a estado histórico y se puede iniciar una nueva.

¿Qué pasa si se rechazan deudas que ya pagué? Si el sistema detecta deudas vencidas y el colegiado ya regularizó, debe esperar a que el pago se procese en el sistema (máx. 24 hs.) y volver a intentar la solicitud.

Módulo de Tickets y Trámites (EPIC-09)

El módulo de Tickets y Trámites permite gestionar solicitudes formales de colegiados y prestadores con flujo de trabajo completo, SLA configurable, semáforo de tiempos y asignación automática de operadores.

Para la documentación de administración (categorías, áreas, parámetros, dashboards), ver la sección de Administración:

Ver documentación completa → Tickets y Soporte{ .md-button .md-button--primary }

Vistas por Rol

Operador de Trámites

El operador accede a su dashboard personal al ingresar al sistema, con tickets agrupados por urgencia y semáforo SLA en cada tarjeta.

Rutas: - Dashboard personal: /operator/dashboard - Kanban propio: /operator/tickets - Detalle de ticket: /tickets/:id

Guía completa del Operador de Trámites{ .md-button }

Supervisor de Trámites

El supervisor accede a métricas globales y al kanban por operador para monitorear la operación completa.

Rutas: - Métricas: /supervisor/metrics - Gestión: /supervisor/tickets

Guía completa del Supervisor de Trámites{ .md-button }

Colegiado / Prestador

Los colegiados y prestadores pueden crear tickets, ver el estado de los suyos y agregar comentarios.

Vista mobile:

Ruta: /my-tickets

Seguimiento público

Cualquier persona puede consultar el estado de un ticket con su número de seguimiento, sin necesidad de iniciar sesión.

Ruta: /track

Ciclo de vida

PENDIENTE → ASIGNADO → EN PROGRESO → [PAUSADO] → RESUELTO → CERRADO

Semáforo SLA

Integración con trámites

Cuando una categoría de ticket tiene un módulo relacionado configurado (ej: Renovación de Matrícula, Débito Automático), en el detalle del ticket aparece el botón "Ver servicio relacionado" que lleva directamente al módulo correspondiente del sistema.

Documentación de administración

• Configuración de Categorías, Áreas de Trabajo y Parámetros
• Dashboard Global Admin

Directorio Público de Psicólogos

El directorio público es el módulo que expone el listado de profesionales habilitados a cualquier persona y a cualquier sitio web externo, sin necesidad de autenticación. Está disponible como página web en el portal y como API REST pública consumible desde cualquier servicio externo.

Quién aparece en el directorio

Para que un profesional aparezca en el directorio deben cumplirse dos condiciones simultáneas:

Si cualquiera de las dos condiciones deja de cumplirse — por ejemplo, si se suspende la matrícula o el profesional desactiva su perfil — el registro deja de aparecer en todos los endpoints públicos de forma inmediata (respetando el TTL de caché).

Arquitectura del módulo

El módulo tiene tres capas independientes:

┌─────────────────────────────────────────────────────────────┐
│  BASE DE DATOS (MySQL)                                       │
│  Tabla `professionals` — campos públicos separados          │
│  de los datos de matrícula y expediente                      │
└───────────────────┬─────────────────────────────────────────┘
                    │ Prisma ORM
┌───────────────────▼─────────────────────────────────────────┐
│  BACKEND API (Node/Express)                                  │
│  publicDirectoryController.js                                │
│  Montado en /api/v1/public — CORS *, sin auth, rate limit    │
└───────────────────┬─────────────────────────────────────────┘
                    │ HTTP (fetch / axios)
┌───────────────────▼─────────────────────────────────────────┐
│  FRONTEND SPA (React)                                        │
│  PublicDirectory.jsx → /directorio-psicologos                │
│  Filtros inicializados desde URL query params                │
└─────────────────────────────────────────────────────────────┘

Acceso

Modelo de datos — campos públicos vs. datos de matrícula

El modelo Professional en la base de datos mantiene dos grupos de campos claramente separados.

Campos exclusivos del perfil público

Estos campos son editados directamente por el profesional (o el admin) para controlar cómo aparece en el directorio. No afectan al expediente de matrícula.

Campos del expediente usados en el directorio

Estos campos forman parte del expediente de matrícula. Aparecen en el directorio pero solo pueden modificarse desde la ficha profesional, no desde la autogestión de perfil público.

Cadenas de fallback

Cuando un campo público no está cargado, la API aplica las siguientes cadenas de fallback en orden:

displayName  =  public_display_name  ??  user.firstName + " " + user.lastName
city         =  office_city  ??  professional.city  ??  user.city
phone        =  public_phone  ??  office_phone

Esto significa que un profesional sin public_display_name configurado aparecerá con su nombre y apellido del sistema. Si no cargó teléfono público, se usará el del consultorio si existe.

Sistema de slugs

Cada profesional con perfil activo tiene un slug único que forma su URL pública.

Generación automática

El slug se genera a partir de apellido + nombre, siguiendo estas transformaciones en orden:

1. Convertir a minúsculas
2. Normalizar caracteres Unicode (NFD) y eliminar diacríticos: á→a, ñ→n, ü→u
3. Eliminar todo lo que no sea letra, número, espacio o guión
4. Recortar espacios extremos
5. Reemplazar espacios por guiones
6. Colapsar guiones múltiples en uno solo

Ejemplo:

Apellido: "De Stefano Surballe"
Nombre:   "Candela"
Slug:     "de-stefano-surballe-candela"

Resolución de colisiones

Si el slug generado ya existe (dos profesionales con el mismo nombre), el sistema agrega un sufijo numérico incremental hasta encontrar uno libre:

garcia-maria-jose      → ocupado
garcia-maria-jose-2    → ocupado
garcia-maria-jose-3    → libre ✓

El slug es un campo UNIQUE en la base de datos — nunca puede haber dos profesionales con el mismo slug.

URL directa a un perfil

https://sandbox.umdev.com.ar/directorio-psicologos/de-stefano-surballe-candela

Al acceder a esta URL, el portal carga el directorio y abre automáticamente el modal de detalle del profesional correspondiente.

API REST Pública

Características generales

GET /directory/info

Metadatos de la API: total de profesionales activos, desglose por modalidad, lista de endpoints y parámetros disponibles.

Cache: public, max-age=300 (5 minutos)

Request:

curl https://sandbox.umdev.com.ar/api/v1/public/directory/info

Response:

{
  "success": true,
  "data": {
    "version": "v1",
    "totalProfessionals": 631,
    "baseUrl": "https://sandbox.umdev.com.ar/api/v1/public",
    "endpoints": {
      "list":         "GET /directory",
      "bySlug":       "GET /directory/by-slug/:slug",
      "byMatricula":  "GET /directory/:enrollmentNumber",
      "info":         "GET /directory/info"
    },
    "filters": {
      "search":    "string — búsqueda libre en nombre, bio, especialidad",
      "city":      "string — ciudad de atención",
      "specialty": "string — especialidad o área clínica",
      "modality":  "PRESENCIAL | VIRTUAL | BOTH",
      "insurance": "string — obra social aceptada",
      "page":      "integer — página (default: 1)",
      "limit":     "integer — resultados por página (default: 20, max: 50)"
    },
    "modalityBreakdown": {
      "PRESENCIAL": 210,
      "VIRTUAL": 152,
      "BOTH": 269
    }
  }
}

Útil para construir selectores dinámicos: consumir /info primero para obtener el total y el desglose antes de renderizar la UI de búsqueda.

GET /directory

Lista paginada de profesionales con perfil público activo.

Cache: public, max-age=120 (2 minutos)

Parámetros:

Ejemplos:

# Listado básico
curl "https://sandbox.umdev.com.ar/api/v1/public/directory"

# Zona Mendoza + OSEP + especialista en niños
curl "https://sandbox.umdev.com.ar/api/v1/public/directory?city=GODOY+CRUZ&insurance=OSEP&search=ni%C3%B1os"

# Solo atención virtual, página 2
curl "https://sandbox.umdev.com.ar/api/v1/public/directory?modality=VIRTUAL&page=2&limit=10"

Response:

{
  "success": true,
  "data": [
    {
      "id": "clx1234...",
      "enrollmentNumber": "M-3847",
      "slug": "garcia-maria-jose",
      "displayName": "María José García",
      "photo": null,
      "specialty": "Psicología Clínica",
      "city": "GODOY CRUZ",
      "province": "Mendoza",
      "modality": "VIRTUAL",
      "attentionArea": "Adultos, Parejas",
      "schedule": "Lunes a Viernes 14:00 a 20:00",
      "phone": "+54 261 4XXXXXX",
      "email": "mgarcia@example.com",
      "website": null,
      "bio": "Especialista en terapia cognitivo-conductual.",
      "insurances": "OSEP, Swiss Medical, OSDE",
      "languages": "Español",
      "orientation": "Cognitivo-Conductual",
      "officeAddress": "Av. San Martín 1234, Mendoza"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 631,
    "totalPages": 32,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

GET /directory/by-slug/:slug

Perfil completo de un profesional por su slug único.

Cache: public, max-age=300 (5 minutos)

Request:

curl "https://sandbox.umdev.com.ar/api/v1/public/directory/by-slug/garcia-maria-jose"

Devuelve los mismos campos que el listado más los campos de detalle: university, degree, enrollmentDate.

GET /directory/:enrollmentNumber

Perfil completo por número de matrícula. Retorna los mismos campos que by-slug.

Request:

curl "https://sandbox.umdev.com.ar/api/v1/public/directory/M-3847"

Lógica interna de búsqueda y filtros

Comprender cómo se construye la consulta a la base de datos es clave para predecir los resultados.

Filtros individuales

Cada filtro agrega una condición AND al WHERE:

Filtro de ciudad

city busca en dos campos simultáneamente (ciudad de consultorio y ciudad del profesional):

(office_city LIKE '%GODOY CRUZ%' OR city LIKE '%GODOY CRUZ%')

Búsqueda libre (search)

Busca en 6 campos con OR:

(
  public_display_name LIKE '%ansiedad%' OR
  public_bio LIKE '%ansiedad%' OR
  specialties LIKE '%ansiedad%' OR
  attention_area LIKE '%ansiedad%' OR
  user.first_name LIKE '%ansiedad%' OR
  user.last_name LIKE '%ansiedad%'
)

Combinación city + search

Cuando se usan ambos filtros juntos, la lógica cambia para garantizar que ambas condiciones se cumplan:

WHERE is_public_profile_active = 1
  AND enrollment_status IN ('APPROVED', 'PROVISIONAL')
  AND (office_city LIKE '%GODOY CRUZ%' OR city LIKE '%GODOY CRUZ%')   -- ciudad
  AND (                                                                  -- search
    public_display_name LIKE '%niños%' OR
    public_bio LIKE '%niños%' OR
    specialties LIKE '%niños%' OR
    attention_area LIKE '%niños%' OR
    user.first_name LIKE '%niños%' OR
    user.last_name LIKE '%niños%'
  )

Añadir más filtros (insurance, modality) agrega condiciones AND adicionales al mismo WHERE.

Cache y rendimiento

El header public permite que CDNs y proxies inversos (nginx, Cloudflare, etc.) cacheen las respuestas. Consecuencias prácticas:

• Un perfil recién activado puede tardar hasta 2 minutos en aparecer en el listado y hasta 5 minutos en responder desde by-slug.
• Un perfil recién desactivado puede seguir siendo accesible durante el TTL restante desde nodos de caché intermedios.
• El endpoint /info refleja el total actualizado con hasta 5 minutos de retraso.

CORS y rate limiting

CORS

Configurado en app.js exclusivamente para el prefijo /api/v1/public:

cors({
  origin: '*',
  methods: ['GET', 'POST', 'OPTIONS'],
  allowedHeaders: ['Content-Type']
})

Headers enviados en cada respuesta:

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, OPTIONS
Access-Control-Allow-Headers: Content-Type

Rate limiting

• Límite: 200 requests por IP cada 15 minutos
• Headers de respuesta: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (draft-7)
• Requests OPTIONS: no cuentan hacia el límite (para no penalizar preflight CORS)
• Respuesta al exceder el límite (HTTP 429):

{
  "success": false,
  "message": "Demasiadas solicitudes. Intente nuevamente en 15 minutos."
}

Portal web — comportamiento del frontend

La página /directorio-psicologos es una SPA React (PublicDirectory.jsx) con las siguientes características:

Inicialización desde URL query params

Los filtros se inicializan a partir de los query params de la URL al cargar la página. Esto permite compartir búsquedas pre-filtradas:

/directorio-psicologos?city=GODOY+CRUZ&insurance=OSEP&search=niños&modality=VIRTUAL&page=2

Parámetros soportados: search, city, modality, attentionArea, insurance, page.

Comportamiento de los filtros

• Búsqueda libre: debounce de 350ms — no dispara la API en cada tecla
• Cambio de filtro dropdown: dispara la API inmediatamente y resetea a página 1
• Paginación: 20 resultados por página

Apertura de perfiles

Al hacer clic en una tarjeta: 1. Abre el modal de detalle 2. Hace un fetch a GET /directory/:enrollmentNumber para obtener los campos de detalle adicionales (university, degree, enrollmentDate) 3. Si el fetch falla (ej. caché expirado y perfil ya inactivo), muestra los datos de la tarjeta como fallback

URL compartible de perfil individual

Si la URL tiene el formato /directorio-psicologos/:slug, el modal se abre automáticamente al cargar la página haciendo un fetch a GET /directory/by-slug/:slug.

Gestión del perfil — Psicólogo (autogestión)

Ruta en el portal: /mi-perfil-publico

Endpoint backend: PUT /api/v1/professionals/my-public-profile

Flujo completo

Carga de página
    → GET /users/{userId}/full-profile
    → Mapea campos al formulario

Toggle "Publicar perfil"
    → PUT /professionals/my-public-profile
    → Payload: { isPublicProfileActive: boolean }
    → Efecto inmediato (sin guardar el resto del formulario)

Guardar cambios
    → PUT /professionals/my-public-profile
    → Payload: { todos los campos del formulario }

Campos editables desde autogestión

Campos NO editables desde aquí

Los siguientes campos provienen del expediente de matrícula y solo pueden modificarse desde la ficha profesional en el panel de Administración:

• specialty (especialidades clínicas)
• orientation (orientación teórica)
• university / degree (formación académica)
• slug (auto-generado, no modificable manualmente)

Vista previa en tiempo real

La página incluye una tarjeta de previsualización que muestra en tiempo real cómo aparecerá el profesional en el directorio público, con foto, nombre, especialidad, ciudad, modalidad, teléfono y obras sociales. En la parte superior del formulario el colegiado puede subir, recortar (a 512x512) o eliminar su foto de credencial mediante el componente PhotoUploader (JPG/PNG/WebP, máx. 8 MB).

Gestión del perfil — Administrador

Endpoint: PUT /api/v1/professionals/:id/public-profile

Requiere: rol ADMIN

Permite activar, desactivar y editar cualquier campo del perfil público de cualquier profesional desde la ficha individual en el módulo de Matrículas.

# Activar perfil
curl -X PUT "https://sandbox.umdev.com.ar/api/v1/professionals/[id]/public-profile" \
  -H "Authorization: Bearer [token-admin]" \
  -H "Content-Type: application/json" \
  -d '{ "isPublicProfileActive": true }'

# Actualizar campos
curl -X PUT "https://sandbox.umdev.com.ar/api/v1/professionals/[id]/public-profile" \
  -H "Authorization: Bearer [token-admin]" \
  -H "Content-Type: application/json" \
  -d '{
    "isPublicProfileActive": true,
    "attentionModality": "VIRTUAL",
    "acceptedInsurances": "OSEP, OSDE, Swiss Medical",
    "languages": "Español, Inglés"
  }'

El endpoint acepta los mismos campos que la autogestión. Solo los campos presentes en el body se actualizan — el resto permanece sin cambios.

Endpoints de utilidad

Estos endpoints son de uso excepcional, no forman parte del flujo normal de la API.

POST /directory/seed-profiles

Activa perfiles públicos en lote para entornos nuevos. Genera datos demo (modalidad, área, horarios, obras sociales) y asigna slugs automáticamente.

Protección: requiere secret: "psicole-seed-2026" en el body.

curl -X POST "https://sandbox.umdev.com.ar/api/v1/public/directory/seed-profiles" \
  -H "Content-Type: application/json" \
  -d '{ "secret": "psicole-seed-2026", "count": 300 }'

POST /directory/generate-slugs

Genera slugs para todos los perfiles activos que no tienen uno asignado. Operación idempotente — no modifica los slugs existentes.

curl -X POST "https://sandbox.umdev.com.ar/api/v1/public/directory/generate-slugs" \
  -H "Content-Type: application/json" \
  -d '{ "secret": "psicole-seed-2026" }'

Response:

{ "success": true, "generated": 45, "total": 45 }

Integración en sitios externos

fetch (JavaScript)

// Metadatos primero — obtener total y filtros disponibles
const info = await fetch('https://sandbox.umdev.com.ar/api/v1/public/directory/info')
  .then(r => r.json());
console.log(`Hay ${info.data.totalProfessionals} profesionales en el directorio`);

// Buscar psicólogos en zona Mendoza que acepten OSEP y atiendan niños
const res = await fetch(
  'https://sandbox.umdev.com.ar/api/v1/public/directory' +
  '?city=GODOY+CRUZ&insurance=OSEP&search=ni%C3%B1os&limit=10'
);
const { data, pagination } = await res.json();
console.log(`${pagination.total} resultados — mostrando ${data.length}`);

data.forEach(psi => {
  console.log(`${psi.displayName} | ${psi.modality} | ${psi.phone}`);
});

PHP

$url = 'https://sandbox.umdev.com.ar/api/v1/public/directory'
     . '?city=GODOY+CRUZ&insurance=OSEP&search=ni%C3%B1os&limit=10';
$json = json_decode(file_get_contents($url), true);

foreach ($json['data'] as $psi) {
    echo $psi['displayName'] . ' — ' . $psi['phone'] . PHP_EOL;
}

Python

import requests

resp = requests.get(
    'https://sandbox.umdev.com.ar/api/v1/public/directory',
    params={
        'city': 'GODOY CRUZ',
        'insurance': 'OSEP',
        'search': 'niños',
        'limit': 10
    }
)
data = resp.json()

for psi in data['data']:
    print(f"{psi['displayName']} | {psi['city']} | {psi['attentionArea']}")

URL compartible pre-filtrada

Para enlazar desde otro sitio web hacia el directorio con filtros pre-aplicados:

https://sandbox.umdev.com.ar/directorio-psicologos?city=GODOY+CRUZ&insurance=OSEP&search=ni%C3%B1os

Al abrir ese link, el portal carga con los filtros ya activos y muestra los resultados correspondientes.

Referencia completa de campos en la respuesta

Campos del listado (GET /directory)

Campos adicionales en detalle (by-slug y /:enrollmentNumber)

Manejo de errores

Estructura de error:

{
  "success": false,
  "message": "Perfil profesional no encontrado o no es público"
}

🖥 Escritorio Gestión de usuarios y asignación de roles

📱 Móvil Gestión de usuarios y asignación de roles

Usuarios y Roles

Descripción

Este módulo permite al administrador gestionar todos los usuarios del sistema: crear cuentas, asignar roles, revocar accesos, visualizar la actividad de cualquier usuario mediante impersonación y consultar el historial de auditoría de accesos.

Acceso

Menú: Administración → Usuarios y Roles Roles con acceso: ADMIN

Crear un usuario

1. Ir a Administración → Usuarios y Roles → Nuevo usuario.
2. Completar el formulario:

1. Hacer clic en Guardar. El sistema genera una contraseña temporal y dispara el aviso de acceso según la configuración de comunicaciones del entorno.

Roles disponibles

Enviar acceso y resetear clave

Desde la lista de usuarios, el ícono de llave permite generar una nueva contraseña temporal y enviar al usuario el aviso con la URL de acceso.

El flujo es transaccional:

1. El administrador confirma el reset.
2. El sistema genera una contraseña temporal.
3. Se intenta enviar el aviso con la URL del sistema y los datos de acceso.
4. Si el aviso falla, la contraseña anterior se conserva y se muestra un mensaje amable.
5. Si el aviso sale correctamente, queda auditado el reset y el usuario puede ingresar con la nueva clave.

Esta acción sirve para usuarios nuevos, usuarios que no recibieron el alta original o cuentas que requieren recuperación asistida.

Editar y revocar acceso

• Para editar un usuario: hacer clic en el ícono de lápiz en la fila correspondiente.
• Para desactivar (sin eliminar): usar el toggle Activo en el formulario de edición. El usuario no podrá iniciar sesión pero sus datos e historial se conservan.
• Para eliminar permanentemente: hacer clic en el ícono de papelera. Esta acción requiere confirmación y es irreversible.

Impersonación de administrador

La impersonación permite a un ADMIN visualizar el sistema como lo ve otro usuario. Es útil para soporte y diagnóstico. Cuando una acción esté habilitada en modo asistido, el sistema debe mostrar claramente que se está operando como otro usuario y registrar auditoría.

Cómo impersonar:

1. En la lista de usuarios, hacer clic en el ícono "Ver como este usuario" (ícono de ojo).
2. Se abre una nueva pestaña con la sesión del usuario en modo solo-lectura.
3. Un banner naranja en la parte superior indica: "Estás viendo el sistema como [Nombre del usuario] — Modo solo-lectura".
4. Para salir de la impersonación, hacer clic en "Volver a mi sesión" en el banner.

Auditoría de accesos

El log de auditoría registra automáticamente todos los eventos de seguridad relevantes.

Cómo acceder: Administración → Usuarios y Roles → Auditoría

Eventos registrados:

Filtros disponibles: por usuario, por tipo de evento, por rango de fechas.

Operadores Especiales, Dinámicos y Asignación de Módulos

PSICOLE permite crear operadores especiales asignándoles solo los módulos del sistema que necesitan para su trabajo diario. Esto es útil cuando un operador trabaja exclusivamente en finanzas, matrículas, cursos, prestadores o trámites, sin acceso innecesario al resto del sistema.

¿Qué son los módulos dinámicos?

Además del sistema de roles fijo (RBAC), PSICOLE ofrece una capa adicional de especialización: los módulos operativos (EPICs). Cada módulo agrupa funcionalidades relacionadas y puede asignarse individualmente a cualquier usuario con rol de operador.

Los EPICs operativos disponibles son:

Administrar módulos de un operador

Acceso: Administración → Operadores → Módulos de Operadores (/admin/operator-modules)

Vista en dispositivo móvil:

Ver módulos asignados

La pantalla muestra una tabla con todos los usuarios que tienen rol de operador, junto con los módulos habilitados para cada uno:

Asignar o modificar módulos

1. Hacer clic en "Editar módulos" en la fila del operador.
2. Se abre el panel de asignación con los 5 EPICs.
3. Seleccionar o deseleccionar los módulos necesarios.

1. Opcionalmente, dentro de cada EPIC, seleccionar funciones específicas (granularidad fina):
2. EPIC-02 → Operaciones, caja, conciliación, planes, débito, transferencias, reintegros.
3. EPIC-06 → Usuarios, reset de accesos, grupos/sedes, super admins, auditoría.
4. EPIC-08 → Pasarelas, comunicaciones, outbox y webhooks.
5. Hacer clic en "Guardar".

Métricas de operadores

Desde el mismo panel, el botón "Ver métricas" muestra:

Panel del Operador (vista del operador)

Cuando un operador con módulos asignados inicia sesión, el sistema muestra solo los menús correspondientes a sus módulos. Por ejemplo:

• Un operador con solo EPIC-02 (Finanzas) ve: Cobros, Caja, Conciliación, Recibos — y nada más.
• Un operador con EPIC-01 y EPIC-09 ve: Matrículas + Trámites.

El onboarding del sistema también se adapta: al iniciar sesión por primera vez, el tour interactivo muestra exclusivamente las funcionalidades de los módulos asignados.

Grupos de Usuarios (Sedes / Ciudades)

Los grupos de usuarios permiten organizar operadores por zona geográfica (sede, delegación, ciudad). Esto es útil cuando el colegio opera en múltiples ciudades y quiere que los operadores de cada sede vean solo los profesionales de su zona.

Acceso: Administración → Operadores → Grupos de Usuarios (/admin/user-groups)

Crear un grupo

1. Hacer clic en "Nuevo grupo".
2. Ingresar nombre del grupo (ej.: "Sede Mendoza", "Delegación Sur").

3. Configurar el grupo en las 3 pestañas:

   • Nombre del grupo
   • Descripción (opcional)

   • Ciudades — chips de ciudades cubiertas por este grupo. Los profesionales de estas ciudades serán visibles para los operadores miembros.

   • Miembros actuales con botón para remover

   • Agregar operador — búsqueda por nombre o email, lista de disponibles

   Permite incluir o excluir profesionales específicos independientemente de su ciudad:

   Tipo	Descripción
   INCLUDE	Agregar un profesional aunque su ciudad NO esté en el grupo
   EXCLUDE	Quitar un profesional aunque su ciudad SÍ esté en el grupo

   Cada excepción puede tener una razón descriptiva opcional.

Ejemplo de uso

El operador "María García" trabaja en la sede de Mendoza. Se crea el grupo "Sede Mendoza" con las ciudades Mendoza, Godoy Cruz y Luján de Cuyo. Se agrega a María como miembro. Ahora María solo ve profesionales de esas tres ciudades cuando trabaja en matrículas o finanzas.

Super Administradores

Los Super Administradores son usuarios con privilegios elevados que pueden realizar operaciones críticas del sistema, como promover o degradar a otros administradores. Es una capa de seguridad adicional sobre el rol ADMIN.

Acceso: Administración → Seguridad → Super Administradores (/admin/super-admins)

Promover un usuario a Super Admin

1. Hacer clic en "Promover usuario".
2. Buscar el usuario por nombre o email.
3. Seleccionar el usuario.
4. El sistema envía un código de verificación de 6 dígitos al email del Super Admin actual.
5. Ingresar el código en el modal de confirmación.
6. La operación queda registrada en el log de auditoría.

Degradar a un Super Admin

1. En la fila del Super Admin, hacer clic en "Degradar".
2. Confirmar la intención.
3. El sistema envía un código de verificación por email.
4. Ingresar el código.

Seguridad del proceso

🖥 Escritorio Configuración de parámetros del sistema

📱 Móvil Configuración de parámetros del sistema

Parámetros del Sistema

Descripción

Los parámetros del sistema son la configuración global que define la identidad y el comportamiento de la plataforma. Incluyen los datos institucionales del Colegio, la personalización visual, la firma digital de credenciales y la configuración de notificaciones.

Acceso

Menú: Administración → Parámetros del Sistema Roles con acceso: ADMIN

Datos institucionales

Estos datos aparecen en reportes, credenciales digitales, encabezados de emails y recibos.

Configuración de la aplicación

Logo y marca

Para subir una imagen: hacer clic en el área de carga o arrastrar el archivo. El sistema previsualizará la imagen antes de guardar.

Firma escaneada

La firma del directivo autorizado se incrusta en las credenciales digitales y en las constancias oficiales emitidas por el sistema.

Pasos para cargar la firma:

1. Escanear la firma en papel blanco con buena resolución (300 DPI mínimo).
2. Recortar la imagen para que solo incluya la firma (sin márgenes excesivos).
3. Guardar como PNG con fondo transparente.
4. En Parámetros del Sistema → Firma escaneada, hacer clic en Subir firma.
5. Vista previa: el sistema muestra cómo quedará la firma en una credencial de ejemplo.
6. Completar los campos:

Parámetros de notificaciones

La configuración SMTP se gestiona en el módulo Notificaciones. Aquí se definen parámetros complementarios:

Guardar cambios

Todos los cambios en parámetros del sistema se aplican inmediatamente tras guardar. No se requiere reiniciar la aplicación. Cada modificación queda registrada en el log de auditoría con el usuario, la fecha y el valor anterior vs. nuevo.

Tarifario Mensual de Cuotas

Que resuelve

El tarifario mensual es la fuente operativa para los importes de cuota por periodo. El concepto cobrable habilitado sigue siendo CUOTA_MENSUAL, pero los valores de mayo, junio y meses siguientes se administran en Dinero -> Configuracion -> Tarifario mensual mediante MONTHLY_FEE_TARIFF_POLICY.

Esta separacion evita crear conceptos mensuales versionados, reduce errores al ejecutar el RUN y deja una politica auditable para descuentos, redondeos y beneficios.

Flujo operativo

1. Tesoreria define el valor general del periodo y los importes finales aprobados para CBU, tarjeta y jubilacion.
2. Super Admin o Finanzas actualiza el Tarifario mensual.
3. El operador previsualiza el RUN en Dinero -> Operaciones -> Cuotas.
4. Al ejecutar el RUN, el sistema genera una deuda por profesional, periodo y concepto CUOTA_MENSUAL.
5. La deuda queda congelada con amount, discount, finalAmount y un cargo interno idempotente debt-charge:<debtId>.
6. El lote CBU toma Debt.finalAmount; no vuelve a calcular descuentos.
7. La conciliacion bancaria corrobora el dinero ingresado o rechazado contra la deuda y la operacion trazable.

Valores certificados mayo/junio 2026

Reglas:

• CBU / Caja de ahorro aplica 20% con adhesion ACTIVE.
• Tarjeta de credito aplica 30% con adhesion ACTIVE.
• Jubilacion aplica 50% sobre la cuota general y excluye CBU/tarjeta.
• No se permite doble descuento jubilacion + CBU/tarjeta sobre la misma cuota.
• Los importes finales se redondean al multiplo operativo de $0,50.
• Junio tarjeta se registra como valor oficial final $11.215,00, no como resultado matematico inferido.

Relacion con Tipos de Cuota

CUOTA_MENSUAL es el unico concepto mensual oficial que debe quedar activo para generacion. Los conceptos mensuales historicos o versionados deben quedar inactivos para evitar que un RUN tome un importe equivocado.

La pantalla de Tipos de Cuota sigue administrando matriculas, cursos, certificados, recargos y otros aranceles. Para cuota mensual, actua como habilitador del concepto; el importe mensual por periodo sale del tarifario.

RUN, lote y conciliacion

El RUN mensual crea deuda pendiente y cargo interno, pero no registra cobro real. El cobro real ocurre despues por caja, transferencia, POS, checkout o debito automatico.

Para CBU / COELSA:

• el lote debe sumar exactamente los Debt.finalAmount incluidos;
• tarjeta de credito no entra al archivo COELSA;
• si el banco aprueba, el pago/recibo queda contra la deuda;
• si el banco rechaza, no se crea ingreso bancario y la deuda vuelve a saldo pendiente segun la regla de rechazo vigente;
• cualquier diferencia contra extracto debe quedar como ajuste, reversa o revision manual documentada.

En el RUN mensual auditable, un extracto bancario general no se imputa completo como cuota. El sistema primero separa rutas operativas:

• Cuota mensual: importe compatible con el tarifario del periodo y destino unico.
• Ajuste o periodo anterior: importe compatible con una cuota vieja o una diferencia aprobada.
• Tramite, curso o arancel: importe que coincide con conceptos configurados fuera de la cuota.
• Liquidacion institucional: Payway, NAVE, Mercado Pago, MODO, recaudacion bancaria, obras sociales o proveedores.
• Transferencia a clasificar: ingreso personal sin tarifa ni deuda unica.
• Movimiento no acreditado: debitos, egresos o importes cero.

Solo la ruta de cuota mensual puede quedar como AUTO_APPLY_STRICT si tambien existe deuda unica, idempotencia y evidencia suficiente. Las demas rutas quedan como MANUAL_REVIEW o EXCLUDED segun corresponda.

Certificacion SANDBOX mayo/junio 2026

La prueba de mayo/junio 2026 certifico que el tarifario mensual congela importes distintos por periodo y que el cobro posterior respeta la deuda generada:

Contra fuentes primarias de tarjeta y CBU, el cierre SANDBOX dejo 5.697 eventos conciliados de 5.986 aceptados/cobrados. El remanente original de 360 eventos fue clasificado completo: 71 aplicados, 123 ya cerrados, 152 manuales, 6 sin deuda PENDING compatible y 8 bloqueados por transaccion bancaria no aplicable.

La prueba no envio correos ni notificaciones. Las aplicaciones usaron marker de SANDBOX, replay idempotente y verificacion de deuda, pago, recibo, banco, cuenta corriente y asiento contable.

Controles antes de ejecutar

• Confirmar que MONTHLY_FEE_TARIFF_POLICY tenga el periodo a generar.
• Confirmar que CUOTA_MENSUAL este activo y los conceptos mensuales legacy esten inactivos.
• Previsualizar cantidad de profesionales, total general, descuentos y final.
• Revisar que jubilados no acumulen CBU/tarjeta.
• Revisar que una adhesion de cobro este ACTIVE; PENDING, SUSPENDED o CANCELLED no otorgan descuento.
• No habilitar correos de generacion salvo decision explicita mediante QUOTA_GENERATION_NOTIFICATIONS_ENABLED.

Evidencia movil

La administracion de tarifario, RUN y lote CBU es operacion interna de Finanzas/Super Admin. La evidencia principal es escritorio. En movil no se recomienda operar ejecuciones masivas; usar solo para consulta si el entorno lo permite.

🖥 Escritorio Definición de tipos de cuota y aranceles

📱 Móvil Definición de tipos de cuota y aranceles

Tipos de Cuota (FeeTypes)

Descripción

Los Tipos de Cuota definen los conceptos cobrables que el Colegio aplica a sus matriculados: cuota mensual, matricula, cursos, certificados, recargos u otros cargos. Cada tipo especifica categoria, codigo interno, periodicidad, vigencia y reglas de descuento de respaldo.

Para cuotas mensuales, FeeType habilita el concepto oficial CUOTA_MENSUAL. El importe de cada periodo se administra en Tarifario Mensual de Cuotas mediante MONTHLY_FEE_TARIFF_POLICY. No se deben crear ni reactivar conceptos mensuales versionados para mayo, junio u otros meses.

Acceso

Menú: Administración → Tipos de Cuota Roles con acceso: ADMIN, OPERADOR_FINANZAS

Listado de tipos de cuota

La pantalla principal muestra una tabla con todos los tipos de cuota configurados:

Crear un tipo de cuota

1. Hacer clic en Nuevo tipo de cuota.
2. Completar el formulario:

1. Hacer clic en Guardar.

Editar un tipo de cuota

Se pueden modificar los datos del tipo de cuota, pero para cambios de valor mensual aprobados por resolucion se debe actualizar el Tarifario Mensual de Cuotas. La generacion selecciona CUOTA_MENSUAL, calcula descuentos con el tarifario del periodo y deja Debt.amount, Debt.discount y Debt.finalAmount en cada deuda creada.

Las cuotas ya generadas no se recalculan por editar el tipo. Si se ejecuta la generacion del periodo actual y existen cuotas mensuales abiertas con un valor anterior, el sistema puede revalorizar deudas abiertas y registrar el cargo interno trazable segun el tarifario vigente.

Antes de enviar un lote CBU, Finanzas debe confirmar que las deudas incluidas reflejan el valor vigente y los beneficios aprobados. Un lote ya enviado al banco se controla por devolución bancaria, no por edición retroactiva del tipo de cuota.

Cuotas certificadas mayo/junio 2026

El importe de junio 2026 debe cargarse como valor oficial fijo de $16.021. No debe documentarse como resultado de un incremento de 2,1% sobre mayo, porque ese calculo no coincide. Los importes finales se redondean al multiplo operativo de $0,50 mas cercano.

Para editar estos valores, usar Tarifario Mensual de Cuotas. Los conceptos mensuales legacy o versionados deben permanecer inactivos.

Desactivar un tipo de cuota

Desactivar un tipo lo excluye de futuras generaciones automáticas. Las cuotas ya existentes de ese tipo no se eliminan ni modifican.

Para desactivar: en la tabla, hacer clic en el toggle Activo de la fila correspondiente, o entrar a editar y desmarcar el toggle Activo.

Ejemplos de tipos de cuota comunes

Cuota Mensual Plena