# Integração SVA - Skeelo (Beta)
## 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] Definição - Skeelo:
> A [Skeelo](https://skeelo.com/pt/) é uma plataforma de serviços de leitura digital, oferecendo livros no formato de e-book e audiolivros. Os assinantes podem baixar e ler os títulos em seus dispositivos a partir da biblioteca variada disponível.

A integração entre a Skeelo 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 Skeelo;
- Credenciais de acesso à API da Skeelo.

## Entrega de Valor
A integração do sistema com a Skeelo 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 Skeelo
- Serviços de audiolivros e eBooks para downloads;
- Serviço de loja de livros digitais;
- Serviço de HQs e acesso ilimitado a quadrinhos, mangás e graphic novels;
- Serviço de clube, onde assinantes ganham acesso exclusivo sobre assuntos diversos;
- Quatro formatos de livros: eBooks, audioBooks, miniBooks, comicBooks.

### Passo 1: Cadastro da Integração
Para estabelecer a comunicação entre o sistema e a Skeelo 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 **Skeelo** no campo **Plataforma**;
4. Preencha o campo:
	- **URL:** este campo se refere à URL fornecida pela plataforma credenciada. Ela é responsável por liberar o acesso do sistema IXC Soft à plataforma **Skeelo** para estabelecer a comunicação entre os sistemas.
	- **Permite criar usuários automaticamente:** ao marcar o filtro como **sim**, e um contrato for ativado com um produto SVA Skeelo inserido, o usuário SVA criado será criado automaticamente com os dados cadastrais do cliente. O mesmo se aplica quando inserido um produto em contratos já ativos. Se marcado como **não**, necessário realizar o cadastro manual.
	  
5. Clique em **Salvar** para validar as modificações; 


### 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. 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 Skeelo e vincule ao campo;
	- **Pacote SVA principal** identifique a descrição do produto de SVA disponibilizado pela plataforma e insira no campo. Este pacote é referente ao pacote principal que será disponibilizado ao cliente;
	  
>[!caution] Atenção ao Pacote SVA principal:
>A descrição do pacote disponibilizado pela plataforma deve ser inserido conforme repassado, na mesma estrutura. Exemplo:
>EBOOK_PREMIUM
>EBOOK_STANDARD

>[!DANGER] Cuidado:
>O pacote SVA Principal deve conter apenas a descrição 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: 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]].

>[!INFO] Importante:
>Quando o parâmetro **Permite criar usuários automaticamente** no cadastro da integração for igual à **Sim**, o processo de inserção do produto Skeelo no contrato realizará a ativação de um usuário SVA.

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
A ativação do usuário SVA pode ocorrer de duas formas: automaticamente ou manualmente.

>[!TIP] Validação cadastral: 
A integração com a plataforma sKEELO valida as seguintes informações cadastrais do cliente para a ativação do usuário SVA:
>- E-mail principal;
>- CNPJ/CPF; 
>
>Se algum destes campos estiver vazio, não será possível realizar a criação do usuário.

#### 1. Ativação automática
Ao manter o parâmetro de cadastro da integração **Permite criar usuários automaticamente** marcado como **sim**, ao realizar a ativação de um contrato que possua o produto de SVA Skeelo associado ou ao vincular o produto no contrato, o usuário é criado automaticamente no sistema e é espelhado na plataforma Skeelo, estabelecendo a comunicação.

>[!TIP] Guia instrutivo:
>Para ver mais informações sobre a ativação automática de usuários SVA, acesse: [[configuracao da criacao automatica de usuarios  - skeelo - master abril 2025|Configuração da Criação Automática de Usuários  - Skeelo - MASTER ABRIL 2025]]

#### 2. Ativação Manual
Ao manter o parâmetro de cadastro da integração **Permite criar usuários automaticamente** marcado como **não**, sendo necessário um operador para realizar o cadastramento do acesso de forma manual, conforme as orientações a seguir:
1. Acesse o formulário **[[usuarios sva|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 - contrato do cliente|Aba SVA - Contrato do cliente]];
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 CNPJ/CPF a partir dos dados de cadastro. se **não**, deve preencher este dado manualmente (CNPJ/CPF deve ser válido);
	  
	 **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 integração:** baseado no status do contrato. Identifica se o usuário SVA está **Ativo**, **Bloqueado** ou **Desativado**;
	- **Usuário integração:** retorno da plataforma, refere-se ao identificador (ID) do usuário na Skeelo 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.

## Casos de uso

### Ações do contrato
A integração com a plataforma da Skeelo 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. Ao realizar uma requisição de deleção do usuário SVA Skeelo, ele assume também o status de **bloqueado** no IXC.
- **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 como **ativo** no usuário SVA;
- **Financeiro em atraso:** o usuário permanece **ativo** quando estiver em atraso de pagamento;
- **Bloqueio manual/Automático:** corta totalmente o acesso do usuário SVA à plataforma, assumindo o status **bloqueado**;
- **Desativar/Inativar contrato:** altera o status do usuário SVA para **Desativado**;
- **Deleção do usuário:** não efetiva a deleção, isto é, não remove o registro do usuário no sistema, somente corta o acesso e altera o status para **bloqueado**;

## Considerações finais
A integração Skeelo 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 #IntegracaoSkeelo #Skeelo

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