Pular para conteúdo

Telvora Book — integração

Tela do Telvora ERP — Telvora Book — integração

Captura do Telvora ERP em ambiente autorizado. Valores de tabelas e formulários foram ocultados para privacidade.

Módulo: Integrações
Menu: Parâmetros → Integrações → Book — Telvora
Público: Administrador
Status: Publicado
Atualizado: 2026-09-07
Refs técnicas: ADR-020 · SyncTelvoraBookEntitlement.php · TelvoraBookHttpAdapter.php · docs Book ERP-INTEGRATION-API.md

O que faz

Conecta o Telvora ERP ao Telvora Book. Ao incluir um produto Book no contrato, o ERP cria ou atualiza o assinante no Book. Se o produto sair do contrato ou o acesso for bloqueado, o ERP desativa o assinante.

Login no app Book: e-mail do cliente + senha do login PPPoE (mesma senha operacional do contrato).

Quem pode usar

  • integration.book.read — consultar conexão
  • integration.book.update — salvar conexão
  • Cadastro de produtos / planos / contratos

Pré-requisitos

1) Conexão ERP ↔ Book

  1. Admin Book (https://book.telvora.com.br/admin/integracoes) → cadastrar provedor e gerar Bearer token.
  2. No ERP: Parâmetros → Integrações → Book — Telvora
  3. URL: https://book.telvora.com.br/api/v1
  4. Cliente / código do provedor (ex.: provider_core3) — opcional, só referência
  5. Bearer token
  6. Acessos simultâneos (padrão), status Ativa
  7. Salvar conexão.

2) Produto com integração

  1. Cadastros → Produtos → Integração:
  2. Tipo = Apps
  3. Provedor = Telvora Book
  4. Acessos simultâneos no app = 1…20
  5. Incluir o produto no plano e/ou nos itens do contrato (ativo).

Acessos simultâneos — prioridade

  1. Campo do produto Book no contrato (maior valor entre produtos Book)
  2. Padrão da conexão Book
  3. 1 (máximo permitido pela API Book: 20)

Passo a passo — liberação

  1. Cliente com e-mail, login PPPoE com senha gravada e contrato ativo.
  2. Inclua o produto Book no contrato e salve.
  3. O ERP chama PUT /erp/subscribers no Book.
  4. O cliente entra em https://book.telvora.com.br com e-mail + senha PPPoE.

Regras importantes

  • Sem produto TELVORA_BOOK ativo → assinante bloqueado no Book (active: false).
  • Contrato com acesso bloqueado / cliente inativo → bloqueia no Book.
  • Criação exige senha PPPoE recuperável (mín. 8 caracteres). Se não houver senha, o sync é adiado (log telvora_book.skip_create_no_password).
  • externalId no Book = ID do cliente no ERP.

Erros / avisos comuns

Situação O que fazer
Não vejo o menu Book Publique a versão e confira permissões integration.book.*.
Assinante não aparece no Book Confira produto no contrato, e-mail do cliente e senha PPPoE.
401 no sync Bearer token incorreto ou revogado.
409 e-mail E-mail já usado por outro assinante do provedor.

Relacionados

Referências