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 |
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
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
- 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