MANUAL DE GERENCIAMENTO SISTEMA VOIP VIRGOS (TARIFADOR)

Transcrição

1 MANUAL DE GERENCIAMENTO SISTEMA VOIP VIRGOS (TARIFADOR)

2 Sumário Introdução Visão Geral Cadastrando Clientes Criando contas no sistema Criando um acesso SIP/IAX (número voip) Cadastrando Troncos (Operadoras) Cadastrando as informações de conexão para um tronco (ip,usuário, senha, etc...) Cadastrando o tronco Tarifação Descrição geral Tariffgroup Criando um Tariffgroup Listando Tariffgroup's cadastrados Associando um Tariffgroup a um cliente Ratecard Criando um Ratecard Listando Ratecard's cadastrados Associando um Ratecard a um Tariffgroup Tarifas (rotas) Criando uma Tarifa Listando e editando tarifas existentes Importando uma tabela de tarifas de uma planilha Agendamento de tarefas para débito/crédito de clientes periodicamente Billing Creditando um cliente Cadastrando pagamentos efetuados pelos clientes Visualizando pagamentos Verificando a situação financeira dos clientes Vouchers Descrição Criando um Voucher

3 6.5.3-Criando vouchers em lote Relatórios Relatório geral Fatura Comparar Ligações Tráfego mensal Tráfego diário Relatório por cliente Manutenção Backup / Download Logs Teste de DTMF Customizar Layout do Cliente Configurações Chave de Acesso ao WebService Exibição do tempo de chamadas Configurações SMTP Dados para emissão de Boleto(*) Pesonalizar os logos da Área Administrativa Valor Mínimo para Fechamento Automático Monitoramento Asterisk Console Usuários conectados SIP Usuarios conectados IAX Chamadas em andamento: Matar ligações e reiniciar Asterisk Ping Gráficos Revendas Revenda por Comissão Adicionar Revenda Comissionada Revenda-Master Adicionar Revenda Master Listar Revenda Master/Comissionada Deletar Revenda Configuração dos Administradores Adicionar Adicionar Admin Parcial Listar Admin e Admin Parcial

4 Introdução Este manual apresenta as principais funcionalidades do sistema Voip Virgos, versão tarifador. O sistema é baseado no software a2billing ( 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 à empresa autora. Verifique sempre a última versão disponível deste documento em 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)

5 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/iax friends. 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

6 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

7 1 ATA configurado para conectar se ao servidor com os dados do acesso criado no servidor (sip friend). 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 , será procurada por tarifas cujo prefixo definido seja , caso não exista, serão procuradas por tarifas 6

8 , depois , depois , depois 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 sip friend determinado no campo 'ip ou nome do friend' no cadastro do tronco. 6 E aqui, finalmente enviamos a chamada para a operadora. 7

9 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

10 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ós Pago. Limite de Crédito: Caso a conta seja do tipo pós pago, deve se definir aqui um limite de utilização de crédito. Data primeiro uso: data da primeira utilização da conta. Inserido automaticamente 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

11 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. E mail do cliente. 2: Campo adicional para e mail 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

12 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, pode se 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ós paga. Período de Vencimento: Período de dias para vencimento do boleto. Disponível apenas se foi selecionado um Período de Fechamento. 11

13 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.2 Criando 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 SIP friend (para um dispositivo que utilize o protocolo SIP) ou em Adicionar IAXfriend (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 sip friend, 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

14 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 comuniquem se 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 conectarse 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

15 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 Voic , 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. Call limit: Limite de chamadas que este SIP/IAX pode efetuar simultaneamente. 14

16 15

17 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.2 Criando 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

18 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 conectar se 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 sip friend 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 completa las. 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

19 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 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

20 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' 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' 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 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

21 Data inicial: inicio da validade deste Ratecard. Data final: final da validade do Ratecard. Tronco: define se 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 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' 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, pode se remover os ratecards já associados e associar novos ratecards. 4.4 Tarifas (rotas) 20

22 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, Caso queira diferenciar tarifas com destinos celular ou fixo, é preciso criar rotas específicas que determinem essa diferença, alguns exemplos: 55119, 55118, e 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

23 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 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 baseando se em dados de planilha eletrônica (Excel, OpenOffice). Abaixo o modelo da tabela de tarifas: São Carlos Fixo São Carlos Celular

24 55169 São Carlos Celular São Paulo Geral Rio de Janeiro Geral 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 (MS DOS), é normal o Excel emitir alguns avisos portanto confirme os 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

25 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

26 25

27 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, deve se 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

28 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 sip friend. Cartão possui 2 ou mais sip friends. 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, deve se 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, deve se 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ós pago; Ambos. Status: estado da tarefa, ativa ou inativa. E mail para envio de relatório: indique um envio de um relatório contendo os resultados da execução da tarefa. 27

29 OBS: a tarefa somente será aplicada aos clientes que estiverem com a opção Executar tarefas periódicas ativada em seu cadastro. 28

30 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.3 Visualizando 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.4 Verificando 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 chama se 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