# Integrações SVA - SVA Brasil

## Introdução

>[!TIP] Definição - SVA Brasil:
>A [SVA Brasil](https://svabrasil.com.br/) é uma empresa especializada em **Serviços de Valor Agregado** para provedores de internet. Seu objetivo é centralizar a gestão de benefícios, melhorar a qualidade de serviços e expandir oportunidades de negócio.

A integração entre a SVA Brasil e o Sistema foi desenvolvida para aprimorar a gestão de serviços de telecomunicações e conteúdo digital, oferecendo uma plataforma unificada para provedores de internet. Esta integração visa expandir o portfólio de serviços oferecidos pelos provedores de internet, incluindo benefícios de saúde, seguros e assistências. Esta integração permite:
- Oferta de serviços diferenciados;
- Centralização da gestão de clientes e faturamento;
- Aumento da competitividade no mercado;
- Diversificação de receitas;

> [!NOTA] **Acesso ao Formulário**
> **Caminho:** Configurações > Integrações > Integrações SVA

### Requisitos de Uso
- Conta ativa na SVA Brasil;
- Credenciais de acesso à API da SVA Brasil.

## Entrega de Valor
A integração do sistema com a [SVA Brasil](https://svabrasil.com.br/) visa centralizar as informações do provedor em um único local e facilitar a gestão de clientes e faturamento mensal. Além disso, promove:
- Otimização do controle de inadimplência;
- Informações centralizadas em um único ambiente;
- Diminui a taxa de imposto utilizando os produtos da integração SVA;
- Aumento do ticket médio;
- Fidelização de clientes;
- Expansão do portfólio de serviços do provedor;
- Aumento de receita e satisfação do cliente;
- Centralização da gestão de clientes e faturamento;
- Fortalecimento da posição competitiva no mercado.

## Configuração da Integração
### Serviços oferecidos pela SVA Brasil
- **Seguros:** Residencial/Empresarial, Gamer, Prestamista;
- **Saúde:** Telemedicina, Chek-up, Assistência nutricional, Psicóloga, Mediamentos, Ondontologia, Pet, e outros;
- Curso Dominantes, Pré-vestibular e ENEM;
- Assistência veicular e rastreamento (veicular, bicicletas elétricas e outros);
- Clube de vantagens e benefícios personalizados.

### Passo 1: Cadastro da Integração
A comunicação entre o sistema IXC e a plataforma **SVA Brasil** ocorre por meio de um fluxo estruturado, no qual é necessário obter os dados de integração API da plataforma e registrá-los no IXC, com o objetivo de estabelecer a troca de informações entre as plataformas envolvidas. Para realizar este procedimento, siga os passos a seguir:

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. Preencha os campos obrigatórios:
	- **Plataforma:** Selecionar a integração SVA Brasil;
	- **Ambiente:** Insira o ambiente conforme fornecido pela plataforma SVA Brasil. O ambiente de **Homologação** é direcionado para testar e  o ambiente de **Produção**, para utilizar diretamente com os clientes;
	- **Login:** insira o login API fornecido pela plataforma;
	- **Senha:** insira a senha de acesso API fornecida pela plataforma.
	  
3. Clique em **Salvar** para validar o cadastro da integração.

>[!INFO]  Campos preenchidos **automaticamente** após a integração ser cadastrada:
>- **Token:** Preenchido automaticamente ao estabelecer a comunicação com a plataforma;

### Passo 2: Configuração 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.

>[!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. Clique no 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 SVA Brasil e vincule ao campo;
	- **Pacote SVA principal:** clique em **Buscar Pacotes SVA** e insira o código do pacote que será ofertado ao cliente. Este dado é informado pela plataforma credenciada.
	  
>[!Caution] Atenção:
>Os produtos exibidos pode variar conforme sua contratação. Consulte a plataforma SVA Brasil para verificar os produtos disponíveis.

>[!DANGER] Cuidado:
>Cada produto cadastrado comporta apenas um pacote. Para ofertar múltiplos pacotes da plataforma, é necessário criar cadastros individuais

>[!failure] Atenção:
>A plataforma SVA Brasil opera apenas com pacote principal, não sendo possível a utilização de pacotes adicionais.

8. Clique em **Salvar** para validar e finalizar o cadastro do produto.

### Passo 3: Produto no Contrato
Para realizar a gestão do contrato efetivamente, é necessário vincular o **produto de SVA** ao contrato. Esta ação permite realizar a geração do faturamento, emitir notas fiscais e também efetuar ativação do usuário SVA associado à integração. Esta ativação pode ocorrer diretamente pelo contrato ou por [[formulario planos de venda|Formulário Planos de Venda]].

1. No menu principal, navegue até **Sistema**;
2. Selecione **Cadastros**;
3. Clique em **Contrato**;
4. Pressione o botão **Editar** para acessar o contrato;
5. Navegue até a aba **Produtos** e clique no botão **Novo**. Defina o tipo do produto como **SVA** e no campo **Produto/Serviço**, clique na lupa e selecione o produto de SVA cadastrado. Clique em **Salvar** para validar as configurações.

>[!INFO] Produtos:
>Para acessar múltiplos produtos, o cliente deve ter a quantidade correspondente vinculada em seu contrato. O mesmo login SVA será utilizado para todos os produtos contratados.

### Passo 4: Ativação do Usuário SVA
Para permitir o acesso do usuário à plataforma, é necessário realizar a ativação do usuário SVA. Siga os passos abaixo:

>[!INFO] Usuário SVA:
>Com seu login e senha SVA, o cliente terá acesso direto ao produto final contratado.

>[!TIP] Validação de dados cadastrais:
>Para permitir a ativação do usuário SVA, a plataforma SVA Brasil valida os seguintes dados cadastrais do cliente:
>- Nome/Razão social;
>- CPF/CNPJ;
>- Sexo (contabilizado para pessoa física);
>- Data de nascimento (pessoa física);
>- Data de fundação (pessoa jurídica);
>- Endereço completo (exceto o campo *Complemento*);
>  
>  Certifique-se de que todos estes dados estão preenchidos no [[formulario cliente|Formulário Cliente]] para que a ativação do usuário SVA seja possível.

1. Acesse o formulário **Usuários SVA** através do caminho: Sistema > Contratos > selecione o contrato que deseja realizar a ativação do usuário SVA (já deve conter o produto no contrato) > Editar > aba SVA;
2. Clique no botão **Novo** para criar um usuário SVA;
3. Preencha os campos:
	- **ID integração:** Clique na lupa e selecione o cadastro da integração, vincule-a ao campo em questão;
	- **Usar dados cadastro:** Se **sim**, o sistema preencherá o campo **Usuário** com o e-mail principal do cadastro do cliente. Se **não**, deve preencher este dado manualmente;
	- **Usuário:** insira um e-mail válido;
	- **Subscrition ID:** valor retornado da API para identificar o cliente em ambas as plataformas.
	  
	**Campos preenchidos automaticamente:**
	-  **ID contrato:** preenchido automaticamente devido ao formulário de Usuário SVA se relacionar ao contrato do cliente e, portanto, o usuário ser ativo a partir deste local no sistema;
	  
4. Clique em **Salvar** para finalizar a ativação do usuário SVA e promover o acesso do cliente à plataforma credenciada.

## Casos de Uso

### Ações do Contrato
A integração com a plataforma da **SVA Brasil** valida ações sobre o contrato, impactando no acesso do usuário SVA, permitindo o controle de acesso pelo sistema e espelhando na plataforma credenciada.

#### Legenda de Status do Usuário SVA:
- **Ativo:** quando o usuário SVA está com o status de **ativo**, indica o consumo deste usuário sob o produto contratado;
- **Bloqueado:** quando o usuário SVA está com o status **bloqueado** no sistema, indica que o consumo está bloqueado. Na plataforma, este login é inativado e assim que ocorrer a liberação, é criado um novo registro de usuário na plataforma;
- **Desativado:** assume o status de **desativado** o usuário SVA que estiver atrelado à um contrato que foi cancelado.

#### Controle de acesso do usuário SVA a partir do status do contrato e alterações manuais:
- **Ativação do usuário e liberação do contrato após bloqueio por inadimplência:** permanece **ativo** o usuário SVA;
- **Financeiro em atraso:** o contrato que estiver com o status **Financeiro em atraso** não alterará o consumo do usuário SVA, portanto, permanecerá **ativo**;
- **Bloqueio automático/Manual:** o bloqueio manual ou automático no sistema impacta no usuário SVA de modo que terá seu status alterado para **bloqueado;**
- **Deleção do usuário:** permite a deleção do usuário, isto é, remove o registro do sistema;
- **Cancelamento do usuário:** O usuário SVA ficará inativo no sistema e na SVA Brasil será deletado. 


## Fluxo de Trabalho

```mermaid
graph TD
    A[Início] --> B[Configurar Integração]
    B --> C[Criar Usuário SVA no Contrato]
    C --> D[Sincronizar Status]
    D --> E{Status do Contrato}
    E -->|Ativo| F[Manter Acesso SVA]
    E -->|Bloqueado| G[Bloquear Acesso SVA]
    E -->|Cancelado| H[Inativar Acesso SVA]
    F --> I[Fim]
    G --> I
    H --> I
```

## Considerações Finais
A integração da plataforma **SVA Brasil** com o Sistema proporciona uma oportunidade significativa para provedores de internet expandirem seus serviços e aumentarem a fidelização de clientes. Ao centralizar a gestão desses serviços no Sistema, os provedores podem oferecer uma experiência mais completa e integrada aos seus clientes.

## Etiquetas
#Integracoes #IntegracoesSVA #IntegracaoSVABrasil #ServicosValorAgregado 

## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [[integracoes sva - sva brasil|Integrações SVA - SVA Brasil]]
- [SVA Brasil](https://svabrasil.com.br/)
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]
- [[formulario cliente|Formulário Cliente]]
- [[aba contato - cliente|Aba Contato - Cliente]]
- [[usuarios sva|Usuários SVA]]