Tutorial Tenant Billing Service

Este artigo aborda o uso do módulo Tenant Billing Service (TBS) do PowerB. Neste tutorial será utilizado:

• 1 Owner;
  
• 1 Tenant;
• 1 Utility de Energia Ativa (kWh);
• 1 Flat Rate Meter;
• 1 Template

PRÉ-REQUISITOS

• Versão do PowerB 4.15;
• Mínimo uma licença S-TBS;
• Noções básicas de navegação e criação de telas gráficas no PowerB;
• Históricos (Trendlogs) precisam ser históricos nativos do PowerB (não é permitido Trendlog BACnet ou de outro protocolo no TBS)

1. ADICIONAR O MÓDULO NOS SERVICES DA STATION

• Procurar por niagaraTenantBilling na sidebar do palette;
  
• Arrastar o Tenant Billing para o Services da Station.

2. ESTRUTURA DO TENANT BILLING SERVICE

• Owners: Proprietário/Empreendimento
  •  Tenant: Inquilino/locatário
    
    • Contract: Contrato
       
• Utilities: Insumos (Energia Ativa, Água, Gás, etc) 
  • Timed Meter Schedules: Programação Horária para os medidores para determinar horários de Ponta, Fora de Ponta, etc.
  • Utility: Insumo
    • Meters: medidores 
      • Flat Rate Meter: medidor de tarifa fixa
      • Timed Meter: medidor de tarifa variável

• Invoices: Visualização das Faturas/Contas geradas
• Auto Billing Profile: Perfil de Rateio Automático
• Templates: Modelo de Fatura

2.1. CONFIGURAÇÃO DOS UTILITIES (INSUMOS)

• Na visualização Utilities Manager, clicar em New e adicionar uma Utility;
• No campo Name, colocar Energia Ativa ou Consumo Ativo;
• No campo Description, colocar Energia Ativa ou Consumo de Energia;

• Entrar na Utility recém criada e clicar em New para adicionar um medidor;
• Em Type to Add, selecionar Flat Rate Meter e clicar em OK;
• Na configuração do Flat Rate Meter, preencher o campo Name com o nome do medidor;
• Preencher o campo Description com o insumo Consumo Ativo - isso é o que irá aparecer na fatura;
• Em Meter type, selecionar o tipo do insumo (Energia, Gás, Água, etc);
• Em Reference, inserir o identificador do medidor. Pode ser qualquer coisa desde que seja único. Isso será usado para mostrar algumas informações relevantes no template da fatura. A ord dos medidores para o TBS é sempre slot:meters/IdentificadorDoMedidor, onde IdentificadorDoMedidor é o texto que for inserido no campo Reference;
• Em History Identifier, selecionar o histórico/trendlog referente ao insumo;
• Em Utility Rate, inserir o valor da tarifa;
• Manter os outros parâmetros sem alteração e clicar em OK.

2.2. CONFIGURAÇÃO DO AUTO BILLING PROFILE

O TBS permite geração automática de faturas (invoices) periodicamente como mensalmente ou de alguma outra maneira customizada. Será Utilizado nesse tutorial um Billing Profile para gerar as faturas todo dia 5 do mês.

• Clicar em New para adicionar um novo Auto Billing Profile;
• Profile name: Mensal_Dia5;
• Marcar Monthly e selecionar 5 em Day of Month. Clicar em Next;
• Em Invoice Information, selecionar a próxima data em que o Auto Billing irá começar;
• Adjustment é uma taxa fixa que pode ser inclusa na fatura e é possível adicionar uma descrição para ele;
  
• Clicar em Next e marcar a opção Saves Invoices to PDF para salvar a fatura em um arquivo PDF e exportar posteriormente. Por padrão, o PDF será salvo na pasta Files da Station.
  
• Clicar em Next e marcar a opção Send Email para enviar a fatura por email para o inquilino. É necessário ter configurado o Email Service na station para correto funcionamento dessa função. Link Tutorial;

2.3. CONFIGURAÇÃO DO OWNER

• Em Owner Manager, clicar me New para adicionar um novo Owner;
• Preencher os campos Name, Description, Contact name, Contact email;
• Selecionar em Auto Billing Profile -> Mensal_Dia5 e clicar em OK para criar o Owner

2.4. CONFIGURAÇÃO DO TENANT

• Clicar no Owner criado no passo anterior e depois em New para criar um novo Tenant;
• Preencher Name, Account Number (deve ser único no mesmo empreendimento), Contact name, Contact email;
• Marcar a opção User Owner Auto Billing Profile para que esse inquilino utiliza o mesmo profile do Owner e clique em OK. Se for um profile diferente, desmarcar a opção e selecionar o auto billing profile desejado.

2.5. CONFIGURAÇÃO DO CONTRACT (CONTRATO)

• Clicar no Tenant criado no passo anterior e depois em New para criar um novo Contract;
• Preencher Name, Currency;
• Os campos Include Tax, Management Fee, Facilities Improvement Fee, Surcharge, apesar dos nomes, podem ser utilizados para qualquer outra função de cobrança que o contrato requer:
  • Include Tax -> yes irá multiplicar por um valor percentual (no campo Tax Rate percentage) em cima do valor da fatura;
  • Apply Tax to Fees -> yes irá aplicar o valor do Tax Rate percentage em cima do Management Fee e Facilities Improvement Fee;
• Management Fee: taxa de administração. Valor fixo a ser adicionado na fatura; 
• Facilities Improvement Fee: taxa de melhoria das instalações. Valor fixo a ser adicionado na fatura;
• Surcharge: Acréscimo/taxa adicional. Valor fixo a ser incluso na fatura final. 
• Template: Referenciar o template da invoice. Será criado no próximo passo.
• Meters: Selecionar os insumos e medidores referentes ao inquilino e a participação (em percentual %) dele no medidor.

3. CRIANDO O TEMPLATE DE INVOICE (FATURA/CONTA)

As invoices são nada mais do que arquivos .px, ou seja, tela gráficas. O cliente pode customizar a invoice com as informações relevantes para os inquilinos ou da forma como achar melhor.

• Criar um novo arquivo PX dentro da pasta Files da Station;
• Customizar o layout da PX como quiser;
• A PX de exemplo é composta por bound labels que tem a propriedade de text animada como na figura abaixo:

• Após criar o arquivo PX, entrar no Templates do Tenant Billing;
• Clicar em New e dar um nome ao template como ModeloContaEnergiaAtiva;
• Em Px File, selecionar o arquivo .px do modelo de fatura e clicar em OK;
• Editar o Contract e selecionar o template do modelo de fatura.

4.GERANDO AS INVOICES (FATURAS/CONTAS)

As invoices são geradas pelo auto billing profile, mas é possível gera-las manualmente. Basta estar no Owner Manager (ou Tenant Manager e até mesmo Contract Manager) e clicar em Generate Invoices.

• Selecionar o(s) contrato(s) e clicar em Next;
• Selecionar o período em Start Date e End Date e clicar em Next;
• Marcar Save Invoices to PDF para visualizar e clicar em Next;

4.1 VISUALIZANDO AS INVOICES (FATURAS/CONTAS)

As invoices podem ser visualizas em Invoice dentro do Tenant Billing Service.

COMO ADICIONAR MAIS INFORMAÇÕES NA INVOICE?

Há diversas informações que podem ser adicionas nas invoices que não foram abordadas neste tutorial. Basta entrar ajuda do PowerB em Help -> Help Contents e procurar por Template Px Engineering. No guia de ajuda, há também as explicações dos BFormats Strings utilizados na criação do template utilizado no tutorial.

FAQ

Além da licença do TBS, é preciso licença de devices?

R.: Sim. A licença do TBS é para o número de inquilinos somente. O cliente ainda precisa adquirir licença de devices para os medidores/hidrômetros, ou seja lá o que queira integrar via comunicação no supervisório.

É possível usar um Trendlog BACnet ou Trendlog de outro protocolo no TBS?

R.: Não. É necessário utilizar as extensões de trendlog nativas do PowerB. No entanto, é possível importar dados passados dos medidores para um trendlog do PowerB desde que o medidor possua alguma função de exportação de dados brutos.

O TBS funciona em um gerenciador (MJACEs, MEdges)?

R.: Não. Atualmente, o TBS é um módulo exclusivo do supervisório.

O TBS funciona a partir de qual versão do PowerB?

R.: A partir da versão 4.15.