# Integração SVA - Campsoft

## Introdução

>[!tip] Atenção!
>Este conteúdo está presente na **versão [[clientes beta ixc soft|Beta]]** do sistema.
>A disponibilidade desta integração na **versão Estável** será a partir de Abril de 2025.

---

>[!TIP] O que é a Campsoft?
> A [Campsoft](https://www.campsoft.com.br/?utm_source=google&utm_campaign=search_core_keywords&utm_medium=cpc&utm_content=g_c_&utm_term=termcampsoft&gad_source=1&gclid=Cj0KCQiAvbm7BhC5ARIsAFjwNHtS_7kqa2fcf1-rT-ze_WVb9_eC7K8B_fTggP6KTNgyxPB5zKXS8GgaAjWTEALw_wcB) é uma plataforma brasileira focada em provedores que oferece soluções de SVAs (Serviços de Valor Adicionado). A plataforma integra diversos serviços digitais, com o objetivo de fidelização de clientes, aumento do ticket médios e otimização tributária. Alguns dos serviços oferecidos pela plataforma, são: Streamings de música, vídeo e audiolivros, clube de descontos, canais de esportes, aplicativos de notícias, educação, TV, programas de segurança online e saúde/bem-estar.

A integração **Campsoft** 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;
- Otimização tributária.

> [!NOTA] **Acesso à Configuração**
> **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;
- 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

### Serviços Oferecidos pela Campsoft
Os serviços oferecidos pela Campsoft incluem:
- Serviços de streaming de vídeo por assinatura;
- Serviços de streaming de áudio;
- Serviços de audiolivros e ebooks para downloads;
- Rede de descontos e convênios;
- Plataformas de cursos profissionalizantes e educação;
- Plataformas de notícias, revistas, artigos e jornais;
- Plataformas de telemedicina.

>[!INFO] Importante:
>O sistema permite somente uma integração com a plataforma Campsoft. Uma integração equivale à um cadastro de integração da Campsoft.

### Passo 1: Cadastro da Integração
Para estabelecer a comunicação entre o sistema e a **Campsoft** 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. A integração com a Campsoft permite a contratação do serviço diretamente pelo sistema IXC Soft. Siga o passo a passo abaixo:

#### Contratação Através do Sistema IXC Soft
O sistema permite a contratação da plataforma **Campsoft** diretamente pelo cadastro da integração, este processo equivale ao cadastro da empresa na Campsoft.

>[!Caution] Atenção:
> Para consultar valores e condições de pagamento, deve entrar em contato com a Campsoft. O sistema IXC Soft não se responsabiliza pelo acordo entre o provedor e a plataforma.

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 **Campsoft** no campo **Plataforma**;
4. Preencha os campos:
	- **Filial de cobrança:** indique a filial para enviar as informações da filial à plataforma no ato do cadastro da empresa;
	- **Ambiente:** indique se ambiente de teste (Homologação) ou se estará em uso para fornecimento aos clientes (Produção);
	- **Senha:** clique em Gerar senha para gerar uma senha.
	  
5. Clique em **Salvar** para validar as modificações e finalizar o cadastro da integração e a contratação do serviço da Campsoft;
6. Após ocorrer o aceite do contrato, os demais campos serão preenchidos automaticamente com o retorno da plataforma, a fim de estabelecer e indicar a comunicação com sucesso:
	- **Api Secret**;
	- **Api Key**;
	- **ID externo da plataforma**;
	- **Refresh token**.	
	  
7. Clique no botão **Abrir plataforma** localizado na parte superior do formulário para ser direcionado ao portal do provedor na plataforma Campsoft.
   
### 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.

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 Campsoft e vincule ao campo;
	- **Pacote SVA principal:** clique no botão **Buscar pacote** e selecione o pacote que será ofertado ao cliente. O ID do pacote é correspondente ao código do pacote na plataforma.
	  
6. 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;
	- **Usar dados cadastro:** se **sim**, o sistema preencherá o campo usuário e  do cliente. Se **não**, deve preencher estes dados manualmente;
		- **Tipo de autenticação:** ao marcar o parâmetro "Usar dados cadastro" como "sim", o campo "Tipo de autenticação é exibido, permitindo selecionar o tipo de autenticação que o cliente utilizará para acessar a plataforma: E-mail, Telefone ou CPNJ/CPF. Selecione uma das opções disponíveis, o sistema preencherá automaticamente o campo de "usuário" com a opção selecionada;
	- **Usuário:** insira um e-mail válido (caso o parâmetro "Usar dados cadastro" esteja marcado como "não");
	- **Senha:** clique no botão **Gerar senha** e gere uma senha aleatória para o acesso do usuário TV à plataforma;
	  
	 **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 caminho;
	  - **Status:** preenchido automaticamente, baseado nos status do contrato ou alterações manuais do usuário SVA;
	  - **Usuário integração:** código de ID (identificador) do usuário na plataforma Campsoft, é preenchido a partir do retorno da plataforma;
	  - **Subscription ID:** identificador único na plataforma baseado no contrato do cliente.
	  
3. Clique em **Salvar** para finalizar a ativação do usuário SVA e promover o acesso do cliente à plataforma credenciada.
   
> [!Caution] **Atenção**: 
>Caso já exista um login e senha criado para este CPF/CNPJ, na plataforma da Campsoft, apenas será retornado ao IXC as informações de usuário e senha, mesmo que seja preenchido outras informações nestes campos.

### Passo 5: Acesso através da Central do Assinante
O usuário uma vez ativo, terá acesso ao aplicativo de descontos diretamente pela Central do Assinante. Siga os passos abaixo:

>[!TIP] Importante:
>Para que o cliente tenha acesso à [[central do assinante|Central do Assinante]], deve possuir os dados de **login hotsite** e **senha hotsite** preenchidos na [[aba contato - cliente|Aba Contato - Cliente]], no [[formulario cliente|Formulário Cliente]]

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 à Campsoft, onde o cliente terá acesso ao seu plano.

## Casos de uso

### Ações do Contrato
A integração com a plataforma da Campsoft 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;
- **Bloqueio manual/automático:** o usuário permanece **bloqueado** quando estiver em atraso de pagamento, ocorre o corte do acesso do usuário SVA à plataforma e assume o status de **Inativo** na Campsoft;
- **Cancelamento:** 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 Campsoft.
- **Deleção:** não permite deleção do usuário SVA, isto é, não remove o registro do sistema. Somente o inativa.


## Fluxo de Trabalho
```mermaid
graph TD
    A[Contratação da plataforma Campsoft 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 **Campsoft** 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 #IntegracaoCampsoft #Campsoft

## Leia também
- [[integracoes|Integrações]]
- [[integracoes de sva|Integrações de SVA]]
- [[rotina de ajustar cadastros sva|Rotina de Ajustar Cadastros SVA]]
- [[aba sva - contrato do cliente|Aba SVA - Contrato do cliente]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[formulario cliente|Formulário Cliente]]
- [[aba contato - cliente|Aba Contato - Cliente]]
- [[usuarios sva|Usuários SVA]]
- [[formulario cliente|Formulário Cliente]]