Asignaciones

El módulo de asignaciones permite configurar los campos de importación, crear plantillas reutilizables, y ejecutar la carga de carteras al sistema.

Estructura del Módulo

Campos de Importación

Configuración del catálogo maestro de campos disponibles para la importación de asignaciones.

¿Qué son los Campos de Importación?

Son los "contenedores" de datos que el sistema reconoce. Cada campo tiene:

Propiedad	Descripción
Nombre	Identificador interno (ej: TotalAdeudo)
Etiqueta	Nombre legible (ej: "Total Adeudo")
Tipo de dato	String, Integer, Decimal, Date
Obligatorio	Si es requerido para cada importación
Aliases	Variaciones de nombre para mapeo automático
Categoría	Agrupación lógica (Financiero, Contacto, etc.)

Administración de Campos

El Admin puede:

• Agregar nuevos campos al catálogo
• Editar propiedades de campos existentes
• Activar/desactivar campos
• Exportar e importar el catálogo en bulk
• Reorganizar el orden de visualización

:::info Sin Migraciones A diferencia de la tabla Accounts (schema fijo), las Asignaciones usan un schema dinámico basado en este catálogo. Agregar un campo nuevo no requiere migración SQL. :::

Acceso:

• Ruta: /asignaciones/campos
• Permiso: page:asignaciones:campos
• Roles: Solo Admin

Plantillas de Asignación

Plantillas reutilizables que guardan la configuración de mapeo entre columnas de un archivo y campos del sistema.

¿Para qué sirven?

Cuando un cliente envía archivos siempre con el mismo formato (mismas columnas en el mismo orden), puedes guardar una plantilla para no tener que mapear las columnas cada vez.

Gestionar Plantillas

1. Ir a Asignaciones → Plantillas
2. Ver el listado de plantillas existentes por cliente
3. Crear nueva, editar o eliminar plantillas

Información de una Plantilla

Campo	Descripción
Nombre	Identificador legible (ej: "Cetelem - Formato Q2 2026")
Cliente	A qué cartera pertenece
Tipo de archivo	txt, xls, xlsx
Delimitador	Para archivos txt (tabulador, pipe)
Con encabezado	Si la primera fila es header
Mapeos	Lista de columna → campo
Uso	Cuántas veces se ha utilizado
Última vez usada	Fecha del último uso

Acceso:

• Ruta: /asignaciones/plantillas
• Permiso: page:asignaciones:plantillas
• Roles: Admin, Supervisor

Importar Asignaciones

Ejecución de la importación de cuentas usando una plantilla configurada o mapeo manual.

Flujo

Resultado de la Importación

Las cuentas importadas se almacenan en la tabla Asignaciones con:

• AccountIdentifier: Valor mapeado al campo "AccountId" del catálogo
• CustomerId: Cliente destino
• Data: JSON con todos los campos mapeados
• ImportJobId: Referencia al job de importación

Si ya existe una cuenta con el mismo AccountIdentifier + CustomerId, los datos se actualizan (merge del JSON).

Acceso:

• Ruta: /asignaciones/importar
• Permiso: page:asignaciones:importar
• Roles: Admin, Supervisor