Mudanças entre as edições de "Configurações MVNO Tip"

De Grupo Voalle
 
(20 revisões intermediárias por 5 usuários não estão sendo mostradas)
Linha 1: Linha 1:
−
<span style="font-size: 21px;">Integração</span>
 
  
 +
===MVNO TIP===
 +
Serviço de Telefonia Móvel - MVNO integrado ao ERPVoalle.
  
−
'''MVNO Tip:''' Serviço de Telefonia Móvel - MVNO integrado ao ERPVoalle.
+
===Objetivo da Documentação===
 +
Explicar como devem ser feitas as configurações necessárias para utilizar a Integração de MVNO Tip.  
  
−
===Objetivo da Documentação===
+
Alguns passos serão realizados internamente, pela equipe do Grupo Voalle, e outros devem ser feitos por você, usuário do ERPVoalle. <br />
−
Explicar como devem ser feitas as configurações necessárias para utilizar a Integração com a Tip.  
 
  
−
Alguns passos serão realizados internamente, pela equipe da Voalle, e outros devem ser feitos por você, usuário do ERPVoalle. <br  />
+
===Pré-Requisitos===
 +
A empresa já deve utilizar em sua operação o CRM Voalle e a nova tela de atendimento.
  
 
==Passo a passo da configuração==
 
==Passo a passo da configuração==
−
'''1.''' {{Icone|tipo=cliente}} Entre em contato com a Tip solicitando as seguintes informações:
+
'''1.''' {{Icone|tipo=cliente}} Entre em contato com a Tip e com sua equipe de TI solicitando as informações detalhadas no documento abaixo:
−
* Dados de configuração do integrador (ambiente de homologação e de ambiente de produção)
 
−
URL Base<br  />
 
−
Token
 
−
* código de todos os planos cadastrados. <br  />
 
−
* nome e contato da pessoa do suporte da Tip, (para caso seja necessário entrar em contato durante o processo de homologação). <br  /><br  />
 
  
−
'''2.''' {{Icone|tipo=cliente}} Verifique com a sua área de TI as seguintes informações:
+
[[:File:Formulario_C07 (1).pdf]]
−
* Informações de E-mail
 
−
Conta de envio<br  />
 
−
Login conta de envio<br  />
 
−
Senha conta de envio<br  />
 
−
Servidor SMTP<br  />
 
−
Porta SMTP<br  />
 
−
Segurança SMTP<br  /><br  />
 
  
−
'''3.''' {{Icone|tipo=cliente}} Envie as informações acima à equipe '''Comercial''' da Voalle.<br />
+
Adicionalmente, informar uma pessoa para ser criado o usuário que irá responsável pelos cadastros no V-DI, informando os campos.
 +
* Nome
 +
* CPF
 +
* E-mail
 +
<br />
 +
'''2.''' {{Icone|tipo=cliente}} Envie o documento '''complementação preenchido''' acima à equipe '''Comercial''' da Voalle.<br />
  
−
'''4.''' {{Icone|tipo=voalle}} Equipe '''Comercial''' após receber as informações necessárias, enviadas pelo cliente, deve encaminhar a solicitação à equipe de '''Integrações da Voalle''', que irá entrar em contato com o cliente, passando informações e prazos de homologação. <br /><br  />
+
'''3.''' {{Icone|tipo=voalle}} Equipe '''Comercial''' após receber o documento preenchido, enviadas pelo cliente, deve encaminhar a solicitação à equipe de '''Entregas da Voalle''', que irá entrar em contato com o cliente, passando informações e prazos de homologação. <br />
  
 
==={{Icone|tipo=voalle}} Configurações - V-DI===
 
==={{Icone|tipo=voalle}} Configurações - V-DI===
−
'''1.''' Crie a base V-DI no banco de dados - PostgreSQL para o cliente.<br />
+
'''1.''' Solicitar à equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.<br />
 +
 
 +
'''2.''' Com a base V-DI criada, realize os cadastros da Empresa, Parceiro e Integradores, nessa ordem.<br />
 +
* 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<br /><br />
 +
 
 +
'''3.''' Realize o cadastro do Usuário responsável para o cliente, desse modo, ele terá acesso para realizar os demais cadastros e configurações necessárias.<br />
  
−
'''2.''' Com a base V-DI criada, realize os cadastros de Empresa, Integradores e Parceiros).<br />
+
'''4.''' Realize as configurações de parâmetros com as informações de e-mail fornecidas pelo cliente.<br />
  
−
'''3.''' Realize ao menos um cadastro de Usuários, para o cliente, assim, ele terá acesso para realizar os demais cadastros e configurações necessárias.<br />
+
Dúvidas relacionadas a este processo podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)| V-DI]]<br />
  
−
'''4.''' Realize o cadastro de um plano, e solicite que o cliente cadastre os demais planos existentes.<br  />
+
==={{Icone|tipo=voalle}} Configurações - ERP===
 +
'''1.''' Solicitar a equipe Administrativo para ser habilitado o módulo V-DI no ERP da empresa.
  
−
'''5.''' Realize as configurações de parâmetros com as informações de "e-mail" fornecidas pelo cliente.<br />
+
==={{Icone|tipo=cliente}} 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.<br />
 +
** '''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.<br />
 +
** '''URL BASE:''' Informar a URL do V-DI, porém alterar a porta para 45720 ao invés de 45721<br />
  
−
'''6.''' Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)]]<br />
+
<br />
  
−
==={{Icone|tipo=voalle}} Configurações - ERP===
+
'''2.''' Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores.
−
'''1.''' Realize o cadastro de Integradores em: Assessoria ao Cliente / Integrações / Integradores.
+
Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo podem ser consultadas em: [[Integradores]] - “Como cadastrar um novo Integrador”.<br />
−
Dúvidas relacionadas a este processo, podem ser consultadas em: [[Integradores]] - “Como cadastrar um novo Integrador”.<br />
 
  
−
'''2.''' Realize o cadastro de Webhooks em: Assessoria ao Cliente / Integrações / Integrações Webhooks.
+
{| class="wikitable"
−
Dúvidas relacionadas a este processo, podem ser consultadas em: [[Cadastro_de_Webhooks]] - “Como cadastrar um Webhook”.<br  />
+
|+ 
 +
|-
 +
!Campo
 +
!Dado
 +
|-
 +
|Alias
 +
|tip_mvno
 +
|-
 +
|Descrição
 +
|Título livre
 +
|-
 +
|Tipo de integração
 +
|Reativa
 +
|-
 +
|V-DI
 +
|Sim
 +
|-
 +
|URL
 +
|Preencher com uma barra "/"
 +
|-
 +
|Versão
 +
|2.0 (MVNO)
 +
|-
 +
|Integration Key
 +
|Hash gerado ao cadastrar o integrador no V-DI, copiar a informação do campo Chave da Integração ao clicar sobre o registro.
 +
|}
 +
'''Obs: Campos não informados não devem ser preenchidos. '''
  
−
'''3.''' Realize a configuração do parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em: Configurações / Parâmetros / Service Desk.<br />
+
'''3.''' Realize o cadastro de Webhooks em: Manutenções / Integrações / Integrações Webhooks.
 +
Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo, podem ser consultadas em: [[Cadastro_de_Webhooks]] - “Como cadastrar um Webhook”.<br />
  
−
'''4.''' Realize o cadastro de uma Praça de Venda GLOBAL em: /SellingPlaces.
+
{| class="wikitable"
−
Utilize o código “99” para a criação desta praça de venda. Preencha somente os campos: código, título, tipo “praça de venda” e local. Salve o Registro.
+
|-
−
No banco de dados, (base do cliente), pesquise pela tabela crm_selling_places e realize as configurações nas colunas descritas abaixo:<br />
+
!Campo
−
(is_global = 1 (obrigatório);
+
!Dado
−
enabled_sale_activation_service = 1 (se cliente for realizar venda de serviço de ativação);
+
|-
−
enabled_sale_product = 1  (se cliente for realizar venda de produto);
+
|Nome do webhook
−
origin_sale_service_products = 2 (obrigatório, para que os serviços vendidos sejam os serviços vinculados nos parâmetros do local e/ou unidades de negócio).<br />
+
|Título livre
 +
|-
 +
|Integrator
 +
|Selecionar a integração cadastrada no passo anterior
 +
|-
 +
|Método HTTP
 +
|POST
 +
|-
 +
|Url
 +
|<nowiki>https://synsuite.SEUDOMINIO.com.br:45720/api/v1/receive</nowiki>
 +
<br />
 +
|-
 +
|Limite de tentativas de Integrar
 +
|15
 +
|-
 +
|Lista de E-mails caso chegue ao máximo de tentativas
 +
|Conforme informado pelo cliente.<br />Caso o cliente informe mais de 1 e-mail, separar por ponto e virgula ";"
 +
|}
 +
'''Obs. Campos não informados não devem ser preenchidos.'''
  
−
'''5.''' No banco de dados, (base do cliente), pesquise pela tabela parameters e realize as configurações na coluna:
+
'''4.''' Marcar o parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em Configurações / Parâmetros / Service Desk.<br />
−
allow_customer_attendance_new_screen = 1 (irá habilitar o ícone relacionado as novas telas de atendimento).<br />
 
  
−
==={{Icone|tipo=cliente}} Configurações - ERP===
+
'''5.''' Realize cadastro dos Serviços de Telefonia Móvel em Faturamento / Cadastros / [[ Produtos/Serviços - Cadastro Serviços | Produtos/Serviços]];<br />  
−
'''1.''' Realize cadastro dos Serviços de Telefonia Móvel em: Faturamento / Cadastros / Produtos/Serviços;<br />  
+
** Marque a opção '''Serviço Composto''' como '''sim'''.<br />  
−
Marque a opção “Serviço Composto” como “sim”.<br />  
+
** No campo '''tipo de serviço''' selecione a opção '''telefonia móvel'''.<br />
−
No campo “tipo de serviço” selecione a opção “telefonia móvel”.<br />
+
** A seleção do tipo telefonia móvel, fará com que sejam adicionados dois novos campos de preenchimento obrigatório, sendo eles:<br />
−
A seleção do tipo telefonia móvel, fará com que sejam adicionados dois novos campos de preenchimento obrigatório, sendo eles:<br />
+
*** '''Empresa de Integração:''' selecione a empresa Integradora.<br />
−
“Empresa de Integração”: selecione a empresa Integradora.<br />
+
*** '''Código de Integração:''' preencha com o código do plano/serviço na integradora.<br />
−
“Código de Integração”: preencha com o código do plano/serviço na integradora.<br />
+
** Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.<br />
−
Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.<br />
+
** Caso desejado controlar o estoque de ICCIDs através da utilização de kits, deverá ser preenchido o campo “kit” no cadastro do serviço de telefonia móvel criado. Dúvidas relacionadas a este processo, podem ser consultadas em: [[Kits]] - “Como cadastrar um Kit” e “Como vincular o Kit a um Serviço”.<br /><br />
−
Caso desejado, controlar o estoque de ICCIDs, através da utilização de kits, deverá ser preenchido o campo “kit” no cadastro do serviço de telefonia móvel criado. Dúvidas relacionadas a este processo, podem ser consultadas em: [[Kits]] - “Como cadastrar um Kit” e “Como vincular o Kit a um Serviço”.<br />
 
  
−
'''2.''' Realize o vínculo dos serviços criados em:  Suíte / Cadastros / Locais.<br  />
+
'''6.''' Vincular os serviços novos na rotina CRM - Voalle / Operações / Dashboard - Parâmetros do CRM, menu Lista de Preço. A lista de preço será vinculada a campanha e conforme parametrização os serviços serão listados durante a venda.
−
Clique no Nome Fantasia do Local e acesse suas configurações.<br  />
 
−
Após, clique em  Parâmetros / Parâmetros Globais - Venda / Serviços Mensais e adicione o serviço criado.<br  />
 
−
Se utilizado Unidade de Negócio, realize o vínculo dos serviços criados em:  Suíte / Cadastros / Locais.<br  />
 
−
Clique no Nome Fantasia do Local e acesse suas configurações.<br  />
 
−
Após, clique em Unidades de Negócio, clique no ícone de Editar, depois em "Serviços" e adicionar o serviço criado.<br  />
 
  
 
==={{Icone|tipo=cliente}} Configurações - V-DI===
 
==={{Icone|tipo=cliente}} Configurações - V-DI===
−
'''1.'''Revise os cadastros realizados pela equipe Voalle.<br />
+
'''1.''' Crie cadastros de CNs, Operadora Doadora e Planos.<br />
 +
Os planos cadastrados no V-DI, precisam possuir o mesmo código informado no ERP, no cadastro do serviço, campo: “Código de Integração”.<br />
  
−
'''2.''' Crie cadastros de Usuários, CNs e Planos.<br  />
+
'''3.''' Realize a importação de ICCIDs (Chips), com o cabeçalho abaixo. Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)|V-DI]].
−
Os planos cadastrados no V-DI, precisam possuir o mesmo código informado no ERP, no cadastro do serviço, campo: “Código de Integração”.<br  />
 
  
−
'''3.''' Realize a importação de ICCIDs (Chips), utilizando um arquivo CSV. Dúvidas relacionadas a este processo, podem ser consultadas em: [[V-DI_(Voalle_Data_Integration)]].
+
{| class="wikitable"
 +
|+ 
 +
|-
 +
! IMSI
 +
! ICCID
 +
! PIN1
 +
! PUK1
 +
! PIN2
 +
! PUK2
 +
! MKT
 +
! ADMIN
 +
|-
 +
| Não preencher
 +
| Exemplo '89552600000008618766
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
| Não preencher
 +
|}
 +
Na coluna ICCIDs, informar uma ' antes da numeração para o excel não quebrar a informação.
  
 
==Páginas relacionadas==
 
==Páginas relacionadas==
−
[[Cadastro_de_Webhooks]]<br />
+
[[Cadastro_de_Webhooks]]<br />
−
[[Integradores]]<br />
+
[[Integradores]]<br />
 
[[V-DI_(Voalle_Data_Integration)]]
 
[[V-DI_(Voalle_Data_Integration)]]

Edição atual tal como às 16h59min de 6 de março de 2023

MVNO TIP

Serviço de Telefonia Móvel - MVNO integrado ao ERPVoalle.

Objetivo da Documentação

Explicar como devem ser feitas as configurações necessárias para utilizar a Integração de MVNO Tip.

Alguns passos serão realizados internamente, pela equipe do Grupo Voalle, e outros devem ser feitos por você, usuário do ERPVoalle.

Pré-Requisitos

A empresa já deve utilizar em sua operação o CRM Voalle e a nova tela de atendimento.

Passo a passo da configuração

1. CLIENTE.png Entre em contato com a Tip e com sua equipe de TI solicitando as informações detalhadas no documento abaixo:

File:Formulario_C07 (1).pdf

Adicionalmente, informar uma pessoa para ser criado o usuário que irá responsável pelos cadastros no V-DI, informando os campos.

  • Nome
  • CPF
  • E-mail


2. CLIENTE.png Envie o documento complementação preenchido acima à equipe Comercial da Voalle.

3. VOALLE.png Equipe Comercial após receber o documento preenchido, enviadas pelo cliente, deve encaminhar a solicitação à equipe de Entregas da Voalle, que irá entrar em contato com o cliente, passando informações e prazos de homologação.

VOALLE.png Configurações - V-DI

1. Solicitar à equipe responsável a criação da base V-DI no banco de dados - PostgreSQL para o cliente.

2. Com a base V-DI criada, realize 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;

3. Realize o cadastro do Usuário responsável para o cliente, desse modo, ele terá acesso para realizar os demais cadastros e configurações necessárias.

4. Realize as configurações de parâmetros com as informações de e-mail fornecidas pelo cliente.

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

VOALLE.png Configurações - ERP

1. Solicitar a equipe Administrativo para ser habilitado o módulo V-DI no ERP da empresa.

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. Realize o cadastro de Integradores em: Manutenções / Integrações / Integradores. Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo podem ser consultadas em: Integradores - “Como cadastrar um novo Integrador”.

 
Campo Dado
Alias tip_mvno
Descrição Título livre
Tipo de integração Reativa
V-DI Sim
URL Preencher com uma barra "/"
Versão 2.0 (MVNO)
Integration Key Hash gerado ao cadastrar o integrador no V-DI, copiar a informação do campo Chave da Integração ao clicar sobre o registro.

Obs: Campos não informados não devem ser preenchidos.

3. Realize o cadastro de Webhooks em: Manutenções / Integrações / Integrações Webhooks. Abaixo, seguem os campos a serem preenchidos para essa integração. Dúvidas relacionadas a este processo, podem ser consultadas em: Cadastro_de_Webhooks - “Como cadastrar um Webhook”.

Campo Dado
Nome do webhook Título livre
Integrator Selecionar a integração cadastrada no passo anterior
Método HTTP POST
Url https://synsuite.SEUDOMINIO.com.br:45720/api/v1/receive


Limite de tentativas de Integrar 15
Lista de E-mails caso chegue ao máximo de tentativas Conforme informado pelo cliente.
Caso o cliente informe mais de 1 e-mail, separar por ponto e virgula ";"

Obs. Campos não informados não devem ser preenchidos.

4. Marcar o parâmetro “Utilizar Webhooks” nos parâmetros globais do sistema em Configurações / Parâmetros / Service Desk.

5. Realize cadastro dos Serviços de Telefonia Móvel em Faturamento / Cadastros / Produtos/Serviços;

    • Marque a opção Serviço Composto como sim.
    • No campo tipo de serviço selecione a opção telefonia móvel.
    • A seleção do tipo telefonia móvel, fará com que sejam adicionados dois novos campos de preenchimento obrigatório, sendo eles:
      • Empresa de Integração: selecione a empresa Integradora.
      • Código de Integração: preencha com o código do plano/serviço na integradora.
    • Após a criação do serviço, edite o mesmo, e realize a configuração da sua composição.
    • Caso desejado controlar o estoque de ICCIDs através da utilização de kits, deverá ser preenchido o campo “kit” no cadastro do serviço de telefonia móvel criado. Dúvidas relacionadas a este processo, podem ser consultadas em: Kits - “Como cadastrar um Kit” e “Como vincular o Kit a um Serviço”.

6. Vincular os serviços novos na rotina CRM - Voalle / Operações / Dashboard - Parâmetros do CRM, menu Lista de Preço. A lista de preço será vinculada a campanha e conforme parametrização os serviços serão listados durante a venda.

CLIENTE.png Configurações - V-DI

1. Crie cadastros de CNs, Operadora Doadora e Planos.
Os planos cadastrados no V-DI, precisam possuir o mesmo código informado no ERP, no cadastro do serviço, campo: “Código de Integração”.

3. Realize a importação de ICCIDs (Chips), com o cabeçalho abaixo. Dúvidas relacionadas a este processo, podem ser consultadas em: V-DI.

 
IMSI ICCID PIN1 PUK1 PIN2 PUK2 MKT ADMIN
Não preencher Exemplo '89552600000008618766 Não preencher Não preencher Não preencher Não preencher Não preencher Não preencher

Na coluna ICCIDs, informar uma ' antes da numeração para o excel não quebrar a informação.

Páginas relacionadas

Cadastro_de_Webhooks
Integradores
V-DI_(Voalle_Data_Integration)

Disponível em “https://wiki.grupovoalle.com.br/index.php?title=Configurações_MVNO_Tip&oldid=20562”