# Importar y exportar clientes

Transfiere clientes entre sistemas, realiza backup o integra datos desde tus registros anteriores.

## Exportar clientes a CSV

### Descarga simple

1. Ve a **Clientes**
2. Haz clic en **Exportar > CSV**
3. Se descarga archivo `clientes-{fecha}.csv`

El archivo contiene todas las columnas:

```csv
nombre,tipo,cif_nif,email,telefono,ciudad,pais,fecha_creacion
Acme Corp,empresa,A12345678,contacto@acme.com,+34 91 123 45 67,Madrid,ES,2025-11-15
Juan García,persona,12345678A,juan@email.com,+34 666 123 456,Barcelona,ES,2026-01-10
```

### Exportación con filtros

Antes de exportar, aplica filtros:

1. Filtra por **tipo** (empresas / personas)
2. Filtra por **región** o **país**
3. Filtra por **rango de fecha** (clientes nuevos)
4. Luego exporta

Se exportan solo los clientes filtrados.

### Casos de uso

- **Cambio de sistema contable**: Exporta clientes para importar en nuevo software
- **Backup**: Guarda CSV seguro regularmente
- **Facturación manual**: Exporta para hacer correspondencia en Word/Excel
- **Integración**: Envía clientes a herramienta de marketing o CRM

## Importar clientes desde CSV

### Preparar archivo

Crea un CSV con columnas mínimas:

```csv
nombre,tipo,cif_nif,email
Beers Ltd,empresa,B87654321,info@beers.com
María López,persona,87654321B,maria@example.com
Servicios TI SL,empresa,C11223344,contacto@servicios-ti.es
```

Columnas reconocidas automáticamente:

| Columna       | Obligatoria | Ejemplo               |
| ------------- | ----------- | --------------------- |
| nombre        | Sí          | "Acme Corp"           |
| tipo          | Sí          | empresa / persona     |
| cif_nif       | Sí          | A12345678 / 12345678A |
| email         | No          | contacto@empresa.com  |
| telefono      | No          | +34 91 123 45 67      |
| ciudad        | No          | Madrid                |
| pais          | No          | ES                    |
| region        | No          | Madrid                |
| codigo_postal | No          | 28001                 |
| web           | No          | www.empresa.com       |

### Detección inteligente de columnas

Frihet usa **IA para detectar automáticamente** columnas incluso si tienen nombres ligeramente diferentes:

- "Empresa" = "nombre"
- "Tipo cliente" = "tipo"
- "NIF" / "CIF" = "cif_nif"
- "Email" / "Correo" / "E-mail" = "email"
- "Teléfono" / "Tlf" = "telefono"
- "Ciudad" / "Municipio" = "ciudad"
- "Web" / "Sitio web" = "web"

Esto permite importar archivos de otros sistemas sin reformat manual.

### Proceso de importación

1. Ve a **Clientes > Importar > Desde CSV**
2. Arrastra archivo o selecciona desde disco
3. Frihet **valida formato** y muestra preview:
   - Filas a importar
   - Columnas detectadas
   - Problemas encontrados
4. Resuelve conflictos (ver abajo)
5. Haz clic **Importar**

### Validación y conflictos

Durante importación, Frihet verifica:

#### Duplicados

Si el CIF/NIF ya existe en tu cuenta:

- **Opción 1**: Saltar (no importar ese cliente)
- **Opción 2**: Actualizar datos del cliente existente
- **Opción 3**: Crear nuevo con datos de la importación

#### CIF/NIF inválido

Si el formato no es válido:

```
Fila 5: "Acme Corp" — CIF "123" no válido
Sugerencia: ¿Quisiste decir "A12345678"?
```

Puedes:

- Corregir antes de importar
- Dejar en blanco (requiere edición manual después)
- Saltar esa fila

#### Email duplicado

Si el mismo email está registrado en 2 clientes:

```
Fila 3: "García & Asociados" usa email "contacto@empresas.com"
También en: "García Servicios Legales" (existente)
```

Elige cuál mantener o crea nuevo con email diferente.

### Ejemplo: Importar desde Excel

Si tus clientes están en Excel:

1. Abre archivo en Numbers / Excel
2. Selecciona rango de datos
3. Copia (Cmd+C)
4. En Frihet, ve a **Clientes > Importar**
5. Pega (Cmd+V) en el área de importación
6. Frihet detecta formato automáticamente

## Operaciones en lote

Tras importar, puedes aplicar cambios a múltiples clientes:

### Asignar plazo de pago

1. Ve a **Clientes**
2. Selecciona varios (checkbox en lista)
3. Haz clic **Acciones > Establecer plazo pago**
4. Elige plazo (30, 60, 90 días)
5. Aplica a todos seleccionados

### Cambiar región

Útil si importaste clientes de otra sucursal:

1. Selecciona clientes
2. **Acciones > Editar región**
3. Nueva región: Cataluña
4. Aplica

### Agregar etiqueta

Categoriza clientes importados:

1. Selecciona clientes
2. **Acciones > Agregar etiqueta**
3. Crea etiqueta (ej: "Importados 2026")
4. Aplica

Las etiquetas permiten filtrar después.

## Exportar a otras herramientas

### A Stripe (para pagos)

Frihet exporta clientes a formato compatible con Stripe:

1. Ve a **Clientes > Exportar**
2. Selecciona **Formato Stripe**
3. Se descarga JSON con estructura correcta
4. Importa en Stripe dashboard

### A HubSpot (CRM)

1. **Clientes > Exportar > HubSpot**
2. Frihet genera token de integración
3. Sincroniza automáticamente bidireccional (plan Premium)

### A Google Sheets

Para colaboración:

1. **Clientes > Exportar > Google Sheets**
2. Se abre nueva hoja compartible
3. Cambios en Sheets se sincronizan a Frihet (delay 1 hora)

## Sincronización continua

En plan **Premium**, habilita sincronización:

1. Ve a **Integraciones > CRM**
2. Selecciona herramienta (HubSpot, Pipedrive, Salesforce)
3. Autoriza acceso (OAuth)
4. Elige qué sincronizar:
   - Datos del cliente (bidireccional)
   - Histórico de facturas (unidireccional: Frihet → CRM)
   - Pagos (unidireccional)

Cambios se sincronizan automáticamente cada hora.

## Problemas comunes

### "CIF no válido en fila 3"

El CIF debe seguir formato: 1 letra + 7 números + 1 letra/número.

- ✅ A12345678
- ❌ 12345678 (falta letra)
- ❌ A1234567 (solo 7 dígitos)

Corrije antes de importar.

### "Email duplicado en mi cuenta"

Un cliente tiene 2 registros con el mismo email. Usa **Clientes > Unir clientes** para consolidar antes de importar.

### "Archivo CSV corrupto"

Si Frihet no puede leer el archivo:

- Guarda como UTF-8 (no Latin-1)
- Verifica delimitador (coma, punto y coma)
- Abre en Excel y resguarda como CSV nuevo
- Intenta import nuevamente

### "Importación lenta"

Si importas 10.000+ clientes:

- Procesa en lotes de 5.000 máximo
- En plan Premium, contacta soporte para import optimizado
- La primera importación es más lenta (índices); posteriores son rápidas