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