Manual Virgos Tarifação

MANUAL DE GERENCIAMENTO
SISTEMA VOIP VIRGOS
(TARIFADOR)
Manual – Sistema Voip Virgos – Versão Tarifador
Atualização: 10/12/10
Sumário
Introdução..............................................................................................................3
1 – Visão Geral......................................................................................................4
2 – Cadastrando Clientes.......................................................................................8
2.1- Criando contas no sistema......................................................................................................................... 8
2.2-Criando um acesso SIP/IAX (número voip)............................................................................................. 12
3 – Cadastrando Troncos (Operadoras)...............................................................16

3.1 - Cadastrando as informações de conexão para um tronco (ip,usuário, senha, etc...)
...................................................................................................................................................................... 16
3.2 – Cadastrando o tronco............................................................................................................................. 16
4 – Tarifação........................................................................................................18
4.1 – Descrição geral...................................................................................................................................... 18
4.2 – Tariffgroup............................................................................................................................................ 18
4.2.1 – Criando um Tariffgroup......................................................................................................................18
4.2.2 – Listando Tariffgroup's cadastrados....................................................................................................19
4.2.3 – Associando um Tariffgroup a um cliente............................................................................................19
4.3 – Ratecard................................................................................................................................................ 19
4.3.1 – Criando um Ratecard..........................................................................................................................19
4.3.2 – Listando Ratecard's cadastrados........................................................................................................20
4.3.3 – Associando um Ratecard a um Tariffgroup........................................................................................20
4.4 – Tarifas (rotas)........................................................................................................................................ 20
4.4.1 – Criando uma Tarifa............................................................................................................................21
4.4.2 – Listando e editando tarifas existentes.................................................................................................22
4.5 - Importando uma tabela de tarifas de uma planilha..................................................................................22
5 - Agendamento de tarefas para débito/crédito de clientes periodicamente......26
6 - Billing.............................................................................................................29
6.1 - Creditando um cliente............................................................................................................................ 29
6.2 - Cadastrando pagamentos efetuados pelos clientes.................................................................................. 29
6.3-Visualizando pagamentos......................................................................................................................... 29
6.4-Verificando a situação financeira dos clientes..........................................................................................29
6.5-Vouchers................................................................................................................................................. 30
6.5.1-Descrição...............................................................................................................................................30
6.5.2-Criando um Voucher.............................................................................................................................30
1
6.5.3-Criando vouchers em lote......................................................................................................................31
7- Relatórios........................................................................................................32
7.1 - Relatório geral....................................................................................................................................... 32
7.2 - Fatura.................................................................................................................................................... 33
7.3 - Comparar Ligações................................................................................................................................ 33
7.4 - Tráfego mensal...................................................................................................................................... 33
7.5 - Tráfego diário........................................................................................................................................ 33
7.6 - Relatório por cliente............................................................................................................................... 34
8 - Manutenção....................................................................................................35
8.1 - Backup / Download............................................................................................................................... 35
8.2 - Logs....................................................................................................................................................... 35
8.3 - Teste de DTMF...................................................................................................................................... 35
8.4 - Customizar Layout do Cliente................................................................................................................ 36
8.5 - Configurações........................................................................................................................................ 36
8.5.1 - Chave de Acesso ao WebService.........................................................................................................36
8.5.3 - Exibição do tempo de chamadas ........................................................................................................36
8.5.4 - Configurações SMTP...........................................................................................................................36
8.5.5 - Dados para emissão de Boleto(*).......................................................................................................37
8.5.6 - Pesonalizar os logos da Área Administrativa.....................................................................................37
8.5.7. - Valor Mínimo para Fechamento Automático.....................................................................................37
9 - Monitoramento ..............................................................................................38
9.1 - Asterisk Console.................................................................................................................................... 38
9.1.1 - Usuários conectados SIP.....................................................................................................................38
9.1.2 - Usuarios conectados IAX....................................................................................................................38
9.1.3 - Chamadas em andamento: .................................................................................................................39
9.1.4 - Matar ligações e reiniciar Asterisk ....................................................................................................39
9.2 - Ping....................................................................................................................................................... 39
9.3 - Gráficos................................................................................................................................................. 39
10 - Revendas......................................................................................................40
10.1 - Revenda por Comissão......................................................................................................................... 40
10.1.1 - Adicionar Revenda Comissionada.....................................................................................................40
10.2 - Revenda-Master................................................................................................................................... 41
10.2.1 - Adicionar Revenda Master................................................................................................................42
10.3 - Listar Revenda Master/Comissionada.................................................................................................. 43
10.4 Deletar Revenda..................................................................................................................................... 43
11 - Configuração dos Administradores..............................................................44

11.1 - Adicionar............................................................................................................................................. 44
11.2 - Adicionar Admin Parcial...................................................................................................................... 44
11.3 - Listar Admin e Admin Parcial.............................................................................................................. 45
2
Introdução
Este manual apresenta as principais funcionalidades do sistema

Voip Virgos, versão tarifador. O sistema é baseado no software a2billing
(www.asterisk2billing.org) e é distribuído sob licença GPL, assim como o
original. Não é tratado neste documento passos para instalação do sistema e
sim para o seu gerenciamento.
Esta documentação, desenvolvida pela Virgos, pode ser distribuída

gratuitamente, desde que mantida sua forma e a referência à empresaautora.
Verifique sempre a última versão disponível deste documento em

http://suporte.virgos.com.br/downloads/manual.pdf
Customizações, consultorias, treinamentos e outros serviços sempre

podem ser solicitados conosco. O contato pode ser feito via:
Virgos Tecnologia da Informação S/S
Episcopal, 1763 – São Carlos SP
(16) 21078647 – www.virgos.com.br
3
1 – Visão Geral
O sistema trabalha basicamente com o cadastramento de troncos de

saída para as chamadas, rotas e clientes.
É possível trabalhar com várias operadoras simultaneamente no sistema,
onde cada operadora será um tronco no sistema.
O que torna isto possível é o cadastramento de rotas no sistema, rotas
são definidas atráves de prefixos de discagem e para cada rota definimos um tronco
de saída. As rotas possuem diversas propriedades, como por exemplo, valor pago
por minuto na rota e valor que será cobrado pela rota.
Abaixo um diagrama mostrando a relação entre cliente, rotas e troncos.
No cadastro de clientes, é cadastrado primeiramente uma conta que

detém as informações do cliente, como: nome, endereço, enfim, os dados cadastrais
do cliente. É nesta conta que atribuímos os créditos ao cliente.
Para cada conta existente podemos criar vários números voip, estes
conhecidos no sistema como sip/iaxfriends. Os termos SIP e IAX indicam o
protocolo de comunicação utilizado pelo dispositivo (ata, softphone, voipphone)
utilizado na comunicação.
Observamos também no digrama acima outros dois termos: tariffgroup e
ratecard.
4
Os ratecard's são na verdade um grupo de tarifas (rotas). No

cadastramento das tarifas umas das propriedades indicadas é em qual dos
ratecard's existentes no sistema ela será inserida.
Os tariffgroup's podem ser considerados como os planos de venda
praticados no sistema, dentro dos tariffgroup's inserimos os ratecard's criados no
sistema.
Com o cadastro de tariffgroup's e ratecard's podemos então associar um
cliente a um tariffgroup.
Desta forma, poderíamos por exemplo, criar um plano com tarifas
reduzidas para clientes empresariais e manter clientes residenciais em um
tariffgroup com tarifação comum.
Abaixo é apresentado outro diagrama, agora demonstrando o
funcionamento do sistema com um cadastramento básico de clientes, rotas e
troncos.
5
1 ATA configurado para conectarse ao servidor com os dados do acesso criado no
servidor (sipfriend). Considerando que o ATA esteja autenticado no servidor,
quando o cliente efetuar uma ligação o ATA enviará número discado para o servidor.
2 O sistema verificará então que este acesso sip está associado ao cliente
'Empresa1'.
3 Nesta fase é verificado a qual tariffgroup o cliente 'Empresa1' está associado,
que no caso é o tariffgroup 'Empresarial'.
4 O sistema fará uma comparação do número discado pelo cliente com todas as
tarifas existentes nos ratecard's atribuídos ao tariffgroup Empresarial, vale ressaltar
que sempre será selecionada a tarifa que seja mais completa em relação ao número
discado pelo usuário.
Por exemplo, caso o usuário disque 01140634771, será procurada por tarifas cujo
prefixo definido seja 01140634771, caso não exista, serão procuradas por tarifas
6
0114063477, depois 011406347, depois 01140634, depois 0114063 e assim

sucessivamente, até que algo seja encontrado.
Caso exista mais de uma tarifa cadastrada com o mesmo prefixo, será escolhida a
de menor custo.
Selecionada a tarifa, o sistema então enviará a chamada para o tronco
correspondente a tarifa selecionada.
5 Chegamos então ao final do processo, onde já sabemos para qual tronco enviar
a ligação. Basta agora resgatarmos as informações de autenticação do tronco
escolhido, tais informações estão no sipfriend determinado no campo 'ip ou nome
do friend' no cadastro do tronco.
6 E aqui, finalmente enviamos a chamada para a operadora.
7
2 – Cadastrando Clientes
2.1 Criando contas no sistema
Para cadastrar um cliente, vá em 'Adicionar Cliente' que está localizado
no menu 'Clientes'. Abaixo a descrição dos campos disponíveis no formulário de
cadastro:
– Número: Número gerado automaticamente pelo sistema, código único para

identificação da conta
– Apelido: É o nome de usuário utilizado para o cliente acessar a interface de

consulta de saldo desta conta. Este campo só aceita caracteres numéricos.
– Senha via Web: Senha utilizada para acesso a interface de consulta de saldo.
– Crédito: Este campo possibilita definir um crédito inicial para o cliente, porém o
sistema não contabiliza o valor como um crédito a ser pago pelo cliente.
– Aviso de crédito: Valor para o aviso de crédito baixo.
– Revendedor: Este campo determina à quem este cliente pertence. Caso seja
selecionado algum revendedor, ele terá acesso a este cliente.
– Língua: idioma do cliente.
– Tariffgroup: Neste campo é definido qual tariffgroup o cliente utilizará para

efetuar suas ligações.
– Campanhas de Áudio(*): Este campo define se este cliente tem acesso às
campanhas de áudio.
– Campanhas de SMS(*): Este campo define se este cliente tem acesso às
campanhas de sms.
8
– Callcenter(*): Este campo define se este cliente tem acesso ao Callcenter.
– Ativo: estado da conta, possíveis valores:
– sim: conta ativada, ligações feitas normalmente (caso o cliente tenha

créditos).
– não: conta desativada, utilização da conta bloqueada.
– Acesso simultâneo: Defina se esta conta poderá realizar mais de um acesso
simultâneo.
– Moeda: moeda corrente do cliente.
– Executar tarefas periódicas: o sistema permite o agendamento de tarefas de
débito, caso exista alguma, defina aqui se tais tarefas serão aplicadas nesta
conta.
– Tipo: tipo de conta, PréPago ou PósPago.
– Limite de Crédito: Caso a conta seja do tipo póspago, devese definir aqui um
limite de utilização de crédito.
– Data primeiro uso: data da primeira utilização da conta. Inserido automati

camente pelo sistema.
– Data da última chamada realizada: data da última vez que o cliente efetuou
uma chamada. Inserido automaticamente pelo sistema.
– Ativar expiração: É possível definir uma data para expiração da conta. As
seguintes opções estão disponíveis:
– Não expirar: A conta nunca expira.
9
– Expirar em uma data: a conta expira na data informada no campo “data de
expiração”.
– Expirar alguns dias após o primeiro uso: A conta expira após o número de
dias informado no campo “dias para expirar”, contando após o data do
primeiro uso.
– Expirar alguns dias após a criação: Expira a conta após o número de dias
informado no campo “dias para expirar”, contando após a data de criação
(cadastro).
– Data de expiração: Defina uma data de expiração para a conta, se o campo
“Ativar expiração” estiver ativo.
– Dias para expirar: Defina o número de dias para a conta expirar, calculo
baseado na definição do campo “Ativar expiração”.
– Sobrenome: sobrenome do cliente.
– Primeiro nome: primeiro nome do cliente.
– Email: Email do cliente.
– Email2: Campo adicional para email do cliente, caso seja necessário.
– Endereço: Endereço do cliente.
– Bairro: Bairro do cliente.
– Cidade: Cidade do cliente.
– Estado: Estado do cliente.
– País: País do cliente.
10
– CEP: CEP do cliente.
– DDD: Área do telefone do cliente. Informando a área local, o cliente não

precisará discálo para efetuar chamadas para localidades com este DDD.
– Telefone: Telefone do cliente.
– Telefone2: Campo adicional para telefone do cliente, caso seja necessário.
– Pessoa para contato: Nome da pessoa para quando for necessário fazer
contato.
– FAX: Fax do cliente.
– Documento (CPF/CNPJ): CPF/CNPJ do cliente.
– Empresa: Nome da empresa do cliente.
– Inscrição Estadual: Número da inscrição estadual do cliente.
– Em uso: Usado para debug, este valor será maior que 0 se o cartão estiver em
uso. Caso a aplicação trave por algum motivo então o ficara marcado como >0.
Neste caso, podese marcar de volta ao 0 para liberar o uso futuro.
– Gravação(*): Ativar a gravação de chamadas para este cliente.
– Data do último Fechamento: Data em que ocorreu o último fechamento da

conta deste cliente. Inserido automaticamente pelo sistema.
– Período de Fechamento: Período de dias entre cada fechamento. Disponível
apenas se a conta for do tipo póspaga.
– Período de Vencimento: Período de dias para vencimento do boleto. Disponível
apenas se foi selecionado um Período de Fechamento.
11
– Observações: Campo livre onde pode ser inserido observações sobre o cliente.
(*) Necessário adquirir estes serviços. Entre em contato com nosso Setor
Comercial para maiores detalhes.
2.2Criando um acesso SIP/IAX (número voip)
É neste cadastro que criamos os acessos que serão utilizados nos

dispositivos. Para cadastrar um acesso, no menu “Clientes” clique em “Adicionar
SIPfriend” (para um dispositivo que utilize o protocolo SIP) ou em “Adicionar IAX
friend” (para um dispositivo que utilize o protocolo IAX).
– Name: identificação do acesso. É através deste número que o acesso receberá
chamadas.
– Tipo: tipo de sipfriend, no caso de clientes utilize o padrão “friend”, a definição
“peer” é utilizada somente no cadastramento de operadoras.
– Username: nome de usuário que será utilizado para este acesso se autenticar no
sistema. Normalmente igual a 'name'.
– Cartão associado: número da conta à qual este acesso será associado.
– Regexten: Se for preenchido deve ser igual ao username.
– Callerid: Identificação do usuário, a que aparece na BINA.
– Amaflags: Deixe como 'billing' para as chamadas serem registradas.
– Senha: senha que será utilizada para autenticação deste acesso no sistema.
– MD5Secret: Senha précriptografada (quase não usado).
– NAT: defina se o dispositivo que utilizará este acesso esta em uma rede que
utilize NAT.
12
– DTMFMode: Deixe como RFC2833.
– Qualify: se habilitada, o sistema irá fazer uma verificação do status deste acesso
regularmente. Se a latência do servidor for muito alta ou ele não suportar 'qualify'
ele pode se tornar UNREACHABLE, impedindo que ligações saim pela
operadora usada. Desabilite e ele deverá funcionar.
– Canreinvite: Determina se durante uma chamada, o sistema deve tentar fazer
com que origem e destino comuniquemse diretamente, com o objetivo de liberar
o tráfego do sistema.
– Disallow: Codecs que não serão permitidos, deixe como 'all'.
– Allow: define quais codecs poderão ser utilizados por este acesso. Os codecs
mais conhecidos estão definidos em ordem de prioridade.
– Host: Deixe dynamic no caso de usuários com ip dinâmico. Você precisa

preecher este campo apenas no caso das operadoras/troncos.
– Callgroup: Deixe em branco.
– Context: Contexto ao que o SIP está atrelado, normalmente 'callingcard'.
– Defaultip: Usado para definir um IP para um SIP antes que o ATA se registre
com o Asterisk. Normalmente deixado em branco.
– Fromuser: Se estiver cadastrando uma operadora/tronco, coloque aqui o

mesmo valor do campo USERNAME, isto é, o usuário que vc usa para conectar
se nela.
– Fromdomain: Força um domínio nas mensagens entre os SIPs.
– Insecure: Define como manipular a conexão entre os peers. Normalmente 'no'
(default) para SIPs e pode ser 'very' para alguns troncos/operadoras.
13
– Language: Código de duas letras indicando o país, isto influencia nos toques e
tons usados. Para o Brasil é br, normalmente fica em branco.
– Mailbox: Extensão do VoiceMail, válido apenas para SIPs do tipo peer.
– Permit, Deny, Mask: Restringem ou permitem IPs.
– Pickupgroup: Grupo que pode pegar chamadas de outros usuários usando *8. É
necessário que a extensão *8 esteja configurada corretamente.
– Port: Porta em que o SIP responde.
– Restrictcid: Não é usado.
– RTPTimeout: Termina uma chamada se houver mais de N segundos de

inatividade na chamada quando o telefone não estiver em espera. Válido
somente para SIPs do tipo igual a peer.
– RTPHoldTimeout: Termina uma chamada depois de N segundos de inatividade
em uma chamada em espera.
– Musiconhold: Uma das classes especificadas no arquivo musiconhold.conf.

Normalmente não usado aqui.
– Regseconds: Número de segundos antes do peer se registrar. Válido apenas
para entradas em tempo real e normalmente é deixado em branco.
– IP Addr: IP do SIP, válido para conexões em tempo real. Deixe em branco.
– CanCallForward: Deixe em yes.
– DDD: Código da área deste SIP/IAX.
– Calllimit: Limite de chamadas que este SIP/IAX pode efetuar simultaneamente.
14
15
3 – Cadastrando Troncos (Operadoras)
3.1 Cadastrando as informações de conexão para um
tronco (ip,usuário, senha, etc...)
Este cadastro é normalmente utilizado para troncos que fazem

autenticação através de usuário e senha. Para este cadastro insira um SIP client
(veja em “2.2Criando um acesso SIP/IAX (número voip)”). Abaixo a descrição dos
campos necessários.
– Name: nome para identificação do tronco no sistema, livre escolha.
– Tipo: o tipo de acesso que estamos cadastrando, no caso de operadoras defina
“peer”.
– Username: insira o nome de usuário fornecido pela operadora. Caso a

autenticação seja feita através do IP do servidor, deixe este campo em branco.
– Senha: insira a senha oferecida pela operadora. Caso a autenticação seja feita
através do IP do servidor, deixe este campo em branco.
– Qualify: Defina se o sistema deve fazer uma verificação regularmente do status
da operadora. Algumas operadoras não suportam este parâmetro, se este for o
caso defina 'no' neste campo.
– Host: insira o IP ou o domínio da operadora.
– Fromuser: Defina o mesmo valor informado no campo username.
3.2 – Cadastrando o tronco
16
Para criar um novo tronco, clique em “Adicionar” localizado no menu

“Troncos”. Abaixo a descrição dos campos utilizados:
– Código do tronco: insira um nome para identificação deste tronco.
– Adicionar prefixo: algumas operadoras necessitam do prefixo '011' antes do
número discado, este campo possibilita que o prefixo seja adicionado
automaticamente ao número discado (*).
– Remover prefixo: remove um ou mais dígitos discados pelo usuário.
– Protocolo: Tipo de protocolo usado para conectarse ao tronco. Sua operadora
lhe fornecerá este parametro. Os valores possíveis são: SIP, IAX2 e ZAP.
– IP ou nome do friend: indique aqui o nome do sipfriend criado para esta

operadora, ou informe o IP ou domínio caso a operadora possua a facilidade de
autenticação através do IP.
– Parametros Adicionais: Usados nos comandos Dial do asterisk. Geralmente

não é necessário.
– Tronco secundário, em caso de falhas: podemos definir aqui tronco dentre os
cadastrados no sistema para que assuma as chamadas destinadas a este
(cadastro atual), caso ele não consiga completalas.
– Crédito no tronco: usado para controlar quanto crédito você tem com a
operadora. Conforme as ligações saírem pelo tronco o crédito diminui. Quando
você colocar mais créditos na operadora você atualiza aqui. Este campo serve
apenas para seu controle não influenciando no sistema de tarifas.
17
4 – Tarifação
4.1 – Descrição geral
A tarifação é constituída por 3 elementos, tariffgroup's, ratecard's e

tarifas, onde os tariffgroup' são os planos de venda do sistema, a cada cliente do
sistema é associado um tariffgroup. Associamos então a um tariffgroup um ou mais
ratecard's, que são grupos de tarifas.
Inserimos então, dentro dos ratecard's, as tarifas, que são uma definição
de cada rota (prefixo) que desejamos permitir ligações dentro do sistema. As tarifas
possuem diversas propriedades, como: prefixo, valor de compra e venda na rota,
tronco de destino para a rota, dentre outras.
Veja abaixo uma figura demonstrando a associação como deve ser feita
no sistema.
4.2 – Tariffgroup
4.2.1 – Criando um Tariffgroup
Para criar um Tariffgroup, clique em “Adicionar Tariffgroup” no menu

“Tarifas”. Abaixo a descrição do formulário de cadastro de um tariffgroup.
– Nome: defina o nome do Tariffgroup.
18
– Tipo: este campo define como o sistema deve agir quando encontrar duas rotas
iguais, porém com tarifas diferenciadas. As opções são: LCR opta pela rota que
possua o menor custo para você, LCD opta pela rota que possua o menor custo
para seu cliente.
– Remover prefixo internacional: defina se as tarifas dos ratecard's que serão
associados a este Tariffgroup possuem os prefixos internacionais '011' ou '00'.
4.2.2 – Listando Tariffgroup's cadastrados
Para listar os Tariffgroup's cadastrados no sistema, vá em “Listar/Editar
Tariffgroup”, localizado no menu “Tarifas”.
Será apresentada a lista de todos os Tariffgroup's cadastrados no sistema
e suas principais informações. É possível editar e apagar qualquer tariffgroup criado
clicando nos botões 'editar' e 'deletar'.
4.2.3 – Associando um Tariffgroup a um cliente.
A associação dos clientes com os Tariffgroup's é feita editando o cadastro
no cliente (menu “Clientes”, “Lista de Clientes/Cartões”) e alterando o campo
Tariffgroup do cliente.
4.3 – Ratecard
4.3.1 – Criando um Ratecard
Para criar um novo ratecard, clique em criar “Adicionar Ratecard”,

localizado no menu “Tarifas”. Os campos envolvidos no cadastro estão descritos
abaixo.
– Nome: defina o nome que será utilizado para identificar o Ratecard.
19
– Data inicial: inicio da validade deste Ratecard.
– Data final: final da validade do Ratecard.
– Tronco: definese um tronco padrão para as tarifas que estarão dentro do
Ratecard. Porém isso não restringe que todas as tarifas dentro do ratecard saiam
pelo tronco definido aqui. O tronco de cada tarifa pode ser editado na própria
tarifa.
– Descrição: apenas um campo para comentários explicativos do ratecard. Não é
obrigatório.
– DNID: não deve ser alterado o valor padrão.
4.3.2 – Listando Ratecard's cadastrados
Para listar os Ratecard's cadastrados no sistema, vá em “Listar/Editar

Ratecard”, localizado no menu “Tarifas”.
Será apresentada a lista de todos os Ratecard's cadastrados no sistema e
suas principais informações. É possível editar e apagar qualquer ratecard criado
clicando nos botões 'editar' e 'deletar'.
4.3.3 – Associando um Ratecard a um Tariffgroup
Isto é feito na edição do Tariffgroup em que o Ratecard será associado.
Um tariffgroup pode possuir uma lista de ratecard associados, que também são
conhecidos como tariffplan's.
Na edição do tariffgroup temos a lista de ratecards associados, podese
remover os ratecards já associados e associar novos ratecards.
4.4 – Tarifas (rotas)
20
4.4.1 – Criando uma Tarifa
Para criar uma nova tarifa, clique em “Adiconar Tarifa” no menu “Tarifas”.
No cadastramento de tarifas é definido para onde o sistema fará ligações (prefixos),
qual operadora utilizar e os valores praticados para cada destino. Abaixo a descrição
dos campos do formulário de cadastro da tarifa:
– Ratecard: defina a qual ratecard a tarifa deve ser inserida.
– Prefixo de Discagem: defina o prefixo da rota. É possível criar tanto rotas mais
abrangentes e rotas mais especificas, dependendo da necessidade de
diferenciação na tarifação. Por exemplo, poderíamos criar uma rota para todos os
destinos do Brasil informando neste campo apenas o '55'. Outra possibilidade
seria criar uma rota para cada DDD, ex: 5516, 5511. Caso queira diferenciar
tarifas com destinos celular ou fixo, é preciso criar rotas específicas que
determinem essa diferença, alguns exemplos: 55119, 55118, 55219 e 55218.
– Destino: uma descrição para a rota, ex: Brasil.
– Por quanto você compra: defina o valor pago na rota à operadora.
– Tempo mínimo que você paga na chamada: defina o tempo mínimo de
tarifação aplicado pela operadora. Ex: Uma operadora que aplique uma tarifa
nos primeiros 30 segundos, após isso a cada 6 segundos.
– Em blocos de quantos segundos você paga: o período de tempo em que a
tarifa é aplicada após a tarifação mínima.
– Quanto você cobra?: O valor que será aplicado ao cliente nesta rota.
– Tempo mínimo de tarifação: o tempo mínimo em que a tarifa será aplicada ao
cliente.
– De quantos em quantos segundos você tarifa o cliente: defina o período em
que será feita a tarifação no cliente após o período mínimo.
21
– Custo por conexão: possibilita tarifar o cliente na conexão da chamada, além do
tempo total utilizado.
– Custo por desconexão: possibilita tarifar o cliente na desconexão da chamada,
além do tempo total utilizado.
– Data inicial: data de inicio do período de validade da tarifa.
– Data final: data final do período da validade da tarifa.
– Dias de semana: dias da semana em que a tarifa será válida.
– Tronco: define para qual tronco a chamada deve ser redirecionada.
– Música de espera: altera o tom de discagem para uma música. O valor “No

music on hold” mantém o tom de discagem convencional.
4.4.2 – Listando e editando tarifas existentes
Após o cadastramento das tarifas, alterações poderão ser feitas atráves
do menu “Editar Ratecard”, localizado no menu “Tarifas”.
Um campo de seleção contendo os ratecards existentes no sistema é
apresentado. Listadas as tarifas de um Ratecard temos a opção de editálas ou
apagálas, clicando nos respectivos botões. Os campos são os mesmos da criação
da tarifa.
4.5 Importando uma tabela de tarifas de uma planilha
O sistema oferece também, a funcionalidade de fazer o cadastramento
das tarifas baseandose em dados de planilha eletrônica (Excel, OpenOffice). Abaixo
o modelo da tabela de tarifas:
55163 São CarlosFixo 0.1 30 6 0.05 30 6

55168 São CarlosCelular 0.5 30 6 0.30 30 6
22
55169 São CarlosCelular 0.5 30 6 0.30 30 6

5511 São PauloGeral 0.08 30 6 0.04 30 6
5516 Rio de JaneiroGeral 0.08 30 6 0.04 30 6
Temos então uma tabela com algumas rotas definidas. Veja que foram
definidos os mesmos campos do cadastramento comum de uma tarifa, são eles:
prefixo, destino, preço de venda, tempo mínimo de venda, tempo adicional de venda,
preço de compra, tempo mínimo de compra e tempo adicional de compra.
O último passo na preparação da tabela é salvála no formato de arquivo
“csv”. Para isso, utilizamos a opção “salvar como” geralmente localizada no menu
“arquivo”. No Excel, selecione o tipo de arquivo “CSV (MSDOS)”, é normal o Excel
emitir alguns avisos portanto confirmeos para finalizar a operação. Em outro editor,
selecione a opção “Texto CSV”, edite as configurações de filtro deixando “;” como
delimitador de campo e delimitador de texto em branco.
Com a planilha salva no formato CSV, podemos executar a importação.
No menu “Tarifas”, vá em “Importar Ratecard”, os passos são descritos abaixo:
– Escolha qual ratecard quer importar: Selecione o ratecard em que as tarifas da
tabela serão importadas.
– Tronco a usar: Determine qual será o tronco de saída para as tarifas.
Em seguida devemos informar como as informações estão dispostas no
arquivo csv. As primeiros 3 colunas do arquivo já estão préselecionadas e são
campos obrigatórios para a importação, são eles:
– Dialprefix: prefixo de discagem (ex.: 5511).
– Destination: uma descrição para a tarifa (ex.: Brasil – São Paulo).
– Rate intial: o preço de venda aplicado na rota.
Na seqüência, podemos informar alguns dados opcionais, como:
23
– Buyrate: o preço de compra para rota.
– Buyrateinitblock: tempo mínimo de compra aplicado na rota.
– Buyrateincrement: o tempo adicional de compra aplicado na rota.
– Initblock: tempo mínimo de venda aplicado na rota.
– Billingblock: tempo adicional de venda aplicado na rota.
– Connect charge: taxa de conexão.
– Disconnect charge: taxa de desconexão.
Considerando a utilização de arquivo seguindo o modelo aqui
apresentado, teríamos a seguinte seqüência a determinar.
● campos obrigatórios
1 – dialprefix.
2 – destination.
3 – rateinitial.
● campos opcionais
4 – initblock.
5 – billingblock.
6 – buyrate.
7 – buyrateinitblock.
8 – buyrateincrement.
Feito isso, indicamos ao sistema qual o arquivo a utilizar na importação,
para isso clique no botão “arquivo”, em seguida clique em importar.
A tela seguinte nos apresenta uma comparação entre o que foi
determinado na tela anterior e os valores encontrados na primeira linha do arquivo
csv. Estando tudo certo, carregue o arquivo novamente e clique em 'continuar
importação' para finalizar o processo.
24
25
5 Agendamento de tarefas para débito/crédito de clientes
periodicamente
Esta é uma funcionalidade em que podemos agendar tarefas para realizar
débito ou crédito dos clientes automaticamente, em um intervalo de tempo
determinado.
Para criar uma tarefa periódica, vá em “Adicionar Tarefas” no menu
“Execuções Periódicas”, abaixo a descrição dos campos disponíveis no cadastro da
tarefa:
– Nome: Defina um nome para a tarefa.
– Valor: Defina o valor que será debitado/creditado de cada cliente. As opções

são:
– valores positivos: debita créditos das contas atingidas pela execução.
– valores negativos: credita as contas atingidas pela execução.
– Ação no cartão: Nesta opção é possível escolher se o cartão do cliente deve ser
desativado e se seus créditos serão retirados quando ele for afetado pela tarefa
periódica. As opções são:
– Apenas retirar os créditos acima inseridos.
– Apenas desativar o cartão sem retirar os créditos.
– Desativar e retirar os créditos acima inseridos.
– Retirar todos os créditos acima inseridos.
– Periodicidade: o intervalo de tempo em que a tarefa deve ser executada. Ex:
diariamente, a cada 10 dias, a cada 30 dias, todo dia x do mês e etc...
– Dia: Caso tenha sido selecionada a opção “Todo dia X do mês” no item anterior,
devese indicar neste campo em qual dia ela será executada.
– Regra: É determinar também que a tarefa somente seja executada caso a regra
aqui definida seja verdadeira, as opções são:
– O usuário não usa o cartão desde N dias.
26
– O usuário usou o cartão nos últimos N dias.
– Recarga de créditos não realiazada nos últimos N dias.
– Cartão possui apenas 1 sipfriend.
– Cartão possui 2 ou mais sipfriends.
– Apenas neste tariffgroup.
– Movimentação em aberto vencido por N dias.
– Usuário efetuou menos de N recargas no mês passado.
– Número de dias: campo utilizado para definição de “N dias” do campo regra.
Caso for utilizada a regra “Apenas neste tariffgroup”, devese definir neste campo
qual o ID do tariffgroup que a tarefa afetará. Caso for utilizada a regra “Usuário
efetuou menos de N recargas no mês passado”, devese definir neste campo o
número de recargas que será utilizada.
– Parar de executar: Não executa a tarefas nos clientes que se encaixem da regra
aqui definida
– Nunca.
– O crédito da conta chegou a zero.
– Máximo de execuções alcançado.
– Máximo de execuções por cartão: determina o valor para o campo “máximo de
execuções alcançado”, da opção parar de executar.
– Tipos dos cartões: Este campo define o tipo do cartão que a tarefa irá afetar.
Suas opções são:
– Prépago;
– Póspago;
– Ambos.
– Status: estado da tarefa, ativa ou inativa.
– Email para envio de relatório: indique um envio de um relatório contendo os
resultados da execução da tarefa.
27
OBS: a tarefa somente será aplicada aos clientes que estiverem com a opção
“Executar tarefas periódicas” ativada em seu cadastro.
28
6 Billing
6.1 Creditando um cliente
Para creditar um cliente, vá em “Creditar cliente”, localizado no menu

“Billing”. Indique o número do cliente e a quantia a ser creditada. Pode ser inserido
também um comentário junto ao crédito que está sendo efetuado. Em seguida clique
em “Creditar valor ao cartão associado”.
6.2 Cadastrando pagamentos efetuados pelos clientes
O cadastramento de pagamentos dos clientes é efetuado para facilitar o
gerenciamento do sistema, quanto a quantias pagas e quantias à pagar.
Está localizado no menu “Billing” em “Cadastrar pagamentos”. Para
cadastrar uma pagamento informamos o username do cliente que efetuou o
pagamento e a quantia que foi paga, além de ser possível também inserir um
comentário sobre o pagamento. É possível escolher o username do cliente clicando
no botão laranja, onde será exibida uma lista para seleção.
6.3Visualizando pagamentos
Nesta opção, localizada no menu “Billing” em “Listar Pagamentos”,

podemos conferir todos os pagamentos efetuados no sistema, com os dados do
cliente que efetuou o pagamento, a data do pagamento, o valor pago e o comentário
associado. Caso você possua o serviço de boletos(*), aparecerá também o campo
“Status” do pagamento, que indica se o boleto já está “pago” ou “à confirmar”.
6.4Verificando a situação financeira dos clientes
Nesta tela podemos visualizar todas as informações relacionadas a

questões financeiras para cada cliente do sistema. A opção chamase “Situação
Financeira” e esta localizada no menu “Billing”.
Temos então listados todos os clientes do sistema, o total de crédito atual,
a quantia total já creditada, o total pago e o valor total à pagar.
29
Em “detalhes” podemos visualizar a data e valor de cada crédito e

pagamento efetuado pelo cliente.
OBS: o campo “crédito” definido no cadastro do cliente, não consta como valor à
pagar para o cliente.
6.5Vouchers
6.5.1Descrição
Vouchers podem ser comparados com os cartões de recarga de celulares
prépagos, onde através de um código digitado do celular o cliente é
automaticamente creditado.
O sistema gera um código de voucher aleatório, para o qual é definido um
valor de crédito. O cliente que possuir este código poderá digitalo na interface de
consulta de saldo para obter os créditos.
Considerações sobre Vouchers:
um voucher só poderá ser utilizado uma única vez.
somente serão aceitos os códigos cadastrados no sistema e seu status estiver
como Ativo.
após sua utilização o voucher é automaticamente desativado.
6.5.2Criando um Voucher
Para criar um voucher, vá em “Adicionar Voucher”, localizado no menu
“Billing”. Abaixo a descrição dos campos:
– Voucher: código aleatório gerado para o voucher.
– Credit: crédito associado a este voucher.
– Activated: estado do voucher.
– Currency: moeda utilizada para o crédito.
30
– Expiration date: data de expiração para o voucher.
6.5.3Criando vouchers em lote
Há a opção de criar vários vouchers em um único processo, bastando
apenas indicar a quantidade de vouchers à criar, a valor que será associado, a
moeda utilizada nos créditos e a data de expiração.
Esta opção chamase “Adicionar Vouchers (em lote)” e está localizada no
menu “Billing”.
31
7 Relatórios
O sistema disponibiliza uma série de relatórios que mostram de várias

maneiras as chamadas efetuadas pelos clientes. Abaixo a descrição dos relatórios
disponíveis.
Diversos filtros podem ser aplicados ao relatório, como: listar chamadas
de apenas um cliente, chamadas em um determinado intervalo de meses, filtrar as
chamadas através do Destino da rota ou filtrar através do número que originou a
chamada. Há também a opção de fazer uma combinação dos diversos filtros
disponíveis.
7.1 Relatório geral
Um dos principais relatórios do sistema é o Relatório geral. Nele
conseguimos listar todas as chamadas efetuadas pelos clientes através do sistema,
onde são mostradas as seguintes informações:
– Data da chamada
– Origem
– Número chamado
– Destino
– Duração
– Cliente/Cartão
– Status
– $/min (compra)
– $/min (venda)
– Custo
– Total
– Tronco
– Tarifa
Caso o serviço de gravações(*) do asterisk estiver ativo, aparecerá
também o ícone de um microfone, onde ao ser clicado é possível fazer o download
da gravação da chamada correspondente. Você ainda pode remover a entrada no
log clicando em “Apagar”.
32
7.2 Fatura
O relatório “Fatura”, apresenta vários dados e sub relatórios. Nele você
pode ver o 'Serviço de Fatura', 'Evolução da Conta' e 'Detalhe das Ligações'.
No 'Serviço de Fatura' você pode ver um gráfico mostrando as ligações
para destinos mais usados, com os dados de duração, número de ligações e custo
total.
No 'Evolução da Conta' é exibido um gráfico relacionando número de
ligações e duração com os dias pedidos no relatório. Ainda é exibido o dado do
custo total.
No 'Detalhes das Ligações' são apresentados detalhes na seguinte
ordem:
– Data da ligação
– Origem
– Número chamado
– Destino
– Tempo
– Cartão
– Total
7.3 Comparar Ligações
Apresenta um gráfico mostrando a utilização do sistema no decorrer no
dia. Útil para verificar em quais horários há uma maior demanda na utilização do
sistema. Existe também a possibilidade de comparar o dia selecionado com os dias
anteriores (“Quantidade de dias para comparar”).
7.4 Tráfego mensal
Exibe um gráfico em pizza relacionando os meses anteriores e o atual
com os minutos usados. Você pode escolher de 1 mês a 6 meses na opção
“Quantidade de meses para comparar”.
7.5 Tráfego diário
33
Exibe um gráfico em pizza relacionando os meses anteriores e o atual
com os minutos usados. Você pode escolher de 1 mês a 6 meses na opção
“Quantidade de meses para comparar”.
7.6 Relatório por cliente
Exibe um relatório por cliente com os seguintes dados para cada entrada:
– Usuário
– Nome
– Sobrenome
– Tipo
– Ligações
– Valor de Venda
– Valor de Compra
– Lucro
No fim do relatório mostra o total de ligações, de venda, de compra e de
lucro.
34
8 Manutenção
8.1 Backup / Download
A primeira opção aqui permite que se faça um backup em formato tar.gz
da base de dados e do sistema de billing e cliente.
A segunda opção permite que se faça backup dos usuários do sistema
em um arquivo xls. Algo como uma exportação dos dados dos usuários..
8.2 Logs
Nessa opção você pode fazer o log de alguns arquivos de log do sistema.
São eles:
– full: Log geral de uso do asterisk.
– revenda_pospago.log: Log de desativacao de clientes pospagos quando o

revendedor associado fica com credito negativo.
– log_mudanca_plano.txt: Log de alteracao automatica de plano dos clientes ao
atingirem determinado consumo em ligacoes celular.
– a2billing.log: Log de processamento do sistema billing.
– Master.csv: CDR de chamadas. Todas as chamadas do sistema ficam

registradas neste arquivo. Porém, NAO é do billing, nao tem associacao com
tarifas ou planos.
8.3 Teste de DTMF
Utilizado para testar se determinada operadora é capaz de fazer callback.
35
8.4 Customizar Layout do Cliente
Aqui é possível customizar certos aspectos da área do cliente. Para isso,
é possível utlizar os seguintes recursos:
– Arquivo CSS: Efetue o upload de um arquivo CSS para alterar o estilo da área
do cliente;
– Imagem do Topo: Imagem que será exibida no topo da página na área do
cliente.
8.5 Configurações
8.5.1 Chave de Acesso ao WebService
Configure essa chave para usar em aplicações externas que precisem de
acesso ao billing.
8.5.3 Exibição do tempo de chamadas
Você pode configurar para que seja exibido o tempo real de conexão ou o
tempo em blocos. Detalhe que pode ocorrer discrepância de tempo em comparação
com as operadoras se usar o tempo real, pois comumente elas configuram a
exibição por blocos de 30 (trinta) segundos.
8.5.4 Configurações SMTP
Configurações utilizadas para o envio de email do sistema.
36
8.5.5 Dados para emissão de Boleto(*)
Insira aqui os dados para a emissão de boletos diretamente pela área do
cliente. Seguem abaixo os campos que devem ser configurados:
– Banco: Selecione aqui o banco de sua preferência;
– Número do Convênio: Número do convênio junto ao banco;
– Número da Agência: Número da agência de seu banco;
– Carteira: Número da carteira junto ao banco;
– Taxa do Boleto: Caso houver, insira aqui a taxa cobrada pela emissão do
boleto.
– Instruções: Instruções que serão impressas junto ao boleto (Ex: “Pagável em
qualquer agência bancária.”);
– Nome da sua Empresa, Endereço, Cidade, Estado, CPF: Informações que
aparecerão junto ao boleto.
– Valores: Valores disponíveis que o cliente terá acesso para escolher.
8.5.6 Pesonalizar os logos da Área Administrativa
Nesta configuração é possível fazer o upload de uma imagem que

aparecerá na interface da área administrativa do Billing. Caso for necessário, existe
também a opção de voltar o logo padrão do sistema, basta apenas clicar no botão
“Voltar Logo Padrão”.
8.5.7. Valor Mínimo para Fechamento Automático
Onde é determinado o valor mínimo do saldo gasto pelo cliente para a
ativação automática do pagamento. O fechamento automático só está disponível
para clientes póspago. Caso nenhum valor seja especificado o sistema utiliza o
valor padrão de 150,00. Segue abaixo o campo que devem ser configurado:
– Valor: Valor mínimo para ativar o fechamento automático. Para valores decimais,
utilizar o ponto (.) ao invés da virgula (,).
37
9 Monitoramento
9.1 Asterisk Console
9.1.1 Usuários conectados SIP
Este relatório possibilita ver os usuários sip que estão conectados no
momento. Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em
seguida clique em “Usuários conectados SIP”. No relatório você terá algo como:
– Nome/User do sipfriend
– Cartão associado
– Nome do cliente
– IP do sipfriend
– Porta de conexão
– Se o reinvite está habilitado
– Status da conexão do sipfriend (tempo em milisegundos da conexão,
desconhecido (UNKNOW), inalcançável (UNREACHABLE) ou não monitorado,
quando o qualify está desabilitado nas configurações do sip friend).
– Reinvite (siginifica que o tráfego de voz da ligação não passa pelo servidor,
economizando processamento e banda, o que melhora a qualidade e diminui a
latência. O reinvite só ocorre quando a chamada é atendida. Portanto, é normal
constar reinvite='no' antes que a chamada seja completada.)
9.1.2 Usuarios conectados IAX
Possibilita verificar os usuários IAX que estão conectados no momento.
Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida
clique em “Usuários conectados SIP”.
Um pouco mais simples que o anterior ele mostra o nome/username,
ip/host, a máscara de rede, a porta em que se conecta e o status, assim como o
anterior.
38
9.1.3 Chamadas em andamento:
Nessa opção podese constatar quais as chamadas estão em andamento.
Para chegar nele entre em “Asterisk console” no menu “Manutenção”, em seguida
clique em “Usuários conectados SIP”.
A saber temos: origem e o nome associado daquele que fez a chamada,
O número discado pelo mesmo, o tempo de ligação ocorrido até o momento, o
codec que está sendo utilizado pelo usuário, se o reinvite está ativado, o status do
sip friend, e se deseja desligar/terminar com a ligação, útil no caso de uma ligação
travada.
9.1.4 Matar ligações e reiniciar Asterisk
Cuidado com essa opção, usea somente se tiver certeza do que está
fazendo pois erros podem ocorrer em caso de travamento.
9.2 Ping
Nessa página você pode fazer o teste de ping para qualquer servidor. O
teste de ping compara o tempo de envio e resposta de pacotes pela internet. No
caso de compara entre servidores voips, até 400ms é um tempo aceitável.
9.3 Gráficos
O monitoramento é feito por gráficos, os quais mostram o uso do sistema
em relação ao asterisk, ao uso do disco (hd), ao banco de dados (mysql), ao tráfego
nas placas de rede, ao uso do email no sistema (postfix), aos processos do sistema
e ao próprio voip.
39
10 Revendas
10.1 Revenda por Comissão
Revenda por Comissão é a forma de revenda utilizado atualmente, onde,
ao criar o revendedor, o administrador deve selecionar os tariffgroups que o
revendedor poderá utilizar para seus clientes.
Esse tipo de revenda é baseado em comissão, portanto o lucro do
revendedor é calculado com base na porcentagem de comissão definido na criação
deste tipo de revenda.
Com relação aos créditos dos clientes, nos prépagos o crédito é dado pelo
revendedor e conforme o cliente utiliza vai descontando de seu saldo; assim que o
saldo do cliente chega a zero ou é insuficiente para que o cliente realize uma ligação
este deve contactar o revendedor para recarga de créditos. Já nos póspagos o
revendedor define o limite que o saldo do cliente pode ficar negativo e não deve ser
inserido créditos à ele para que ele fique com saldo positivo. Conforme o cliente faz
ligações o crédito do revendedor é debitado, e se o saldo do revendedor chegar a
zero todos clientes póspagos serão desativados automaticamente pelo sistema, por
isso é importante que quando o revendedor trabalhar com clientes póspagos ele se
mantenha sempre com saldo de créditos positivo.
10.1.1 Adicionar Revenda Comissionada
Nessa área você irá criar uma nova Revenda Comissionada. Os campos
diferentes da Revenda Master são:
– Login: "username" que o revendedor irá utilizar para acessar sua área no billing.
– Senha: senha que será utilizada com o "username" informado no login.
– %Comissão: Insira a porcentagem de ganho do revendedor. Caso você defina
uma comissão, ao gerar relatórios tanto você quanto o revendedor verão o
cálculo de lucro baseado no movimento de ligações dos clientes do revendedor e
no movimento de créditos comprados. Você pode deixar 0 e assim o sistema não
efetuará o cálculo dessas comissões.
– Créditos: Crédito inicial da revenda.
40
– Ver Ligações Detalhadas: Essa opção habilita, ou não, que o revendedor veja
as ligações detalhadas de seus clientes.
– Acesso ao Asterisk Console (Monitoramento): Permite ao revendedor
observar em tempo real os usuários conectados e as chamadas em andamento
dos mesmos.
– Ver Valor de Compra: O revendedor será capaz de ver o valor que você paga
na compra das ligações. Normalmente você irá negar a ele essa informação.
– Pemissão de Criação: Define se, ao criar um cliente o revendedor poderá definir
um status para a conta do cliente. ativo, pode ser usada automaticamente,
inativo, necessitará ser ativada pelo administrador responsável e nenhum, não
vai definir nenhum status para a conta do cliente.
– Campanhas de Áudio: Permite a revenda ativar campanhas de áudio para seus
clientes.
– Campanhas de SMS: Permite a revenda ativar campanhas de sms para seus
clientes.
– Callcenter: Permite a revenda disponibilizar o callcenter para seus clientes.
– Tariffgroup: Define quais os tariffgroups que o revendedor criado irá poder
utilizar junto aos seus clientes.
– A partir do campo Nome, insira os dados que achar necessário para a
identificação de seu revendedor.
10.2 RevendaMaster
Revenda que especifica o valor de venda. Ela é de certa forma autônoma,
one ela não ganha uma comissão, já que ela mesma define por quanto irá revender
(obtendo assim seu próprio lucro).
O funcionamento desta revenda deve proceder como descrito abaixo:
1 O administrador deve criar Ratecards para servirem de modelo
para o dos revendedores.
OBS1: A criação do Ratecard modelo é igual a de qualquer Ratecard.
O preço de venda especificado nas tarifas deste Ratecard será o preço que o
revendedor vai pagar ao administrador.
OBS2: Após ter sido criado o Ratecard modelo, quando for feita
alguma alteração nele (preço de compra, billingbllock, ou qualquer outro campo), o
sistema atualizará todas as tarifas que foram originadas a partir daquele modelo.
2 Agora é necessário criar um novo revendedor (utilizar a nova opção de
criação de revendedores). Nele o administrador deve especificar quais os modelos
41
de Ratecard (tarifas) que o revendedor terá acesso para poder criar as suas
próprias.
Pronto, a nova revenda está criada, agora vamos para a área do novo
revendedor:
1 A primeira coisa que o revendedor deve fazer é abrir o menu "Tarifas" e
selecionar a opção "Criar novo Ratecard". Nele o revendedor especificará o nome do
ratecard e qual ratecard modelo será usado.
2 Ao criar um novo ratecard o revendedor será redirecionado
automaticamente para a área de edição de tarifas (o novo ratecard criado pelo
revendedor já estará selecionado e pronto para que ele defina o valor de venda).
3 O revendedor deve definir qual o preço de venda, por padrão será
igual ao preço de compra até que um valor seja definido. Ele pode editálas uma a
uma através do botão editar de cada tarifa ou editar várias de uma vez através do
campo "Preço de venda" no fim da página.
4 Com os ratecards criados e o preço de venda das tarifas definidos, o
revendedor deve criar um novo tariffgroup através do menu "Criar tariffgroup" e
selecionar quais ratecards fazem parte deste tariffgroup.
Pronto, com os tariffgroups criados o revendedor já pode criar seus
clientes com os seus próprios tariffgroups. Sempre que um de seus clientes efetuar
uma ligação o valor tarifado será aquele que o revendedor definiu.
Com relação aos créditos dos clientes, a revendamaster pode creditar livremente
seus clientes, e toda ligação que eles fizerem, quer seja prépago ou póspago, será
reduzido do saldo atual da revendamaster. Se o saldo ficar igual ou menor que zero
o sistema desativará todos os clientes do revendedor, portanto é importante que o
revendedor mantenha seu saldo de créditos sempre com valor positivo.
10.2.1 Adicionar Revenda Master
Nessa área você irá criar uma nova Revenda Master. Os campos para
preenchimento são:
– Login: "username" que o revendedor irá utilizar para acessar sua área no billing.
– Créditos: Crédito inicial da revenda.
42
– Ver Ligações Detalhadas: Essa opção habilita, ou não, que o revendedor veja
as ligações detalhadas de seus clientes.
– Acesso ao Asterisk Console (Monitoramento): Permite ao revendedor
observar em tempo real os usuários conectados e as chamadas em andamento
dos mesmos.
– Pemissão de Criação: Define se, ao criar um cliente o revendedor poderá definir
um status para a conta do cliente. ativo, pode ser usada automaticamente,
inativo, necessitará ser ativada pelo administrador responsável e nenhum, não
vai definir nenhum status para a conta do cliente.
– Campanhas de Áudio: Permite a revenda ativar campanhas de áudio para seus
clientes.
– Campanhas de SMS: Permite a revenda ativar campanhas de sms para seus
clientes.
– Gera Boleto: Permite a revenda gerar boletos com dados próprios.
– Callcenter: Permite a revenda disponibilizar o callcenter para seus clientes.
– Modelo de Tarifa: Aqui você vai definir qual o modelo de tarifa que será aplicada
a essa revenda.
– A partir do campo Nome, insira os dados que achar necessário para a
identificação de seu revendedor.
10.3 Listar Revenda Master/Comissionada
Nesta opção você pode consultar as revendas já criadas em seu sistema.
Para isso clique em Listar Comissionadas ou Listar Masters para que seja exibida a
listagem. Caso seja necessário alguma alteração, é possível utilizar o botão “editar”
ou caso necessário remover uma revenda basta utilizar o botão “deletar”.
10.4 Deletar Revenda
Ao deletar uma revenda, todos os dados referentes a ela serão apagados
de maneira irreversível , ou seja, cartões, configurações (SMTP, Boleto, etc), planos
e grupos de tarifas, tarifas, créditos e pagamentos.
43
11 Configuração dos Administradores
11.1 Adicionar
Crie seus administradores aqui, tenha por preferência preencher todos os
campos.
11.2 Adicionar Admin Parcial
Você pode também criar administradores parciais que podem
"administrar" apenas certas configurações de seu servidor. Seguem os campos
necessários para o cadastro de um administrador parcial:
– Login: "username" que o administrador parcial irá utilizar para acessar sua área
no billing.
– Permissões: aqui são definidas quais as áreas que este administrador parcial
terá acesso. As opções são:
– Clientes: tem permissão de acesso e configuração no menu
“Clientes”.
– Billing: tem permissão de acesso e configuração no menu “Billing”.
– Tarifas: tem permissão de acesso e configuração no menu “Tarifas”.
– Troncos: tem permissão de acesso e configuração no menu
“Troncos”.
– Relatórios: tem permissão para acessar o menu “Relatórios”.
– Execuções Periódicas: tem permissão de acesso e configuração no
menu “Execuções Periódicas”.
– Administradores: tem permissão de acesso e configuração no menu
“Adminstradores”.
– Revenda: tem permissão de acesso e configuração no menu
“Revendas”.
– Manutenção: tem permissão de acesso e configuração no menu
“Manutenção”.
– Monitoramento: tem permissão de acesso e configuração no menu
“Monitoramento”.
– Permissão para Creditar: define se este administrador parcial pode efetuar
créditos aos clientes.
44
– Callcenter(*): define se este administrador parcial pode liberar o callcenter aos
clientes.
– Nome, Endereço, CEP, Estado, Telefone, Fax: insira nestes campos os dados
cadastrais que você julgar importantes.
11.3 Listar Admin e Admin Parcial
Aqui você pode listar os admnistradores bem como editar suas

configurações ou deletálos.
45

Manual Virgos Tarifação

Enviado por

Dados do documento

Título original

Direitos autorais

Formatos disponíveis

Compartilhar este documento

Compartilhar ou incorporar documento

Opções de compartilhamento

Você considera este documento útil?

Este conteúdo é inapropriado?

Direitos autorais:

Formatos disponíveis

Manual Virgos Tarifação

Enviado por

Direitos autorais:

Formatos disponíveis

MANUAL DE GERENCIAMENTO

3 – Cadastrando Troncos (Operadoras)...............................................................16

5 - Agendamento de tarefas para débito/crédito de clientes periodicamente......26

6.5.3-Criando vouchers em lote......................................................................................................................31

11 - Configuração dos Administradores..............................................................44

Este manual apresenta as principais funcionalidades do sistema

Esta documentação, desenvolvida pela Virgos, pode ser distribuída

Verifique sempre a última versão disponível deste documento em

Customizações, consultorias, treinamentos e outros serviços sempre

O sistema trabalha basicamente com o cadastramento de troncos de

No cadastro de clientes, é cadastrado primeiramente uma conta que

Os ratecard's são na verdade um grupo de tarifas (rotas). No

0114063477, depois 011406347, depois 01140634, depois 0114063 e assim

– Número: Número gerado automaticamente pelo sistema, código único para

– Apelido: É o nome de usuário utilizado para o cliente acessar a interface de

– Tariffgroup: Neste campo é definido qual tariffgroup o cliente utilizará para

– sim: conta ativada, ligações feitas normalmente (caso o cliente tenha

– Data primeiro uso: data da primeira utilização da conta. Inserido automati­

– DDD: Área do telefone do cliente. Informando a área local, o cliente não

– Data do último Fechamento: Data em que ocorreu o último fechamento da

É neste cadastro que criamos os acessos que serão utilizados nos

– Host: Deixe dynamic no caso de usuários com ip dinâmico. Você precisa

– Fromuser: Se estiver cadastrando uma operadora/tronco, coloque aqui o

– RTPTimeout: Termina uma chamada se houver mais de N segundos de

– Musiconhold: Uma das classes especificadas no arquivo musiconhold.conf.

Este cadastro é normalmente utilizado para troncos que fazem

– Username: insira o nome de usuário fornecido pela operadora. Caso a

Para criar um novo tronco, clique em “Adicionar” localizado no menu

– IP ou nome do friend: indique aqui o nome do sip­friend criado para esta

– Parametros Adicionais: Usados nos comandos Dial do asterisk. Geralmente

A tarifação é constituída por 3 elementos, tariffgroup's, ratecard's e

Para criar um Tariffgroup, clique em “Adicionar Tariffgroup” no menu

Para criar um novo ratecard, clique em criar “Adicionar Ratecard”,

Para listar os Ratecard's cadastrados no sistema, vá em “Listar/Editar

– Música de espera: altera o tom de discagem para uma música. O valor “No

55163 São Carlos­Fixo 0.1 30 6 0.05 30 6

55169 São Carlos­Celular 0.5 30 6 0.30 30 6

– Valor: Defina o valor que será debitado/creditado de cada cliente. As opções

Para creditar um cliente, vá em “Creditar cliente”, localizado no menu

Nesta opção, localizada no menu “Billing” em “Listar Pagamentos”,

Nesta tela podemos visualizar todas as informações relacionadas a

Em “detalhes” podemos visualizar a data e valor de cada crédito e

O sistema disponibiliza uma série de relatórios que mostram de várias

– revenda_pospago.log: Log de desativacao de clientes pos­pagos quando o

– Master.csv: CDR de chamadas. Todas as chamadas do sistema ficam

Nesta configuração é possível fazer o upload de uma imagem que

Aqui você pode listar os admnistradores bem como editar suas

Você também pode gostar

– Data primeiro uso: data da primeira utilização da conta. Inserido automati

– IP ou nome do friend: indique aqui o nome do sipfriend criado para esta

55163 São CarlosFixo 0.1 30 6 0.05 30 6

55169 São CarlosCelular 0.5 30 6 0.30 30 6

– revenda_pospago.log: Log de desativacao de clientes pospagos quando o