# Integração SVA - Music
Este guia aborda a integração entre a Music e o Sistema IXC Provedor, permitindo aos provedores de internet oferecer serviços de valor agregado (SVA) aos seus clientes.

## Introdução

>[!TIP] O que é a Music?
> A Music é uma plataforma que oferece soluções de SVAs (Serviços de Valor Adicionado), fornecendo serviços de streaming de áudio por assinatura com transmissão através da internet.

A integração Music com o Sistema visa expandir o portfólio de serviços oferecidos pelos provedores de internet, incluindo benefícios de saúde, streamings de áudio e vídeo, cursos profissionalizantes e clube de descontos. 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;

### Serviços Oferecidos pela Music
- Streaming de áudio por assinatura online e offline;

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

## Entrega de valor
Centraliza as informações do provedor em um único local e facilita a gestão de clientes e faturamento mensal.

- Informações centralizadas;
- Diminuir a taxa de imposto utilizando os produtos da integração SVA ;
- Aumento do ticket médio;
- Fidelização de clientes.

## Configuração da Integração

### Passo 1: Estabelecendo comunicação entre os sistemas
Para estabelecer a comunicação entre o sistema e a Music e realizar 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. 

1. Acesse o formulário de **Integrações 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 **Music** no campo **Plataforma**;
4. Preencha os campos:
	- **Login:** insira o login do usuário API fornecido pela plataforma;
	- **Senha:** insira a senha do usuário API fornecida pela plataforma;
	- **URL:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma Music para estabelecer a comunicação entre as plataformas envolvidas;
	  
5. Clique em **Salvar** para validar as modificações e finalizar o cadastro da integração;

>[!INFO] Atenção
>Os dados de **Login**, **Senha** e **URL** são informações fornecidas pela 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] O cadastro do produto no sistema é respectivo ao pacote disponível para a plataforma.

1. No menu principal, navegue até **Sistema**;
2. Selecione **Cadastros**;
3. Clique em **Produtos**;
4. Pressione o botão **Novo**;
5. Preencha os campos obrigatórios na aba **Produtos** e na aba **Planejamento**;
6. Acesse a aba **SVA**;
7. Preencha os campos:
	- **ID Integração SVA:** clique na lupa e selecione o cadastro da integração de SVA Music e vincule ao campo;
	- **Pacote SVA principal:** insira o código do pacote que será ofertado ao cliente.
	  
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.


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

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;
	- **ID Produto:** clique na lupa e selecione o produto de SVA Music que está associado ao contrato do cliente;
	- **Usar dados cadastro:** se **sim**, o sistema preencherá os campos **Usuário** e **Telefone** a partir do dado de e-mail no cadastro do cliente. Se **não**, deve preencher estes dados manualmente;
	- **Usuário:** inserir um e-mail válido;
	- **Telefone:** inserir um telefone válido;
	- **Senha:** clique no botão **Gerar senha** para gerar uma senha aleatório ao usuário SVA.
	
	  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 caminho;
	  - **Usuário integração:** código de ID (identificador) do usuário na plataforma Music, é preenchido a partir do retorno da plataforma;
	  
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 Music não valida ações sobre o contrato, somente permite a inativação e ativação manual do usuário SVA.

>[!CAUTION] **Importante:** A integração Music não possui controle de inadimplência, portanto em casos de bloqueio do status de acesso do contrato o acesso aos produtos IXER continuarão funcionando. 

#### Controle de acesso do usuário SVA a partir de alterações manuais:

- **Ativação do usuário:** permanece **ativo** o usuário SVA. É possível ativar o usuário SVA pelo botão **Ativar**;
- **Inativação:** se ocorrer o cancelamento do contrato, o acesso do usuário fica inativo na plataforma. No sistema, é possível **desativar o usuário manualmente**, pelo botão **Desativar**, caso o cliente queira manter o contrato ativo e desativar somente o contrato com a Music.

## Fluxo de trabalho
```mermaid
graph TD
    A[Contratação da plataforma Music pelo provedor] -->|Após contratação| B[Cadastro da integração no sistema]
    B -->|Comunicação estabelecida| C[Cadastro do produto SVA no sistema]
    C -->|Produto cadastrado| D[Vínculo do produto SVA no contrato do cliente final]
    D -->|Contrato atualizado| E[Ativação do usuário SVA]
    E -->F[Usuário ativado] 
    F -->|Processo concluído| G[Cliente acessa benefícios]

```


## Considerações finais
A integração Music 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 
#Integracao #IntegracaoSVA #Music
  

## Leia também
- [[formulario cliente|Formulário Cliente]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]  
- [Music](https://brisamusic.com.br/)