Como podemos ajudar?

Como integrar um serviço SVA (streaming, e-book, etc.) — passo a passo completo

Como integrar um serviço SVA (streaming, e-book, etc.) — passo a passo completo

Um serviço SVA (Watch Brasil, PlayHub, Digilivro, Graviola, e todas as outras plataformas de streaming/conteúdo integradas ao sistema) segue sempre a mesma cadeia de cadastro, independente de qual plataforma for. Este artigo explica o passo a passo geral, do zero até o cliente ter o serviço no contrato. Pra saber exatamente quais dados pedir pra cada plataforma específica (Watch Brasil, PlayHub, Digilivro, etc.), veja o artigo de referência de credenciais por plataforma .

Visão geral da cadeia de cadastro

São 5 peças conectadas:

1. Integrador — a conexão técnica com a plataforma externa (credenciais de API).
2. Plano SVA — o que o mercado chama de "Grupo" na tela do contrato. É o plano/pacote específico daquela plataforma (ex.: "Watch Combo Premium").
3. Produto de estoque — necessário pra emitir nota fiscal desse serviço.
4. Serviço de Contrato — o item de catálogo que junta o Integrador, o Plano padrão e o Produto, pronto pra ser vendido.
5. Item no contrato do cliente — a etapa final, onde o serviço realmente é vendido pro cliente.

Os passos 1-2 (Integrador) e o passo 3 (Produto de estoque) podem ser feitos em qualquer ordem entre si — mas os dois precisam estar prontos antes de criar o Serviço de Contrato (passo 4), porque ele exige os dois já cadastrados.

Passo 1 — Cadastrar o Integrador

1. Acesse SVA > Integrador e clique em Adicionar.
2. Escolha a plataforma (Gateway) — a tela muda os campos pedidos automaticamente conforme a plataforma escolhida (algumas pedem usuário e senha, outras só um token, outras usuário/senha e um código de instância).
3. Preencha os campos de credencial com os dados que a plataforma forneceu (veja o artigo de referência pra saber exatamente o que pedir pra cada uma).
4. Grave o Integrador.
5. Clique em "Testar conexão API" pra confirmar que as credenciais estão certas antes de seguir.

Atenção: nem toda plataforma responde ao teste de conexão — algumas simplesmente não têm esse recurso implementado do lado delas, e o botão sempre vai dar "Teste indisponível para este gateway". Isso não significa que a integração está errada; nesses casos, a validação real só acontece na hora de importar planos ou cadastrar o primeiro cliente.

Passo 2 — Criar os Planos SVA (o "Grupo")

O Plano SVA representa o pacote específico daquela plataforma (ex.: o plano de streaming X, o plano de e-book Y). É esse cadastro que depois aparece na tela do contrato do cliente com o nome "Grupo" — não confunda com o Grupo de rede/velocidade, é outra coisa.

1. Acesse SVA > Plano.
2. Se a plataforma tiver suporte a isso, clique em "Importar planos", escolha o Integrador e o sistema busca os planos direto da API da plataforma — mais rápido e evita erro de digitação no código do plano.
3. Se preferir cadastrar manualmente, clique em Adicionar, escolha o Integrador e preencha a Descrição e o Código do integrador (o identificador desse plano específico do lado da plataforma externa — sem isso certo, o sistema manda o usuário pro plano errado lá na plataforma).

Passo 3 — Criar o Produto de estoque (pra emitir nota fiscal)

1. Confirme que existe uma Série Fiscal configurada com o tipo de nota "SVA" (Fiscal > Série Fiscal) — se sua empresa já emite nota de outros SVAs, provavelmente já existe.
2. Confirme que existe uma Categoria de Produto apontando pra essa série fiscal (Estoque > Categoria).
3. Acesse Estoque > Produto e adicione o produto: nome, a Categoria do passo anterior, valor de venda e a Categoria Fiscal.
4. Confirme que a Categoria Fiscal escolhida tem uma Situação Tributária cadastrada cobrindo esse produto (CFOP e os percentuais de imposto ficam configurados aí, não no cadastro do produto em si) — sem isso, a nota não sai.

Passo 4 — Criar o Serviço de Contrato

1. Acesse Cliente > Serviço e adicione um novo serviço.
2. Escolha o Tipo = SVA.
3. Selecione o Integrador criado no passo 1 — é obrigatório pra esse tipo de serviço.
4. Selecione o Grupo padrão (o Plano SVA do passo 2) — o campo só libera depois de escolher o Integrador, e só lista planos daquele mesmo Integrador.
5. Selecione o Produto criado no passo 3 — é essa ligação que faz a nota fiscal sair certa quando o serviço for cobrado.
6. Preencha o valor padrão e grave.

Passo 5 — Vender o serviço pro cliente

Depois de cadastrado, o Serviço de Contrato aparece disponível de duas formas:

• Em um Plano de Venda — inclua o serviço num plano de venda comercial pra ele já vir junto na hora de fechar contratos novos.
• Direto num contrato existente — use a ação Ações > Atualização de plano no contrato do cliente pra adicionar o serviço avulso. Na tela de serviços do contrato, escolha o Serviço (o catálogo do passo 4) e confira o Grupo (o Plano SVA) — ele já vem pré-selecionado com o Grupo padrão, mas pode ser trocado ali mesmo se o cliente quiser um plano diferente daquela mesma plataforma.

Erros comuns

• "Integrador obrigatório para geração de usuários!" — tentou gravar o Serviço de Contrato tipo SVA sem escolher um Integrador.
• Grupo (Plano) não aparece no serviço do contrato — confira se o Plano SVA foi cadastrado apontando pro Integrador certo; o sistema só lista planos do mesmo Integrador escolhido no Serviço.
• Nota fiscal não sai desse serviço — confira a cadeia fiscal completa: Série Fiscal (tipo SVA) → Categoria de Produto → Produto → Categoria Fiscal → Situação Tributária com CFOP configurado. Falta em qualquer um desses elos trava a nota.
• "Teste indisponível para este gateway" — normal pra algumas plataformas (não é erro de configuração); só confirme a integração cadastrando um usuário de teste.