> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.gdash.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como criar clientes e unidades consumidoras em massa.

A criação em massa de **Clientes e  Unidades Consumidoras (UCs)** é uma funcionalidade bastante útil em diversos cenários, especialmente quando há a necessidade de manter os dados atualizados de forma rápida e eficiente. Neste artigo, vamos mostrar como realizar essas criações por meio de planilhas.

Para facilitar o processo de importação, o **GDASH disponibiliza uma planilha padrão**. Nela, você pode preencher todas as informações necessárias de forma organizada e no formato correto para que o sistema reconheça os dados.

| **Dica importante:** recomendamos que o preenchimento da planilha seja feito **por usina**. Assim, no momento da importação, será mais simples relacionar corretamente os **clientes** e as **Unidades Consumidoras (UCs)** à usina correspondente.

1. Clique na aba clientes, e em seguida no link Clique para baixar um modelo de .xlsx

![Download de planilha padrão de importação de clientes e UCs.](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_11p546a.png)

### Modelos de Planilhas Disponíveis:

O GDASH disponibiliza **dois modelos de planilhas** para importação, que variam conforme o tipo de conta do usuário:

* **Planilha para Monitoramento (PRO):** para contas que utilizam o GDASH apenas para o monitoramento de usinas e unidades consumidoras.
* **Planilha para Investimento (SPE):** voltada para contas que, além do monitoramento, incluem usinas de investimento e gestão de beneficiários.

### Preenchimento para Unidades Consumidoras de Usinas PRO

![Preenchimento de dados usina PRO](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1t3wel9.png)

No caso de usinas PRO, o preenchimento da planilha deve ser feito apenas até o campo **Subclasse**. Abaixo, explicamos o que deve ser inserido em cada campo:

* **CPF/CNPJ**: Dados de CPF ou CNPJ informado nas faturas da concessionária;
* **Nome/Razão Social**: Nome do cliente informado nas faturas da concessionária;
* **Número do cliente**: Código ou número da instalação, conforme a nomenclatura utilizada pela concessionária. É o identificador da UC junto à distribuidora;
* **Concessionária**: Concessionária que atende a localização do cliente cadastrado.
* **E-mail e Telefone**: dados de contato do cliente.
* **Senha para desbloqueio de faturas:** Senha para desbloqueio das faturas que foram cadastradas para serem importadas via e-mail. Normalmente são os 4 ou 5 primeiros dígitos do CPF/CNPJ do titular da fatura.
* **Número da Instalação:** número de identificação da Unidade Consumidora. Esse campo pode ter nomes diferentes, dependendo da concessionária. Entre as variações mais comuns estão: Instalação, Código da Instalação, Unidade Consumidora. Independentemente da nomenclatura utilizada, todos se referem ao mesmo dado: o identificador único da unidade junto à concessionária.
* **Nome da Instalação:** Nome da Unidade Consumidora. Durante a importação manual de faturas, esse campo é normalmente preenchido com o endereço da UC fornecido pela concessionária, mas pode ser qualquer nome usado para identificação interna.
* **Novo número de instalação**: Alteração do número das UCs para cumprir a Resolução Normativa ANEEL nº 1.095/2024 a partir de 2026
* **Número da UC Geradora**: Informar o número da instalação da fonte de crédito (geradora) de cada beneficiária;
* **Unidade Geradora**: Indique **"Sim"** se a UC for a geradora dos créditos, ou **"Não"** se for uma beneficiária.
* **Percentual de rateio**: Percentual dos créditos de energia a serem compensados por essa UC, conforme cadastrado na concessionária.
* **Tipo de Conexão**: Informe o tipo de conexão da unidade: **monofásico**, **bifásico** ou **trifásico**.
* **Modalidade Tarifária** e **Subclasse**: Essas informações estão disponíveis na fatura da UC. Para o campo **Subclasse**, utilize **"comum"** em todos os casos, exceto quando a UC for classificada como **irrigação noturna**.

### Preenchimento para Unidades Consumidoras de Usinas SPE

![Dados Usinas SPE](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_wyorlu.png)
Além dos campos comuns já utilizados nas usinas do tipo PRO, as Unidades Consumidoras vinculadas a usinas SPE exigem o preenchimento de campos adicionais. Veja abaixo a explicação de cada um:

* **Percentual de Desconto**: Refere-se ao percentual de desconto aplicado sobre a energia compensada, conforme o modelo de negócio da empresa. Exemplo: se o cliente recebe 20% de desconto sobre os créditos compensados, informe **20** neste campo.
* **Carência (em meses)**: Representa o período, a partir da data de início do contrato, durante o qual a UC **ainda não receberá créditos**. Se a UC **já estiver recebendo créditos**, preencha o campo com **0**.
* **Data de Início do Contrato**: Campo **obrigatório** para geração de cobranças. Esta data também é usada em conjunto com o campo de **carência** para calcular o início da compensação. Se a UC já estiver recebendo créditos, informe uma **data anterior à data atual**.
* **Data de Fim de Contrato**: Deve ser preenchida **apenas** se a UC já possuir uma data definida para encerramento do contrato.
* **Desconto na Carência**: Permite aplicar um **percentual de desconto diferente** durante o período de carência. Este campo funciona em conjunto com os campos **Carência** e **Data de Início de Contrato**.
* **Economia total (em Reais) - deve conter o valor de economia que a Unidade Consumidora (UC)** já possuía **antes da migração para o GDASH**. No sistema, esse valor será utilizado como ponto de partida. Assim, a **primeira economia gerada pela UC dentro do GDASH** será **somada** ao valor informado nesta coluna.

**Exemplo de Desconto na Carência**: 
Se o cliente recebe normalmente 20% de desconto, mas nos **3 primeiros meses** foi acordado um desconto maior, de **25%**, preencha: **Carência**: 3 ,**Data de Início do Contrato**: data de início do benefício, **Desconto na Carência**: 25 conforme a primeira linha da imagem acima.

**Exemplo de Economia total:**
Se a UC já tinha uma economia acumulada de **R$ 1.200,00** antes da migração, e na primeira cobrança dentro do GDASH foi gerada uma economia de **R$ 300,00**, o demonstrativo da cobrança passará a registrar a economia total da UC de **R$ 1.500,00**.

# Exemplo prático de preenchimento

![Exemplo de preenchimento planilha de clientes](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_am2psl.png)
![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image179axhx_1gpimq5.png)

O **Número do Cliente** é um campo fundamental no preenchimento da planilha, pois é ele que determina se as **Unidades Consumidoras (UCs)** serão **agrupadas em um mesmo cliente** ou tratadas de forma **separada** dentro do GDASH.
🔹 **Importante:** esse campo **não precisa ser igual** ao número de cliente presente na fatura da concessionária.
Isso porque, em algumas concessionárias, o número de cliente está vinculado diretamente à **UC** e não ao cliente em si.
Nesses casos, você pode utilizar um **número de identificação interno** (definido por sua equipe) para unir ou separar as UCs conforme a necessidade de gestão.

### Exemplo de Agrupamento de UCs
Na imagem acima, ao realizar a importação no GDASH:
* O **CLIENTE 01** terá **5 UCs vinculadas** a ele.
* O **CLIENTE 02** terá **2 UCs vinculadas**.
* Os demais clientes terão **apenas 1 UC vinculada** cada.
Esse comportamento ocorre porque o campo **Número do Cliente** é utilizado para definir o agrupamento das Unidades Consumidoras.

![CLIENTE 01 - 5 UCs](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_2zbulg.png)
![Demais clientes e respectivas UCs](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_y5czo9.png)
# Passo a passo de importação da planilha

2. No menu do GDASH, clique na aba **Clientes**, em seguida, selecione a opção **Importar Clientes**. Escolha a **planilha preenchida** em seu computador e confirme a importação.

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/importar-clientes_1ic5hbp.png)

3. Ao importar a planilha, verifique se as **colunas da planilha** estão corretamente relacionadas com os **campos do GDASH**. Se você estiver utilizando a **planilha padrão disponibilizada pelo GDASH**, essa correspondência será feita **automaticamente**. Após a conferência, clique em **Salvar**.

![Correlação de colunas da planilha e campos do GDASH](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/correlacao-de-colunas_9n6p9h.png)
4. Um aviso informando que os clientes que possuem mais de uma UC, será criado apenas uma vez será mostrado. Clique em prosseguir. 

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/aviso_1k8dtwt.png)
5. Selecione todos os clientes ao lado na caixa ao lado da coluna Nome, logo após clique em Atribuir a uma usina

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1niymnc.png)

6. Busque a usina em que deseja relacionar os clientes e clique em selecionar.
![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1hc6xy7.png)
7. Por fim, clique em importar clientes no final da página

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_5erfkv.png)
8. Pronto, os clientes e as UCs serão criadas na respectiva usina. 


![Lista de Clientes da Usina FV 01](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_1hadcm3.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/8/0/f/f/80ffc517dd839800/image_oms7cd.png)


| **Dúvidas ou problemas? Fale com nosso suporte clicando&#32;[aqui](https://wa.me/553172170619)!**