Como podemos ajudar?

Antes de começar

Este artigo cobre apenas a venda/ativação de um serviço SVA para um cliente específico — ou seja, assume que o Integrador e o Catálogo de Planos (Sva > Integrador, Sva > Plano) já estão previamente configurados no sistema, e que já existe um Serviço de Contrato (Cliente > Serviço de Contrato) do tipo SVA apontando para esse integrador. Se essa parte ainda não existe, ela precisa ser feita antes (consulte o artigo complementar sobre configuração de Integrador e Catálogo de Planos).

Passo a passo: adicionar o serviço no contrato do cliente

1. Abra o Contrato do cliente. Na aba "Contrato", role até o quadro Serviços (lista todos os serviços já vinculados ao contrato: internet, telefonia, SVA, outros).
2. Clique em Adicionar. Abre-se o popup "Adicionar serviço".
3. Na primeira etapa, preencha: Serviço (selecione o Serviço de Contrato do tipo SVA já cadastrado — ex.: "HBO Max", "Watch", etc.), Grupo (o Plano SVA específico daquele integrador, carregado automaticamente ao escolher o Serviço), Produto (preenchido/travado automaticamente a partir do cadastro do serviço), Quantidade, Valor e Valor de desconto — o Valor Total é calculado e travado.
4. Clique em Avançar.
5. Na segunda etapa, escolha o Usuário:
   • Se o cliente já tiver um usuário SVA daquele integrador (por exemplo, já possui outro serviço do mesmo parceiro), selecione o usuário existente na lista — o novo serviço passa a usar o mesmo login/senha já cadastrado no parceiro.
   • Se não houver usuário, marque "Criar novo usuário" e preencha os campos exigidos pelo integrador escolhido (variam por parceiro — por exemplo, alguns pedem usuário e senha, outros CPF e telefone). O formulário já vem pré-preenchido com e-mail/telefone/CPF do cliente quando aplicável.
6. Clique em Salvar.

Ao salvar, o sistema grava a linha de serviço no contrato (situação Ativo) e, se um novo usuário SVA foi criado, chama a API do integrador para criar o assinante e em seguida ativar o plano escolhido; se um usuário já existente foi reaproveitado, chama a API para salvar os dados do usuário e ativar o novo plano nele. Fica registrado no histórico do contrato: "Inserir serviço" com a descrição do serviço e o valor cobrado.

Como aparece na fatura

Cada débito financeiro gerado para o contrato mantém uma referência à linha de serviço que o originou. Por isso, o serviço SVA aparece como um item de composição próprio na mensalidade/fatura do cliente — com o nome cadastrado no Serviço de Contrato (ex.: "HBO Max") — junto com o plano de internet e os demais serviços contratados, pelo valor definido (Valor × Quantidade − Valor de desconto).

Como o provisionamento é feito do lado do parceiro (chamada de API)

O sistema resolve automaticamente qual integração usar de acordo com o gateway configurado no Integrador (existem cerca de vinte parceiros suportados — Qualifica, EITV, Campsoft, Playhub, Youcast, MultTV, NXTV, Digilivro, Celeti, OleTV, entre outros), cada um com seu próprio conector. As chamadas típicas realizadas são:

• Criar usuário no parceiro (envia os dados exigidos por aquele gateway específico: e-mail, CPF, telefone, usuário/senha etc.);
• Adicionar plano ao usuário — ativa de fato o plano/pacote escolhido na plataforma do parceiro;
• Salvar usuário / Remover plano / Remover usuário, usadas nas trocas e cancelamentos (ver abaixo).

Se a chamada à API do parceiro falhar (erro de rede, credencial, plano indisponível etc.), o sistema não desfaz a operação local: a linha de serviço no contrato é salva normalmente, e o erro é apenas registrado no histórico do contrato, na categoria "SVA", com a mensagem de erro do parceiro. Por isso, depois de adicionar, trocar ou remover um SVA, é importante conferir o histórico do contrato em busca de entradas de erro em "SVA" — o serviço pode estar lançado no contrato/fatura sem estar de fato liberado no parceiro.

Como trocar o plano de um cliente que já tem SVA ativo

1. No quadro Serviços do contrato, clique no ícone de edição (lápis) na linha do serviço SVA já ativo. Abre o popup "Editar serviço".
2. Altere o campo Grupo para o novo Plano SVA desejado (dentro do mesmo Serviço/Integrador).
3. Clique em Salvar.

Ao salvar, o sistema compara o plano antigo com o novo: se mudou, ele chama automaticamente a API do parceiro para remover o plano antigo do usuário (só remove de fato se nenhum outro serviço ativo do mesmo contrato ainda estiver usando aquele mesmo plano) e em seguida adicionar o novo plano — tudo em uma única operação de salvar, sem precisar remover e recriar o serviço manualmente. A mesma lógica se aplica se, ao editar, também for trocado o Usuário vinculado.

Atenção: serviços SVA que vieram automaticamente de um Plano de Venda aparecem com os ícones de editar/remover desabilitados nessa grade — eles são controlados pela composição do plano de venda, não editáveis diretamente aqui. Só é possível editar/trocar/remover livremente por essa tela os serviços SVA adicionados manualmente (como neste fluxo).

Como cancelar um SVA já ativo no cliente

1. No quadro Serviços, clique no ícone de lixeira (remover) na linha do serviço.
2. Confirme no popup "Deseja remover este serviço do contrato?"

Ao confirmar, a linha do serviço passa para situação Removido e o sistema decide o que fazer no parceiro: se o usuário SVA não estiver mais vinculado a nenhum outro serviço ativo do contrato, ele chama a API para remover o usuário por completo (cancela a assinatura); se o usuário ainda tiver outros serviços ativos, mas nenhum deles usar o mesmo plano que está sendo cancelado, ele chama a API apenas para remover aquele plano específico, preservando a conta. Fica registrado no histórico "Remover serviço"; eventuais erros da chamada ao parceiro também são gravados em "SVA" no histórico, sem impedir a remoção local.

Erros comuns

Mensagem/sintoma	Causa
"Serviço não informado!" / "Produto não informado!" / "A quantidade não pode ser menor que 1!" / "O valor não pode ser menor que 0!"	Campo obrigatório não preenchido corretamente ao salvar o popup de adicionar/editar serviço.
"O serviço selecionado não permite criação/seleção de usuário!"	O Serviço de Contrato escolhido não está configurado para gerar usuário (falha de cadastro no catálogo, fora do escopo deste artigo).
"Nenhum grupo selecionado para criação/seleção de usuário!"	Tentou avançar para a etapa de usuário sem escolher o Plano (Grupo) na primeira etapa.
Ícones de editar/remover aparecem apagados na linha do serviço	O serviço veio de um Plano de Venda vinculado ao contrato — precisa ser alterado pela composição do plano de venda, não diretamente aqui.
Serviço lançado no contrato/fatura, mas cliente sem acesso liberado no parceiro	A chamada à API do integrador falhou silenciosamente do ponto de vista do operador — o lançamento local não é desfeito. Verificar o histórico do contrato, categoria "SVA", em busca da mensagem de erro.