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

# Importar registros de objetos personalizados desde CSV

> Crea o actualiza registros de objetos personalizados en bloque con un CSV, control de duplicados y seguimiento.

La importación en bloque te permite cargar un archivo CSV para crear registros nuevos de un objeto personalizado, actualizar los que ya existen o hacer ambas cosas en una sola importación. Incluye control de duplicados basado en campos únicos y una página de **Acciones masivas** desde la que puedes seguir, pausar, reanudar o cancelar cada importación.

Es la forma más rápida de poblar un objeto personalizado con cientos o miles de registros sin crearlos uno por uno.

## Ventajas

* **Carga rápida:** importa grandes volúmenes desde un CSV.
* **Modos flexibles:** crear, actualizar o crear y actualizar, según tu caso.
* **Datos más limpios:** los campos únicos evitan duplicados y conflictos.
* **Control operativo:** pausa, reanuda o cancela desde Acciones masivas.
* **Visibilidad:** estadísticas de la importación, errores y advertencias por fila, con indicaciones para resolverlos.

## Modos de importación

| Modo | Úsalo cuando |
| - | - |
| Crear | Tu archivo solo trae registros nuevos. |
| Actualizar | Solo quieres modificar registros que ya existen. |
| Crear y actualizar | Tu archivo mezcla registros nuevos con registros existentes. |

## Duplicados y campos únicos

Si tu objeto tiene **campos únicos** (por ejemplo, un número de póliza o una matrícula), la importación los usa para detectar si una fila corresponde a un registro que ya existe.

* Si mapeas más de un campo único, Chateea te pide elegir cuál usar para la comparación.
* Si una fila intenta asignar un valor único que ya pertenece a otro registro, la importación marca esa fila con un error o una advertencia para que la corrijas. Así se evitan conflictos entre registros.

## Antes de empezar

Un CSV limpio y un mapeo correcto marcan la diferencia entre una importación sin sobresaltos y una larga sesión de correcciones.

* Asegúrate de que cada fila tenga el **campo principal** y los **campos obligatorios** del objeto.
* Usa un solo objeto por archivo. La importación de varios objetos en un mismo CSV todavía no está disponible.
* Si vas a actualizar, incluye la columna del campo único que identifica cada registro.

## Importar registros

**1. Abre el objeto personalizado**

Entra a **Objetos personalizados** en tu cuenta y elige el objeto en el que quieres importar registros.

**2. Haz clic en Importar**

El botón **Importar** está en la parte superior derecha.

**3. Selecciona el objeto y sube el archivo**

Elige el objeto de destino y carga tu CSV.

**4. Elige el modo de importación**

Selecciona **Crear**, **Actualizar** o **Crear y actualizar**.

**5. Elige el campo único para duplicados**

Si mapeaste varios campos únicos, selecciona cuál se usará para detectar duplicados. Si solo hay uno, este paso no aparece.

**6. Mapea los campos**

Mapea primero los campos principales y obligatorios. Después mapea el resto, incluidos **Propietario** y **Seguidores** si los necesitas.

**7. Decide si actualizar valores vacíos**

Activa **Actualizar valores vacíos** solo si quieres que las celdas vacías del CSV borren el valor actual del registro al actualizar. Los campos principales y obligatorios nunca se vacían.

**8. Inicia la importación**

Haz clic en **Iniciar importación**.

> [!WARNING]
>
> Con **Actualizar valores vacíos** activado, cualquier celda en blanco sobrescribe el dato que ya tenías. Revisa bien el archivo antes de usar esta opción.

## Seguir y controlar la importación

Ve a **Acciones masivas → Objetos personalizados** para gestionar tus importaciones:

* **Pausar** y **Reanudar** una importación en curso.
* **Cancelar** una importación. Se detiene el procesamiento, pero las filas que ya se procesaron pueden quedar aplicadas.
* Abrir la importación para ver sus estadísticas. En las pestañas **Errores** y **Advertencias** verás el detalle por fila, junto con la indicación **Cómo resolverlo**.

## Preguntas frecuentes

> **¿Cuándo uso Crear, Actualizar o Crear y actualizar?**
>
> Usa **Crear** para datos totalmente nuevos, **Actualizar** para modificar solo registros existentes, y **Crear y actualizar** cuando el archivo mezcla ambos casos.

> **¿Por qué me pide elegir un campo para duplicados?**
>
> Porque mapeaste más de un campo único y hay que indicar cuál se usa para identificar los registros existentes.

> **¿Qué significa el manejo estricto de conflictos en campos únicos?**
>
> Si una fila rompe las reglas de un campo único (por ejemplo, intenta asignar un valor que ya tiene otro registro), la importación la marca con un error o una advertencia para que la corrijas.

> **¿Qué hace Actualizar valores vacíos?**
>
> Permite que los valores vacíos del CSV se apliquen al actualizar. Los campos principales y obligatorios quedan excluidos.

> **¿Puedo pausar una importación y seguir después?**
>
> Sí, desde **Acciones masivas → Objetos personalizados**.

> **¿Qué pasa si cancelo una importación?**
>
> Se detiene. Las filas procesadas antes de cancelar pueden quedar aplicadas.

> **¿Dónde veo qué filas fallaron?**
>
> Abre el detalle de la importación y revisa las pestañas **Errores** y **Advertencias**. Cada mensaje incluye cómo resolverlo.

> **¿Puedo importar varios objetos en un mismo CSV?**
>
> Todavía no. La importación de varios objetos aparece como próximamente.

## Artículos relacionados

> **[Eliminar registros en bloque](https://help.chateea.com/docs/crm/eliminar-registros-de-objetos-en-bloque.md)**
>
> Borra y restaura registros de objetos personalizados.

> **[Activar automatizaciones en bloque](https://help.chateea.com/docs/crm/activar-automatizaciones-en-bloque.md)**
>
> Envía los registros importados a un flujo de trabajo.


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