Contexto: El módulo de pagos define qué se cobra (catálogo de conceptos), cuánto vale la unidad fiscal de referencia (UT en Argentina, UMA en México), y permite consultar el listado de todos los pagos procesados en la plataforma. Una vez configurado, los trámites pueden referenciar conceptos del catálogo y los precios se actualizan globalmente al editar el valor anual de la unidad.
Audiencia: funcionarios con rol superadministrador o administrador (configuración) + operador (consulta de la lista de pagos).
Cuándo aplicar: al armar la operación financiera de la plataforma, al inicio de cada año fiscal (actualizar UT/UMA), al sumar conceptos nuevos, o para consultar el estado de los pagos procesados.
Configuración del Módulo de pagos
Introducción
Esta funcionalidad es el centro de comando donde se definen las reglas económicas de la plataforma. Su propósito es triple:
| Objetivo | Qué resuelve |
|---|---|
| Estandarización | Crear un catálogo único de conceptos (qué se cobra) y unidades de valor (cuánto vale la moneda fiscal). |
| Automatización | Permitir que los trámites calculen costos automáticamente, en pesos o en unidades tributarias (UT o UMA), evitando errores humanos y discrepancias. |
| Trazabilidad | Consultar el listado completo de pagos procesados, con filtros por estatus y rango de fechas. |
Una correcta configuración asegura una recaudación transparente y eficiente.
Roles involucrados
| Rol | Qué hace |
|---|---|
| Superadministrador / Administrador | Acceso total a configuración y catálogo. Crea, edita y elimina las reglas financieras. |
| Operador | Interactúa con la lista de pagos. Ve estatus de transacciones (pagado, pendiente, rechazado, etc.), filtra por fechas y descarga reportes. No configura valores. |
| Ciudadano | No ve este módulo. Ve el resultado: cuando inicia un trámite, el sistema le muestra el costo exacto basado en el concepto y el valor de la UT/UMA vigentes. |
Cómo acceder
Ve a la barra lateral izquierda y haz clic en “Pagos”. El módulo tiene dos sub-pestañas:
| Sub-pestaña | Para qué |
|---|---|
| Lista de pagos | Consultar el historial de todos los pagos procesados. |
| Configuración | Definir UT/UMA y catálogo de conceptos. |
Esta página cubre ambas. Empieza por Configuración (lo que se arma una sola vez) y al final documenta Lista de pagos (consulta operativa diaria).
Configuración del módulo
Al entrar a “Configuración”, el panel izquierdo muestra el encabezado “Módulo Pagos” con dos opciones:
| Opción | Para qué |
|---|---|
| Configuración Pagos | Gestiona las unidades tributarias (UT/UMA). |
| Catálogo de conceptos | Crea los ítems que se van a cobrar. |
Gestión de Unidades Tributarias (UT / UMA)
Dependiendo del país, vas a trabajar con Unidades Tributarias (UT) en Argentina o Unidades de Medida y Actualización (UMA) en México. Estas unidades permiten que los precios se actualicen globalmente sin editar cada trámite uno por uno.
Con la opción “Configuración Pagos” seleccionada, la pantalla muestra el formulario “Valor de la UT” y la tabla “Historial de la UT” a la derecha.
💡 Cálculo automático: “El valor mensual de la UT se calcula multiplicando su valor diario por 30.4 veces y su valor anual se calcula multiplicando su valor mensual por 12.” Solo cargas Año + Valor diario; el sistema completa los otros dos automáticamente.
Agregar un nuevo año de UT/UMA
-
En el formulario “Valor de la UT” completa los dos campos editables:
Campo Qué define Año de la UT Año fiscal de vigencia. Valor diario de la UT Cuánto vale 1 unidad por día. Los campos Valor mensual de la UT y Valor anual de la UT se calculan automáticamente.
-
Haz clic en “Agregar”. El nuevo valor aparece inmediatamente en la tabla “Historial de la UT” con columnas Año / Diario / Mensual / Anual y los íconos de Editar y Eliminar por fila.
Editar un valor existente
Si la ley fiscal cambia o hubo un error de tipeo:
-
En la tabla “Historial de la UT” ubica el año a corregir.
-
Haz clic en el ícono de lápiz (Editar) de la fila. Se abre la ventana “Editar el valor de la UT” con los mismos cuatro campos del formulario (los dos automáticos siguen siendo solo de lectura).
-
Modifica los valores y haz clic en “Guardar”.
Eliminar un valor
- En la tabla “Historial de la UT” ubica el año a borrar.
- Haz clic en el ícono de papelera (Eliminar) de la fila.
- Confirma la acción.
Gestión del catálogo de conceptos
Acá se crean los ítems cobrables (ej. tasa de habilitación, derecho de oficina).
Con la opción “Catálogo de conceptos” seleccionada en el panel izquierdo, la pantalla muestra:
- Botón “Nuevo concepto” en la esquina superior derecha.
- Buscador “Buscar por nombre de concepto” con ícono de lupa.
- Íconos auxiliares: goma (Limpiar filtros) e ícono de descarga (Descargar).
- Tabla con las columnas Clave / Concepto / Descripción / Pago / Tipo costo / Monto / Monto mínimo / Monto máximo / Acciones.
Crear un nuevo concepto
-
Haz clic en “Nuevo concepto” en la esquina superior derecha. Se abre la ventana “Nuevo concepto”.
-
Completa los campos:
Campo Qué define Clave Se genera automáticamente. Es el ID del concepto. Concepto Nombre visible (ej. Renovación de licencia). Descripción Detalle breve para referencia interna o externa. Pago Moneda. Default: Pesos. Alternativa: unidades tributarias (UT/UMA). Tipo costo Fijo (precio único) o Variable (rango con mínimo y máximo). Monto mínimo Solo aparece si eliges Variable. Monto inferior del rango. Monto máximo Solo aparece si eliges Variable. Monto superior del rango. -
Haz clic en “Guardar”.
⚠️ Validación de costo Variable: si dejas el monto mínimo mayor o igual al máximo, la plataforma muestra el error “El monto mínimo debe ser menor que el monto máximo” y no permite guardar.
Editar un concepto
-
En la tabla del catálogo, busca el concepto.
-
Haz clic en el ícono de lápiz (Editar) de la columna “Acciones”. Se abre la ventana “Editar concepto” con los mismos campos del alta.
-
Modifica los valores y haz clic en “Guardar”.
Eliminar un concepto
-
En la tabla del catálogo, ubica el concepto.
-
Haz clic en el ícono de papelera (Eliminar) de la columna “Acciones”.
-
La plataforma pide confirmación con el mensaje “¿Estas seguro que quieres borrar este elemento?”. Haz clic en “Continuar” para confirmar o “Cancelar” para volver.
Lista de pagos
Sub-pestaña “Lista de pagos” del módulo. Muestra el historial de todos los pagos procesados por la plataforma — los que el ciudadano pagó vía pasarela y los que se cancelaron, rechazaron, quedaron pendientes o terminaron en disputa. Es la herramienta diaria del operador para conciliar transacciones y descargar reportes.
Componentes
- Tarjeta “Total de pagos” con contador en la parte superior.
- Cuatro buscadores principales: “Buscar por folio”, “Buscar por CUIT”, “Buscar por padrón o nombre” y “Buscar por transacción”.
- Ícono de filtro (Abrir filtros) que expande la sección de filtros avanzados (Status + Rango de fechas) en la misma página.
- Íconos auxiliares: goma (Limpiar filtros) y descarga (Descargar).
- Listado de pagos con los registros encontrados o el estado vacío “Sin registro” cuando no hay coincidencias.
Aplicar filtros avanzados
Al hacer clic en el ícono de filtro, se expande una sección con dos controles:
| Control | Qué filtra |
|---|---|
| Estatus | Lista desplegable con los estados posibles: Pagado / Rechazado / Pendiente / Autorizado / En proceso / En disputa / Cancelado / Pago devuelto / Pago con contracargo / Creado, entre otros. |
| Rango de fechas | Período de pagos a mostrar. |
Haz clic en “Buscar” para aplicar los filtros. La lista se actualiza con los pagos que coinciden con los criterios seleccionados.
Descargar reporte
Haz clic en el ícono de descarga para exportar el listado actual (con los filtros aplicados) a un archivo descargable.
Tips y recomendaciones
Antes de configurar
- Ten la ordenanza fiscal a mano: no adivines los valores. Ten el documento legal del año en curso para cargar el valor diario exacto de la UT/UMA. El mensual y el anual se calculan solos.
- Planifica tus conceptos: antes de crear conceptos sin orden, agrúpalos. Si tres trámites cobran lo mismo por la misma razón, usa un solo concepto reutilizable.
Durante la configuración
- Nombres descriptivos: en el campo Descripción, sé claro. Ayuda a otros administradores a saber para qué sirve ese cobro en el futuro.
- Verifica la moneda: mucho cuidado al elegir entre Pesos y UT/UMA. Si eliges UT/UMA, el precio fluctúa automáticamente cuando actualizas el valor del año; si eliges pesos, queda fijo y vas a tener que editarlo manualmente si hay inflación.
Durante la operación (Lista de pagos)
- Filtros antes de descargar: el reporte exporta lo que ves en pantalla. Si quieres solo los pagos del último mes, aplica el filtro de fecha antes de hacer clic en descargar.
- Limpieza de filtros: si no encuentras un pago que sabes que existe, haz clic en la goma para descartar filtros que estén ocultando registros.
Después de configurar
- Auditoría anual: al inicio de cada año fiscal, tu primera tarea tiene que ser ir a Configuración Pagos y agregar el nuevo año de la UT/UMA. Esto actualiza automáticamente todos los trámites vinculados.
Errores comunes y cómo evitarlos
| Error | Causa | Solución |
|---|---|---|
| No puedo agregar la UT/UMA del año X. | Ya existe un registro para ese año. | No intentes agregar uno nuevo. Ve al historial, busca el año y usa el ícono de lápiz para editar los valores. |
| No puedo eliminar un concepto. | El sistema protege la integridad: no se puede eliminar si está vinculado a un trámite activo o si hay una solicitud abierta usándolo. | 1. Desvincula el concepto de la configuración del trámite. 2. Asegúrate de que no haya solicitudes pendientes de pago con ese concepto. 3. Intenta eliminar nuevamente. |
| Error “El monto mínimo debe ser menor que el monto máximo”. | Cargaste un costo Variable con mínimo igual o mayor al máximo. | Revisa los valores. El mínimo siempre tiene que ser estrictamente menor que el máximo. |
| No aparece ningún pago en el listado. | Filtros activos restrictivos o no hay pagos en el rango seleccionado. | Haz clic en la goma para limpiar filtros y verifica el rango de fechas. |
Glosario técnico
- Clave: código único e inmutable que identifica a un concepto dentro de la base de datos. Sirve para integraciones con sistemas contables externos.
- UMA (Unidad de Medida y Actualización): referencia económica en pesos para determinar la cuantía del pago de obligaciones en México.
- UT (Unidad Tributaria): similar a la UMA, utilizada en Argentina para fijar tasas e impuestos que se actualizan por inflación.
- Costo variable: configuración que permite definir el monto final a pagar en el momento de la transacción, siempre respetando los límites preestablecidos (Monto mínimo y Monto máximo).
- Estatus de pago: estado del ciclo de vida de una transacción (Pagado, Rechazado, Pendiente, Autorizado, En proceso, En disputa, Cancelado, Pago devuelto, Pago con contracargo, Creado).
Ver también
Antes de configurar:
- Configuración general — reglas globales de la plataforma.
Después de configurar:
- Pagos — suma la etapa de pagos a un trámite.
Relacionados:
- Whitelist — probar el cobro antes de publicar.
- Registro de cambios — auditar cambios en conceptos y UT/UMA.