Configurações Integração Summit

De Grupo Voalle
Revisão de 15h34min de 23 de outubro de 2023 por Vitoria.tormes (discussão | contribs)


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

CLIENTE.png 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.

Assessoria.png 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.

VOALLE.png 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;

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

CLIENTE.png 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.

CLIENTE.png 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