Importar clients via CSV

Use isto quando quiser carregar muitos clientes de uma vez no formato que o Aquatechy espera — não uma exportação genérica de outro produto. No app, abra Clients → CSV Import ou vá para /clients/import-csv. Você baixa nosso template, preenche linha por linha, envia aqui, escolhe uma company e importa.

Somente CSV. O Aquatechy aceita apenas arquivos .csv — não envie .xlsx, .xls ou outros formatos. Se trabalha no Excel ou Google Sheets, exporte Comma Separated Values (.csv) no final e envie esse arquivo.

Toda coluna é obrigatória. Para cada linha de client, preencha todas as colunas exatamente como o template define — mesmos cabeçalhos, mesma ordem e valor em toda célula (siga a linha de exemplo e os valores permitidos; não deixe células vazias a menos que o template documente valor vazio).

Before you start

Você precisa de pelo menos uma company que seu usuário possa gerenciar (Owner, Admin ou Office). Se o app disser que não há companies, crie uma em settings primeiro — a tela de importação oferece Create Company nesse caso.

1. Download the template

Na página de importação, use Download Template (baixa client_import_template.csv do app). Esse arquivo define os cabeçalhos exatos e o conjunto completo de campos que você deve informar — mantenha cabeçalhos inalterados (ortografia e ordem) e planeje preencher toda coluna para cada linha de client.

Using Google Sheets (no Excel required)

Se não usa Microsoft Excel, Google Sheets funciona bem para este template — basta conta Google e navegador.

Open the template in Sheets

• Acesse Google Sheets, comece uma planilha em branco e File → Import → Upload com o client_import_template.csv baixado do Aquatechy. Escolha Replace spreadsheet (ou Insert new sheet) para as colunas ficarem em uma grade limpa.
• Ou envie o arquivo ao Google Drive, clique com o botão direito e Open with → Google Sheets.

Edit carefully

• Deixe a linha 1 como cabeçalho — mesmo texto, mesma ordem, sem colunas extras ou células mescladas.
• Adicione uma nova linha por client abaixo da linha de exemplo (pode apagar a linha de exemplo ao terminar ou manter e colocar seus dados abaixo — só não envie arquivo com texto placeholder do tutorial nas células de dados).
• Se o Sheets alterar números (ex.: telefones ou monthlyPayment), selecione as células → Format → Number → Plain text para os valores ficarem como o Aquatechy espera (telefones de 10 dígitos, centavos só como dígitos).

Save back to CSV for Aquatechy

• Ao terminar: File → Download → Comma Separated Values (.csv) apenas — é o que o Aquatechy importa. Não envie Excel ou outros formatos.
• Envie somente esse .csv em Choose File na página de importação.

2. Fill the sheet

As regras abaixo valem no Google Sheets, Excel ou outro app — sempre exporte CSV no final.

Trabalhe a partir da linha de exemplo: copie a estrutura, uma linha por client. Complete toda coluna para cada linha conforme template e exemplo — sem pular colunas.

• Headers — Não renomeie nem reordene colunas.
• Export — Salve apenas como .csv para upload; o Aquatechy não importa .xlsx, .xls ou outros tipos.
• Phone — Use 10 dígitos apenas (sem hífens ou parênteses). O Aquatechy formata como +1 (###) ###-####. Linhas com telefone inválido aparecem destacadas na prévia e Import fica desabilitado até todos serem válidos.
• E-mail — Obrigatório em cada linha.
• clientState / poolState — Códigos de duas letras funcionam (ex.: FL). Nomes completos de estado também são normalizados quando possível.
• animalDanger — Use TRUE ou FALSE (case-insensitive na importação).
• poolType — Use um dos valores permitidos (ex.: Chlorine, Salt, Other) — informe valor em toda linha; siga o template.
• clientType — Residential ou Commercial.
• monthlyPayment — Armazenado em centavos no arquivo: só dígitos, ex.: 11000 representa $110.00 (a prévia mostra formatação em dólares).

As colunas do template incluem campos de cobrança e localização da pool (ex.: clientAddress, poolAddress, poolAddressLine2, customerCode, clientCompany, lockerCode, enterSide, poolNotes, clientNotes, etc.). Preencha cada coluna como a linha de exemplo demonstra para aquele tipo de campo.

3. Import in Aquatechy

De volta em Import Clients from CSV:

1. Escolha Company owner — todo client importado fica vinculado a esta company.
2. Clique Choose File e selecione seu .csv preenchido.
3. Revise a tabela de prévia. Corrija linhas ainda sinalizadas (ex.: E-mail required, Phone must be 10 digits ou campos obrigatórios faltando) e reenvie se necessário.
4. Quando a prévia estiver boa, execute Import {n} Clients (o rótulo inclui a contagem de linhas).

Se o arquivo não puder ser analisado, verá erro pedindo o formato correto do template CSV.

After the import

O processo cria uma pool para cada client do arquivo. Planeje uma passagem rápida no app para ajustar detalhes da pool se precisar, e configure agendas de serviço em Routes (assignments não são definidos por esta importação CSV).