Guia IPBrick Billing

Transcrição

1 Guia IPBrick Billing iportalmais 1 de Outubro de Introdução A crescente aceitação da facturação electrónica por parte dos consumidores e da comunidade empresarial tornou-nos conscientes da necessidade de implementar uma solução de facturação electrónica de confiança, levámos esse pensamento um passo adiante e integramo-lo com o iportaldoc, o nosso software de Gestão documental e workflow. O IPBrick Billing é um software do sistema de facturação electrónica e de contabilização de chamadas. Serve tanto para manter um registo de todos os nossos gastos com telecomunicações ou para cobrar aos clientes as suas chamadas telefónicas (ex.: um hotel). 2 Características Conforme foi referido anteriormente, este software funciona em interacção estreita com o iportaldoc e, claro, com a IPBrick. O IPBrick Billing é muito fácil de configurar. Para começar a trabalhar, só é preciso configurar que telefones registados da IPBrick são para facturar, e modificar a tarifa predefinida. Para uma facturação mais detalhada, também permite a associação de tarifas diferentes a telefones diferentes. É feito o upload das tarifas através de ficheiros.csv. Ao modificar uma associação telefone/tarifa, é possível voltar a calcular todos os custos de chamadas do telefone ou começar a usar a nova tarifa só nas chamadas novas. 1

2 Os relatórios de facturação são gerados através do software iportaldoc, assegurando um arquivo avançado e eficiente de todos os relatórios. 3 Cenário A - Uma IPBRICK.GT Este cenário aplica-se apenas no caso de apenas uma IPBrick.GT com a autenticação LDAP configurada por omissão como Master LDAP. 3.1 Procedimento de Instalação Para activar o módulo Billing, necessitará de instalar o pacote ucoip4iportaldoc.deb disponível em: Ele permite: 1. Gravação de chamada em MP3 ou WAV no iportaldoc com classificação da chamada automática. 2. Guarda automaticamente todos os faxes e mensagens de correio electrónico recebidos e enviados e classifica os documentos. 3. Fornece a facturação para operadores ou telefones 4. Permite-lhe gerar relatórios do custo total da chamada para qualquer telefone ou equipamento remoto SIP do cliente que efectua chamadas através da IP- Brick. Os custos baseiam-se na duração da chamada e no prefixo marcado IPBrick 5.1 Para instalar o pacote ucoip4iportaldoc_en-1.0_all.deb é preciso que: 1. todas as actualizações até à 14 estejam instaladas. Ler as notas de lançamento e fazer o seu download em: Nota: Ter em atenção que precisa de se registar na nossa loja online para que a secção de download esteja disponível. 2

3 Downloads Software Updates IPBrick v Novamente na nossa loja online: Downloads Software IPBrick Related Software IPBrick 5.1 UCoIP 4 iportaldoc 1.0 Fazer o Download do pacote: ucoip4iportaldoc_en-1.0_all.deb 3. Instalar primeiro as actualizações para a IPBrick por ordem e depois o ucoip4iportaldoc DEB em Configuraç~oes Avançadas > IPBrick >Update. Seguir as instruções de instalação. 4. Aplicar as Configurações Figura 1: Insert update IPBrick Faça o download do pacote ucoi4iportaldoc_v2.0_to_ipbrick5.2.deb em: 3

4 Nota: Tome em atenção que precisa de se registar na nossa eshop para que a secção de downloads esteja disponível. Downloads Software IPBrick Related Software IPBrick 5.2 UCoIP 4 iportaldoc Instalar o DEB via a interface web da IPBrick: Configuraç~oes Avançadas > IPBrick > Update 3. Seguir as intruções de instalação e aplicar as configurações. 3.2 Configuração DNS 4. Se a IPBrick não é o seu servidor primário de DNS adicione as seguintes entradas no seu servidor DNS, apontando para o IP da IPBrick.GT: iportaldoc.seudominio.com billing.seudominio.com contacts.seudominio.com 3.3 Licença IPBrick Será necessário actualizar a licença do iportaldoc com a opção de Billing activo. 3.4 Configuração do Billing para operadores VoIP Configuração do operador (IPBrick com billing) Para configurar o Billing irá necessitar de efectuar alterações na interface web da IPBrick, no website Billing e no iportaldoc. 4

5 3.4.2 Configuração da IPBrick Aceder à interface web do servidor Intranet IPBrick e criar as contas SIP de que necessitar, uma por cliente. Se os telefones a facturar são locais, crie-os em IPBrick.I > Gest~ao de Máquinas. Se são servidores ou telefones remotos inserilos em: Configuraç~oes Avançadas > Telefonia > Telefones Registados e devem ser definidos como remotos. NOTA: Se não quiser associar os seus telefones ao LDAP poderá também utilizar a mesma localização no servidor IPBrick.GT O login e a password serão usados para registar os telefones do cliente ou os servidores SIP remotos. Figura 2: Adicionar um novo telefone interno 5

6 Figura 3: Adicionar um telefone ou servidor externo Criar todas as classes de acesso em: IPBrick.GT > VoIP > Funç~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. 6

7 Figura 4: Adicionar telefone ou servidores a uma classe de acesso Ao terminar, por favor faça Aplicar Configuraç~oes Configuração Billing Neste website pode definir que telefones e servidores devem ser facturados e alterar os valores de facturação. Aceda ao interface web do Billing em (substituir seudominio.com pelo domínio correcto). 1. O login é: administrator 2. A password predefinida para este utilizador é: 123 Pode autorizar utilizadores adicionais e definir perfis diferentes em: Gest~ao > Utilizadores e Gest~ao > Grupos. preencher com os dados da empresa em Gest~ao > Dados da Empresa. 7

8 Figura 5: Actualizar a informação da empresa Definir a moeda, o imposto e os prefixos de saída em: Gest~ao > Opç~oes do Programa O Código de marcação de saída será substituído pelo código de marcação de país e o prefixo internacional será listrado quando corresponder aos valores de facturação.. 8

9 Figura 6: Alterar opções Substituir o valor de facturação PREDEFINIDO e adicionar os novos, conforme precisar. O ficheiro com os valores deve ter uma extensão.csv. Aqui está um exemplo de um ficheiro de valor de facturação: Code;Country;Price;Period;InitialPeriod;InitialPrice 0;DEFAULT; ;1;1; ;AFGHANISTAN; ;1;1; ;ALASKA; ;1;1; ;ALBANIE; ;1;60; Neste exemplo, todas as chamadas são facturadas ao segundo, excepto a Rota da Albânia, em que o primeiro minuto custa 0.05 e a restante chamada é facturada em períodos de um segundo. As duas primeiras linhas são obrigatórias. O prefixo PREDEFINIDO é usado quando nenhum outro prefixo corresponde. A ordem dos prefixos no ficheiro CSV é irrelevante, os prefixos são correspondidos por comprimento: o custo será calculado a partir do prefixo com maior extensão que corresponda ao número a ser facturado. 9

10 É possível definir um período de facturação inicial (ex.: no primeiro minuto a chamada custa X) e a partir desse período, cada segundo será facturado. Cada campo valor está separado por ";" e o seu significado é o seguinte: 1. Código - Prefixo no formato internacional sem o prefixo internacional (sem 00 por omissão). Por exemplo, para corresponder ao número (telemóveis portugueses) o prefixo deve ser País - Nome do país ou descrição do valor. 3. Preço - Custo de cada Período. 4. Período - Após o período inicial definido em PeriodoInicial, ao custo da chamada é acrescentado o valor Preço de cada Período. 5. PeriodoInicial - Quantos segundos do período inicial. 6. PreçoInicial - Custo do período inicial. Figura 7: Valores do Upload O custo da chamada é calculado usando as fórmulas seguintes: 10

11 1. se o tempo de chamada é inferior ou igual ao: PeriodoInicial: CustoTotal=PeriodoInicial*PreçoInicial 2. if call time greater than InitialPeriod: CustoTotal=PeriodoInicial*PreçoInicial + Preço*(TempoChamada- PeriodoInicial)/Período Após fazer o upload dos ficheiros CSV pode editar cada um dos valores no interface web de Facturação ou substituir o valor fazendo o upload de um novo. Figura 8: Adicionar telefones e servidores Para estabelecer que telefones ou servidores serão facturados, aceder a Gest~ao > Telefones e clicar em Adicionar telefones. Seleccionar os telefones ou os servidores conforme ache necessário e seleccionar que valor de facturação a ser utilizado. Também pode adicionar servidores clicando na opção Adicionar servidor. Ao adicionar servidores ou telefones desta forma, as chamadas corresponderão à identificação da pessoa que telefona. Isto também permite adicionar telefone PBX se a identificação da pessoa que telefona enviada por estes telefones for única Configuração do Contactos Aceder ao interface web do Contactos em (substituir seudominio.com pelo domínio correcto). 11

12 1. O login é: administrator 2. A password predefinida para este utilizador é: 123 Criar um novo tipo de entidade clicando em Definiç~oes > Gest~ao de Entidades, depois Tipos de Entidade e Inserir se não tiver nenhuma. Escolher um nome para o grupo de entidades a facturar. Figura 9: Adicionar um novo tipo de entidade Criar um novo tipo de entidade clicando em Definiç~oes > Gest~ao de Entidades e depois Inserir. Para facturação, deve ser configurado o campo telefone IPBrick. Preencher também os outros campos. 12

13 Figura 10: Criar uma nova entidade 13

14 3.4.5 Configuração do iportaldoc Aceda à interface web do iportaldoc em (substitua seudominio.com pelo domínio correcto). 1. O login é: administrator 2. A password predefinida para este utilizador é: 123 Figura 11: Inserir um novo documento de facturação Inserir um novo documento no directório Billing. Escolher o tipo de entidade e a entidade a partir da lista. Se definiu a Localização e um Contacto para essa entidade, escolha-os nas respectivas listas. 14

15 Depois de preencher os campo exigidos, clicar em Editar documento. Escolha o período, os telefones ou servidores da entidade e os contactos a facturar. Surgirá uma lista de todas as chamadas efectuadas por estes equipamentos no período seleccionado, assim como o valor total. Inserir o documento gerado e enviá-lo para o cliente ou imprimi-lo. Figura 12: Escolher as chamadas a facturar 15

16 3.5 Configuração do cliente O Cliente tem uma IPBrick 1. Aceder à interface web IPBrick do cliente. 2. In IPBrick.GT > VoIP > Gest~ao de Rotas clique em inserir nova rota de saída. 3. Clicar em Opç~oes Avançadas e preencha os campos exigidos: (a) Tipo SIP (b) Nome Nome da rota ou descrição (c) Endereço do Servidor SIP o IP público da IPBrick ou o domínio (d) Porta do Servidor SIP 5090 (e) Autenticação Utilizador/Password (f) Utilizador login criado na IPBrick para esta conta SIP (g) Login de autenticação login criado na IPBrick para esta conta SIP (h) Password/Confirme Password a password para este login (i) Identificador de Chamador login criado na IPBrick para esta conta SIP (j) Domínio de Registo Domíno da IPBrick (k) Outros campos preconfigurados 4. Clique em Inserir 5. Em IPBrick.GT > VoIP > Gest~ao de Rotas clique na rota recém criada. 6. Insira um ou mais prefixos para encaminhar as chamadas para a IPBrick com Billing O Cliente tem um telefone SIP ou um gateway que suporte SIP 1. Registar o telefone ou gateway com a seguinte autenticação: (a) Domain IP Público ou Domínio da IPBrick ex: ipbrick.dominio.com (b) Domínio e porta do Proxy IP Público ou Domínio da IPBrick, Porta 5090 ex: :

17 (c) Username login criado na IPBrick para esta conta SIP (d) Login de autenticação login criado na IPBrick para esta conta SIP (e) Password password para este login 4 Cenário B - Duas IPBRICKS Este cenário tem duas IPBricks, uma IPBrick.I com a solução iportaldoc já instalada e que em termos de autenticação se comporta como um LDAP Master; e uma IPBrick.GT já configurada como LDAP client ou até Slave. NOTA: O pacote ucoip4iportaldoc deve ser instalado TANTO na IPBrick.GT COMO NA IPBrick.I, mesmo que este último tenha já instalado o iportaldoc. 4.1 Procedimento Básico Por favor instale o pacote UCoIP tanto na IPBrick.GT como na máquina com iportaldoc; Actualize a licença iportaldoc (obviamente na máquino que o tem instalado) de forma a activar o módulo Billing; Configure o servidor DNS de forma a que o serviço Billing aponte para a máquina IPBrick.GT; Configure o DNS de forma a que os serviços Contacts e iportaldoc apontem para a máquina instalada com iportaldoc. 4.2 Procedimento de instalação Como no cenário anterior, de forma a activar o módulo Billing, irá ter de instalar o pacote ucoip4iportaldoc.deb disponível em: Este pacote dá suporte a: 1. Gravação de Chamadas em MP3 ou WAV no iportaldoc com classificação automática. 17

18 2. Guarda automaticamente todos os faxes e s enviados ou recebidos e classifica os documentos. 3. Providencia facturação para operadores ou telefones - Permite que crie relatórios com o custo total de chamadas para qualquer telefone ou equipamento remoto SIP que faça chamadas através da IPBrick. Os custos são baseados na duração da chamada e no prefixo marcado Packages for IPBrick 5.1 Para instalar o pacote ucoip4iportaldoc_en-1.0_all.deb necessita que: 1. Todos os updates, até ao 14, sejam instalados. Por favor leia as release notes e faça o download em: NOTA: Tenha em atenção que precisa de se registar na nossa eshop para que a secção de dowloads esteja disponível. Downloads Software Updates IPBrick v Novamente, na nossa eshop: Downloads Software IPBrick Related Software IPBrick 5.1 UCoIP 4 iportaldoc 1.0 Faça o download do pacote: ucoip4iportaldoc_en-1.0_all.deb 3. Instale primeiro os updates para a IPBrick por ordem e depois o pacote DEB ucoip4iportaldoc em: Advanced Configurations > IPBrick > Update. Siga as instruções de instalação. 4. Aplicar Configurações 18

19 Figura 13: Inserir update Pacotes para a IPBrick Download o pacote ucoi4iportaldoc_v2.0_to_ipbrick5.2.deb em: NOTA: Tenha em atenção que precisa de se registar na nossa eshop para que a secção de dowloads esteja disponível. Downloads Software IPBrick Related Software IPBrick 5.2 UCoIP 4 iportaldoc Instale o DEB na interface web da IPBrick.GT: Configuraç~oes Avançadas > IPBrick > Update 3. Siga as instruções de instalação e aplique as configurações. 19

20 4.3 Configuração de DNS Se a IPBrick.I é o servidor DNS primário altere a entrada billing.seudominio.com para o IP da IPBrick.GT; Se a IPBrick não for o seu servidor DNS primário adicione as seguintes entradas ao seu servidor DNS: iportaldoc.seudominio.com apontando para o IP da IPBrick.I contacts.seudominio.com apontando para o IP da IPBrick.I billing.seudominio.com apontando para o IP da IPBrick.GT 4.4 Licença iportaldoc Activação da licença iportaldoc s com o módulo Billing activo SÓ no servidor IPBrick.I! 4.5 Configuração do Billing para operadores VoIP Configuração do operador (IPBrick com billing) Para configurar o Billing irá necessitar de efectuar alterações na interface web da IPBrick, no website Billing e no iportaldoc. Na IPBrick.GT com o Billing instalado, aceda à interface web, crie as contas SIP que necessitar, uma por cliente. Se os telefones a facturar são locais, crie-os na IPBrick.I > Gest~ao de Máquinas. Se forem servidores remotos ou telefones insira-os em: Configuraç~oes Avançadas > IPBrick > Update devem estar configurados como remotos. O login e a password serão usados para registar os telefones dos clientes ou os servidores remotos SIP. 20

21 Figura 14: Adicionar um novo telefone interno Figura 15: Adicionar um telefone externo ou servidor Criar uma classe de acesso em: 21

22 IPBrick.GT > VoIP > Funç~oes > Saída > Classes de Acesso com as rotas certas e autorizadas para cada cliente e adicione o seu telefone ou servidor como membro desta classe de acesso. Figura 16: Adicionar telefones ou servidores a uma classe de acesso Quando terminar, faça Aplicar Configuraç~oes Configuração IPBrick Aceda à interface do servidor intranet IPBrick e crie tantas contas SIP accounts quantas necessitar, uma por cliente. If the phones to bill are local, create them in IPBrick.I > Machines management. If there are remote servers or phones you will need to change the Local default value to Remote at the IPBrick.GT server in: Configuraç~oes > Telefonia > Telefones registados devendo estar definidos como remotos. NOTA: Se não pretender associar os seus telefones ao LDAP poderá criá-los na mesma localização no servidor IPBrick.GT. 22

23 O login e a password será usada para registar os telefones dos clientes ou servidores SIP remotos. Figura 17: Adicionar um novo telefone interno 23

24 Figura 18: Adicionar um telefone externo ou servidor Todas as Classes de Acesso devem ser criadas no servidor IPBrick.GT. Para criar uma classe de acesso vá a: IPBrick.GT > VoIP > Funç~oes > Saída > Classes de Acesso com as rotas autorizadas para cada cliente e adicione o telefone ou servidor como membro desta classe de acesso. 24

25 Figura 19: Adicionar telefone ou servidires a uma classe de acesso Quando terminar faça Aplicar Configuraç~oes Configuração do Billing Neste website poderá definir quais os telefones e sevidores serão facturados e alterar as taxas de facturação. Aceda à interface at (substitua seudominio.com pelo domínio correcto). 1. O login é: administrator 2. A password por omissão é: 123 Poderá autorizar utilizadores adicionais e definir ou perfis diferentes em: Gest~ao > Utilizadores and Gest~ao > Grupos. Preencha com os dados da empresa em Gest~ao > Dados da Empresa. 25

26 Figura 20: Actualizar dados da empresa Defina a moeda, taxa e prefixos de saída em: Gest~ao > Opç~oes de Programa O código de marcação de saída irá ser substituido pelo código do país e o prefixo internacional será removidodialing code will be replaced by the country dialing code and the international prefix will be striped when matching the billing rates. 26

27 Figura 21: Alterar opções Substitua a taxa de facturação PRECONFIGURADA e adicione novas se assim necessitar. O ficheiro com as taxas deverá ter a extensão.csv. Aqui está um exemplo de um ficheiro de facturação: Code;Country;Price;Period;InitialPeriod;InitialPrice 0;DEFAULT; ;1;1; ;AFGHANISTAN; ;1;1; ;ALASKA; ;1;1; ;ALBANIE; ;1;60; Neste exemplo, todas as chamadas são facturadas ao segundo, excepto a Rota da Albânia, em que o primeiro minuto custa 0.05 e a restante chamada é facturada em períodos de um segundo. As duas primeiras linhas são obrigatórias. O prefixo PREDEFINIDO é usado quando nenhum outro prefixo corresponde. A ordem dos prefixos no ficheiro CSV é irrelevante, os prefixos são correspondidos por comprimento: o custo será calculado a partir do prefixo com maior extensão que corresponda ao número a ser facturado. 27

28 É possível definir um período de facturação inicial (ex.: no primeiro minuto a chamada custa X) e a partir desse período, cada segundo será facturado. Cada campo valor está separado por ";" e o seu significado é o seguinte: 1. Código - Prefixo no formato internacional sem o prefixo internacional (sem 00 por omissão). Por exemplo, para corresponder ao número (telemóveis portugueses) o prefixo deve ser País - Nome do país ou descrição do valor. 3. Preço - Custo de cada Período. 4. Período - Após o período inicial definido em PeriodoInicial, ao custo da chamada é acrescentado o valor Preço de cada Período. 5. PeriodoInicial - Quantos segundos do período inicial. 6. PreçoInicial - Custo do período inicial. Figura 22: Taxas de Upload O custo da chamada é calculado usando as fórmulas seguintes: 28

29 1. se o tempo de chamada é inferior ou igual ao: PeriodoInicial: CustoTotal=PeriodoInicial*PreçoInicial 2. if call time greater than InitialPeriod: CustoTotal=PeriodoInicial*PreçoInicial + Preço*(TempoChamada- PeriodoInicial)/Período Após fazer o upload dos ficheiros CSV pode editar cada um dos valores no interface web de Facturação ou substituir o valor fazendo o upload de um novo. Figura 23: Adicionar telefones e servidores Para configurar quais os telefones ou servidores que irão ser facturados, aceda por favor a Gest~ao > Telefones e clique em Adicionar telefones. Seleccione tantos telefones quantos os necessitar e seleccionequal a taxa de facturação a ser utilizada. Também pode adicionar servidores clicando na opção Adicionar servidor. Ao adicionar servidores ou telefones desta forma, as chamadas corresponderão à identificação da pessoa que telefona. Isto também permite adicionar telefone PBX se a identificação da pessoa que telefona enviada por estes telefones for única Configuração do Contactos Aceda à interface web do Contactos (substitua seudominio.com pelo domínio correcto). 29

30 1. O login é: administrator 2. A password preconfigurada para este utilizador é: 123 Crie um tipo de entidade em Definiç~oes > Gest~ao de Entidades, depois Tipos de Entidade e Inserir se não existir nenhum. Escolha um nome para o grupo de entidades que irão ser facturadas. Figura 24: Adicionar um novo tipo de entidade Crie uma nova entidade clicando em Definiç~oes > Gest~ao de Entidades seguido de Inserir. Para facturação, o campo Telefone IPBrick deve ser configurado. Preencha também os outros campos conforme ache necessário. 30

31 Figura 25: Criar uma nova entidade 31

32 4.5.5 Configuração do iportaldoc Aceda à interface web do iportaldoc em (substitua seudominio.com pelo domínio correcto). 1. O login é: administrator 2. A password predefinida para este utilizador é: The login is: administrator 2. The default password for this user is: 123 Figura 26: Inserir um novo documento de facturação Insira um novo documento no directório Billing. Escolha o tipo de entidade e a entidade da lista. 32

33 Se definiu a Localização e o Contacto para essa entidade, escolha-os também a partir da lista respectiva. Depois de preencher os campos respectivos clique em Editar documento. Escolha o período, os telefones ou servidores da entidade e os contactos a facturar. Surgirá uma lista de todas as chamadas efectuadas por estes equipamentos no período seleccionado, assim como o valor total. Inserir o documento gerado e enviá-lo para o cliente ou imprimi-lo. 33

34 Figura 27: Escolher as chamadas a serem facturadas 4.6 Configuração do Cliente O cliente tem uma IPBrick 1. Aceder à interface web IPBrick do cliente. 2. In IPBrick.GT > VoIP > Gest~ao de Rotas clique em inserir nova rota de saída. 34

35 3. Clicar em Opç~oes Avançadas e preencha os campos exigidos: (a) Tipo SIP (b) Nome Nome da rota ou descrição (c) Endereço do Servidor SIP o IP público da IPBrick ou o domínio (d) Porta do Servidor SIP 5090 (e) Autenticação Utilizador/Password (f) Utilizador login criado na IPBrick para esta conta SIP (g) Login de autenticação login criado na IPBrick para esta conta SIP (h) Password/Confirme Password a password para este login (i) Identificador de Chamador login criado na IPBrick para esta conta SIP (j) Domínio de Registo Domíno da IPBrick (k) Outros campos preconfigurados 4. Clique em Inserir 5. Em IPBrick.GT > VoIP > Gest~ao de Rotas clique na rota recém criada. 6. Insira um ou mais prefixos para encaminhar as chamadas para a IPBrick com Billing O Cliente tem um telefone SIP ou um gateway que suporte SIP 1. Registar o telefone ou gateway com a seguinte autenticação: (a) Domain IP Público ou Domínio da IPBrick ex: ipbrick.dominio.com (b) Domínio e porta do Proxy IP Público ou Domínio da IPBrick, Porta 5090 ex: :5090 (c) Username login criado na IPBrick para esta conta SIP (d) Login de autenticação login criado na IPBrick para esta conta SIP (e) Password password para este login 35