Controllr/Manual/Importar Planilha de Dados
Índice
Importar Planilha de Dados
Nas versões mais recentes (a partir da Build 122), os usuários do ISP Controllr ganharam a capacidade de realizar a importação manual de dados de forma autônoma. Essa funcionalidade permitirá aos usuários incorporar informações provenientes de outros sistemas diretamente no Controllr, ampliando a flexibilidade e a eficiência do processo. O método escolhido para essa importação é a utilização de planilhas no formato CSV (Comma-Separated Values). Essa abordagem oferece uma forma padronizada e acessível de transferir dados, garantindo compatibilidade e facilitando a integração de informações externas no ISP Controllr.
A seguir, seguem os aplicativos que permitem a importação de dados dentro do seu sistema:
- Clientes
- Contratos
- Perfis
- Cobranças
- Autenticação de CPE
- Fibra OLT
- Setor de Distribuição
- Planos de Acessos
- Monitor Pool
- Ponto de Distribuição
- Equipamentos
Montando as Tabelas
Algumas versões do Excel definem a vírgula (,) como separador de espaçamento. Troque esse separador para o ponto e vírgula (;).
Antes de importar os dados para o Controllr, deve-se montar as planilhas seguindo rigorosamente a ordem das colunas e os valores a serem preenchidos em cada coluna. Adiante, será mostrado o passo a passo de como criar esses arquivos em algumas plataformas.
Recomenda-se criar um arquivo para cada aplicativo dentro do Controllr. Dessa forma, caso precise, ainda terá o arquivo preenchido para fazer novamente o processo.
Excel
Após a criação de um novo arquivo, assegure-se de inserir os dados de maneira precisa. Inclua o cabeçalho na linha imediatamente superior, contendo os nomes dos campos. Nas linhas subsequentes, adicione os dados correspondentes aos respectivos campos.
Finalizando o preenchimento dos dados em sua tabela, clique na opção Arquivo > Salvar como > Em Tipo marque a opção CSV (separado por vírgulas) (*.csv) esse é o formato que o Controllr irá importar a sua tabela.
O Excel mostrará uma mensagem de que alguns recursos poderão ser perdidos, basta marcar a opção Sim.
Ao finalizar e salvar a tabela no formato correto, abra o seu CSV no Notepad ++ ou, caso prefira, poderá usar o Bloco de Notas do sistema operacional Windows.
Ao salvar a sua tabela a codificação padrão é a ANSI. Como algumas palavras tem caracteres especiais (acentuação e a letra Ç), ao importar essa tabela, você terá que converter essa codificação para que o Controllr leia corretamente os caracteres especiais. A codificação final deverá estar no formato UTF-8.
_Notepad++_
Veja as imagens abaixo demonstrando o procedimento dentro do ambiente do Notepad++. A primeira imagem mostra como abrir o arquivo CSV gerado anteriormente dentro do aplicativo. A segunda imagem contém o passo fundamental, ela exibe o local onde devemos clicar para converter o formato. Por fim, finalize pressionando Ctrl + S para salvar o arquivo.
_Bloco de Notas_
No aplicativo de Bloco de Notas, ressalve o arquivo alterando a codificação no momento em que irá salvar.
Aplicativos
Pronto, agora basta adicionar o arquivo de sua planilha no aplicativo correspondente dentro do seu Controllr. Abaixo, descreveremos os principais aplicativos em nosso sistema e quais os campos necessários para fazer a importação corretamente.
Clientes
No aplicativo de Clientes, é possível efetuar a inserção simultânea de diversos usuários. No menu superior, basta escolher o botão de 
Importar. Clique aqui para baixar o arquivo exemplo, que já conta com dois clientes devidamente preenchidos, abrangendo uma Pessoa Física e uma Pessoa Jurídica, facilitando assim o processo de preenchimento.
O botão 
Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
| # | Nome das Colunas | Obrigatório | Valores |
|---|---|---|---|
| 01º | ID do Cliente | Não | Numérico |
| 02º | Status | Não | Ativo (Habilitado) / Desabilitado (Desativado) Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 03º | Tipo (Pessoa) | Não | Física / Jurídica Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 04º | Nome / Razão Social | Sim | Textual |
| 05º | Sobrenome / Nome Fantasia | Não | Textual |
| 06º | Não | Textual Caso precise adicionar mais de um valor, você deverá separar os valores com o sinal ##. | |
| 07º | Telefone(s) | Não | Textual Caso precise adicionar mais de um valor, você deverá separar os valores com o sinal ##. |
| 08º | CPF / CNPJ | Não | Textual |
| 09º | RG / IE | Não | Textual |
| 10º | Usuário (Hotsite) | Não | Textual |
| 11º | Senha (Hotsite) | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 12º | Escritório | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 13º | Data Nascimento | Não | Formato: DD/MM/AAAA ou YYYY/MM/DD Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 14º | Data Cadastro | Não | Formato: DD/MM/AAAA ou YYYY/MM/DD Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 15º | Observação | Não | Textual |
| 16º | Endereço | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 17º | Número | Não | Numérico Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 18º | Bairro | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 19º | Complemento | Não | Textual |
| 20º | CEP | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 21º | Estado | Não | Textual Caso informado, o valor deverá ter somente a sigla do estado. Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 22º | Cidade | Não | Textual |
| 23º | Latitude | Não | Textual Caso não preenchido, o valor padrão será 0.0. |
| 24º | Longitude | Não | Textual Caso não preenchido, o valor padrão será 0.0. |
Contratos
No aplicativo de Contratos, é possível efetuar a inserção simultânea de diversos acordos via documento com os seus clientes. No menu superior, basta escolher o botão de Importar. Clique aqui para baixar o arquivo exemplo, que já conta com dois exemplos, facilitando assim o processo de preenchimento.
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
| # | Nome das Colunas | Obrigatório | Valores |
|---|---|---|---|
| 01º | ID Contrato | Não | Numérico |
| 02º | Número do Contrato | Não | Numérico |
| 03º | ID do Cliente | Sim | Numérico |
| 04º | Status | Não | Desabilitado / Ativado / Alertado / Pendente / Bloqueado / Cancelado Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 05º | Cortesia | Não | Sim (1) / Não (0) Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 06º | Vencimento | Não | Numérico Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 07º | Banco | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 08º | Modelo Contrato | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 09º | Escritório | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 10º | Perfil | Não | Textual Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 11º | CFOP | Não | Numérico Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 12º | ICMS | Não | Monetário |
| 13º | IBPT | Não | Monetário |
| 14º | Desconto | Não | Monetário Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 15º | Observação | Não | Textual |
| 16º | Data Cadastro | Não | Formato: DD/MM/AAAA ou YYYY/MM/DD Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 17º | Data Ativação | Não | Formato: DD/MM/AAAA ou YYYY/MM/DD Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 18º | Bloqueio Automático | Não | Sim / Não Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 19º | Permitir Visualização | Não | Sim / Não Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
| 20º | Permitir Impressão | Não | Sim / Não Caso não preenchido, o valor padrão será o definido na categoria Informações Padrão. |
Perfis
Dentro de cada contrato, há um Perfil associado. E dentro dela, você consegue adicionar vários perfis de uma vez. No menu superior, basta escolher o botão de Importar. Clique aqui para baixar o arquivo exemplo, que já conta com dois exemplos, facilitando assim o processo de preenchimento.
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
| # | Nome das Colunas | Obrigatório | Valores |
|---|---|---|---|
| 01º | Número (Contrato) | Sim | Numérico |
Cobranças
Dentro do aplicativo Financeiro, contém o aplicativo de Cobranças relacionadas a dívidas do seus clientes. E dentro dele, você consegue adicionar as Cobranças de uma só vez. No menu superior, basta escolher o botão de Importar. Clique aqui para baixar o arquivo exemplo, que já conta com dois exemplos, facilitando assim o processo de preenchimento.
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
| # | Nome das Colunas | Obrigatório | Valores |
|---|---|---|---|
| 01º | ID da Cobrança | Não | Numérico |
| 02º | Número do Contrato | Sim | Numérico (Número do contrato da tabela contrato) |
| 03º | Nosso Número | Sim | Numérico |
| 04º | Data de Criação | Sim | Data Formato - DD/MM/AAAA |
| 05º | Data de Vencimento | Sim | Data Formato - DD/MM/AAAA |
| 06º | Data de Crédito (Pagamento) | Não | Data Formato - DD/MM/AAAA |
| 07º | Valor da Cobrança | Sim | Monetário (0.00) |
| 08º | Valor Pago da Cobrança | Não | Monetário (0.00) |
| 09º | Tipo de Cobrança | Sim | Internet / Avulso / Suporte |
| 10º | Método de Pagamento | Sim | Dinheiro / Banco / Cartão / Cheque / Gateway |
| 11º | Observações | Não | Textual |
| 12º | Parcela | Não | Sim / Não |
| 13º | Proporcional | Não | Sim / Não |
| 14º | ID do Cliente | Sim | Numérico (ID do cliente da tabela cliente) |
| 15º | Gateway Key | Não | Textual |
| 16º | ID do Banco | Sim | Numérico |
Autenticação de CPE
Dentro do aplicativo ISP, você encontra as autenticações de cada usuário na página Autenticação. E dentro dele, você consegue adicionar diversas CPE de uma só vez. No menu superior, basta escolher o botão de Importar. Clique aqui para baixar o arquivo exemplo, que já conta com dois exemplos, facilitando assim o processo de preenchimento.
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
| # | Nome das Colunas | Obrigatório | Valores |
|---|---|---|---|
| 01º | Usuário (Autenticação) | Sim | Textual |
| 02º | Senha (Autenticação) | Sim | Textual |
| 03º | Painel | Não | Textual (Se informado verifica a existência do nome do painel), vazio é referênciado o Painel Padrão |
| 04º | Grátis | Sim | Sim / Não |
| 05º | Número do Contrato | Sim | Numérico |
| 06º | Número ID do Cliente | Sim | Numérico |
| 07º | Plano | Sim | Textual (O nome deve ser igual ao do cadastro do Plano de Acesso) |
| 08º | Dispositivo | Sim | Textual (O nome deve ser igual ao cadastro do Dispositivo) |
| 09º | Tipo do IP | Sim | Não Preencher / Preencher Manualmente / Auto-Preencher |
| 10º | IP | Sim / Não | Numérico (É obrigatório o preenchimento se setar a opção Preencher Manualmente ) |
| 11º | Tipo de Autenticação | Sim | DHCP / IPxMAC / HOTSPOT / PPPoE |
| 12º | Tipo da MAC | Sim | Não Preencher / Preencher Manualmente / Auto-Preencher |
| 13º | MAC | Sim / Não | Textual (É obrigatório o preenchimento se setar a opção Preencher Manualmente ) |
| 14º | Subrede | Sim | Textual (O nome deve ser igual ao cadastro no APP Subredes) |
| 15º | Comodato (Equipamento) | Sim | Sim / Não |
| 16º | Fibra | Sim | Sim / Não |
| 17º | Latitude (Equipamento) | Não | Numérico |
| 18º | Longitude (Equipamento) | Não | Numérico |
| 19º | Status | Sim | Ativado / Bloqueado / Pendente / Desabilitado |
Fibra OLT
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
Setor de Distribuição
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
Planos de Acessos
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
Monitor Pool
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
Ponto de Distribuição
O botão Importar só estará disponível para ativação após o preenchimento de determinados campos na categoria de Informações Padrões. Esta etapa é crucial, pois caso alguma célula na planilha esteja em branco, ela será automaticamente preenchida com as informações padrão, garantindo a integridade e a consistência dos dados.
Equipamentos
Download tabela em branco (com 2 equipamentos exemplo PF e PJ): Link
| # | Nome das Colunas | Obrigatório | Valores |
|---|---|---|---|
| 01º | ID do Equipamento | Não | Numérico |
| 02º | Nome do equipamento | Sim | Textual |
| 03º | MAC | Sim | Textual |
| 04º | Número do Equipamento | Sim | Numérico |
| 05º | Lote do Equipamento | Sim | Numérico |
| 06º | Nota Fiscal | Não | Numérico |
| 07º | Série da Nota Fiscal | Não | Numérico |
| 08º | Observação | Não | Textual |
O botão "Importar" só se tornará ativo após o preenchimento de todos os campos.
- Os campos serão informações complementares para os Equipamentos.
