Exportar e Importar Clientes
¿Qué es Exportar/Importar?
Exportar: Descargar tu base de datos de clientes a un archivo (Excel o PDF).
Importar: Cargar múltiples clientes desde un archivo Excel de una sola vez.
¿Para qué sirve?
Exportar
- 📊 Respaldo: Guardar copia de seguridad de tu base de datos
- 📈 Análisis: Trabajar con datos en Excel (gráficas, reportes)
- 📄 Reportes: Generar documentos para presentaciones
- 📧 Compartir: Enviar lista a contador, socio o auditor
- 🗂️ Archivo: Mantener historial mensual de clientes
Importar
- ⚡ Velocidad: Crear cientos de clientes en segundos
- 🔄 Migración: Traer datos de otro sistema
- ✏️ Actualización masiva: Corregir muchos datos a la vez
- 📋 Carga inicial: Iniciar con base de datos existente
Exportar Clientes
¿Cómo exportar?
Paso 1: Accede a Clientes
- Ve al menú "Clientes"
- Verás el listado completo
Paso 2: Haz Clic en Exportar
- Busca botón "Exportar" (esquina superior derecha)
- Haz clic en el botón
- Se abre menú con opciones
Paso 3: Selecciona Formato
Opción A: Excel (.xlsx)
- ✅ Ideal para análisis
- ✅ Editable
- ✅ Permite fórmulas y filtros
- ✅ Compatible con Excel, Google Sheets, LibreOffice
- 📊 Recomendado para: Trabajar con datos, importar después
Opción B: PDF
- ✅ Ideal para imprimir
- ✅ No modificable (seguridad)
- ✅ Fácil de compartir
- ✅ Formato profesional
- 📄 Recomendado para: Reportes, presentaciones, archivo
Paso 4: Descarga el Archivo
- Selecciona formato (Excel o PDF)
- El archivo se descarga automáticamente
- Busca en tu carpeta de "Descargas"
Nombre del archivo:
clientes-2024-03-15-14-30.xlsx
clientes-2024-03-15-14-30.pdf
(incluye fecha y hora de exportación)
¿Qué información incluye la exportación?
El archivo exportado contiene todos los clientes con los siguientes datos:
Columnas del archivo:
| Columna | Descripción | Ejemplo |
|---|---|---|
| Código | Identificador único | CLI-0001 |
| Nombre | Primer nombre | Juan |
| Apellido | Apellido(s) | Pérez García |
| Correo electrónico | [email protected] | |
| Teléfono | Número de contacto | 809-555-0100 |
| Dirección | Dirección completa | Calle Principal #45 |
| RNC/Cédula | Identificación fiscal | 001-0123456-7 |
| Régimen Fiscal | Tipo de contribuyente | Normal |
| Estado | Activo o Inactivo | Activo |
| Total Facturas | Cantidad de compras | 15 |
| Total Gastado | Monto total | RD$ 45,320.00 |
| Fecha Creación | Cuándo se registró | 2024-01-15 |
Nota: Se exportan TODOS los clientes (activos e inactivos).
Ejemplos de Uso de Exportación
Ejemplo 1: Respaldo Mensual
Objetivo: Guardar copia de seguridad cada fin de mes.
Pasos:
- Último día del mes, abre "Clientes"
- Clic en "Exportar" → Excel
- Se descarga:
clientes-2024-03-31.xlsx - Guarda en carpeta:
Respaldos/2024/Marzo/ - Repite cada mes
Beneficio: Si algo pasa, tienes respaldo histórico.
Ejemplo 2: Análisis de Base de Datos
Objetivo: Saber cuántos clientes activos tienes por régimen fiscal.
Pasos:
- Exporta a Excel
- Abre archivo en Excel
- Usa tabla dinámica:
- Filas: Régimen Fiscal
- Valores: Contar Clientes
- Resultado:
Normal: 145 clientes
RUI: 12 clientes
Gobierno: 3 clientes
Exportación: 1 cliente
Ejemplo 3: Reporte para Contador
Objetivo: Enviar lista de clientes para declaración anual.
Pasos:
- Exporta a Excel
- Abre archivo
- Filtra solo clientes con facturas (Total Facturas > 0)
- Guarda como:
Clientes-para-declaracion-2024.xlsx - Envía por email a contador
Ejemplo 4: Lista Impresa
Objetivo: Tener lista física de clientes para reunión.
Pasos:
- Exporta a PDF
- Abre el PDF
- Imprime (Archivo → Imprimir)
- Resultado: Documento profesional listo para presentar
Importar Clientes
⚠️ Importante Antes de Importar
Requisitos:
- ✅ Tienes permiso IMPORT en el sistema
- ✅ Archivo en formato Excel (.xlsx)
- ✅ Estructura correcta de columnas
- ✅ Datos validados (sin errores)
Advertencias:
- ⚠️ La importación crea clientes masivamente
- ⚠️ Si hay errores en el archivo, pueden fallar varios registros
- ⚠️ Revisa bien antes de importar
Preparar Archivo para Importar
Paso 1: Descarga la Plantilla
Opción A: Exporta clientes actuales
- Exporta a Excel
- Usa ese archivo como plantilla
- Borra filas de clientes existentes
- Agrega tus nuevos clientes
Opción B: Crea archivo manualmente
- Abre Excel
- Crea hoja con columnas requeridas (ver abajo)
- Llena con tus datos
Paso 2: Estructura del Archivo
Columnas OBLIGATORIAS:
| Columna | Descripción | Obligatorio | Ejemplo |
|---|---|---|---|
| codigo | Código único | ✅ Sí | CLI-0100 |
| nombre | Primer nombre | ✅ Sí | María |
| apellido | Apellido(s) | ⚪ No | González |
| Correo | ⚪ No | [email protected] | |
| telefono | Teléfono | ⚪ No | 809-555-1234 |
| direccion | Dirección | ⚪ No | Calle 5 #20 |
| taxId | RNC/Cédula | ⚪ No | 001-0123456-7 |
| taxRegime | Régimen fiscal | ⚪ No | NORMAL |
| isActive | Estado | ⚪ No | TRUE |
Nota: Nombres de columnas deben ser exactos (case-sensitive).
Paso 3: Formato de Datos
Código (codigo):
✅ CLI-0100, CLI-0101, CLI-0102
✅ CLIE-001, CLIE-002
❌ (vacío)
❌ Duplicado con cliente existente
Nombre (nombre):
✅ Juan, María Elena, José Luis
❌ (vacío)
Email (email):
✅ [email protected]
✅ (vacío)
❌ usuariodominio.com (sin @)
❌ Email duplicado
Teléfono (telefono):
✅ 809-555-0100
✅ (809) 555-0100
✅ 8095550100
✅ (vacío)
Régimen Fiscal (taxRegime):
✅ NORMAL (por defecto)
✅ RUI
✅ SPECIAL_REGIME
✅ GOVERNMENT
✅ EXPORT
❌ normal (minúsculas no válidas)
❌ otro_regimen
Estado (isActive):
✅ TRUE (activo)
✅ FALSE (inactivo)
✅ (vacío - por defecto es TRUE)
❌ 1, 0, Si, No
Paso 4: Ejemplo de Archivo
Ejemplo básico:
| codigo | nombre | apellido | telefono | taxId | taxRegime | isActive | |
|---|---|---|---|---|---|---|---|
| CLI-0100 | Juan | Pérez | [email protected] | 809-555-0100 | 001-0123456-7 | NORMAL | TRUE |
| CLI-0101 | María | González | [email protected] | 829-555-0200 | 001-7654321-0 | NORMAL | TRUE |
| CLI-0102 | Pedro | Martínez | 809-555-0300 | NORMAL | TRUE | ||
| CLI-0103 | Consumidor | Final | 000-00000-0 | NORMAL | TRUE |
Proceso de Importación
Paso 1: Prepara el Archivo
- Completa todos los datos
- Verifica que no haya:
- Códigos duplicados
- Emails duplicados
- Campos obligatorios vacíos
- Guarda como
.xlsx
Paso 2: Accede a Importar
Nota: La función de importar está disponible en:
- Ve a "Clientes"
- Busca botón "Importar" (si tienes permiso IMPORT)
- Haz clic
Si no ves el botón, no tienes permiso de importación.
Paso 3: Sube el Archivo
- Clic en "Seleccionar archivo" o "Examinar"
- Busca tu archivo
.xlsx - Selecciónalo
- Clic en "Abrir"
Paso 4: Inicia la Importación
- Verifica que el archivo sea el correcto
- Clic en "Importar"
- El sistema procesa el archivo
- Espera (puede tomar varios segundos si son muchos registros)
Paso 5: Revisa Resultados
Si todo sale bien:
✅ Importación completada exitosamente
✅ 50 clientes creados
✅ 0 errores
Si hay errores:
⚠️ Importación completada con advertencias
✅ 45 clientes creados
❌ 5 clientes fallaron
📋 Ver detalles de errores
Errores comunes:
- Código duplicado
- Email duplicado
- Formato inválido
- Campos obligatorios vacíos
Paso 6: Verifica los Clientes
- Ve al listado de "Clientes"
- Busca algunos de los importados
- Verifica que los datos sean correctos
- Si algo está mal, edita o elimina y reintenta
Actualización Masiva con Exportar/Importar
Situación: Necesitas actualizar teléfonos de 50 clientes.
Pasos:
-
Exporta:
- Exporta base de datos a Excel
-
Edita:
- Abre archivo en Excel
- Actualiza columna "telefono"
- Guarda archivo
-
Importa:
- Importa archivo actualizado
- Sistema actualiza registros existentes (por código)
Resultado: 50 teléfonos actualizados en minutos en lugar de editarlos uno por uno.
Mejores Prácticas
Para Exportar
✅ Exporta Periódicamente
- Mensualmente: Como respaldo
- Antes de cambios grandes: Por seguridad
- Para declaraciones: Cuando lo requiera contador
✅ Nombra Archivos Claramente
✅ clientes-respaldo-marzo-2024.xlsx
✅ clientes-declaracion-anual-2024.xlsx
✅ clientes-activos-2024-03-15.xlsx
❌ copia.xlsx
❌ datos.xlsx
✅ Guarda en Lugar Seguro
- Carpeta específica:
Respaldos/Clientes/ - Cloud: Google Drive, Dropbox
- Disco externo: Para respaldos críticos
Para Importar
✅ Prueba Primero
Si vas a importar 500 clientes:
- Importa solo 10 primero
- Verifica que salgan bien
- Luego importa el resto
✅ Valida Antes de Importar
Checklist:
- ☑️ Códigos únicos
- ☑️ Emails válidos
- ☑️ Régimen fiscal correcto
- ☑️ Nombres completos
✅ Respaldo Antes de Importar
- Exporta base de datos actual
- Guarda respaldo
- Ahora sí, importa
- Si algo sale mal, tienes respaldo
✅ Importa en Horario Bajo
- No importes 1000 clientes en hora pico
- Mejor en la noche o madrugada
- Menos carga en el sistema
Casos de Uso Avanzados
Caso 1: Migración desde Otro Sistema
Situación: Vienes de otro software y tienes 300 clientes.
Pasos:
- Exporta clientes desde sistema antiguo (CSV o Excel)
- Abre en Excel
- Ajusta columnas a formato de CloudSuite Pro:
- Renombra columnas
- Agrega códigos únicos (CLI-0001, CLI-0002...)
- Valida régimen fiscal
- Guarda como
.xlsx - Importa en CloudSuite Pro
- Verifica resultados
- Resultado: Base de datos completa en nueva plataforma
Caso 2: Limpieza de Duplicados
Situación: Tienes duplicados en la base de datos.
Pasos:
- Exporta a Excel
- Ordena por nombre
- Identifica duplicados visualmente
- Marca cuál es el correcto (más facturas)
- En CloudSuite Pro:
- Desactiva o elimina duplicados
- Mantén solo el registro oficial
Caso 3: Segmentación para Marketing
Situación: Quieres enviar email solo a clientes que gastaron más de RD$10,000.
Pasos:
- Exporta a Excel
- Filtra: Total Gastado > 10,000
- Copia columna Email
- Usa lista para campaña de marketing
- Resultado: Email dirigido a mejores clientes
Caso 4: Reporte de Clientes Inactivos
Situación: Auditoría solicita lista de clientes inactivos.
Pasos:
- Exporta a Excel
- Filtra: Estado = Inactivo
- Exporta a PDF para imprimir
- Entrega a auditor
- Resultado: Reporte profesional listo
Solución de Problemas
Problema 1: No Veo Botón de Exportar
Causa: No tienes permiso EXPORT.
Solución:
- Contacta al administrador
- Solicita permiso de exportación
- O pide a alguien con permiso que lo haga
Problema 2: No Veo Botón de Importar
Causa: No tienes permiso IMPORT.
Solución:
- Contacta al administrador
- Solicita permiso de importación
- Solo administradores suelen tenerlo
Problema 3: Archivo Excel No Abre
Causa: Archivo corrupto o formato incorrecto.
Solución:
- Descarga de nuevo
- Verifica extensión (debe ser .xlsx)
- Prueba abrir con Google Sheets
Problema 4: Importación Falla
Errores comunes:
"Código duplicado":
- Verifica que cada código sea único
- No debe existir en sistema actual
"Email duplicado":
- Busca emails repetidos en tu archivo
- Quita duplicados o déjalos vacíos
"Formato inválido":
- Revisa taxRegime (debe ser: NORMAL, RUI, etc.)
- Revisa isActive (debe ser: TRUE o FALSE)
"Campos obligatorios vacíos":
- Asegúrate de que codigo y nombre tengan valor
Problema 5: Se Importaron Pero con Datos Incorrectos
Solución A (Pocos registros):
- Edita manualmente uno por uno
Solución B (Muchos registros):
- Elimina los que importaste mal (si no tienen facturas)
- Corrige archivo
- Importa de nuevo
Solución C (Actualización):
- Corrige datos en Excel
- Reimporta (actualiza registros existentes)
Permisos Necesarios
Para Exportar
Permiso: EXPORT
Sin este permiso:
- ❌ No ves botón de exportar
- ✅ Puedes ver lista de clientes
- ✅ Puedes crear/editar individualmente
Para Importar
Permiso: IMPORT
Sin este permiso:
- ❌ No ves botón de importar
- ✅ Puedes ver y exportar
- ✅ Puedes crear clientes uno por uno
Nota: Por seguridad, solo administradores o roles específicos tienen permiso de importación.
Preguntas Frecuentes
¿Cuántos clientes puedo exportar?
Todos. No hay límite. Se exportan todos los clientes registrados.
¿La exportación incluye clientes inactivos?
Sí, se exportan tanto activos como inactivos. Puedes filtrarlos después en Excel.
¿Puedo exportar solo clientes activos?
No directamente. Exporta todos y luego filtra en Excel por columna "Estado = Activo".
¿El archivo exportado tiene contraseña?
No. Guárdalo en lugar seguro si contiene información sensible.
¿Puedo importar desde CSV?
El sistema espera Excel (.xlsx). Si tienes CSV:
- Abre en Excel
- Guarda como .xlsx
- Importa
¿Qué pasa si importo cliente con código existente?
Sistema actual: Rechaza y muestra error "Código duplicado".
Recomendación: Usa códigos únicos para evitar conflictos.
¿Puedo importar clientes sin email?
Sí, el email es opcional. Déjalo vacío en la columna.
¿Hay límite de cuántos clientes puedo importar?
No hay límite fijo, pero importaciones muy grandes (miles) pueden tomar tiempo. Importa en lotes si son muchos:
- Lote 1: Clientes 1-500
- Lote 2: Clientes 501-1000
- etc.
¿Se puede programar exportación automática?
No en la versión actual. Debe hacerse manualmente.
¿La importación valida RNC con DGII?
No. Solo valida formato. Tú debes verificar que los RNC sean correctos.