Configurações Integração Summit

Guia de Integração Summit

Solução de Telefonia Fixa (STFC) integrada ao ERP Voalle.

Objetivo

Apresentar um guia de configurações necessárias para que o ERPVoalle se comunique com o serviço de telefonia Summit.

A integração utiliza o sistema Voalle Data Integration como intermedidor de comunicação entre ERPVoalle e Summit, com isso, é necessário realizar configurações no ERPVoalle e no V-DI.

Configurações

Solicitação da integração

Entrar em contato com a Voalle e solicitar a integração com a Summit enviando as seguintes informações para que os cadastros iniciais sejam feitos:

Informações para criação do usuário gestor do V-DI

Campo	Uso
Nome	Para cadastro do usuário no V-DI
CPF	Para cadastro do usuário no V-DI
E-mail	Será o login do usuário e endereço para envio de definição de senha

Informações para configurar o envio de e-mail do V-DI

Campo	Uso
Conta de envio	Envios de e-mail do V-DI
Login da conta de envio	Envios de e-mail do V-DI
Senha da conta de envio	Envios de e-mail do V-DI
Servidor SMTP	Envios de e-mail do V-DI
Porta SMTP	Envios de e-mail do V-DI
Segurança SMTP	Envios de e-mail do V-DI

Informações para configurar a integração com a Summit

Essas informações podem ser solicitadas a Summit ou coletadas no sistema SSW

Campo	Uso
URI	Endereço e porta para integração com o sistema Summit.
Partição	Código identificador cadastrado no sistema EMS da Summit.
Estágio do contrato para Replicação	Define a partir de que estágio o contrato poderá ser replicado.
Diretório FTP	Endereço do diretório onde os arquivos de faturamento são salvos.
Usuário FTP	Usuário para autenticação no diretório FTP.
Senha FTP	Senha para autenticação no diretório FTP.
Categoria - Bloqueio Parcial	Categoria padrão atribuída ao status Bloqueio Parcial.
Categoria - Bloqueio Administrativo	Categoria padrão atribuída ao status Bloqueio Administrativo.
Categoria - Suspensão	Categoria padrão atribuída ao status Suspensão.

Direcionamento da solicitação

1. Verificar com a equipe de Administrativo se o módulo Voalle Data Integration | V-DI e o módulo Summit está ativo no ERPVoalle e se a empresa possui o V-DI contratado.

2. Caso o módulo não esteja ativo, enviar o protocolo a equipe Administrativo para ativar.

3. Caso o cliente não possua o V-DI contratado, enviar o protocolo a equipe responsável para dar as tratativas.

Configurações - V-DI

1. Com a base V-DI criada, realizar os cadastros da Empresa, Parceiro e Integradores, nessa ordem.

• Para o cadastro do parceiro é necessária a geração de uma chave única que será informada no campo ERP KEY na aba configurações. Será usada esta mesma chave também nas configurações globais para vincular o ERP ao V-DI;
  • Site com a funcionalidade: https://www.uuidgenerator.net/guid
    
    

2. Realizar o cadastro do Usuário responsável para o cliente, assim, ele terá acesso para dar continuidade nos demais cadastros e configurações necessárias.

3. Realizar as configurações dos parâmetros com as informações de "e-mail" fornecidas pelo cliente.

Dúvidas relacionadas a este processo, podem ser consultadas em: V-DI

Configurações - V-DI

1. Acessar o link enviado por e-mail para gerar a senha de acesso ao V-DI.

2. Após logar no V-DI, acessar a rotina Cadastros / Integradores, e no integrador Summit cadastrado pela Voalle validar as informações preenchidas.

3. Acessar a rotina STFC / Planos e realizar o cadastro dos planos que serão comercializados.

• Também é possível importar todos os planos diretamente da integradora através do botão Importar Planos.
  
  

Configurações - ERP

1. Configurar os parâmetros do ERP em: Configurações / Parâmetros, menu Voalle Data Integration | V-DI

• ERP KEY: Informar a Chave do ERP gerada no cadastro de Parceiros do V-DI. Para ver a chave, basta clicar sobre o registro do Parceiro cadastrado.
  
• API KEY: Informar a Chave da API gerada no cadastro de Parceiros do V-DI. Para ver a chave, basta clicar sobre o registro do Parceiro cadastrado.
  
• URL BASE: Informar a URL do V-DI, porém alterar a porta para 45720 ao invés de 45721
  

2. Acessar a rotina Manutenções / Integrações / Integradores e cadastrar um novo integrador.

Campo	Dado
Alias	"summit_stfc"
Descrição	Título livre
Tipo de integração	Reativa
Versão	4.0 - STFC
V-DI	Sim
URL	Preencher com uma barra "/"
Chave de Integração	Pegar no cadastro de Integradores

3. Acessar a rotina Manutenções / Integrações / Webhooks e cadastrar um novo gatilho.

Campo	Dado
Nome do Webhook	Título livre
Integrador	Selecionar o integrador cadastrado no passo 2
Método	Post
Url	{url do ERP}:45720/api/v1/receive
Limite de Tentativas de Integrar	15
Lista de E-mails	Lista com os endereços de e-mail que receberão o alerta quando o limite de tentativas for esgotado

4. Na rotina Faturamento / Cadastros / Produtos/Serviços deve ser cadastrados os planos que serão comercializados. Os campos específicos para integração Summit são:

Campo	Dado
Tipo	Telefonia Fixa
Emp. Integração	"Summit"
Integrador	Integrador cadastrado no passo 2
Plano Summit	Selecionar um plano dos cadastrados no V-DI
Licença	"RE", "SX" ou "ST"
Categoria	Informe o ID da categoria conforme o cadastro de categorias, na plataforma SSW Summit

5. Cadastro de grupos e números de telefone. Realizar o cadastro dos grupos de telefones conforme necessário e após isso, cadastrar os números de telefone, que serão vinculados ao serviço no momento da venda. Lembrando que o controle de linhas é feito pelo ERP e não pela integradora.

Para maiores explicações sobre a rotina, acesse: Grupos de Telefone e Dashboard - Telefonia