¶ Integração STFC - SaperX
No Hubsoft há a integração com a plataforma de STFC, SaperX
Para configurar esta integração, são necessárias as seguintes informações:
- ip: IP de produção para conexão com a plataforma. Sua alteração pode causar mal funcionamento na integração. Altere apenas se tiver convicção na exatidão do dado.
- porta: Porta utilizada em conjunto com o IP de produção da plataforma.
- client_secret: Token para gerar acesso à API
- client_id: ID para gerar acesso à API
- login: Usuário utilizado para autenticação na plataforma
- senha: Senha utilizada para autenticação na plataforma
Todas estas informações são passadas pela própria plataforma.
Há também alguns parâmetros opcionais que podem ser utilizados, sendo eles:
- valor_did: Valor cobrado pelo uso do DID.
Formato: 100.00
- did_ACB: Aceita chamada a cobrar
Valores disponíveis: 0 para não e 1 para sim
- did_can_sell: Número apto a venda
Valores disponíveis: 0 para não e 1 para sim
- did_ddr_reserved: Número reservado para DDR
Valores disponíveis: 0 para não e 1 para sim
¶ Cadastrando a Integração
Com os dados (IP, Porta e Token) em mãos, basta adicionar a integração no HubSoft, seguindo este passo a passo:
Acesse o módulo STFC, em Configuração > Integração > STFC
Clique em Adicionar
Uma tela será exibida, solicitando os dados da Integração, precisaremos preencher os campos que forem obrigatórios (*), a Descrição e os parâmetros:
- ip
- porta
- client_secret
- client_id
- login
- senha
Após preencher, clique em Salvar.
¶ Adicionando os Planos
Após cadastrar a integração com a plataforma, será necessário sincronizar os planos, para que o sistema traga todos os serviços que serão ofertados aos clientes. Para isso, clique em Ações > Planos.
Clique em Sincronizar Planos.
Após a sincronização, todos os planos disponíveis serão exibidos na listagem dos planos da Plataforma Saper X:
¶ Adicionando os Números
Agora que os planos já estão criados, iremos para a próxima etapa, que é o cadastro de números. Esse cadastro, consiste nos números que serão entregues para os seus clientes. Devido a transmissão de dados via API, conforme os números forem liberados no sistema, também serão liberados na plataforma. Assim se forem bloqueados no HubSoft, também serão bloqueados na plataforma.
Para cadastrar os números você deve ir em Ações > Números
Clique em Adicionar Número, preencha os campos e clique em salvar
Para preencher o formulário de adição de números, há as seguintes possibilidades:
- Inserir uma faixa de números. Por exemplo, adicionar uma faixa inicial com o final 90 e no número final adicionar um número com final 99. Dessa maneira o sistema irá criar 10 números automaticamente, começando com o final 90 e terminando com o final 99.
Caso queria adicionar apenas um número, basta inseri-lo no campo Número Inicial e deixar o campo Número Final vazio.
- Adicionar IP’s para o número, para ser cadastrado na Saper X, bastando preencher o campo Domínio do formulário. Inserindo os IP’s separados por vírgula, caso haja mais de um.
Ainda na visualização dos números, conseguiremos buscar de forma livre pelo número ou pelo cliente vinculado. Poderemos buscar pelos filtros de status do número (se está vinculado à algum cliente ou não) e pelo status da transmissão. E por último também conseguiremos realizar algumas ações de forma massiva.
¶ Campo de Busca
¶ Filtros
¶ - Apagar Massivamente
Quando forem selecionados apenas os números que estiverem disponíveis (que não estejam vinculados a nenhum cliente), será disponibilizada a opção de Apagar Massivamente.
¶ - Desvincular Massivamente
Caso apenas números vinculados sejam selecionados, ou seja, números que já pertencem a algum cliente, a opção de Desvincular Massivo ficará disponível.
Ao selecionar a opção de Desvincular, o sistema irá adicionar os números na fila de remoção para enviar a plataforma. Tendo o processamento feito por uma rotina interna de envio STFC, é só aguardar que os números serão removidos.
¶ - Apagar Massivamente e Desvincular Massivamente
Ao selecionar todos os números, serão exibidas ambas as opções.
¶ Apagar por Faixa
Para a exclusão massiva de número também é possível Apagar e Desvincular por Faixa. Para que desvincule o cliente, é necessário que a chave Desvincular esteja marcada.
Esta opção é muito útil para quando for adicionada uma faixa de números incorreta.
¶ Contabilização
- Há também alguns dados sobre os números, vinculados e desvinculados, que podem ser acessados através de um botão que fica no canto superior direito da janela de Números STFC.
¶ Adicionando o Número no Serviço do Cliente
Para adicionarmos um número ao serviço do cliente, devemos ir em Serviços do Cliente > Outras Opções (três pontinhos) > Dados de STFC
Nos serviços do cliente, o usuário poderá adicionar os parâmetros de forma individual e também adicionar o número que será vinculado ao cliente.
Para adicionar os Parâmetros, clique em Adicionar Parâmetros, selecione a integração e preencha os campos.
Para adicionar os Números, clique em Adicionar Número, selecione a integração, o plano e informe o número. Após preenchido, clique em Salvar.
Assim que o número for adicionado, é necessário aguardar a transmissão do mesmo à plataforma.
Caso apresente algum erro na transmissão, verifique se os dados da integração estão corretos ou entre em contato com o nosso suporte.
¶ Parâmetro Para Emissão de NF de Telefonia
Para provedores que fornecem serviços de telefonia e utilizam a composição de telefonia nos planos (Tipo de Utilização = 1 e Classificação do Item doc. Fiscal = 0101), foi adicionado um novo parâmetro nos Dados de STFC no serviço do cliente para que seja possível emitir a NF e validar sem nenhum erro.
Para adicionar esse parâmetro é necessário acessar o serviço do cliente > ir em outras opções > Dados de STFC
Clique em Adicionar Parâmetro, selecione a Integração, no Parâmetro 1 deverá ser informado o seguinte parâmetro numero_telefone_nf e no Valor 1 deverá ser informado o número do cliente.
¶ Realizando o Faturamento
Através do Hubsoft, conseguiremos buscar todas as cobranças de STFC que estão na plataforma para que seja feito o faturamento dos números. Dessa forma, o sistema irá consultar via API, os valores que estão faturados e o provedor poderá gerar o boleto do cliente através do sistema.
Caso algum valor faturado esteja incorreto, o provedor deve entrar em contato com a plataforma de STFC.
Para realizar o processamento de faturas, você deve ir em Ações > Processar/Faturar
Precisaremos preencher o Tipo de Lançamento, o Mês, o Ano (que será faturado) e se Permitirá o Detalhamento das Chamadas, em seguida basta Carregar o processamento. Ao processar o sistema irá exibir os custos por número para adicionar/gerar às faturas.
