Compras de Cuotas — Crowdfunding

Requisitos previos de acceso

• Permiso (módulo): viewCrowdfunding (para abrir la pantalla). Aprobar/cancelar una orden requiere adicionalmente el módulo approveTransactions.
• Licencia/Feature: CROWDFUNDING
• Contenedor del menú: GENERAL → grupo Inversiones / Distribuciones Financieras

Qué es / cuándo usar

El crowdfunding es financiamiento colectivo: varios inversores realizan aportes a un proyecto y reciben cuotas proporcionales. Esta pantalla lista todas las órdenes de compra de cuota realizadas por los usuarios, por proyecto. El operador la utiliza para aprobar o cancelar órdenes pendientes, investigar el perfil del inversor (datos de adecuación/suitability) y exportar la base para conciliación o compliance.

Requisitos previos

• Permiso: viewCrowdfunding para visualizar; approveTransactions para aprobar/cancelar (ambos son dobles — enum CPM en el backend + módulo en la DB). Sin approveTransactions, las acciones de aprobación/cancelación en el detalle de la orden no están disponibles.
• Licencia/Feature: CROWDFUNDING habilitada en la licencia del tenant (Vault); de lo contrario el ítem no aparece en el menú.
• Dependencias: proyectos de crowdfunding ya registrados; órdenes creadas por los inversores.

Paso a paso

1. Acceda a Inversiones → Compras de Cuotas - Crowdfunding (ruta /manage-crowdfunding-orders).
2. Utilice la búsqueda (por nombre/apellido/ID del usuario) y el filtro de proyecto para localizar las órdenes.
3. Haga clic en una orden para abrir los detalles.
4. En el detalle, con el permiso approveTransactions, apruebe o cancele la orden.
5. Opcionalmente, exporte el CSV para conciliación.

Filtros y columnas

Filtro / Columna	Qué muestra	Origen del dato
Búsqueda (texto)	Filtra por ID, nombre o apellido del usuario (debounce 300 ms)	Cruce local → userIds en la consulta
Proyecto	Filtra por proyecto de crowdfunding (Todos por defecto)	projectIds en la consulta
Fecha/hora	Cuándo se creó la orden	created_at
Nombre / E-mail	Identificación del inversor	Cruce con la lista de usuarios
Proyecto	Proyecto de la cuota comprada	Cruce con la lista de proyectos
Monto	Importe aportado	amount de la orden (BigNumber)
Estado	CREATED/FINISHED/CANCELLED etc.	status de la orden

Acciones y modales

• Abrir detalles: muestra datos del inversor (documento, dirección, banco) y los campos de adecuación a la inversión (inversor calificado, ingreso mensual, patrimonio, porcentaje en crowdfunding, etc.).
• Aprobar / Cancelar (en el detalle): disponible con approveTransactions. Se confirma mediante bottom-sheet y llama a updateCrowdfundingOrder cambiando el status (APPROVED/CANCELLED). Si la operación es exitosa, la página se recarga.
• Exportar CSV: genera un archivo con fecha, nombre, e-mail, documento, dirección, banco, monto, estado y los campos de suitability (inversor calificado, grandes inversiones, ingreso mensual, activos reales, inversiones financieras, inmuebles, bienes muebles, otros).

Reglas de negocio / advertencias

Atención

• Las acciones de aprobar/cancelar dependen del módulo approveTransactions — sin él la pantalla es solo de consulta.
• El CSV incluye datos de adecuación a la inversión (suitability), utilizados para el compliance de la oferta — trate el archivo como dato sensible.

Irreversible

• La aprobación consolida la participación del inversor en la captación. Una vez confirmada, la cancelación implica reversión conforme a las reglas del proyecto.

• Valores financieros: amount se trata como BigNumber, sin redondeo.
• Invariante captado ↔ cuotas: la emisión de cuotas (NFTs) de un proyecto de crowdfunding es exclusiva del job de crowdfunding — aprobar la orden aquí no mintea un NFT directamente. Esto garantiza por construcción que el monto captado corresponda a la suma de las cuotas emitidas; la conciliación orden × cuota es responsabilidad del job, no de emisión manual vía BackOffice.
• Estado APPROVED: la aprobación presupone que el usuario-inversor está aprobado para operar financieramente.

Pantallas relacionadas

• Solicitudes de Préstamos
• Distribución
• Financiero