Importación de Cuentas
Permite cargar archivos con datos de cuentas/integrantes para asignar a los ejecutivos de cobranza. El sistema soporta archivos Excel (.xlsx, .xls) y texto delimitado (.txt), con mapeo inteligente de columnas y procesamiento en background.
Flujo Completo de Importación
Paso a Paso
1. Subir Archivo
- Ir a Gestión de Cuentas → Importación de Cuentas
- Seleccionar el cliente/cartera destino
- Hacer clic en "Seleccionar archivo" o arrastrar el archivo
- Formatos soportados:
.txt(tabulado),.xls,.xlsx - Tamaño máximo: 50 MB
2. Análisis Automático
El sistema detecta automáticamente:
- Tipo de archivo y delimitador
- Codificación (UTF-8, Latin-1)
- Número de columnas
- Presencia de fila de encabezado
- Muestra de las primeras filas para vista previa
3. Mapeo Inteligente
El sistema sugiere mapeos automáticos usando:
- Coincidencia por nombre — "Nombre" → Campo
NombreCompleto - Alias configurados — "Tel" → Campo
TelPrincipal - Plantillas guardadas — Si existe una plantilla para este cliente/formato
:::tip Plantillas de Mapeo Si importas archivos del mismo formato frecuentemente (ej: mismo banco), guarda la configuración como plantilla. La próxima vez se aplicará automáticamente. :::
4. Revisión y Ajuste
- Se muestra una tabla con cada columna del archivo y su campo destino sugerido
- Las sugerencias con alta confianza se marcan en verde
- Puedes modificar cualquier mapeo manualmente
- Las columnas sin mapeo se ignoran en la importación
5. Validación
Antes de importar, el sistema valida los datos según el tipo de cada campo:
| Tipo de Campo | Validación | Ejemplo Válido | Ejemplo Inválido |
|---|---|---|---|
| Fecha | Formatos ISO, DD/MM/YYYY, MM/DD/YYYY | 2024-01-15 | 32/13/2024 |
| Decimal | Numérico con hasta 2 decimales | $1,234.56 | abc |
| Entero | Números enteros | 42 | 42.5 |
| AccountId | Mínimo 5 caracteres | ACC12345 | A1 |
| Texto | Longitud máxima según campo | Juan Pérez | (>255 chars) |
6. Procesamiento en Background
- Se crea un ImportJob con estado "pending"
- El Worker procesa cada registro:
- Upsert: Si la cuenta ya existe (mismo AccountId + CustomerId), se actualiza
- Create: Si no existe, se crea nueva
- Se genera un registro de auditoría por cada campo modificado
- Progreso visible en tiempo real
7. Resultado
| Indicador | Significado |
|---|---|
| ✅ Creados | Cuentas nuevas insertadas |
| 🔄 Actualizados | Cuentas existentes modificadas |
| ❌ Fallidos | Registros con errores de validación |
Los registros fallidos se pueden descargar como reporte CSV con detalle del error por campo.
Plantillas de Mapeo
Crear Plantilla
- Después de configurar un mapeo exitoso, hacer clic en "Guardar como Plantilla"
- Asignar un nombre descriptivo (ej: "Sears - Formato Mensual")
- La plantilla queda disponible para futuras importaciones del mismo cliente
Usar Plantilla Existente
- Al subir un archivo, si existe una plantilla compatible se sugiere automáticamente
- También puedes seleccionar una plantilla manualmente antes de subir
- Los mapeos de la plantilla se aplican instantáneamente
Administrar Plantillas
- Ruta:
/asignaciones/plantillas - Ver, editar o eliminar plantillas existentes
- Cada plantilla está vinculada a un cliente específico
Campos del Sistema
Los campos disponibles para importación se definen en el Catálogo de Campos (/asignaciones/campos), que incluye:
- Datos financieros (Saldo, Adeudo, Pagos, etc.)
- Datos personales (Nombre, Teléfono, Dirección, etc.)
- Datos del crédito (Contrato, Producto, Fechas, etc.)
- Referencias (Aval, Referencias personales)
:::info Campos Dinámicos El sistema de Asignaciones usa un catálogo de campos configurable. Nuevos campos pueden agregarse sin necesidad de migraciones de base de datos. :::
Acceso
| Propiedad | Valor |
|---|---|
| Ruta | /accounts/import |
| Permiso | page:accounts:import |
| Roles por defecto | Admin, Supervisor |
| APIs involucradas | api:accounts:import, api:import:analyze, api:import:suggest-mappings, api:import:validate-mappings |