Como podemos ajudar?

Como integrar a Digilivro — passo a passo com exemplo real

Como integrar a Digilivro — passo a passo com exemplo real

Este artigo mostra a integração da Digilivro do início ao fim, tela por tela, com um exemplo real de cadastro. Se você já entende o fluxo geral, veja também o passo a passo genérico de integração SVA e a referência de credenciais de todas as plataformas .

Pré-requisito

• O token de API (Bearer) da sua conta, fornecido pelo suporte da Digilivro. É o único dado de credencial que essa integração pede — não tem usuário/senha nem instância.

Passo 1 — Cadastrar o Integrador

1. Acesse SVA > Integrador e clique em Adicionar.
2. Preencha a Descrição (um nome pra identificar essa integração, ex.: "Digilivro").
3. Em Gateway, escolha Digilivro — repare que a tela muda sozinha e só pede o campo Token.
4. Cole o token fornecido pela Digilivro no campo Token.
5. Grave.

Tela de exemplo:

Passo 2 — Criar o Plano ("Grupo")

O Plano representa a assinatura específica da Digilivro (ex.: "Assinatura Mensal", "Plano Anual"). É esse cadastro que depois aparece como "Grupo" na tela do contrato do cliente.

1. Acesse SVA > Plano e clique em Adicionar.
2. Preencha a Descrição do plano.
3. Selecione o Integrador criado no Passo 1.
4. Preencha o Código Integrador — o identificador desse plano específico do lado da Digilivro. Peça esse código pro suporte deles junto com o token.
5. Grave.

Tela de exemplo:

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

1. Confirme que já existe uma Categoria de Produto apontando pra uma Série Fiscal do tipo SVA (Fiscal > Série Fiscal / Estoque > Categoria) — se sua empresa já emite nota de algum outro SVA, provavelmente já existe uma categoria pronta (algo como "Serviços de Valor Agregado").
2. Acesse Estoque > Produto e adicione o produto: Nome, a Categoria SVA do passo anterior, o Valor de venda e a Unidade (normalmente "Serviço").
3. Confirme o Código de classificação e o Indicador da operação — para um serviço de conteúdo/assinatura como a Digilivro, o mais adequado costuma ser "Outros serviços de valor adicionado" e "Demais serviços, em operações onerosas" (confira com seu contador se esse enquadramento serve pro seu caso).

Tela de exemplo:

Passo 4 — Criar o Serviço de Contrato

1. Acesse Cliente > Serviço e adicione um novo serviço.
2. Preencha a Descrição.
3. Em Tipo de serviço, escolha SVA — os campos de Integrador e Grupo aparecem depois disso.
4. Em Integrador, escolha o Integrador Digilivro do Passo 1.
5. Em Grupo padrão, escolha o Plano do Passo 2.
6. Em Produto, escolha o Produto do Passo 3 — é essa ligação que faz a nota fiscal sair certa quando o serviço for cobrado do cliente.
7. Preencha o Valor padrão e grave.

Tela de exemplo — repare que os quatro cadastros anteriores aparecem juntos aqui, todos amarrados:

Passo 5 — Vender o serviço pro cliente

Depois de cadastrado, adicione o serviço a um Plano de Venda (pra vir junto em contratos novos) ou use Ações > Atualização de plano num contrato já existente pra adicionar o serviço avulso — igual descrito no artigo geral de integração SVA .

Erros comuns

• "Integrador obrigatório para geração de usuários!" — esqueceu de escolher o Integrador no Serviço de Contrato.
• Grupo não aparece no Serviço — confira se o Plano foi cadastrado apontando pro mesmo Integrador Digilivro escolhido no Serviço.
• Como a Digilivro usa um token estático (sem expiração automática gerenciada pelo sistema), se as chamadas começarem a falhar depois de funcionar por um tempo, confirme com o suporte da Digilivro se o token ainda é válido antes de suspeitar de outra causa.