> ## 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 Unidades

> Las 32 columnas del stock y el formato separado para atributos de unidades.

## Antes de comenzar

Ingresá al tenant correcto con un usuario habilitado para ejecutar **Importar unidades** en Nova. Se aceptan CSV, XLS y XLSX. La primera fila contiene los encabezados exactos indicados abajo.

La carga se hace en dos pasos si necesitás características como superficies, dormitorios o amenities: **Importar unidades** carga el stock y su dirección; **Importar atributos** carga las características de unidades ya existentes.

## Plantilla de stock

[Descargar plantilla CSV completa](data:text/csv;charset=utf-8,%EF%BB%BFsku%2Cproject%2Cproduct%2Cproduct_type%2Cstatus%2Cpossession_date%2Ccurrency_type%2Cprice%2Clisting_type%2Cname%2Cstage%2Csector%2Cunit%2Ctipology%2Cstore_active%2Cstore_link%2Cpossession_type%2Cproject_description%2Cproject_tagline%2Cproject_website%2Cproduct_description%2Cproduct_tagline%2Ccountry%2Cstate%2Ccity%2Cneighborhood%2Cdistrict%2Cpostal_code%2Caddress_line_1%2Caddress_line_2%2Clatitud%2Clongitud%0ADEMO-HOR-0302%2CAltos%20del%20Horizonte%2CTorre%20Jacarand%C3%A1%2Cdepartamentos%2Cdisponible%2C15-12-2027%2CUSD%2C128500.50%2Cventa%2CDepartamento%20302%2CEtapa%201%2C3%2C302%2CDos%20dormitorios%20con%20balc%C3%B3n%2C1%2Chttps%3A%2F%2Finmobiliaria.example.com%2Funidades%2Fdemo-hor-0302%2Cen_ejecucion%2CProyecto%20ficticio%20de%20viviendas%20con%20espacios%20verdes%2CTu%20pr%C3%B3ximo%20lugar%2Chttps%3A%2F%2Fhorizonte.example.com%2CTorre%20ficticia%20de%20departamentos%20de%20uno%20y%20dos%20dormitorios%2CVivir%20con%20luz%20natural%2CArgentina%2CC%C3%B3rdoba%2CC%C3%B3rdoba%2CBarrio%20del%20Horizonte%2CZona%20Norte%2C5000%2CAvenida%20Imaginaria%201234%2CTorre%20Jacarand%C3%A1%20-%20Piso%203%20-%20Depto.%20302%2C-31.4201%2C-64.1888%0A)

Incluye las **32 columnas** admitidas y una unidad ficticia. Proyecto, producto, SKU, tipología, dirección y precio son de ejemplo. Usá los nombres reales de tu catálogo para actualizar stock existente; los nombres nuevos pueden crear proyectos y productos.

## Lista completa de columnas de stock

Las ocho columnas marcadas **Sí** deben existir y tener valor en cada fila.

| Columna | Obligatoria | Formato y comportamiento | Ejemplo |
| - | - | - | - |
| `sku` | **Sí** | Identificador único; si existe, se actualiza la unidad. No repetir en el archivo. | `DEMO-HOR-0302` |
| `project` | **Sí** | Nombre del proyecto; si no existe se crea. | `Altos del Horizonte` |
| `product` | **Sí** | Nombre del producto dentro del proyecto; si no existe se crea. | `Torre Jacarandá` |
| `product_type` | **Sí** | Tipo de producto. Consultá los valores permitidos debajo. | `departamentos` |
| `status` | **Sí** | Estado de la unidad; usar los valores exactos indicados debajo. | `disponible` |
| `possession_date` | **Sí** | Fecha de posesión: `DD-MM-YYYY`, `MM-YYYY` o `YYYY`. También admite fecha serial entera de Excel. | `15-12-2027` |
| `currency_type` | **Sí** | `ARS`, `USD` o `EUR`, en mayúsculas. | `USD` |
| `price` | **Sí** | Precio numérico, con punto decimal, sin símbolo ni separador de miles. | `128500.50` |
| `listing_type` | No | `venta`, `alquiler`, `alquiler_temporal` o `permuta`. | `venta` |
| `name` | No | Nombre descriptivo de la unidad. | `Departamento 302` |
| `stage` | No | Etapa del proyecto. | `Etapa 1` |
| `sector` | No | Piso, manzana o sector, según el tipo de producto. | `3` |
| `unit` | No | Número o denominación de departamento, lote, cochera, etc. | `302` |
| `tipology` | No | Nombre de tipología. El encabezado es `tipology` (no `typology`). Se crea o actualiza y vincula al producto. | `Dos dormitorios con balcón` |
| `store_active` | No | `si` o `1` activan la tienda; `0` la desactiva. Vacío queda sin valor explícito. | `1` |
| `store_link` | No | Enlace asociado a la publicación de la unidad. | `https://inmobiliaria.example.com/unidades/demo-hor-0302` |
| `possession_type` | No | `pozo`, `inmediata` o `en_ejecucion`, en minúsculas. | `en_ejecucion` |
| `project_description` | No | Descripción del proyecto; si se informa, también actualiza proyectos existentes. | `Proyecto ficticio de viviendas con espacios verdes` |
| `project_tagline` | No | Frase breve del proyecto; también actualiza proyectos existentes. | `Tu próximo lugar` |
| `project_website` | No | Web del proyecto; también actualiza proyectos existentes. | `https://horizonte.example.com` |
| `product_description` | No | Descripción del producto; también actualiza productos existentes. | `Torre ficticia de departamentos de uno y dos dormitorios` |
| `product_tagline` | No | Frase breve del producto; también actualiza productos existentes. | `Vivir con luz natural` |
| `country` | No | País de la dirección de la unidad. | `Argentina` |
| `state` | No | Provincia o estado. | `Córdoba` |
| `city` | No | Ciudad. | `Córdoba` |
| `neighborhood` | No | Barrio. | `Barrio del Horizonte` |
| `district` | No | Distrito o zona. | `Zona Norte` |
| `postal_code` | No | Código postal como texto. | `5000` |
| `address_line_1` | No | Calle y número. | `Avenida Imaginaria 1234` |
| `address_line_2` | No | Complemento de dirección. | `Torre Jacarandá - Piso 3 - Depto. 302` |
| `latitud` | No | Latitud decimal con punto; este es el encabezado exacto. | `-31.4201` |
| `longitud` | No | Longitud decimal con punto; este es el encabezado exacto. | `-64.1888` |

## Valores permitidos

| Campo | Valores |
| - | - |
| `product_type` | `cocheras`, `oficinas`, `departamentos`, `locales`, `lotes`, `casas`, `parking`, `macro_locales`, `duplex`. |
| `status` | `disponible`, `pisado`, `cotizado`, `reservado`, `revision`, `vendido`, `no_disponible`. |
| `listing_type` | `venta`, `alquiler`, `alquiler_temporal`, `permuta`. |
| `possession_type` | `pozo`, `inmediata`, `en_ejecucion`. |
| `currency_type` | `ARS`, `USD`, `EUR`. |
| `store_active` | `si` o `1` para activar; `0` para desactivar. |

Usá exactamente estos valores. Un estado desconocido puede guardarse como `disponible`; la moneda o el tipo de posesión inválidos generan error. Un tipo de operación desconocido queda sin valor.

## Fechas, números e identificadores

**La fecha de posesión usa día-mes-año:** `15-12-2027`. También admite `12-2027` (primer día del mes), `2027` (1 de enero) y fechas seriales enteras de Excel. No uses `2027-12-15`: este importador no interpreta ese orden como año-mes-día.

Usá punto decimal, sin separadores de miles ni símbolos monetarios. Guardá SKU, número de unidad y código postal como texto para conservar ceros iniciales.

Para `project` y `product`, la plantilla usa nombres. El importador también contempla IDs cuando la celda llega como entero nativo; un número guardado como texto puede tratarse como nombre. Por eso en CSV recomendamos usar nombres y revisar coincidencias. El producto se resuelve dentro del proyecto de la fila.

## Altas y actualizaciones

El SKU identifica la unidad. Si ya existe se actualiza: **incluí todos los valores que querés conservar**. No es una actualización parcial; por ejemplo, omitir `name`, `stage`, `sector`, `unit`, `tipology`, `store_active`, `store_link`, `listing_type` o `possession_type` puede vaciarlos.

Los nombres nuevos de proyecto y producto crean registros. Las descripciones, frases y web informadas también pueden actualizar registros compartidos por otras unidades. El tipo de producto informado puede actualizar un producto existente.

La tipología se busca por nombre y se vincula al producto: usá nombres específicos para evitar reutilizar una tipología de otro producto. La dirección solo modifica columnas con valor; las celdas vacías no borran su información anterior. La importación marca la unidad y los proyectos/productos nuevos como publicados.

## Importar atributos de unidades

Superficies, dormitorios, baños, orientación y amenities **no se cargan agregándolos al CSV de stock**. Una vez creadas las unidades, ejecutá **Importar atributos** con su propia planilla:

1. La **primera fila** contiene títulos descriptivos (se ignora como encabezado técnico).
2. La **segunda fila** contiene `sku` y las keys exactas de los atributos configurados en tu tenant.
3. Desde la tercera fila se incluyen los valores. Solo `sku` es obligatorio y debe corresponder a una unidad existente.
4. Los atributos decimales usan punto; enteros usan números sin decimales; booleanos usan **1 o 0**; opciones usan su key exacta, no la etiqueta.

> [!WARNING]
>
> Esta acción sincroniza la lista de atributos de cada unidad: cuando hay al menos un valor para importar, los atributos anteriores que no estén incluidos pueden desvincularse. Incluí todas las características que querés conservar. No uses textos como `false` o `no` para booleanos: se pueden interpretar como verdadero; usá `0`.

Las keys disponibles dependen del catálogo de cada tenant. Las columnas desconocidas se ignoran y no crean atributos. Consultá el catálogo, sus tipos y opciones antes de importar. Los encabezados se normalizan a minúsculas, sin tildes y con guiones bajos; las keys configuradas deben coincidir con ese resultado.

El [catálogo y plantilla de atributos](https://docs.isprop.com/integraciones/atributos-unidades.md) detalla las keys habituales y un archivo con el formato de dos filas de encabezado.

## Ejecutar y revisar

1. Abrí **Importar unidades**, seleccioná el archivo y elegí si enviar notificaciones.
2. Confirmá y consultá el progreso en **Procesos**.
3. Revisá los errores de importación desde el listado de unidades antes de reenviar filas corregidas.
4. Si corresponde, cargá después la planilla mediante **Importar atributos**.

| Problema | Qué revisar |
| - | - |
| Faltan columnas o valores requeridos | Completar las ocho columnas obligatorias. |
| Moneda o posesión inválidas | Usar las keys exactas de la tabla de valores. |
| Fecha de posesión incorrecta | Usar `DD-MM-YYYY`, no `YYYY-MM-DD`. |
| SKU duplicado | Dejar una sola fila por SKU. |
| No existe la unidad al importar atributos | Importar primero el stock y comprobar el SKU. |
| No aparecen superficies o amenities | Usar la acción separada y las keys del catálogo en la segunda fila. |

Una falla no revierte las filas ya procesadas. Revisá las unidades existentes antes de reintentar el archivo completo.


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