Guia IPBRICK Billing 2.0
iPortalMais
4 de Janeiro de 2013
Conte´
udo
1 Introdu¸c˜ao 3
2 Caracter´ısticas 3
2.1 Novas caracter´ısticas no Billing 2.0 . . . 3
3 Procedimento B´asico 4 4 Instala¸c˜ao 4 4.1 Pacotes para a IPBRICK 5.3 . . . 4
4.2 Pacotes para a IPBRICK 5.2 . . . 5
5 Configura¸c˜ao 6 5.1 Configura¸c˜ao IPBRICK . . . 6
5.1.1 Configura¸c˜ao Billing . . . 8
5.1.2 Adicionar Servidores . . . 9
5.1.3 Gest˜ao de Utilizadores . . . 10
5.1.4 Atribui¸c˜ao de perfis de utilizadores . . . 13
5.1.5 Cria¸c˜ao de perfis de utilizadores . . . 13
5.2 Menu Billing . . . 15
5.2.1 Taxas . . . 15
5.2.2 Taxas por origem . . . 17
5.2.3 Taxas por rota . . . 20
5.3 Menu Monitoriza¸c˜ao . . . 21
5.3.1 Hist´orico de Chamadas . . . 21
5.3.2 Logs de Sistema . . . 22
5.4 Manuten¸c˜ao . . . 23
5.5 Configura¸c˜oes - Op¸c˜oes . . . 24
5.5.1 Dados da Empresa . . . 25
5.6 Configura¸c˜ao do Contacts . . . 26
5.6.1 Criar uma Entidade . . . 27
1
Introdu¸
c˜
ao
A crescente aceita¸c˜ao da fatura¸c˜ao electr´onica por parte dos consumidores e da comunidade empresarial tornou-nos conscientes da necessidade de implementar uma solu¸c˜ao de fatura¸c˜ao electr´onica de confian¸ca, lev´amos esse pensamento um passo adiante e integramo-lo com o iPortalDoc, o nosso software de Gest˜ao documental e workflow.
O IPBRICK Billing ´e um software do sistema de fatura¸c˜ao electr´onica e de con-tabiliza¸c˜ao de chamadas. Serve tanto para manter um registo de todos os nossos gastos com telecomunica¸c˜oes ou para cobrar aos clientes as suas chamadas telef´onicas (ex.: um hotel).
2
Caracter´ısticas
Conforme foi referido anteriormente, este software funciona em intera¸c˜ao com o iPortalDoc e, claro, com a IPBRICK. O IPBRICK Billing ´e muito f´acil de config-urar. Para come¸car a trabalhar, s´o ´e preciso configurar que telefones registados da IPBRICK s˜ao para faturar, e modificar a tarifa predefinida.
Para uma fatura¸c˜ao mais detalhada, tamb´em permite a associa¸c˜ao de tarifas diferentes a telefones diferentes. ´E feito o upload das tarifas atrav´es de ficheiros .csv. Ao modificar uma associa¸c˜ao telefone/tarifa, ´e poss´ıvel voltar a calcular todos os custos de chamadas do telefone ou come¸car a usar a nova tarifa s´o nas chamadas novas.
Os relat´orios de fatura¸c˜ao s˜ao gerados atrav´es do software iPortalDoc, assegu-rando um arquivo avan¸cado e eficiente de todos os relat´orios.
2.1
Novas caracter´ısticas no Billing 2.0
O IPBRICK Billing 2.0 apresenta as seguintes novas caracter´ısticas:
• Interface web redesenhada;
• ´E poss´ıvel efectuar fatura¸c˜ao de uma rota de sa´ıda;
• Billing centralizado, ou seja, ser´a poss´ıvel configurar o IPBRICK Billing para processar as estat´ısticas de v´arias IPPBRICK.GTs.
3
Procedimento B´
asico
• Instale o pacote UCoIP para o servidor com o servi¸co Billing (n˜ao ´e obrigat´orio que seja o servidor IPBRICK.GT);
• Atualize a(s) licen¸ca(s) iPortalDoc de forma a ativar o m´odulo Billing;
• Configure o DNS server de forma apontar o servi¸co Billing ao servidor com o m´odulo UCoIP instalado.
4
Instala¸
c˜
ao
De forma a ativar o m´odulo Billing, ser´a necess´ario instalar o pacote ucoip4iportaldoc.deb dispon´ıvel em:
http://eshop.ipbrick.com/
Nota: Tenha em aten¸c˜ao que ter´a de estar registado na nossa eshop para que a sec¸c˜ao de downloads esteja dispon´ıvel.
Ele permite:
1. Grava¸c˜ao de chamada em MP3 ou WAV no iPortalDoc com classifica¸c˜ao au-tom´atica da chamada.
2. Guarda automaticamente todos os faxes e mensagens de correio electr´onico recebidos e enviados e classifica os documentos.
3. Fornece a fatura¸c˜ao para operadores ou telefones. Permite-lhe gerar relat´orios do custo total da chamada para qualquer telefone ou equipamento remoto SIP do cliente que efectua chamadas atrav´es da IPBRICK. Os custos baseiam-se na dura¸c˜ao da chamada e no prefixo marcado.
4.1
Pacotes para a IPBRICK 5.3
Para instalar o pacote UCoIP mais recente ter´a de:
http://eshop.ipbrick.com/
Nota: Ter em aten¸c˜ao que precisa de se registar na nossa loja online para que a sec¸c˜ao de download esteja dispon´ıvel.
Descarregar a vers˜ao ucoip4iportaldoc.deb mais recente.
2. Instal´a-la na sua IPBRICK em:
Configura¸c~oes Avan¸cadas > IPBRICK > Update
Siga as instru¸c˜oes de instala¸c˜ao.
3. Aplique as configura¸c˜oes
Figura 1: Inserir Update
4.2
Pacotes para a IPBRICK 5.2
Uma IPBRICK 5.2 necessitar´a de ter instalado todos os seus updates, no m´ınimo at´e ao update 4, pois o pacote ucoip4iportaldoc v2.2.1 ir´a depender dele.
1. Descarregue o ´ultimo pacote ucoip4iportaldoc em:
Nota: Tome em atent¸c˜ao que ter´a de se registar na nossa eshop para que a sec¸c˜ao de Downloads esteja dispon´ıvel.
Downloads Software IPBRICK Related Software IPBRICK v5.3
Descarregue o pacote:
ucoip4iportaldoc_v2.2.1_to_IPBRICK5.3_iPortalDoc3.1.x.deb
Descarregue os updates em: Downloads Software Updates IPBRICK v5.2
2. Instale primeiro, na sua IPBRICK, os updates necess´arios (at´e, no m´ınimo, ao quatro) e, de seguida, o pacote ucoip4iportaldoc v2.2.1 em:
Configura¸c~oes Avan¸cadas > IPBRICK > Update
Siga as instru¸c˜oes de instala¸c˜ao.
3. Applique configura¸c˜oes.
5
Configura¸
c˜
ao
Para configurar o Billing necessitar´a de efetuar altera¸c˜oes via a interface web da IPBRICK, no site Billing e no iPortalDoc.
5.1
Configura¸
c˜
ao IPBRICK
Aceda ao servidor IPBRICK de Intranet e crie as contas SIP que vai necessitar, uma por cliente. Se os telefones a faturar s˜ao locais, insira-os em:
Figura 2: Adicionar um novo telefone interno
Se existirem servidores ou telefones remotos insira-os em:
Configura¸c~oes Avan¸cadas > Telefonia > Telefones registados (ter˜ao de ser configurados como remotos).
O login e palavra passe ser˜ao usados para registar os telefones dos clientes ou servidores SIP remotos.
Figura 3: Adicionar um telefone ou servidor externo
Criar todas as classes de acesso em:
IPBRICK.GT > VoIP > Fun¸c~oes > Sa´ıda > Classes de Acesso
com as rotas adequadas e autorizadas para cada cliente e adicionar o seu telefone ou servidor como um membro desta classe de acesso.
Ao terminar, por favor fa¸ca Aplicar Configura¸c~oes.
5.1.1 Configura¸c˜ao Billing
Neste website pode definir que telefones e servidores devem ser faturados e alterar os valores de fatura¸c˜ao.
Aceda ao interface web do Billing em http://billing.seudominio.com (substi-tuir seudominio.com pelo dom´ınio correcto).
1. O login ´e: administrator
Figura 4: IPBRICK Billing Interface de Autentica¸c˜ao
5.1.2 Adicionar Servidores
A primeira p´agina a ser vizualizada, ap´os autentica¸c˜ao, ´e a de Configura¸c~oes > Servidores
Figura 5: P´agina dos Servidores
Aqui poder´a adicionar pares de servidores iPortalDoc e IPBRICK.GT, pois neces-sitar´a de uma licen¸ca iPortalDoc com o m´odulo Billing activo em cada IPBRICK.GT
Se o iPortalDoc e a IPBRICK.GT s˜ao ambos locais, o IPBRICK Billing ´e au-tomaticamente configurado. S´o ´e necess´ario inserir um novo par de servidores se desejar usar o IPBRICK Billing conjuntamente com m´ultiplas GTs.
Figura 6: P´agina de inser¸c˜ao de servidores
Preencha os campos apresentados com os dados do seu servidor e clique no bot˜ao Inserir button.
Se clicar no nome de um servidor ir´a aceder a uma p´agina onde lhe ser´a poss´ıvel modificar ou eliminar o par.
Figura 7: P´agina Modificar/Apagar Servidor
´
E poss´ıvel adicionar mais servidores ao repetir o procedimento descrito anterior-mente.
5.1.3 Gest˜ao de Utilizadores
Poder´a autorizar utilizadores adicionais e definir perfis diferentes em:
Figura 8: P´agina Acesso Web - Utilizadores
Clique em Adicionar/Remover Utilizadores para gerir o IPBRICK Billing.
Figura 9: P´agina Gest˜ao de Utilizadores
Selecione os utilizadores que deseja adicionar como Utilizadores Billing da lista em Utilzadores LDAP. Ap´os sele¸c˜ao, clique no bot˜ao cuja seta aponta na dire¸c˜ao dos utilizadores Billing. De forma inversa ´e poss´ıvel remover utilizadores da lista Billing, selecionando-os primeiro e depois clicar no bot˜ao que aponta na
dire¸c˜ao da lista dos utilizadores LDAP.
O link Sincronizar utilizadores com o LDAP permite-lhe actualizar a sua lista de utilizadores com a do LDAP. Se porventura, um utilizador for removido do lDAP ser´a tamb´em removido do IPBRICK Billing.
Figura 10: Sinroniza¸c˜ao de Utilizadores
Depois de ter conclu´ıdo as altera¸c˜oes ir´a regressar `a p´agina de utilizadores, onde poder´a ver inserido os novos utilizadores.
5.1.4 Atribui¸c˜ao de perfis de utilizadores
Para atribuir permiss˜oes a utilizadores, clique no link Associa¸c~ao de Perfis em:
Configura¸c~oes > Acesso Web > Utilizadores
Por predefini¸c˜ao existem apenas dois perfis:
• Admin: Perfil sem restri¸c˜oes, pode aceder a todos os menus Billing: – Billing
– Monitoriza¸c˜ao – Manuten¸c˜ao – Configura¸c˜oes
• Default: O utilizador com este perfil s´o pode aceder ao menu Monitoriza¸c˜ao. A um utilizador novo ser´a atribu´ıdo automaticamente o perfil predefinido.
Nota: Para criar perfis de utilizadores consulte a pr´oxima sec¸c˜ao deste docu-mento.
5.1.5 Cria¸c˜ao de perfis de utilizadores
Aceda a Acesso Web > Perfis
Figura 12: Perfis
Figura 13: P´agina de Inser¸c˜ao de Perfil
Digite o nome do perfil a ser criado e coloque um visto os campos onde deseja conceder permiss˜oes.
Quando termnar clique em Inserir.
Ter´a agora dspon´ıvel o novo perfil em Associa¸c~ao de Perfis.
5.2
Menu Billing
Dado que o servi¸co Billing ´e bastante particular, incluimos de seguida um pequeno gloss´ario com a defini¸c˜oes dos termos mais importantes
• Tarifa: Lista de prefixos com os pre¸cos correspondentes, cada linha ´e consid-erada como a taxa da tarifa. A cada utilizador, servidor, rota, etc, pode ser associada apenas uma tarifa.
• Taxas por Origem: O custo da chamada ´e calculado de acordo com a sua origem, ou seja: quem fez a chamada e o prefixo marcado. Assim, a tarifa que ser´a usada ´e aquela associada com a chamada e dependendo do prefixo marcado o custo da chamada ´e calculado de acordo com a sua tarifa.
• Taxas por Rota: O custo da chamada ´e calculado pela rota de sa´ıda e prefixo marcado. Isto significa que, a tarifa utilizada ser´a associada `a rota da chamada e, dependendo do prefixo, o custo ser´a sempre calculado de acordo com a tarifa configurada.
5.2.1 Taxas
Em Billing > Taxas ´e possivel inserir um ficheiro .csv.
Figura 15: Billing - P´agina de Taxas
Substituir o valor de fatura¸c˜ao PREDEFINIDO e adicionar os novos, conforme precisar. O ficheiro com os valores deve ter uma extens˜ao .csv. Aqui est´a um exemplo de um ficheiro de valor de fatura¸c˜ao:
Atribue um nome `a sua taxa de billing e clique no bot˜ao Browse para selecionar o ficheiro .csv a importar.
Figura 16: Taxas de Upload
Aqui tem um exemplo de um ficheiro .csv:
Code;Country;Price;Period;InitialPeriod;InitialPrice 0;DEFAULT;0.1666666667;1;1;0.1666666667 93;AFGHANISTAN;0.0103333333;1;1;0.0103333333 1907;ALASKA;0.0010000000;1;1;0.0010000000 355;ALBANIE;0.0035000000;1;60;0.0500000000 ...
Neste exemplo, todas as chamadas s˜ao faturadas ao segundo, excepto a Rota da Albˆania, em que o primeiro minuto custa 0.05 e a restante chamada ´e faturada em per´ıodos de um segundo.
As duas primeiras linhas s˜ao obrigat´orias. O prefixo PREDEFINIDO ´e usado quando nenhum outro prefixo corresponde. A ordem dos prefixos no ficheiro CSV ´e irrelevante, os prefixos s˜ao correspondidos por comprimento: o custo ser´a calculado a partir do prefixo com maior extens˜ao que corresponda ao n´umero a ser faturado.
´
E poss´ıvel definir um per´ıodo de fatura¸c˜ao inicial (ex.: no primeiro minuto a chamada custa X) e a partir desse per´ıodo, cada segundo ser´a faturado.
Cada campo valor est´a separado por ";" e o seu significado ´e o seguinte:
1. C´odigo - Prefixo no formato internacional sem o prefixo internacional (sem 00 por omiss˜ao). Por exemplo, para corresponder ao n´umero +3519 (telem´oveis portugueses) o prefixo deve ser 3519.
3. Pre¸co - Custo de cada Per´ıodo.
4. Per´ıodo - Ap´os o per´ıodo inicial definido em PeriodoInicial, ao custo da chamada ´e acrescentado o valor Pre¸co de cada Per´ıodo.
5. PeriodoInicial - Quantos segundos do per´ıodo inicial.
6. Pre¸coInicial - Custo do per´ıodo inicial.
O custo da chamada ´e calculado de acordo com as seguintes f´ormulas:
1. Se o tempo de chamada for inferior ou igual ao InitialPeriod : TotalCost=InitialPeriod*InitialPrice
2. Se o tempo de chamada for superior ao InitialPeriod :
TotalCost=InitialPeriod*InitialPrice + Price*(Calltime-InitialPeriod)/Period
Depois de fazer o upload dos ficheiros CSV, poder´a editar cada um dos valores na interface web do Billing (clique no nome da taxa) ou substituir a taxa fazendo o upload de uma nova.
Se n˜ao desejar criar um ficheiro .csv clique em Inserir.
Figura 17: Inserir lista de taxas
5.2.2 Taxas por origem
Em Billing Taxas por Origem poder´a adicionar telefones, servidores, IPs e
Figura 18: Billing Taxas por Origem
A liga¸c˜ao Adicionar Telefone ir´a abrir uma nova p´agina. ´E poss´ıvel selecionar da lista de telefones dispon´ıveis quais os que ser˜ao abrangidos pela taxa a ser aplicada.
Figura 19: P´agina de inser¸c˜ao de telefone
A p´agina Adicionar Servidor ir´a mostrar este campos:
• N´umero de telefone: Selecione o n´umero da lista; • Servidor: O nome a atribuir ao servidor que vai inserir;
Figura 20: P´agina de inser¸c˜ao do servidor
A p´agina Adicionar IP apresenta-lhe os seguintes campos configur´aveis:
• N´umero de telefone: Selecione o n´umero da lista; • IP: Digite o IP que deseja adicionar;
• Descri¸c˜ao: Campo opcional. Digite uma breve descri¸c˜ao; • Taxa Billing: Selecione a taxa a ser aplicada.
Figura 21: P´agina de inser¸c˜ao de IP
Como na p´agina de inser¸c˜ao de utilizadores, em Adicionar Login ´e-lhe permitido escolher que logins a adicionar assim como as taxas a serem aplicadas.
Figura 22: P´agina de Inser¸c˜ao
5.2.3 Taxas por rota
Nesta p´agina ´e poss´ıvel associar tarifas a rotas.
Figura 23: Billing - Taxas por rota
Figura 24: Billing - Taxas por rota - Adicionar
Preencha o formul´ario:
• Rota: O nome aqui inserido ter´a de ser igual ao da rota correspondente na IPBRICK;
• Descri¸c~ao: Apenas como referˆencia, insira o breve descri¸c˜ao; • Taxa de Billing: Selecione da lista a taxa a ser aplicada. Clique no bot˜ao Adicionar para inserir a taxa por rota.
5.3
Menu Monitoriza¸
c˜
ao
5.3.1 Hist´orico de Chamadas
Esta p´agina permite-lhe verificar se os custos de chamadas est˜ao a ser bem cal-culados.
Figura 25: P´agina Hist´orico de Chamadas
Selecione os crit´erios de pesquisa colocando um visto nas op¸c˜oes desejadas. Em termos de per´ıodo de tempo: se n˜ao colocar um visto em Mostrar apenas entre, o sistema recuperar´a todas as estat´ısticas, indeendentemente do per´ıodo. Cliqie no ´ıcone do calend´ario para selecionar a data de in´ıcio e fim. De forma a agilizar o
processo de pesquisa, tem dispon´ıveis os seguintes links r´apidos:
Hoje — Ontem — Este Mˆes — Mˆes Passado — Este Ano — Ano Passado
Clique no bot˜ao de filtro para visualizar os resultados.
5.3.2 Logs de Sistema
Como o nome sugere, esta p´agina apresenta-lhe o registo de autentica¸c˜oes no sistema IPBRICK Billing, para al´em desse log, a¸c˜oes como inser¸c˜ao de telefones, associa¸c˜ao de tarifas, etc tamb´em ser˜ao registadas.
Figura 26: P´agina Logs de Sistema
Os ’logs’ est˜ao agrupados por n´umeros, representando os dias pr´evios da data atual.
Figura 27: P´agina log atual
5.4
Manuten¸
c˜
ao
A op¸c˜ao de Manuten¸c˜ao oferece-lhe a possibilidade de apagar da BD o hist´orico das estat´ısticas de chamadas com mais de dois meses.
Figura 28: Manuten¸c˜ao - Base de Dados
5.5
Configura¸
c˜
oes - Op¸
c˜
oes
Define op¸c˜oes para a BD, Hist´orico de Chamadas, Moeda, Tarifa e Prefixos de Sa´ıda:
Configura¸c~oes > Op¸c~oes
Figura 29: Op¸c˜oes
Figura 30: Op¸c˜oes
5.5.1 Dados da Empresa
Outro aspecto importanta passa por aceder a: Configura¸c~oes > Dados da Empresa
Preencha os capos apresentados com toda a informa¸c˜ao respeitante `a sua orga-niza¸c˜ao (nome, n´umero de contribuinte, endere¸co, etc.).
Figura 31: Dados da empresa
5.6
Configura¸
c˜
ao do Contacts
Aceda `a interface web: http://contacts.seudominio.com (substitua seudo-minio.com pelo dom´ınio correcto).
1. O login ´e: administrator
2. A password predefinida para este utilizador ´e: 123
5.6.1 Criar uma Entidade
Como j´a foi dito anteriormente, para ser poss´ıvel a cria¸c˜ao de entidades, ´e necess´ario criar primeiro, pelo menos um Tipo de Entidade na p´agina Dados Auxiliares.
NOTA: Este procedimento ´e obrigat´orio.
Clique em Inserir.
No separador Geral, preencha os campos dispon´ıveis (Nome, Endere¸co, C´odigo Postal, Pa´ıs and N´umero de Contribuinte)
NOTA: Alguns destes atributos s˜ao criados no separador Dados Auxiliares e n˜ao s˜ao obrigat´orios.
Figura 33: Contactos P´ublicos - Cria¸c˜ao de Entidades - Separador Geral
No separador Classifica¸c˜ao seleccione o tipo de entidade que deseja criar (como pode ver, ´e aqui que se tornam importantes as configura¸c˜oes feitas previamente em Dados Auxiliares)
Figura 34: Contactos P´ublicos - Cria¸c˜ao de Entidades - Separador Classifica¸c˜ao
Para diversificar ainda mais a classifica¸c˜ao da entidade, existem mais dois sepa-radores.
• Comunica¸c˜oes: – Email.
– Telefone: Se desejar adicionar v´arios n´umeros por favor separe-os com / – Telem´ovel: Se desejar adicionar v´arios n´umeros por favor separe-os com / – Fax: Se desejar adicionar v´arios n´umeros por favor separe-os com / – MSN.
– IPBRICK phone: Seleccione o IPBRICK phone da entidade registada no servidor IPBRICK.
• Outros:
– Localiza¸c˜ao: Seleccione a partir dos atributos previamente criados. – Coment´arios: Adicione os coment´arios que desejar.
– NIB: Insira o NIB da entidade. – Web: A p´agina web da entidade. – Dom´ınio da empresa
– Anivers´ario: Clique por favor no icone do calend´ario para seleccionar o anivers´ario da Entidade/Contacto.
– Estado: Para seleccionar um Estado ter´a de o criar em Dados Auxiliares. – Prov´ıncia: Para seleccionar uma Prov´ıncia ter´a de a criar em Dados
Aux-iliares.
– Regi˜ao: Para seleccionar uma Regi˜ao ter´a de a criar em Dados Auxiliares. – Apresenta¸c˜ao: Preencha com os dados necess´arios a serem considerados. – Cargo: A posi¸c˜ao hier´arquica ocupada.
– Campo Extra: Adiciona um atributo adicional.
Clique em Guardar
Depois de criar uma Entidade, poder´a verificar se todos os dados foram inseridos correctamente, se assim n˜ao for, clique em Modificar ou Apagar se deseja apagar a entrada.
5.7
Configura¸
c˜
ao iPortalDoc
Acceda `a interface web do iPortalDoc em https://iportaldoc.seudominio.com (substitua seudominio.com pelo dom´ınio correcto).
1. O login ´e: administrator
Figura 35: Inserir um novo documento de fatura¸c˜ao
Inserir um novo documento no direct´orio Billing. Escolher o tipo de entidade e a entidade a partir da lista.
Se definiu a Localiza¸c˜ao e um Contacto para essa entidade, escolha-os nas respec-tivas listas.
Depois de preencher os campo exigidos, clicar em Editar documento.
Escolha o per´ıodo, os telefones ou servidores da entidade e os contactos a fatu-rar. Surgir´a uma lista de todas as chamadas efectuadas por estes equipamentos no per´ıodo seleccionado, assim como o valor total.