> ## Documentation Index
> Fetch the complete documentation index at: https://docs.isprop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar Leads

> Las 31 columnas admitidas para importar contactos y oportunidades desde CSV o Excel.

## Antes de comenzar

Ingresá al tenant correcto con un usuario habilitado para importar. En el CRM, abrí la importación de contactos y oportunidades; en Nova, utilizá **Importar leads**. Ambos accesos usan el mismo formato y crean o actualizan el contacto junto con su oportunidad.

## Preparar el archivo

Se aceptan CSV, XLS y XLSX. La primera fila debe contener los encabezados exactos que se listan debajo, sin traducirlos. Las únicas columnas obligatorias son **email, nombre y apellido**. Cada fila debe tener esos tres valores y un email válido, sin duplicados dentro del archivo.

[Descargar plantilla CSV completa](data:text/csv;charset=utf-8,%EF%BB%BFemail%2Cnombre%2Capellido%2Ctelefono%2Cidentificacion%2Ccuit%2Crazon_social%2Ccargo%2Cdescripcion%2Cfecha_nacimiento%2Cestado_civil%2Ccanal%2Cproyecto%2Cproducto%2Csku%2Casignado_a%2Cestado%2Ctemperatura%2Ccampana%2Corigen%2Cnotas%2Crazon_perdida%2Cvalor_estimado%2Cprobabilidad%2Cpuntuacion%2Cproximo_seguimiento%2Cultimo_contacto%2Cconvertido_en%2Cfecha_cierre_estimada%2Ccreado_el%2Cetiquetas%0Alucia.rios%40example.com%2CLuc%C3%ADa%2CR%C3%ADos%2C%2B54%209%20351%20000%200101%2C99000101%2C27-99000101-0%2CHorizonte%20Ejemplo%20SRL%2CArquitecta%2CContacto%20ficticio%20interesado%20en%20vivienda%20familiar%2C1991-04-18%2Csoltero%2CSitio%20web%2CAltos%20del%20Horizonte%2CTorre%20Jacarand%C3%A1%2CDEMO-HOR-0302%2Cvendedor.demo%40example.com%2Ccontactado%2Ccaliente%2CPrimavera%20Horizonte%202026%2CFormulario%20de%20la%20web%2CSolicita%20visita%20por%20la%20tarde%2C%2C128500.50%2Calta%2C85%2C2026-11-06%2016%3A00%2C2026-11-03%2010%3A30%2C%2C2026-12-15%2C2026-11-01%2009%3A00%2CInversi%C3%B3n%7CVisita%20pendiente%0Amateo.luna%40example.com%2CMateo%2CLuna%2C%2B54%209%20351%20000%200102%2C99000102%2C20-99000102-0%2CLuna%20Ejemplo%20SAS%2CDise%C3%B1ador%2CContacto%20ficticio%20interesado%20en%20vivienda%20familiar%2C1988-08-12%2Ccasado%2CSitio%20web%2CAltos%20del%20Horizonte%2CTorre%20Jacarand%C3%A1%2CDEMO-HOR-0302%2Cvendedor.demo%40example.com%2Cconvertido%2Ccaliente%2CPrimavera%20Horizonte%202026%2CFormulario%20de%20la%20web%2COperaci%C3%B3n%20ficticia%20concretada%2C%2C128500.50%2Calta%2C85%2C%2C2026-11-03%2010%3A30%2C2026-11-02%2012%3A00%2C2026-12-15%2C2026-11-01%2009%3A00%2CCliente%7CInversi%C3%B3n%0A)

La plantilla incluye las **31 columnas** y dos personas ficticias. Los nombres, documentos, teléfonos, direcciones de email, importes y relaciones son de ejemplo. Reemplazá proyecto, producto, SKU y vendedor por valores existentes en tu tenant. La columna `razon_perdida` está incluida y vacía porque las oportunidades de ejemplo no están perdidas.

## Lista completa de columnas

| Columna | Obligatoria | Formato y comportamiento | Ejemplo |
| - | - | - | - |
| `email` | **Sí** | Email válido del contacto; identifica altas y actualizaciones. No repetir dentro del archivo. | `lucia.rios@example.com` |
| `nombre` | **Sí** | Nombre del contacto. | `Lucía` |
| `apellido` | **Sí** | Apellido del contacto. | `Ríos` |
| `telefono` | No | Teléfono como texto, con prefijo internacional. | `+54 9 351 000 0101` |
| `identificacion` | No | Documento como texto; conservar ceros iniciales. | `99000101` |
| `cuit` | No | CUIT como texto. | `27-99000101-0` |
| `razon_social` | No | Razón social del contacto o empresa. | `Horizonte Ejemplo SRL` |
| `cargo` | No | Cargo o puesto laboral. | `Arquitecta` |
| `descripcion` | No | Descripción del contacto. | `Contacto ficticio interesado en vivienda familiar` |
| `fecha_nacimiento` | No | Fecha de nacimiento, preferentemente `YYYY-MM-DD`. | `1991-04-18` |
| `estado_civil` | No | `soltero`, `casado`, `divorciado`, `viudo`, `union_convivencial`. También admite sus etiquetas visibles. | `soltero` |
| `canal` | No | ID, nombre o key del canal, sin distinguir mayúsculas. Si no existe se crea. | `Sitio web` |
| `proyecto` | No | Nombre de un proyecto existente. Debe coincidir con el catálogo del tenant. | `Altos del Horizonte` |
| `producto` | No | Nombre de un producto existente. Evitar nombres repetidos entre proyectos. | `Torre Jacarandá` |
| `sku` | No | SKU de una unidad existente, sin distinguir mayúsculas. Usá el SKU, no el UUID de la referencia API. | `DEMO-HOR-0302` |
| `asignado_a` | No | Email (recomendado), ID o nombre exacto de un vendedor activo. | `vendedor.demo@example.com` |
| `estado` | No | `nuevo`, `contactado`, `presupuestado`, `cotizado`, `convertido`, `dormido`, `descalificado`, `muerto`. También admite etiquetas visibles. | `contactado` |
| `temperatura` | No | `frio`, `tibio`, `caliente`; también admite sus etiquetas visibles. | `caliente` |
| `campana` | No | Nombre de campaña comercial. | `Primavera Horizonte 2026` |
| `origen` | No | Origen de la consulta. | `Formulario de la web` |
| `notas` | No | Notas de la oportunidad. | `Solicita visita por la tarde` |
| `razon_perdida` | No | Nombre o key de una razón de pérdida existente; si no coincide se ignora. | Vacío si no aplica |
| `valor_estimado` | No | Importe numérico sin símbolo monetario ni separador de miles. | `128500.50` |
| `probabilidad` | No | `baja`, `media` o `alta`. | `alta` |
| `puntuacion` | No | Entero entre 0 y 100; valores fuera de rango se limitan a ese rango. | `85` |
| `proximo_seguimiento` | No | Próximo seguimiento: `YYYY-MM-DD HH:MM`. | `2026-11-06 16:00` |
| `ultimo_contacto` | No | Último contacto: `YYYY-MM-DD HH:MM`. | `2026-11-03 10:30` |
| `convertido_en` | No | Fecha de conversión, cuando corresponda. No cambia por sí sola el estado. | Vacío si no aplica |
| `fecha_cierre_estimada` | No | Fecha estimada de cierre: `YYYY-MM-DD`. | `2026-12-15` |
| `creado_el` | No | Fecha de alta histórica: reemplaza la fecha de creación incluso al actualizar. | `2026-11-01 09:00` |
| `etiquetas` | No | Separar con pipe: `Inversión\|Visita pendiente`. Al informarlas se sincronizan las etiquetas del lead. | `Inversión\|Visita pendiente` |

## Fechas y números

Para las fechas usá `YYYY-MM-DD` o `YYYY-MM-DD HH:MM` (por ejemplo `2026-11-06 16:00`). También se aceptan fechas seriales numéricas de Excel. Una fecha que no se puede interpretar queda sin valor: revisalas antes de importar. Usá punto decimal en importes y guardá teléfonos, documentos y CUIT como texto para evitar que Excel los reformatee.

## Relaciones, asignación y valores por defecto

* **Canal:** admite ID, nombre o key. Si el nombre no existe se crea. En altas sin canal busca primero Directo, luego Otros; si ninguno existe crea Otros.
* **Proyecto y producto:** deben existir; no se crean desde este importador. Los nombres se buscan sin distinguir mayúsculas. Si no coinciden, no se vinculan. Para evitar ambigüedad usá nombres únicos de producto.
* **Unidad:** se busca por SKU. Comprobá que corresponda al proyecto y producto elegidos.
* **Vendedor:** se busca solo entre usuarios activos. Un vendedor inexistente o inactivo genera un aviso y se ignora esa columna. Si una oportunidad existente tiene un vendedor inactivo y no se informa otro válido, intenta reasignarla mediante las reglas configuradas; si no puede, conserva el anterior y avisa.
* **Estado:** al crear, vacío o desconocido usa `nuevo`. Al actualizar, vacío conserva el estado; un valor desconocido no vacío lo cambia a `nuevo`.
* **Temperatura:** un valor informado pero desconocido se convierte en `tibio`. Usá los valores de la tabla.
* **Probabilidad y estado civil:** un valor desconocido se interpreta como vacío.
* **Razón de pérdida:** debe existir por nombre o key; no se crea desde el archivo. Usala junto con el estado correspondiente.

## Altas y actualizaciones

El email identifica al contacto. Un contacto eliminado con ese email puede restaurarse. Si ya existe una oportunidad para ese contacto se actualiza la primera que encuentra; no se crea otra oportunidad por cambiar el proyecto.

Nombre y apellido se actualizan con los valores obligatorios. Los campos opcionales del contacto se actualizan cuando llegan informados. En la oportunidad, los campos vacíos normalmente conservan la información previa; no uses celdas vacías como mecanismo para borrar datos. `puntuacion=0` y `valor_estimado=0` se tratan como vacíos y no reemplazan un valor previo. Al informar `etiquetas`, su lista se sincroniza: incluí todas las que querés conservar.

`creado_el` permite cargar historial, pero también modifica la fecha de creación de una oportunidad existente. Revisalo antes de reenviar la plantilla.

## Ejecutar y revisar

1. Seleccioná el archivo. Desde el CRM el máximo es 10 MB.
2. Elegí si enviar notificaciones. Desactivarlas evita avisos masivos durante cargas históricas.
3. Confirmá la importación y seguí el avance en **Procesos**.
4. Revisá el resumen y la tabla de errores de importación. Las filas inválidas se omiten y las válidas continúan; una falla no revierte las filas ya procesadas.
5. Corregí solo las filas con errores y reimportalas, verificando previamente los contactos que se hayan actualizado.

## Problemas frecuentes

| Problema | Qué revisar |
| - | - |
| Falta una columna obligatoria | Usar los encabezados `email`, `nombre`, `apellido` en la primera fila. |
| Email inválido o repetido | Corregir el formato y dejar una sola fila por email. |
| No se vinculó el proyecto, producto o unidad | Comprobar nombres y SKU existentes en el tenant. |
| Aviso sobre vendedor | Reemplazar `asignado_a` por el email de un usuario activo. |
| No aparece una fecha | Revisar el formato y que Excel no haya convertido la celda en otro tipo de dato. |
| Se creó un canal inesperado | Revisar la ortografía: un canal desconocido puede crear uno nuevo. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.