ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

MANUALDEGERENCIAMENTO SISTEMAVOIPVIRGOS (TARIFADOR)

1/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Introduo 1Visogeral 2Cadastrandoclientes 2.1Criandocontasnosistema 2.2CriandoumacessoSIP/IAX(nmerovoip) 2.3Criandocontasemlote 3CadastrandoTroncos(operadoras) 3.1Cadastrandootronco 3.2Cadastrandoasinformaesparaconexocomumtronco 4Tarifao 4.1Descriogeral 4.2Tariffgroup 4.2.1CriandoumTariffgroup 4.2.2ListandoTariffgroup'scadastrados 4.2.3AssociandoumTariffgroupaumcliente 4.3Ratecard 4.3.1CriandoumRatecard 4.3.2ListandoRatecard'scadastrados 4.3.3AssociandoumRatecardaumTariffgroup 4.4Tarifas(rotas) 4.4.1Criandoumatarifa 4.4.2Listandoeeditandotarifasexistentes 4.5Importandoumatabeladetarifasdeumaplanilha 5Agendandoexecuesdetarefasparadebito/crditoperiodicamente 6Billing 6.1Creditandoumcliente 6.2Cadastrandopagamentosefetuadospelosclientes 6.3Visualizandopagamentos 6.4Verificandoasituaofinanceiradosclientes 6.5Vouchers 6.5.1CriandoumVoucher 6.5.2Criandovouchersemlote 7Relatrios 7.1CdrReport 7.2Invoice 7.3Callscompare 7.4monthlytraffic 8Manuteno&Monitoramento
2/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

8.1ConsoledoAsterisk 8.2Backup/Download 8.3Logs 8.4TestedePing 8.5TestedeDTMF 8.6Configuraes 8.7Monitoramento 9Revendas 9.1ListarComissionadas 9.2ListarMaster 9.3CriarComissionada 9.4CriarMaster 9.5CustomizarLayout 10Administradores 10.1AdicionarAdministrador 10.2AdicionarAdministradorParcial 10.3ListarAdmininistradoreeAdministradoresParciais

3/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

INTRODUO Este manual apresenta as principais funcionalidades do sistema Voip Virgos, verso tarifador. O sistema baseado no software a2billing (www.asterisk2billing.org) e distribudo sob licena GPL, assim como o original.Notratadonestedocumentopassosparainstalaodosistemae simparaoseugerenciamento. Esta documentao, desenvolvida pela Virgos, pode ser distribuda gratuitamente,desdequemantidasuaformaearefernciaempresaautora. Verifique sempre a ltima verso disponvel deste documento em http://suporte.virgos.com.br/downloads/manual.pdf Customizaes, consultorias, treinamentos e outros servios sempre podemsersolicitadosconosco.Ocontatopodeserfeitovia: VirgosTecnologiadaInformaoS/S Episcopal,1763SoCarlosSP (16)2107VOIP(8647)www.virgos.com.br

4/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

1VISOGERAL
O sistema trabalha basicamente com o cadastramento de troncos de sadaparaaschamadas,rotaseclientes. possveltrabalharcomvriasoperadorassimultaneamentenosistema, ondecadaoperadoraserumtronconosistema. Oquetornaistopossvelocadastramentoderotasnosistema,rotas sodefinidasatrvesdeprefixosdediscagemeparacadarotadefinimosumtronco desada.Asrotaspossuemdiversaspropriedades,comoporexemplo,valorpago porminutonarotaevalorquesercobradopelarota. Abaixoumdiagramamostrandoarelaoentrecliente,rotasetroncos.

No cadastro de clientes, cadastrado primeiramente uma conta que detmasinformaesdocliente,como:nome,endereo,enfim,osdadoscadastrais docliente.nestacontaqueatribumososcrditosaocliente. Para cada conta existente podemos criar vrios nmeros voip, estes conhecidos no sistema como sip/iaxfriends. Os termos SIP e IAX indicam o protocolo de comunicao utilizado pelo dispositivo (ata, softphone, voipphone) utilizadonacomunicao. Observamostambmnodigramaacimaoutrosdoistermos:tariffgroupe ratecard. Os ratecard's so na verdade um grupo de tarifas (rotas). No cadastramento das tarifas umas das propriedades indicadas em qual dos ratecard'sexistentesnosistemaelaserinserida.

5/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Os tariffgroup's podem ser considerados como os planos de venda praticadosnosistema,dentrodostariffgroup'sinserimososratecard'scriadosno sistema. Comocadastrodetariffgroup'seratecard'spodemosentoassociarum clienteaumtariffgroup. Desta forma, poderamos por exemplo, criar um plano com tarifas reduzidas para clientes empresariais e manter clientes residenciais em um tariffgroupcomtarifaocomum. Abaixo apresentado outro diagrama, agora demonstrando o funcionamento do sistema com um cadastramento bsico de clientes, rotas e troncos.

6/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

1ATAconfiguradoparaconectarseaoservidorcomosdadosdoacessocriadono servidor (sipfriend). Considerando que o ATA esteja autenticado no servidor, quandooclienteefetuarumaligaooATAenviarnmerodiscadoparaoservidor. 2Osistemaverificarentoqueesteacessosipestassociadoaocliente 'Empresa1'. 3Nestafaseverificadoaqualtariffgroupocliente'Empresa1'estassociado, quenocasootariffgroup'Empresarial'. 4 Osistemafarumacomparaodonmerodiscadopeloclientecomtodasas tarifasexistentesnosratecard'satribudosaotariffgroupEmpresarial,valeressaltar quesempreserselecionadaatarifaquesejamaiscompletaemrelaoaonmero discadopelousurio. Porexemplo,casoousuriodisque01140634771,serprocuradaportarifascujo prefixodefinidoseja 01140634771,casonoexista,seroprocuradasportarifas 0114063477, depois 011406347, depois 01140634, depois 0114063 e assim sucessivamente,atquealgosejaencontrado.
7/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Casoexistamaisdeumatarifacadastradacomomesmoprefixo,serescolhidaa demenorcusto. Selecionada a tarifa, o sistema ento enviar a chamada para o tronco correspondenteatarifaselecionada. 5Chegamosentoaofinaldoprocesso,ondejsabemosparaqualtroncoenviar a ligao. Basta agora resgatarmos as informaes de autenticao do tronco escolhido,taisinformaesestonosipfrienddeterminadonocampo'ipounome dofriend'nocadastrodotronco. 6Eaqui,finalmenteenviamosachamadaparaaoperadora.

2CADASTRANDOCLIENTES 2.1Criandocontasnosistema
Para cadastrar um cliente, v em 'criar cliente' que est localizado no menu 'Clientes'. Abaixo a descrio dos campos disponveis no formulrio de cadastro:

Nmero: Nmero gerado automaticamente pelo sistema, cdigo nico para identificaodaconta Apelido:onome deusurioutilizadopara ocliente acessara interfacede consultadesaldodestaconta.Estecamposaceitacaracteresnumricos. SenhaviaWeb:Senhautilizadaparaacessoainterfacedeconsultadesaldo. Crdito:Estecampopossibilitadefinirumcrditoinicialparaocliente,pormo sistemanocontabilizaovalorcomoumcrditoaserpagopelocliente. Avisodecrdito:Valorparaoavisodecrditobaixo. Revendedor: Informe aqui o login que ser utilizado pelo revendedor / mantenedorparaqueeletenhaacessoaogerenciamentodeclientes.
8/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Lngua:idiomadocliente. Tariffgroup: Neste campo definido qual tariffgroup o cliente utilizar para efetuarsuasligaes. Ativo:estadodaconta,possveisvalores:

sim: conta ativada, ligaes feitas normalmente (caso o cliente tenha crditos). no:contadesativada,utilizaodacontabloqueada.

Acessosimultneo:Definaseestacontapoderrealizarmaisdeumacesso simultneo. Moeda:moedacorrentedocliente. Executartarefasperidicas:osistemapermiteoagendamentodetarefasde dbito, caso exista alguma, defina aqui se tais tarefas sero aplicadas nesta conta. Tipo:tipodeconta,PrPagoouPsPago. LimitedeCrdito:Casoacontasejadotipopspago,devesedefiniraquium limitedeutilizaodecrdito. Data primeiro uso: data da primeira utilizao da conta. Inserido automati camentepelosistema. Ativar expirao: possvel definir uma data para expirao da conta. As seguintesopesestodisponveis:

Noexpirar:Acontanuncaexpira. Expiraremumadata:acontaexpiranadatainformadanocampodatade expirao.

9/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Expiraralgunsdiasapsoprimeirouso:Acontaexpiraapsonmerode dias informado no campo dias para expirar, contando aps o data do primeirouso. Expiraralgunsdiasapsacriao:Expiraaconta apsonmerodedias informado no campo dias para expirar, contando aps a data de criao (cadastro).

Datadeexpirao:Definaumadatadeexpiraoparaaconta,seocampo Ativarexpiraoestiverativo. Dias para expirar: Defina o nmero de dias para a conta expirar, calculo baseadonadefiniodocampoAtivarexpirao. Emuso:estecampoapenasinformaonmerototaldeacessosdestacontaque estoefetuandoligaesnomomento. Sobrenome:sobrenomedocliente. Primeironome:primeironomedocliente. Email:Emaildocliente. Endereo:Endereodocliente. Bairro:Bairrodocliente. Cidade:Cidadedocliente. Estado:Estadodocliente. Pas:Pasdocliente. CEP:CEPdocliente. Telefone:Telefonedocliente.
10/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

FAX:Faxdocliente. Documento(CPF/CNPJ):CPF/CNPJdocliente. Emuso:Usadoparadebug,estevalorsermaiorque0seocartoestiverem uso.Casoaaplicaotraveporalgummotivoentooficaramarcadocomo>0. Nestecaso,podesemarcardevoltaao0paraliberarousofuturo.

2.2CriandoumacessoSIP/IAX(nmerovoip)
neste cadastro que criamos os acessos que sero utilizados nos dispositivos.Paracadastrarumacesso,nomenuclientescliqueemCriarSIPfriend (paraumdispositivoqueutilizeoprotocoloSIP)ouemCriarIAXfriend(paraum dispositivoqueutilizeoprotocoloIAX).

Name:identificaodoacesso.atravsdestenmeroqueoacessoreceber chamadas. Tipo:tipodesipfriend,nocasodeclientesutilizeopadrofriend,adefinio peerutilizadasomentenocadastramentodeoperadoras. Username:nomedeusurioqueserutilizadoparaesteacessoseautenticarno sistema.Normalmenteiguala'name'. Cartoassociado:nmerodacontaqualesteacessoserassociado. Regexten:Seforpreenchidodeveserigualaousername. Callerid:Identificaodousurio,aqueaparecenaBINA. Amaflags:Deixecomo'billing'paraaschamadasseremregistradas. Senha:senhaqueserutilizadaparaautenticaodesteacessonosistema.

11/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

MD5Secret:Senhaprcriptografada(quasenousado). NAT:definaseodispositivoqueutilizaresteacessoestaemumaredeque utilizeNAT. DTMFMode:DeixecomoRFC2833. Qualify:sehabilitada,osistemairfazerumaverificaodostatusdesteacesso regularmente.Sealatnciadoservidorformuitoaltaouelenosuportar'qualify' ele pode se tornar UNREACHABLE, impedindo que ligaes saim pela operadorausada.Desabiliteeeledeverfuncionar. Canreinvite:Determinaseduranteumachamada,osistemadevetentarfazer comqueorigemedestinocomuniquemsediretamente,comoobjetivodeliberar otrfegodosistema. Disallow:Codecsquenoseropermitidos,deixecomo'all'. Allow:definequaiscodecspoderoserutilizadosporesteacesso.Oscodecs maisconhecidosestodefinidosemordemdeprioridade. Host: Deixe dynamic no caso de usurios com ip dinmico. Voc precisa preecherestecampoapenasnocasodasoperadoras/troncos. Callgroup:Deixeembranco. Context:ContextoaoqueoSIPestatrelado,normalmente'callingcard'. Defaultip:UsadoparadefinirumIPparaumSIPantesqueoATAseregistre comoAsterisk.Normalmentedeixadoembranco. Fromuser: Se estiver cadastrando uma operadora/tronco, coloque aqui o mesmovalordocampoUSERNAME,isto,ousurioquevcusaparaconectar senela. Fromdomain:ForaumdomnionasmensagensentreosSIPs.
12/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Insecure:Definecomomanipularaconexoentreospeers.Normalmente'no' (default)paraSIPsepodeser'very'paraalgunstroncos/operadoras. Language:Cdigodeduasletrasindicandoopas,istoinfluencianostoquese tonsusados.ParaoBrasilbr,normalmenteficaembranco. Mailbox:ExtensodoVoiceMail,vlidoapenasparaSIPsdotipopeer. Permit,Deny,Mask:RestringemoupermitemIPs. Pickupgroup:Grupoquepodepegarchamadasdeoutrosusuriosusando*8. necessrioqueaextenso*8estejaconfiguradacorretamente. Port:PortaemqueoSIPresponde. Restrictcid:Nousado. RTPTimeout: Termina uma chamada se houver mais de N segundos de inatividade na chamada quando o telefone no estiver em espera. Vlido somenteparaSIPsdotipoigualapeer. RTPHoldTimeout:TerminaumachamadadepoisdeNsegundosdeinatividade emumachamadaemespera. Musiconhold: Uma das classes especificadas no arquivo musiconhold.conf. Normalmentenousadoaqui. Regseconds: Nmerodesegundosantesdopeerseregistrar.Vlidoapenas paraentradasemtemporealenormalmentedeixadoembranco. IPAddr:IPdoSIP,vlidoparaconexesemtemporeal.Deixeembranco. CanCallForward:Deixeemyes.

3CADASTRANDOTRONCOS(OPERADORAS)
13/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

3.1Cadastrandoasinformaesdeconexoparaumtronco (ip,usurio,senha,etc...)
Este cadastro normalmente utilizado para troncos que fazem autenticaoatravsdeusurioesenha.ParaestecadastroinsiraumSIPclient (vejaem2.2CriandoumacessoSIP/IAX(nmerovoip)).Abaixoadescriodos camposnecessrios.

Name:nomeparaidentificaodotronconosistema,livreescolha. Tipo:otipodeacessoqueestamoscadastrando,nocasodeoperadorasdefina peer. Username: insira o nome de usurio fornecido pela operadora. Caso a autenticaosejafeitaatravsdoIPdoservidor,deixeestecampoembranco. Senha:insiraasenhaoferecidapelaoperadora.Casoaautenticaosejafeita atravsdoIPdoservidor,deixeestecampoembranco. Qualify:Definaseosistemadevefazerumaverificaoregularmentedostatus daoperadora.Algumasoperadorasnosuportamesteparmetro,seesteforo casodefina'no'nestecampo. Host:insiraoIPouodomniodaoperadora. Fromuser:Definaomesmovalorinformadonocampousername.

3.2Cadastrandootronco Para criar um novo tronco, clique em 'Adicionar' localizado no menu troncos.Abaixoadescriodoscamposutilizados:

14/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Cdigodotronco:insiraumnomeparaidentificaodestetronco. Adicionarprefixo: algumasoperadorasnecessitamdoprefixo'011'antesdo nmero discado, este campo possibilita que o prefixo seja adicionado automaticamenteaonmerodiscado(*). Removerprefixo:removeumoumaisdgitosdiscadospelousurio. IP ou nome do friend: indique aqui o nome do sipfriend criado para esta operadora,ouinformeoIPoudomniocasoaoperadorapossuaafacilidadede autenticaoatravsdoIP. Troncosecundrio,emcasodefalhas:podemosdefiniraquitroncodentreos cadastrados no sistema para que assuma as chamadas destinadas a este (cadastroatual),casoelenoconsigacompletalas. Crdito no tronco: usado para controlar quanto crdito voc tem com a operadora.Conformeasligaessarempelotroncoocrditodiminui.Quando voccolocarmaiscrditosnaoperadoravocatualizaaqui.Estecamposerve apenasparaseucontrolenoinfluenciandonosistemadetarifas.

4TARIFAO 4.1Descriogeral 4.2CriandoumTariffgroup 4.3CriandoumRatecard 4.4Criandoumatarifa 4.5Importandoumatabeladetarifasdeumaplanilha 4.1Descriogeral

A tarifao constituda por 3 elementos, tariffgroup's, ratecard's e tarifas,ondeostariffgroup'soosplanosdevendadosistema,acadaclientedo sistemaassociadoumtariffgroup.Associamosentoaumtariffgroupumoumais ratecard's,quesogruposdetarifas.

15/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Inserimosento,dentrodosratecard's,astarifas,quesoumadefinio decadarota(prefixo)quedesejamospermitirligaesdentrodosistema.Astarifas possuemdiversaspropriedades,como:prefixo,valordecompraevendanarota, troncodedestinoparaarota,dentreoutras. Vejaabaixoumafigurademonstrandoaassociaocomodeveserfeita nosistema.

4.2Tariffgroup 4.2.1CriandoumTariffgroup
ParacriarumTariffgroup,cliqueemCriarTariffgroupnomenuTarifas. Abaixoadescriodoformulriodecadastrodeumtariffgroup.

Nome:definaonomedoTariffgroup. Tipo:estecampodefinecomoosistemadeveagirquandoencontrarduasrotas iguais,pormcomtarifasdiferenciadas.Asopesso:LCRoptapelarotaque possuaomenorcustoparavoc,LCDoptapelarotaquepossuaomenorcusto paraseucliente. Removerprefixointernacional:definaseastarifasdosratecard'squesero associadosaesteTariffgrouppossuemosprefixosinternacionais'011'ou'00'.

4.2.2ListandoTariffgroup'scadastrados

16/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Para listar os Tariffgroup's cadastrados no sistema, v em Listar Tariffgroup,localizadonomenuTarifas. SerapresentadaalistadetodososTariffgroup'scadastradosnosistema esuasprincipaisinformaes.possveleditareapagarqualquertariffgroupcriado clicandonosbotes'edit'e'delete'.

4.2.3AssociandoumTariffgroupaumcliente.
AassociaodosclientescomosTariffgroup'sfeitaeditandoocadastro nocliente(menuclientes,listadeclientes/cartes)ealterandoacampoTariffgroup docliente.

4.3Ratecard 4.3.1CriandoumRatecard
Paracriarumnovoratecard,cliqueemcriarRatecard,localizadonomenu Tarifas.Oscamposenvolvidosnocadastroestodescritosabaixo.

Nome:definaonomequeserutilizadoparaidentificaroRatecard. Datainicial:iniciodavalidadedesteRatecard. Datafinal:finaldavalidadedoRatecard. Tronco: definese um tronco padro para as tarifas que estaro dentro do Ratecard.Pormissonorestringequetodasastarifasdentrodoratecardsaiam pelotroncodefinidoaqui.Otroncodecadatarifapodesereditadonaprpria tarifa. Descrio:apenasumcampoparacomentriosexplicativosdoratecard.No obrigatrio. DNID:nodeveseralteradoovalorpadro.

17/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

4.3.2ListandoRatecard'scadastrados
ParalistarosRatecard'scadastradosnosistema,vemListarRatecard, localizadonomenuTarifas. SerapresentadaalistadetodososRatecard'scadastradosnosistemae suas principais informaes. possvel editar e apagar qualquer ratecard criado clicandonosbotes'edit'e'delete'.

4.3.3AssociandoumRatecardaumTariffgroup
IstofeitonaediodoTariffgroupemqueoRatecardserassociado. Um tariffgroup pode possuir uma lista de ratecard associados, que tambm so conhecidoscomotariffplan's. Naediodotariffgrouptemosalistaderatecardsassociados,podese removerosratecardsjassociadoseassociarnovosratecards.

4.4Tarifas(rotas) 4.4.1CriandoumaTarifa
Nocadastramentodetarifasdefinidoparaondeosistemafarligaes (prefixos),qualoperadorautilizareosvalorespraticadosparacadadestino.Abaixo adescriodoscamposdoformulriodecadastrodatarifa:

Ratecard:definaaqualratecardatarifadeveserinserida. Prefixo:definaoprefixodarota.possvelcriartantorotasmaisabrangentese rotas mais especificas, dependendo da necessidade de diferenciao na tarifao. Por exemplo, poderamoscriar uma rota para todos os destinos do Brasilinformandonestecampoapenaso'55'.Outrapossibilidadeseriacriaruma rotaparacadaDDD,ex:5516,5511.Casoqueiradiferenciartarifascomdestinos celularoufixo,precisocriarrotasespecficasquedeterminemessadiferena, algunsexemplos:55119,55118,55219e55218. Destino:umadescrioparaarota,ex:Brasil.

18/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Porquantovoccompra:definaovalorpagonarotaoperadora. Tempomnimopagonachamada:definaotempomnimodetarifaoaplicado pelaoperadora.Ex: Umaoperadoraqueapliqueumatarifanosprimeiros30 segundos,apsissoacada6segundos. Emblocosdequantossegundosvocpaga:operododetempoemquea tarifaaplicadaapsatarifaomnima. Quantovoccobra?:Ovalorqueseraplicadoaoclientenestarota. Tempomnimodetarifao:otempomnimoemqueatarifaseraplicadaao cliente. Dequantosemquantossegundosvoctarifaocliente:definaoperodoem queserfeitaatarifaonoclienteapsoperodomnimo. Custoporconexo:possibilitatarifaroclientenaconexodachamada,almdo tempototalutilizado. Custopordesconexo:possibilitatarifaroclientenadesconexodachamada, almdotempototalutilizado. Datainicial:datadeiniciodoperododevalidadedatarifa. Datafinal:datafinaldoperododavalidadedatarifa. Diasdesemana:diasdasemanaemqueatarifaservlida. Tronco:defineparaqualtroncoachamadadeveserredirecionada. Msica deespera:altera otomdediscagempara uma msica. O valor No musiconholdmantmotomdediscagemconvencional.

4.4.2Listandoeeditandotarifasexistentes
19/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Apsocadastramentodastarifas,alteraespoderoserfeitasatrves domenuEditarRatecard,localizadonomenuTarifas. Um campo de seleo contendo os ratecards existentes no sistema apresentado.ListadasastarifasdeumRatecardtemos aopodeeditalasou apaglas,clicandonosrespectivosbotes.Oscampossoosmesmosdacriao datarifa.

4.5Importandoumatabeladetarifasdeumaplanilha
Osistemaoferecetambm,afuncionalidadedefazerocadastramento dastarifasbaseandoseemdadosdeplanilhaeletrnica(Excel,OpenOffice).Abaixo omodelodatabeladetarifas: 55163 SoCarlosFixo 55168 SoCarlosCelular 55169 SoCarlosCelular 5511 SoPauloGeral 5516 RiodeJaneiroGeral 0.1 0.5 0.5 0.08 0.08 30 30 30 30 30 6 6 6 6 6 0.05 0.30 0.30 0.04 0.04 30 30 30 30 30 6 6 6 6 6

Temosentoumatabelacomalgumasrotasdefinidas.Vejaqueforam definidos osmesmoscamposdocadastramentocomumde uma tarifa,soeles: prefixo,destino,preodevenda,tempomnimodevenda,tempoadicionaldevenda, preodecompra,tempomnimodecompraetempoadicionaldecompra. Oltimopassonapreparaodatabelasalvlanoformatodearquivo csv.Paraisso,utilizamosaoposalvarcomogeralmentelocalizadanomenu arquivo.NoExcel,selecioneotipodearquivoCSV(MSDOS),normaloExcel emitiralgunsavisosportantoconfirmeosparafinalizaraoperao.Emoutroeditor, selecioneaopoTextoCSV,editeasconfiguraesdefiltrodeixando;como delimitadordecampoedelimitadordetextoembranco. ComaplanilhasalvanoformatoCSV,podemosexecutaraimportao. Nomenutarifas,vemImportRatecard,ospassossodescritosabaixo:

Escolhaqualratecardquerimportar:Selecioneoratecardemqueastarifasda tabelaseroimportadas.

20/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Troncoausar:Determinequalserotroncodesadaparaastarifas.

Emseguidadevemosinformarcomoasinformaesestodispostasno arquivo csv. As primeiros 3 colunas do arquivo j esto prselecionadas e so camposobrigatriosparaaimportao,soeles:

Dialprefix:prefixodediscagem(ex.:5511). Destination:umadescrioparaatarifa(ex.:BrasilSoPaulo). Rateintial:opreodevendaaplicadonarota. Naseqncia,podemosinformaralgunsdadosopcionais,como:

Buyrate:opreodecomprapararota. Buyrateinitblock:tempomnimodecompraaplicadonarota. Buyrateincrement:otempoadicionaldecompraaplicadonarota. Initblock:tempomnimodevendaaplicadonarota. Billingblock:tempoadicionaldevendaaplicadonarota. Connectcharge:taxadeconexo. Disconnectcharge:taxadedesconexo.

Considerandoautilizaodearquivoseguindoomodeloaqui apresentado,teramosaseguinteseqnciaadeterminar.

camposobrigatrios 1dialprefix. 2destination.

21/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

3rateinitial.

camposopcionais 4initblock. 5billingblock. 6buyrate. 7buyrateinitblock. 8buyrateincrement.

Feitoisso,indicamosaosistemaqualoarquivoautilizarnaimportao, paraissocliquenobotoarquivo,emseguidacliqueemimportar. A tela seguinte nos apresenta uma comparao entre o que foi determinadonatelaanterioreosvaloresencontradosnaprimeiralinhadoarquivo csv. Estando tudo certo, carregue o arquivo novamente e clique em 'continuar importao'parafinalizaroprocesso.

5Agendandodetarefasparadebito/crditodeclientes periodicamente
Estaumafuncionalidadeemquepodemosagendartarefaspararealizar debito ou crdito dos clientes automaticamente, em um intervalo de tempo determinado. Para criar uma tarefa peridica, v em Adicionar no menu Tarefas peridicas,abaixoadescriodoscamposdisponveisnocadastrodatarefa:

Nome:Definaumnomeparaatarefa. Valor:Defina ovalorqueser debitado/creditado decada cliente. Asopes so:

valor0:zeraoscrditosdascontasatingidaspelaexecuo. valorespositivos:debitacrditosdascontasatingidaspelaexecuo. valoresnegativos:creditaascontasatingidaspelaexecuo.

Periodicidade:ointervalodetempoemqueatarefadeveserexecutada.Ex: diariamente,acada10dias,acada30diaseetc...

22/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Regra:determinartambmqueatarefasomentesejaexecutadacasoaregra aquidefinidasejaverdadeira,asopesso:

OusurionousaocartodesdeNdias. OusuriousouocartonosltimosNdias.

Nmerodedias:campoutilizadoparadefiniodeNdiasdocamporegra. Parardeexecutar:Noexecutaatarefasnosclientesqueseencaixemdaregra aquidefinida

Nunca. Ocrditodacontachegouazero. Mximodeexecuesalcanado.

Mximodeexecuesporcarto:determinaovalorparaocampomximode execuesalcanado,daopoparardeexecutar. Status:estadodatarefa,ativaouinativa. Emailparaenvioderelatrio:indiqueumenviodeumrelatriocontendoos resultadosdaexecuodatarefa.

OBS:atarefasomenteseraplicadaaosclientesqueestiveremcomaopo Executartarefasperidicasativadaemseucadastro.

6BILLING 6.1Creditandoumcliente
Para creditar um cliente, v em Creditar cliente, localizado no menu Billing.Indiqueonmerodoclienteeaquantiaasercreditada.Emseguidaclique emCreditarvaloraocartoassociado.

6.2Cadastrandopagamentosefetuadospelosclientes
Ocadastramentodepagamentosdosclientesefetuadoparafacilitaro gerenciamentodosistema,quantoaquantiaspagasequantiaspagar.
23/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Est localizado no menu Billing em Cadastrar pagamentos. Para cadastrarumapagamentoinformamosoiddoclientequeefetuouopagamentoea quantiaquefoipaga.possvelescolheroIDdoclienteclicandonobotolaranja, ondeserexibidaumalistaparaseleo.

6.3Visualizandopagamentos
Nestaopo,localizadanomenuBillingemVerpagamentos,podemos conferirtodosospagamentosefetuadosnosistema,comosdadosdoclienteque efetuouopagamento,adatadopagamentoeovalorpago.

6.4Verificandoasituaofinanceiradosclientes
Nesta tela podemos visualizar todas as informaes relacionadas a questes financeiras para cada cliente do sistema. A opo chamase Situao financeiraeestalocalizadanomenuBilling. Temosentolistadostodososclientesdosistema,ototaldecrditoatual, aquantiatotaljcreditada,ototalpagoeovalortotalpagar. Em detalhes podemos visualizar a data e valor de cada crdito e pagamentoefetuadopelocliente. OBS:ocampocrditodefinidonocadastrodocliente,noconstacomovalor pagarparaocliente.

6.5Vouchers 6.5.1Descrio
Voucherspodemsercomparadoscomoscartesderecargadecelulares prpagos, onde atravs de um cdigo digitado do celular o cliente automaticamentecreditado. Osistemageraumcdigodevoucheraleatrio,paraoqualdefinidoum valordecrdito.Oclientequepossuirestecdigopoderdigitalonainterfacede consultadesaldoparaobteroscrditos. ConsideraessobreVouchers: umvoucherspoderserutilizadoumanicavez.
24/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

somente sero aceitososcdigoscadastradosnosistemaeseu statusestiver comoAtivo. apssuautilizaoovoucherautomaticamentedesativado.

6.5.2CriandoumVoucher
Para criar um voucher, v em Criar voucher, localizado no menu Billing.Abaixoadescriodoscampos:

Voucher:cdigoaleatriogeradoparaovoucher. Credit:crditoassociadoaestevoucher. Activated:estadodovoucher. Currency:moedautilizadaparaocrdito. Expirationdate:datadeexpiraoparaovoucher.

6.5.3Criandovouchersemlote
Haopodecriarvriosvouchersemumnicoprocesso,bastando apenasindicaraquantidadedevoucherscriar,avalorqueserassociado,a moedautilizadanoscrditoseadatadeexpirao. Esta opo chamase Criar Vouchers (em lote) e est localizada no menuBilling.

7RELATRIOS
Osistemadisponibiliza umasrie de relatriosquemostramdevrias maneirasaschamadasefetuadaspelosclientes.Abaixoadescriodosrelatrios disponveis.

25/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Diversosfiltrospodemseraplicadosaorelatrio,como:listarchamadas deapenasumcliente,chamadasemumdeterminadointervalodemeses,filtraras chamadasatravsdoDestinodarotaoufiltraratravsdonmeroqueoriginoua chamada. H tambm a opo de fazer uma combinao dos diversos filtros disponveis.

7.1Relatriogeral
UmdosprincipaisrelatriosdosistemaoRelatriogeral.Nele conseguimoslistartodasaschamadasefetuadaspelosclientesatravsdosistema, ondesomostradasasseguintesinformaes:

Datadachamada Origem Nmerochamado Destino Durao Cliente/Carto Status $/min(compra) $/min(venda) Total Tronco Tarifa VocaindapoderemoveraentradanologclicandoemApagar.

7.2Fatura
OrelatrioFatura,apresentavriosdadosesubrelatrios.Nelevoc podevero'ServiodeFatura','EvoluodaConta'e'DetalhedasLigaes'. No'ServiodeFatura'vocpodeverumgrficomostrandoasligaes paradestinosmaisusados,comosdadosdedurao,nmerodeligaesecusto total. No 'Evoluo da Conta' exibido um grfico relacionando nmero de ligaeseduraocomosdiaspedidosnorelatrio.Aindaexibidoodadodo custototal. No 'Detalhes das Ligaes' so apresentados detalhes na seguinte ordem:
26/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Datadaligao Origem Nmerochamado Destino Durao CardUsed Custo

7.3Compararchamadas
Apresentaumgrficomostrandoautilizaodosistemanodecorrerno dia.tilparaverificaremquaishorrioshumamaiordemandanautilizaodo sistema.Existetambmapossibilidadedecompararodiaselecionadocomosdias anteriores(Quantidadedediasparacomparar).

7.4Trfegomensal
Exibeumgrficoempizzarelacionandoosmesesanterioreseoatual comosminutosusados.Vocpodeescolherde1msa6mesesnaopo Quantidadedemesesparacomparar.

7.4Relatrioporcliente
Exibeumrelatrioporclientecomosseguintesdadosparacadaentrada:

Usurio Nome Sobrenome Tipo Ligaes ValordeVenda ValordeCompra Lucro

27/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

Nofimdorelatriomostraototaldeligaes,devenda,decompraede lucro.

8Manuteno&Monitoramento 8.1ConsoledoAsterisk 8.1.1UsuriosconectadosSIP

Esterelatriopossibilitaverosusuriossipqueestoconectadosno momento.ParachegarneleentreemAsteriskconsolenomenuManuteno,em seguidacliqueemUsuriosconectadosSIP.Norelatriovocteralgocomo:

Nome/Userdosipfriend Cartoassociado Nomedocliente IPdosipfriend Portadeconexo Seoreinviteesthabilitado Status da conexo do sipfriend (tempo em milisegundos da conexo, desconhecido (UNKNOW), inalcanvel (UNREACHABLE)ou no monitorado, quandooqualifyestdesabilitadonasconfiguraesdosipfriend). Reinvite (siginifica que o trfego de voz da ligao no passa pelo servidor, economizandoprocessamentoebanda,oquemelhoraaqualidadeediminuia latncia.Oreinvitesocorrequandoachamadaatendida.Portanto,normal constarreinvite='no'antesqueachamadasejacompletada.)

8.1.2UsuariosconectadosIAX
PossibilitaverificarosusuriosIAXqueestoconectadosnomomento. ParachegarneleentreemAsteriskconsolenomenuManuteno,emseguida cliqueemUsuriosconectadosSIP. Um pouco mais simples que o anterior ele mostra o nome/username, ip/host,amscaraderede,aportaemqueseconectaeostatus,assimcomoo anterior.

28/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

8.1.3Chamadasemandamento:
Nessaopopodeseconstatarquaisaschamadasestoemandamento. ParachegarneleentreemAsteriskconsolenomenuManuteno,emseguida cliqueemUsuriosconectadosSIP. Asabertemos:origemeonomeassociadodaquelequefezachamada, O nmero discado pelo mesmo, o tempo de ligao ocorrido at o momento, o codecqueestsendoutilizadopelousurio,seoreinviteestativado,ostatusdo sipfriend,esedesejadesligar/terminarcomaligao,tilnocasodeumaligao travada.

8.1.4MatarligaesereiniciarAsterisk
Cuidadocomessaopo,useasomentesetivercertezadoqueest fazendopoiserrospodemocorreremcasodetravamento.

8.1.5Comandopersonalizado
EnviaumcomandopersonalizadodiretoaoAsterisk.Tomecuidadocom estaopo.

8.2Backup/Download
Aprimeiraopoaquipermitequesefaaumbackupemformatotar.gz dabasededadosedosistemadebillingecliente. Asegundaopopermitequesefaabackupdosusuriosdosistema emumarquivoxls.Algocomoumaexportao.

8.3Logs
Nessaopovocpodefazerologdealgunsarquivosdelogdosistema. Soeles:

full:Loggeraldeusodoasterisk.

29/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

revenda_pospago.log: Log de desativacao de clientes pospagos quando o revendedorassociadoficacomcreditonegativo. log_mudanca_plano.txt:Logdealteracaoautomaticadeplanodosclientesao atingiremdeterminadoconsumoemligacoescelular. a2billing.log:Logdeprocessamentodosistemabilling. Master.csv: CDR de chamadas. Todas as chamadas do sistema ficam registradasneste arquivo. Porm,NAO do billing,nao temassociacaocom tarifasouplanos.

8.4TestedePing
Nessapginavocpodefazerotestedepingparaqualquerservidor.O testedepingcomparaotempodeenvioerespostadepacotespelainternet.No casodecomparaentreservidoresvoips,at400msumtempoaceitvel.

8.5TestedeDTMF
Utilizadoparatestarsedeterminadaoperadoracapazdefazercallback.

8.6Configuraes 8.6.1ChavedeAcessoaoWebService
Configureessachaveparausaremaplicaesexternasqueprecisemde acessoaobilling.

8.6.2RamalPrincipal:
Configureosipfriendqueirreceberaschamadasdesuporte.

30/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

8.6.3Exibiodotempodechamadas
Vocpodeconfigurarparaquesejaexibidootemporealdeconexoouo tempoemblocos.Detalhequepodeocorrerdiscrepnciadetempoemcomparao com as operadoras se usar o tempo real, pois comumente elas configuram a exibioporblocosde30(trinta)segundos.

8.7Monitoramento
Omonitoramentofeitoporgrficos,osquaismostramousodosistema emrelaoaoasterisk,aousododisco(hd),aobancodedados(mysql),aotrfego nasplacasderede,aousodoemailnosistema(postfix),aosprocessosdosistema eaoprpriovoip.

9Revendas

RevendaporComissoaformaderevendautilizadoatualmente,onde, ao criar o revendedor, o administrador deve selecionar os tariffgroups que o revendedorpoderutilizarparaseusclientes. Essetipoderevendabaseadoemcomisso,portantoolucrodo revendedorcalculadocombasenaporcentagemdecomissodefinidonacriao destetipoderevenda. Com relao aos crditos dos clientes, nos prpagos o crdito dado pelo revendedoreconformeoclienteutilizavaidescontandodeseusaldo;assimqueo saldodoclientechegaazeroouinsuficienteparaqueoclienterealizeumaligao este deve contactar o revendedor para recarga de crditos. J nos pspagos o revendedordefineolimitequeosaldodoclientepodeficarnegativoenodeveser inseridocrditoseleparaqueelefiquecomsaldopositivo.Conformeoclientefaz ligaesocrditodorevendedordebitado,eseosaldodorevendedorchegara zerotodosclientespspagosserodesativadosautomaticamentepelosistema,por issoimportantequequandoorevendedortrabalharcomclientespspagoselese mantenhasemprecomsaldodecrditospositivo.

RevendaMaster:Revendaqueespecificaovalordevenda.
Devidoaosurgimentodestanecessidade,foicriadoumnovomodelode revendedor.Elenosermaiscomissionado,jqueagoraeledefineporquantoele irrevender(tirandoseuprpriolucro,quedependedovalorpeloqualelerevende).
31/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

O funcionamento desta nova revenda deve proceder como descrito abaixo: 1OadministradordevecriarRatecardsparaserviremdemodelo paraodosrevendedores. OBS1:AcriaodoRatecardmodeloigualadequalquerRatecard. O preo de venda especificado nas tarifas deste Ratecard ser o preo que o revendedorvaipagaraoadministrador. OBS2:Apstersidocriado oRatecardmodelo,quandoforfeita algumaalteraonele(preodecompra,billingbllock,ouqualqueroutrocampo),o sistemaatualizartodasastarifasqueforamoriginadasapartirdaquelemodelo. 2Agoranecessriocriarumnovorevendedor(utilizaranovaopode criaoderevendedores).Neleoadministradordeveespecificarquaisosmodelos de Ratecard (tarifas) que o revendedor ter acesso para poder criar as suas prprias. Pronto,anovarevendaestcriada,agoravamosparaareadonovo revendedor: 1Aprimeiracoisaqueorevendedordevefazerabriromenu"Tarifas"e selecionaraopo"CriarnovoRatecard".Neleorevendedorespecificaronomedo ratecardequalratecardmodeloserusado. 2 Ao criar um novo ratecard o revendedor ser redirecionado automaticamente para a rea de edio de tarifas (o novo ratecard criado pelo revendedorjestarselecionadoeprontoparaqueeledefinaovalordevenda). 3Orevendedordevedefinirqualopreodevenda,porpadroser igualaopreodecompraatqueumvalorsejadefinido.Elepodeeditlasumaa umaatravsdobotoeditardecadatarifaoueditarvriasdeumavezatravsdo campo"Preodevenda"nofimdapgina. 4Comosratecardscriadoseopreodevendadastarifasdefinidos,o revendedor deve criar um novo tariffgroup atravs do menu "Criar tariffgroup" e selecionarquaisratecardsfazempartedestetariffgroup. Pronto, com os tariffgroups criados o revendedor j pode criar seus clientescomosseusprpriostariffgroups.Semprequeumdeseusclientesefetuar umaligaoovalortarifadoseraquelequeorevendedordefiniu. Comrelaoaoscrditosdosclientes,arevendamasterpodecreditarlivremente seusclientes,etodaligaoqueelesfizerem,quersejaprpagooupspago,ser reduzidodosaldoatualdarevendamaster.Seosaldoficarigualoumenorquezero osistemadesativartodososclientesdorevendedor,portantoimportantequeo revendedormantenhaseusaldodecrditossemprecomvalorpositivo.

32/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

9.1CriarRevendedoraMaster: NessareavocircriaraRevendaMaster

explicadaacima.Oscamposparapreenchimentoso: LOGIN:"username"queorevendedorirutilizarparaacessarsuarea nobilling. SENHA:senhaqueserutilizadacomo"username"informadonologin. CRDITOS:Crditoinicialdarevenda. VERLIGAESDETALHADAS:Essaopohabilita,ouno,queorevendedor

vejaasligaesdetalhadasdeseusclientes.

VERUSURIOS/LIGAESEMANDAMENTO:Permiteaorevendedor observaremtemporealosusuriosconectadoseaschamadasemandamentodos mesmos. PERMISSODECRIAO:Definese,aocriarumclienteorevendedor poder definir um status para a conta do cliente. ativo, pode ser usada automaticamente,inativo,necessitarserativadapeloadministradorresponsvele nenhum,novaidefinirnenhumstatusparaacontadocliente. MODELODETARIFA:Aquivocvaidefinirqualomodelodetarifaque seraplicadaaessarevenda. A partir do nome, insira os dados que achar necessrio para a identificaodeseurevendedor.

9.2 Criar Revendedora Comissionada: Nessa rea voc ir criar a

RevendaComissionada.OscamposdiferentesdaRevendaMasterso: %COMISSO:Insiraaporcentagemdeganhodorevendedor.Casovoc definaumacomisso,aogerarrelatriostantovocquantoorevendedorveroo clculodelucrobaseadonomovimentodeligaesdosclientesdorevendedoreno movimentodecrditoscomprados. Vocpodedeixar0eassimosistemanoefetuaroclculodessascomisses. VERVALORDACOMPRA:Orevendedorsercapazdeverovalorque voc paga na compra das ligaes. Normalmente voc ir negar a ele essa informao. TARIFFGROUP:Definequaisostariffgroupsqueorevendedorcriadoir poderutilizarjuntoaosseusclientes. 9.3Listagem:Vocpodeestarlistandosuasrevendedoras.Paraissocliqueem ListarComissionadasouListarMastersparalistarasrevendascomissionadasouas revendasmastersrespectivamente.

10ConfiguraodosAdministradores
33/34

ManualSistemaVoipVirgosVersoTarifador Atualizao:13/01/2008

tenhaporprefernciapreenchertodososcampos.

10.1AdicionarAdministrador:Crieseusadministradoresaqui, 10.2AdicionarAdministradorParcial:Vocpodetambmcriar

administradoresparciaisquepodem"administrar"apenascertasconfiguraesde seuservidor.Aspossveisreasso: clientes:tempermissodeacessoeconfiguraonaabaclientes. billing:tempermissodeacessoeconfiguraonaababilling. tarifas:tempermissodeacessoeconfiguraonaabatarifas. troncos:tempermissodeacessoeconfiguraonaabatroncos. relatrios:tempermissoparaacessarareaderelatrios. tarefas peridicas: tem permisso de acesso e configurao na aba tarefas peridicas. administradores: tem permisso de acesso e configurao na aba dos adminstradores. cadastro:tempermissoparacadastro Fiqueatentosedeterminadoadministradorpoderounocreditaraosclientes. aquivocpodelistarosadmnistradoresbemcomonaopoedit,editar,modificar asconfiguraesdomesmo.

10.3ListarAdmininistradoreseAdministradoresParciais:

34/34