Módulo 2 · Importa tu cartera

Read in English: Module 2 · Import your portfolio.

Objetivo: subir tu CSV de cuentas, mapear las columnas, leer el reporte de teléfonos E.164 y entender el dedupe — sin duplicar ni perder registros. Tiempo: ~10 minutos · Antes: Módulo 1.

Tu cartera vive en el CMS o en el Excel que te mandó el cliente. Aquí la convertimos en cuentas marcables, con las llaves correctas para que el cumplimiento cuente bien desde el día uno.

1. Abre Deudas y suelta tu archivo

Ve a Deudas y arrastra tu CSV a la zona de carga:

Sirve el CSV tal como sale de Excel (acentos, comas dentro de comillas, BOM — todo eso se tolera). Si una fila tiene más o menos columnas que el encabezado, el mapeador te lo reporta en vez de desalinear datos en silencio.

2. El mapeador: dile qué es cada columna

El sistema lee tus encabezados y los primeros renglones, y propone el mapeo. Tú confirmas o corriges:

Los destinos que importan de verdad:

Columna destino	Qué es	Por qué importa
External ref (número de cuenta)	La llave única de la deuda.	Es la llave Reg F: el contador 7-en-7 cuenta por esta referencia. Si la cambias entre importaciones, duplicas cuentas y rompes los contadores.
Consumer ref	La llave de la persona.	La analítica de penetración deduplica por persona con esta llave. Si no la mapeas, cada cuenta cuenta como una persona distinta (1 cuenta = 1 persona, política explícita).
Teléfono primario / secundario	Los números a marcar.	Pasan por validación E.164 (paso 3).
Tipo de línea, estado, ciudad, zona horaria	Datos del contacto.	Los gates de cumplimiento los usan (horario local del consumidor, reglas estatales).
Saldo, moneda, tipo de deuda	Datos de la cuenta.	Lo que ven tus gestores y tus reportes.

"Nombre del deudor" aparece deshabilitado

El destino Debtor full name se muestra con chip pending: la versión actual todavía no almacena nombres, así que ese valor no se envía (en lugar de fingir que se guardó). Mapéalo cuando el campo exista.

¿Importas el mismo formato cada mes? Guarda el mapeo como plantilla — se reaplica solo cuando el sistema reconoce los mismos encabezados. Las plantillas se guardan en el servidor: todo tu equipo y cualquier navegador ven las mismas; al editar una se conservan sus versiones anteriores y la importación registra la versión que usó. Las plantillas que tu navegador guardaba antes se ofrecen para pasarlas al servidor una sola vez.

3. El reporte E.164: teléfonos que sí marcan

Antes de importar, cada teléfono se valida al formato internacional E.164 (+13125551001). El reporte separa tres montones:

1. Válidos — entran tal cual.
2. Reparados — el sistema pudo normalizarlos (por ejemplo (312) 555-1001 → +13125551001). Revisa la muestra; entran ya normalizados.
3. Inválidos — no se pueden marcar. No bloquean la importación: descarga el exceptions.csv, corrígelos con tu cliente y reimporta solo esos.

Seguridad en la hoja de cálculo: en el exceptions.csv y en el CSV de filas rechazadas, una celda que empieza por =, +, -, @, un tabulador, un retorno de carro, un salto de línea, o los equivalentes de ancho completo ＝, ＋, －, ＠ se neutraliza: se entrega con un ' delante, de modo que Excel o Sheets la muestren como texto y nunca la ejecuten como fórmula. El prefijo forma parte de la celda: quítalo antes de reimportar.

El motor exige E.164 a nivel de base de datos: un teléfono mal formado no puede entrar. Mejor enterarte aquí, con un CSV de excepciones en la mano, que perder intentos en el piso.

4. La vista de dedupe: filas → cuentas → personas

Antes del botón final ves el resumen: cuántas filas trae el archivo, en cuántas cuentas se agrupan (por external ref) y cuántas personas son (por consumer ref).

• La importación es idempotente: las cuentas se actualizan por external ref y los teléfonos por número. Reimportar el mismo archivo no duplica nada — actualiza.
• Por eso el mismo archivo dos veces = mismos números en la vista previa. Si la cuenta de "cuentas" no te cuadra, casi siempre es una columna de external ref mal mapeada.

5. Importa

Clic en Importar. El archivo sube por bloques y el resultado es registro por registro: si 3 filas de 5 000 vienen mal, entran 4 997 y las 3 fallidas se reportan con su número de fila y motivo — nada de "todo o nada" a ciegas.

6. Devuelve el retorno a tu sistema

La cartera entra por Deudas, y el resultado del trabajo sale por el mismo sitio. La tarjeta Retorno de intentos está siempre visible — no hace falta tener un archivo cargado — y descarga el historial de intentos de un rango de fechas para devolverlo a tu sistema:

1. Elige el rango con desde y hasta. Los días van en UTC, y la fecha final puede caer como mucho 31 días después de la inicial; un rango más largo se avisa en pantalla y ni se pide.
2. Clic en Exportar CSV. El archivo trae una fila por intento con su resultado final, de todas las campañas.
3. Si algo falla por el camino — cancelas, el servidor rechaza el rango o la descarga no llega íntegra — no se descarga ningún fichero. Nunca te quedas con un CSV a medias que parezca completo.

La misma protección rige en este archivo: una celda que empieza por =, +, -, @, un tabulador, un retorno de carro, un salto de línea, o los equivalentes de ancho completo ＝, ＋, －, ＠ también se neutraliza y sale con un ' delante.

El envío automático por SFTP aún no existe

Debajo verás Envío nocturno programado por SFTP con su casilla desactivada y el chip aún no disponible: se muestra desactivado, no se finge. Mientras tanto, el retorno se descarga a mano por rango de fechas.

7. Encuentra una cuenta desde cualquier pantalla

Cuando un deudor llama o escribe, necesitas llegar a su cuenta en segundos, desde donde estés. La búsqueda global de la barra superior lo hace sin pasar por el listado de Deudas. Está arriba, en todas las pantallas, y responde al atajo / (o Ctrl/Cmd+K). El / es un atajo de una sola tecla y cada agente puede apagarlo en Configuración → Atajos de teclado («Atajos de una sola tecla (1–9 y 0 en el cierre, / para buscar)»; se guarda por agente, en ese navegador). Con el ajuste apagado, Alt+/ sigue enfocando la búsqueda: funciona siempre.

• Busca solo cuentas. Si lo tecleado tiene forma de teléfono (y normaliza a E.164), consulta por phone; si es texto, por consumer_ref y por external_ref. No busca por nombre del deudor: la plataforma no sirve esa búsqueda y la barra no la inventa.
• Arranca con 3 caracteres. Por debajo no pregunta nada a la plataforma; a partir de ahí, con un pequeño retardo mientras tecleas, trae como máximo 10 resultados, deduplicados por cuenta.
• Enter o un clic abre el detalle de esa cuenta.
• Estados honestos. Cargando, sin resultados y error de plataforma se muestran como son; un fallo de la plataforma se ve como error, nunca como una lista vacía que parezca "no hay nada".

La búsqueda respeta el alcance de tu llave: solo ve las cuentas que tu sede y tu tenant ya pueden ver en el listado.

Ponte a prueba

1. ¿Cuál es la columna que alimenta el contador Reg F 7-en-7: el consumer ref o el external ref?
2. Tu archivo trae 40 teléfonos inválidos. ¿Se cae la importación?
3. Reimportas el mismo CSV de ayer completo. ¿Cuántas cuentas nuevas se crean?

Respuestas

1. El external ref (número de cuenta): Reg F cuenta por deuda. El consumer ref agrupa por persona para la analítica.
2. No. Importa lo válido y te da un exceptions.csv con los 40 para corregir y reimportar.
3. Cero. La importación es idempotente: actualiza por external ref / teléfono, no duplica.

Siguiente: Módulo 3 · Tu primera campaña →