# Integração SVA - Partiu! Clube de Vantagens
Este guia aborda a integração entre a Partiu! Clube de Vantagens 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 Partiu! Clube de Vantagens?
> A Partiu! Clube de Vantagens é uma plataforma de descontos e benefícios em diversos estabelecimentos, tanto físicos como online, atuando como um cartão de desconto virtual.

A integração Partiu! Clube de Vantagens com o Sistema visa expandir o portfólio de serviços oferecidos pelos provedores de internet. 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;
- Otimização tributária.

### Serviços Oferecidos pela Partiu! Clube de Vantagens

- Descontos exclusivos a estabelecimentos parceiros;
- Ofertas personalizadas para descontos que se encaixam no perfil de consumo do usuário;
- Através do aplicativo, pode encontrar facilmente as ofertas mais próximas;
- Programas de fidelidade;
- Ofertas disponíveis em um só lugar.

> [!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 Partiu! Clube de Vantagens 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 **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 **Partiu! Clube de Vantagens** no campo **Plataforma**;
4. Preencha os campos:
	- **Login:** insira o login do usuário API fornecido pela plataforma credenciada;
	- **Senha:** insira a senha do usuário API fornecido pela plataforma credenciada;
	- **URL:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por "liberar o acesso" do sistema IXC Soft à plataforma **Partiu! Clube de Vantagens** para estabelecer a comunicação entre os sistemas. Insira a URL fornecida pela plataforma. (https://api.partiu.com.br/api/v1)

	Preenchido automaticamente:
	- **Token:** após salvar a integração, um *token* será gerado. O *token* é responsável para autenticar a comunicação entre as plataformas envolvidas.
	  
5. Clique em **Salvar** para validar as modificações; 


### Passo 2: Configuração do produto SVA
O cadastro do produto de TV é 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 Partiu! Clube de Vantagens e vincule ao campo;
	  
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 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:

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 já vinculado ao contrato, para definir qual o plano que este usuário terá acesso;
	- **Usar dados cadastro:** se **sim**, o sistema preencherá o campo CNPJ/CPF e campo usuário a partir dos dados de CNPJ/CPF e e-mail no cadastro do cliente. Se **não**, deve preencher este dado manualmente (CNPJ/CPF deve ser válido);
	- **Usuário:** inserir um e-mail válido;

	  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:** retorno da plataforma, refere-se ao identificador (ID) do usuário na Partiu! Clube de Vantagens após ser cadastrado.
	  
4. Clique em **Salvar** para finalizar a ativação do usuário SVA e promover o acesso do cliente à plataforma credenciada.

### Passo 5: Acesso à aplicação pela Central do Assinante
O usuário uma vez ativo, terá acesso ao aplicativo de descontos diretamente pela Central do Assinante. Siga os passos abaixo:

1. O cliente deve **acessar** a [[central do assinante|Central do Assinante]] disponibilizada pela sua organização;
2. O usuário deve clicar no ícone de *etiqueta*, no menu lateral esquerdo. Este ícone direcionará à uma aba de acesso à Partiu! Clube de Vantagens, onde o cliente terá acesso a todos os descontos e benefícios personalizados para seu perfil de consumo.


## Casos de uso

### Ações do contrato
A integração com a plataforma da Partiu! Clube de Vantagens 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.

#### 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, bloqueio manual/automático e inativação do contrato:** o usuário permanece **bloqueado** quando estiver em atraso de pagamento ou desativado, corta o acesso do usuário SVA à plataforma;
- **Deleção do usuário:** permite a deleção do usuário, isto é, remove o registro do sistema.


## Fluxo de trabalho
```mermaid
graph TD
    A[Contratação da plataforma Partiu! Clube de Vantagens 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 -->|Usuário ativado| F[Disponibilização do acesso ao Clube de Vantagens na Central do Assinante]
    F -->|Processo concluído| G[Cliente acessa benefícios]

```


## Considerações finais
A integração Partiu! Clube de Vantagens 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 #IntegracoesSVA #PartiuClubeDeVantagens

## Leia também
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [[rotina de ajustar cadastros sva|Rotina de Ajustar Cadastros SVA]]