Como podemos ajudar?

SVA — Configurando o integrador e o catálogo de planos

SVA (Serviço de Valor Agregado) é todo serviço de um parceiro externo — TV por streaming, ebooks, telefonia, antivírus — que o seu provedor revende junto com a internet e cobra dentro do contrato do cliente. Hoje o Quaza já conversa com mais de vinte parceiros, entre eles Watch Brasil, PlayHub, Skeelo, Olé TV, Campsoft, Cariap, Now+, NxTV, Digilivro, Lê Aí e Historinhaas Kids.

Antes de conseguir vender qualquer serviço SVA para um cliente, existem dois cadastros que precisam existir no sistema: o Integrador (a conta do seu provedor na plataforma do parceiro, com as credenciais de API) e os Planos daquele integrador (os pacotes que você efetivamente revende). Sem esses dois cadastros prontos, a tela de "Adicionar serviço SVA no contrato do cliente" não tem o que oferecer — é por isso que essa configuração inicial é sempre o primeiro passo, feito uma única vez por parceiro, e não a cada cliente novo.

Este manual cobre exatamente essa etapa de configuração: cadastrar o integrador, testar a conexão, cadastrar/importar os planos e usar o log de requisições para diagnosticar problemas. Como adicionar o serviço já configurado no contrato de um cliente específico é assunto do artigo "Como adicionar um serviço SVA no contrato do cliente", referenciado no final desta página.

Passo a passo — Cadastrando um Integrador de SVA

Acesse o menu SVA > Integrador. Essa tela lista todos os integradores já cadastrados no seu provedor, com as colunas Código, Descrição, Gateway, Alteração e Alterador. Para cadastrar um novo, clique em Adicionar integrador SVA, no canto superior direito.

1. Descrição: um nome seu para identificar esse integrador na hora de vincular planos e usuários a ele (ex.: "Watch Brasil - Produção").
2. Gateway: escolha o parceiro que esse integrador representa. É a lista de plataformas homologadas no Quaza — ex.: Campsoft, Cariap OTT, Celeti, Digilivro, EiTV, Graviola, Historinhaas Kids, ITTV, Lê Aí, MultTV, Now+, NxTV, Olé TV, PlayHub, Qualifica, Skeelo, Watch Brasil, YouCast.
3. Status: define o ambiente da API — Homologação (ambiente de teste do parceiro, não cria acessos reais) ou Produção (ambiente real, cria assinantes de verdade). Só opere com clientes de verdade quando o integrador estiver em Produção.
4. Situação: habilitado/desabilitado — um integrador desabilitado não aparece disponível para vincular planos ou usuários novos.

Assim que você escolhe o Gateway, o formulário muda dinamicamente e mostra só os campos de credencial que aquele parceiro específico exige — o Quaza esconde os demais. Os campos possíveis são:

Campo	Para que serve	Gateways que costumam pedir
Usuário (apiUsuario)	Login de API fornecido pelo parceiro	Qualifica, PlayHub, Watch Brasil, Olé TV, Skeelo, Lê Aí, Historinhaas Kids
Senha (apiSenha)	Senha de API fornecida pelo parceiro	Qualifica, PlayHub, Watch Brasil, Olé TV, Lê Aí, Historinhaas Kids
Token	Token/chave de acesso à API	ITTV, Campsoft, Graviola, MultTV, Digilivro, Celeti, Now+, NxTV, Skeelo, Lê Aí, Historinhaas Kids
Instância	Identificador da instância/ambiente contratado junto ao parceiro	EiTV, Cariap, YouCast, NxTV, Aya Books
Id do cliente (clientId) / Client secret	Credenciais de autenticação client id/secret	Lê Aí, Historinhaas Kids

Depois de salvar, abra novamente o integrador e use o botão Testar conexão API, na barra de ações do detalhe. O sistema faz uma chamada real de teste com as credenciais preenchidas:

• Se aparecer o aviso "Conexão estabelecida com sucesso", as credenciais estão corretas e o integrador está pronto para uso.
• Se der erro, revise usuário/senha/token com o que o parceiro forneceu e confirme se o ambiente (Homologação x Produção) selecionado é o mesmo que o parceiro liberou para essas credenciais.

Atenção: nem todo gateway tem teste de conexão implementado — alguns parceiros não oferecem esse tipo de endpoint na API deles, e o sistema informa "Teste indisponível para este gateway" nesse caso. Isso não indica erro no cadastro; a única forma de validar é provisionando um usuário de teste.

Passo a passo — Cadastrando e consultando os Planos SVA

Acesse o menu SVA > Plano. Cada plano representa um pacote do parceiro que você efetivamente revende (ex.: "HBO Max + Telecine", "Ebook Premium", "TV Combo Mobile"). A listagem traz as colunas Código, Descrição, Integrador, Código Integrador, Situação, Alteração e Alterador.

Todo plano fica amarrado a um Integrador e guarda um Código Integrador — o identificador exato que o parceiro reconhece do outro lado da API para aquele pacote. É esse código, e não a descrição que você digita, que vai nas chamadas feitas ao parceiro quando um cliente é provisionado nesse plano.

Importando o catálogo automaticamente

Na listagem de Plano existe o botão Importar planos, no canto superior direito, ao lado de "Adicionar plano". Ao clicar, o sistema abre um popup pedindo que você escolha o Integrador (só aparecem integradores com situação habilitada) e, ao confirmar, o Quaza consulta a API do parceiro e traz automaticamente o catálogo de planos disponíveis, já com o Código Integrador preenchido corretamente.

Essa importação só existe para os gateways cujo parceiro oferece um endpoint de catálogo. Para os demais, ao tentar importar o sistema retorna a mensagem "Importação de planos não implementada para integradores da [nome do gateway]" — nesse caso o cadastro precisa ser manual.

Cadastrando um plano manualmente

Clique em Adicionar plano e preencha:

1. Descrição: o nome do pacote como você quer que apareça no sistema.
2. Integrador: a qual integrador (parceiro) esse plano pertence. Depois de salvo, esse campo fica bloqueado para edição.
3. Código Integrador: o identificador exato que o parceiro usa para esse pacote — peça essa informação ao parceiro, geralmente disponível no painel dele ou na documentação de integração.
4. Plano é mobile?: campo específico do gateway Olé TV, que diferencia planos de TV para equipamento fixo dos planos mobile (streaming em app).

Um plano cadastrado sem o código de integração correto trava o provisionamento de qualquer cliente vinculado a ele — o parceiro simplesmente não reconhece o pacote enviado.

Um plano só pode ser excluído se não houver nenhum usuário SVA vinculado a ele; caso contrário o sistema bloqueia a exclusão com o aviso "Não é possível remover este plano pois há usuários atrelados ao mesmo."

Consultando o Log de Requisições (RequestLog)

Acesse SVA > Log Request. É uma tela somente leitura — você não cadastra nem edita nada aqui — que registra toda chamada de API que o Quaza fez a qualquer parceiro: autenticação, criação de usuário, consulta, bloqueio, desbloqueio.

Cada linha do log traz:

• Url: o endereço da API chamada (costuma indicar a ação, ex.: rotas de autenticação/token, criação de assinante, bloqueio).
• Método: o verbo HTTP usado (GET, POST, PUT etc.).
• Código da requisição: o código HTTP de resposta — 200 indica sucesso; códigos 4xx ou 5xx indicam falha na chamada.
• Cabeçalho, Corpo da requisição e Resposta da requisição: o conteúdo exato enviado e devolvido pelo parceiro, essencial para entender por que uma chamada falhou.

Esse é o primeiro lugar a olhar sempre que "o SVA do cliente parou de funcionar" ou "não consigo cadastrar esse assinante": localize a requisição mais recente relacionada àquele integrador/cliente, veja o código HTTP e leia o conteúdo da resposta do parceiro — normalmente ele já explica o motivo (credencial expirada, dado inválido, plano inexistente etc.).

Erros comuns na configuração

Mensagem / sintoma	Causa	Como resolver
"Integrador: [nome], não cadastrado como gateway."	O integrador foi salvo sem um Gateway válido selecionado, ou o gateway ficou inconsistente.	Edite o Integrador e selecione novamente o Gateway correto antes de tentar provisionar qualquer usuário nele.
Falha ao clicar em "Testar conexão API" (credenciais recusadas)	Usuário/senha/token digitados errados, ou as credenciais são de Homologação mas o integrador está marcado como Produção (ou vice-versa).	Confira exatamente o que o parceiro forneceu e o ambiente correspondente; ajuste o campo Status (Homologação/Produção) do Integrador.
"Teste indisponível para este gateway."	O parceiro escolhido não tem endpoint de teste de conexão implementado no Quaza — não é um erro, é uma limitação daquele gateway específico.	Valide as credenciais provisionando um usuário de teste e conferindo o resultado no Log Request.
"Importação de planos não implementada para integradores da [gateway]."	Aquele parceiro não expõe uma API de catálogo de planos.	Cadastre os planos manualmente em SVA > Plano, usando o código de integração fornecido pelo parceiro.
"Integrador inválido!" ao tentar importar planos	Nenhum integrador foi selecionado no popup de importação, ou nenhum integrador habilitado existe ainda.	Cadastre e habilite o Integrador antes de tentar importar os planos dele.
Erro de validação específico do parceiro ao salvar um usuário (ex.: "E-mail do usuário inválido!", "CPF do usuário inválido!", "Telefone do usuário inválido!")	O gateway exige um formato/tipo de dado que não foi preenchido corretamente no cadastro do assinante — cada parceiro valida campos diferentes (uns pedem e-mail, outros CPF, outros telefone).	Confira, no próprio Integrador, quais campos aquele gateway exige (o formulário só mostra os obrigatórios) e revise o dado antes de salvar novamente.
"[Parceiro]: O plano selecionado não está configurado!"	O plano escolhido para o assinante não existe ou não tem código de integração válido cadastrado naquele parceiro.	Verifique em SVA > Plano se o plano está cadastrado, habilitado e com o Código Integrador correto — reimporte se possível.

Depois de configurado

Com o Integrador criado, testado, e os Planos daquele parceiro cadastrados (importados ou manuais), a configuração inicial está pronta. A partir daqui, vender o serviço para um cliente específico é uma operação por contrato — feita na tela de Cliente, não em SVA.

Para esse próximo passo, consulte o artigo "Como adicionar um serviço SVA no contrato do cliente", que explica como lançar os valores do serviço no Contrato Serviço e como vincular o SVA ao contrato do cliente para que ele passe a fazer parte da cobrança.