Importar clients desde CSV

Usa esto cuando quieras cargar muchos clientes de una vez en el formato que Aquatechy espera — no una exportación genérica de otro producto. En la app, abre Clients → CSV Import o ve a /clients/import-csv. Descargas nuestra plantilla, llenas fila por fila, la subes aquí, eliges una company e importas.

Solo CSV. Aquatechy acepta únicamente archivos .csv — no subas .xlsx, .xls u otros formatos. Si trabajas en Excel o Google Sheets, exporta Comma Separated Values (.csv) al final y sube ese archivo.

Toda columna es obligatoria. Para cada fila de client, llena todas las columnas exactamente como define la plantilla — mismos encabezados, mismo orden y valor en cada celda (sigue la fila de ejemplo y los valores permitidos; no dejes celdas vacías salvo que la plantilla documente valor vacío).

Before you start

Necesitas al menos una company que tu usuario pueda administrar (Owner, Admin o Office). Si la app dice que no hay companies, crea una en settings primero — la pantalla de importación ofrece Create Company en ese caso.

1. Download the template

En la página de importación, usa Download Template (descarga client_import_template.csv del app). Ese archivo define los encabezados exactos y el conjunto completo de campos que debes completar — mantén encabezados sin cambios (ortografía y orden) y planea llenar toda columna para cada fila de client.

Using Google Sheets (no Excel required)

Si no usas Microsoft Excel, Google Sheets funciona bien para esta plantilla — solo necesitas cuenta de Google y navegador.

Open the template in Sheets

• Ve a Google Sheets, inicia una hoja en blanco y File → Import → Upload con el client_import_template.csv descargado de Aquatechy. Elige Replace spreadsheet (o Insert new sheet) para que las columnas queden en una cuadrícula limpia.
• O sube el archivo a Google Drive, clic derecho y Open with → Google Sheets.

Edit carefully

• Deja la fila 1 como encabezado — mismo texto, mismo orden, sin columnas extra ni celdas combinadas.
• Agrega una nueva fila por client bajo la fila de ejemplo (puedes borrar la de ejemplo al terminar o mantenerla y poner tus datos abajo — solo no subas archivo con texto placeholder del tutorial en celdas de datos).
• Si Sheets cambia números (ej.: teléfonos o monthlyPayment), selecciona esas celdas → Format → Number → Plain text para que los valores queden como Aquatechy espera (teléfonos de 10 dígitos, centavos solo como dígitos).

Save back to CSV for Aquatechy

• Al terminar: File → Download → Comma Separated Values (.csv) únicamente — eso es lo que Aquatechy importa. No subas Excel u otros formatos.
• Sube solo ese .csv en Choose File en la página de importación.

2. Fill the sheet

Las reglas abajo aplican en Google Sheets, Excel u otra hoja — siempre exporta CSV al final.

Trabaja desde la fila de ejemplo: copia la estructura, una fila por client. Completa toda columna para cada fila según plantilla y ejemplo — sin saltar columnas.

• Headers — No renombres ni reordenes columnas.
• Export — Guarda solo como .csv para subir; Aquatechy no importa .xlsx, .xls u otros tipos.
• Phone — Usa 10 dígitos solamente (sin guiones ni paréntesis). Aquatechy formatea como +1 (###) ###-####. Filas con teléfono inválido se resaltan en la vista previa y Import queda deshabilitado hasta que todos sean válidos.
• E-mail — Obligatorio en cada fila.
• clientState / poolState — Códigos de dos letras funcionan (ej.: FL). Nombres completos de estado también se normalizan cuando es posible.
• animalDanger — Usa TRUE o FALSE (case-insensitive al importar).
• poolType — Usa uno de los valores permitidos (ej.: Chlorine, Salt, Other) — ingresa valor en toda fila; sigue la plantilla.
• clientType — Residential o Commercial.
• monthlyPayment — Se guarda en centavos en el archivo: solo dígitos, ej.: 11000 representa $110.00 (la vista previa muestra formato en dólares).

Las columnas de la plantilla incluyen campos de facturación y ubicación de pool (ej.: clientAddress, poolAddress, poolAddressLine2, customerCode, clientCompany, lockerCode, enterSide, poolNotes, clientNotes, etc.). Llena cada columna como la fila de ejemplo demuestra para ese tipo de campo.

3. Import in Aquatechy

De vuelta en Import Clients from CSV:

1. Elige Company owner — todo client importado queda vinculado a esta company.
2. Clic Choose File y selecciona tu .csv lleno.
3. Revisa la tabla de vista previa. Corrige filas aún marcadas (ej.: E-mail required, Phone must be 10 digits o campos obligatorios faltantes) y vuelve a subir si hace falta.
4. Cuando la vista previa se vea bien, ejecuta Import {n} Clients (la etiqueta incluye el conteo de filas).

Si el archivo no se puede analizar, verás error pidiendo el formato correcto de plantilla CSV.

After the import

El proceso crea una pool para cada client del archivo. Planea una pasada rápida en la app para ajustar detalles de pool si hace falta, y configura agendas de servicio en Routes (assignments no se definen con esta importación CSV).