# Configuração da Criação Automática de Usuários - EXA

## Introdução

>[!TIP] O que é a EXA?
> A [EXA](https://exa.com.br/) é uma plataforma especializada em segurança digital, focada em oferecer soluções para a navegação segura de usuários à internet.

A funcionalidade de **Criação Automática de Usuários** do sistema EXA permite otimizar a gestão de contas de usuário, automatizando a criação de novos perfis com base em critérios predefinidos. Este processo visa aumentar a eficiência, reduzir erros manuais e garantir que os novos usuários sejam configurados com as permissões e acessos corretos, de acordo com os parâmetros definidos pelo administrador.

>[!NOTE] **Acesso à Funcionalidade**
>**Caminho:** Configurações > Integrações > Integrações SVA > Permite criar usuários automaticamente

### Requisitos de Uso
Para utilizar este recurso, é necessário atender as seguintes condições:
- Possuir conta ativa na EXA;
- Credenciais de acesso à API da EXA para efetuar o cadastro da integração no sistema.

## Entrega de Valor
A **Criação Automática de Usuários** oferece diversos benefícios para a gestão de contas no sistema EXA. Abaixo estão os principais valores entregues por essa funcionalidade:
- Redução de erros manuais;
- Economia de tempo ao automatizar a criação de usuários, possibilitando o investimento em outras tarefas relevantes;
- Garante que todos os usuários sejam configurados de acordo com os mesmos parâmetros;
- Promove maior agilidade, tornando o processo mais rápido e evitando falhas de criação;
- Melhoria na experiência do usuário final.

## Estrutura da Funcionalidade
A funcionalidade de **Criação Automática de Usuários** para a [[integracao sva -  exa|Integração SVA -  EXA]] consiste nas seguintes configurações:
- **Cadastro e Parametrização da Integração SVA EXA**: A primeira etapa da configuração da **Criação Automática de Usuários** consiste no **cadastro e parametrização da integração SVA EXA**, que estabelece a comunicação entre o sistema EXA e os sistemas externos SVA. Essa integração permite que o processo de criação de usuários seja automatizado.
- **Cadastro de Produtos SVA**: A segunda etapa consiste no **Cadastro de Produtos SVA**, que visa vincular os produtos à integração. Isso garante que, ao ativar um usuário, ele tenha acesso ao produto SVA correspondente.
- **Informações Essenciais no Contrato**: Para garantir a eficácia da criação automática de usuários, é fundamental que o contrato contenha as seguintes informações essenciais:
    - **E-mail do Usuário**
    - **Telefone Celular**
    - **CNPJ/CPF**
    - **Produto SVA Relacionado ao Contrato**


## Configuração da Criação Automática de Usuários

### Passo 1: Parametrização da Integração EXA

#### 1.1 Cadastro da Integração EXA no Sistema
Para estabelecer a comunicação entre o sistema e a EXA e efetuar o gerenciamento da integração diretamente pelo sistema, é necessário efetuar o cadastro da integração, permitindo a troca de dados entre as plataformas envolvidas. Siga os passos abaixo:

1. Acesse o formulário de **[[integracoes de sva|Integrações de SVA]]** através do caminho: Configurações > Integrações > Integrações SVA;
2. Clique no botão **Novo** para cadastrar a integração;
3. Selecione **EXA** no campo **Plataforma**;
4. Preencha os campos:
	- **URL:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma **EXA** para estabelecer a comunicação entre os sistemas. Insira a URL fornecida pela plataforma. 
	- **Seu prefixo:** informação respectiva ao campo Seu prefixo na plataforma EXA;
	- **Permite criar usuários automaticamente:** ao marcar o filtro como **sim**, e um contrato for ativado com um produto SVA EXA inserido, o usuário SVA criado será criado automaticamente com os dados cadastrais do cliente. O mesmo se aplica quando inserido um produto EXA em contratos já ativos. Se marcado como **não**, necessário realizar o cadastro manual.
	  
5. Clique em **Salvar** para validar as modificações e finalizar o cadastro da integração. 

#### 1.2 Edição de Integração já Cadastrada
Se a integração EXA já estiver cadastrada, é possível ajustar a opção de criação automática de usuários para ativar essa parametrização, portanto, edite o campo a seguir:

- **Permite criar usuários automaticamente**: Ao marcar a opção como **Sim**, usuários serão automaticamente criados com os dados do cliente ao ativar contratos com produtos EXA. Caso seja marcado como **Não**, o cadastro do usuário deverá ser feito manualmente.

### Passo 2: Cadastro do Produto SVA
O cadastro do produto de SVA é essencial para a gestão do produto no contrato, faturamento e também para permitir a ativação do usuário SVA, pois o produto se relaciona com a integração pelos pacotes disponibilizados pela plataforma.

>[!DANGER] Atenção:
>A criação automática do usuário SVA somente é possível se o produto estiver devidamente criado, relacionado à integração e vinculado ao contrato do cliente. Sem essas condições, o processo de criação automática de usuários não será realizado.

>[!INFO] Importante:
>O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastros > Produtos;
2. Pressione o botão **Novo**;
3. Preencha os campos obrigatórios na aba **Produtos** e na aba **Planejamento**;
4. Acesse a aba **SVA**;
5. Preencha os campos:
	- **ID Integração SVA:** clique na lupa e selecione o cadastro da integração de SVA EXA e vincule ao campo;
	- **Pacote SVA principal:** insira o código do pacote que será ofertado ao cliente. Este dado é informado pela plataforma credenciada.
	
>[!CAUTION] Atenção:
>O pacote SVA Principal deve conter apenas o vínculo de um único produto. Cada produto no sistema deve corresponder a um pacote específico na plataforma, garantindo melhor gerenciamento dos contratos e produtos fornecidos ao usuário SVA.	  
	  
6. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3: Ativação do Usuário SVA
O **cadastro do contrato do cliente** permite o registro e gerenciamento dos acordos entre a empresa e seus clientes. Esta funcionalidade centraliza informações essenciais, como o modelo de contrato, os produtos relacionados e o faturamento. Além disso, também possibilita a **ativação do usuário SVA**.

Quando configurada a criação automática de usuários SVA, a ativação ocorre automaticamente a partir da ativação do contrato do cliente, desde que os seguintes requisitos sejam atendidos:
- **E-mail cadastrado**;
- **Telefone cadastrado**;
- **CPF/CNPJ preenchido e válido**;
- **Produto SVA vinculado ao contrato**.

>[!danger] Atenção:
>Caso algum desses requisitos não esteja preenchido, o processo de ativação automática do usuário SVA não será realizado. 
>

A ativação automática de um usuário SVA pode ocorrer através do cadastro de um contrato **novo** ou de um contrato **já existente**.

#### 3.1 Novo contrato
Ao cadastrar um **novo contrato**, o sistema verifica automaticamente se os **requisitos** para a criação do usuário SVA estão atendidos:
- **E-mail cadastrado**;
- **Telefone celular cadastrado**;
- **CPF/CNPJ preenchido e válido**;
- **Produto SVA vinculado ao contrato**.

Se todos os dados estiverem corretos e completos, o sistema ativa automaticamente o usuário SVA. Para efetuar este procedimento, siga os passos a seguir:

1. Acesse o formulário de [[formulario contrato do cliente|Contrato do Cliente]] através do caminho: Sistema > Cadastros > Contratos;
2. Clique no botão novo para cadastrar o contrato;
3. Na aba **Contrato**, preencha os campos:
	- **Tipo**: selecione o tipo de serviço (Internet, Telefonia, Serviços, SVA); 
	- **Cliente**: selecione o cliente ao qual o contrato será atribuído;		
	- **Planos de venda**: indique o plano de venda específico para o cliente. Certifique-se de que o produto de SVA está atrelado à este plano de venda ou insira-o manualmente ao contrato **antes** de realizar a ativação;
	- **Descrição**: forneça uma breve descrição do contrato;
	- **Tipo de cobrança**: clique na lupa e indique a forma de geração dos boletos do cliente (quantidade de vezes, vencimento, etc);
	- **Modelo para impressão**: selecione o modelo de impressão do contrato;
	- **Filial**: indique a filial responsável pelo contrato;
	- **Data base financeiro**: a data indica quando o cliente começa a usar o serviço e é usada para calcular a cobrança recorrente. Ela é preenchida automaticamente ao ativar o contrato;
	- **Data renovação**: esse campo servirá para informar a data em que o cliente efetuou a renovação do contrato.
	  
4. Em seguida, acesse a aba **Faturamento** e preencha os campos:
	- **Tipo documento fatura**: selecione o tipo de documento para a fatura;
	- **Carteira de cobrança**: selecione a carteira de cobrança;
	- **Vendedor**: indique o vendedor responsável pelo contrato;
	- **Tipo de envio de cobrança**: selecione a forma de envio da cobrança; 
	- **Gera financeiro automático**: indique se o financeiro será gerado automaticamente;
	- **Base geração por tipo de documento**: escolha a base de geração do documento (Documento opcional do contrato, Documento do produto do contrato ou Padrão).
	
5. Após preencher todas as informações, **revise** os dados inseridos.
6. Clique no botão **Salvar** para finalizar o cadastro do contrato.

Ao **salvar** o contrato, ele assumirá **status diferentes de ativo**. O contrato poderá ser efetivamente ativado, assumindo o status **ativo**, por meio das seguintes possibilidades:
- Ativação manual diretamente pelo contrato do cliente pelo botão **Ativar**, quando houver assinatura presencial;
- Ativação através da assinatura digital utilizando a integração [[ixc assina|IXC Assina]];
- Ativação através da assinatura pela [[central do assinante|Central do Assinante]];
- Ativação através do aceite eletrônico através do Opa! Suite.

Após assumir o status **Ativo**, o usuário SVA é criado automaticamente e ficará armazenado no sistema, podendo ser acessado através dos caminhos:
- Sistema > Cadastros > TV/SVA > [[usuarios sva|Usuários SVA]];
- Sistema > Cadastros > Contratos > [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]].

#### 3.2 Contrato já ativo
A **ativação automática de usuários SVA** para **contratos já ativos** ocorre quando um **produto SVA** é inserido no contrato. Nesse cenário, o contrato já está ativo, mas ainda não possui o consumo do produto SVA. Ao incluir o produto no contrato, o sistema valida os seguintes dados para a criação automática do usuário SVA:
- **E-mail cadastrado**;
- **Telefone cadastrado**;
- **CPF/CNPJ preenchido e válido**.

Para incluir um novo produto SVA em um contrato já ativo, siga os passos a seguir:

1. Acesse o contrato do cliente do qual deseja realizar a ativação do produto e do usuário SVA através do caminho: Sistema > Cadastros > Contratos;
2. Selecione o contrato do cliente e clique em **Editar**;
3. Acesse a aba **Produtos** e clique no botão **Novo**;
4. Preencha os campos:
	- **Tipo:** marque a opção **SVA**;
	- **Produto/Serviço:** clique na lupa e selecione o produto cadastrado e relacionado à integração EXA;
	- **Quantidade:** defina a quantidade de produto com o valor 1.
	  
5. Clique em **Salvar** para concluir as alterações.

Após salvar, o sistema automaticamente criará o usuário SVA com base nos dados do cliente. O usuário ficará armazenado no sistema e poderá ser acessado pelos seguintes caminhos:
- Sistema > Cadastros > TV/SVA > [[usuarios sva|Usuários SVA]];
- Sistema > Cadastros > Contratos > [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]

## Casos de Uso

### Desativação de Usuário SVA
Ao utilizar o parâmetro **Permite criar usuários automaticamente** configurado como **sim**, quando um **produto SVA** é removido do contrato, o **usuário SVA** será automaticamente **deletado** do sistema.

## Fluxo de Trabalho
```mermaid
flowchart TD
    A[Contratação com a plataforma EXA] --> B
    B[Cadastro da integração com os dados da API] --> C
    C[Parametrização de ativação automática de usuários SVA] --> D
    D[Sistema estabelece comunicação com a EXA] --> E
    E[Cadastro do produto EXA SVA no sistema] --> F
    F[Ativação de contratos] --> G & H
    G[Avalia se existe e-mail, telefone, CPF/CNPJ preenchidos] --> J
    H[Avalia se o produto de SVA está no contrato] --> I & J
    I[Dados corretos] --> K[Criar automaticamente o usuário SVA]
    J[Dados incorretos] --> L[Não cria o usuário SVA]
```

## Considerações Finais
A funcionalidade de **Criação Automática de Usuários** otimiza o processo de ativação, garantindo que apenas usuários com dados completos e válidos (e-mail, telefone, CPF/CNPJ e produto SVA) sejam ativados automaticamente. Isso reduz erros operacionais e melhora a experiência do usuário. A integração entre EXA e a plataforma assegura uma comunicação eficiente e sem falhas, agilizando o acesso aos serviços contratados. Contudo, a qualidade dos dados inseridos é crucial para o sucesso do processo, sendo essencial garantir que as informações sejam corretamente preenchidas para evitar falhas na criação do usuário.

## Etiquetas
#Integracoes #IntegracoesSVA #IntegracaoEXA #CriacaoAutomaticaUsuarioSVA #UsuarioSVA

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [[integracao sva -  exa|Integração SVA -  EXA]]
- [EXA](https://exa.com.br/)
- [[usuarios sva|Usuários SVA]]
- [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[formulario cliente|Formulário Cliente]]