# Geração de Adicional de Telefonia - Filtros VoIP
## Introdução
A **Geração do Adicional de Telefonia** consiste em uma rotina, que deve ser executada manualmente por um operador no sistema, da qual tem como objetivo realizar o faturamento e valor excedente dos [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]] de determinado período de um [[ramal sip|Ramal SIP]], incluindo este valor como um serviço adicional no [[formulario contrato do cliente|Contrato do Cliente]]. Os Serviços Adicionais permitem vincular valores extras à mensalidade do contrato recorrente de um cliente. Esses valores adicionais são somados ao financeiro do cliente após a aplicação do serviço.

Portanto, a **Geração do Adicional de Telefonia** consiste na identificação das ligações de um ramal SIP que excederam o plano contratado e, portanto, serão cobradas de forma adicional.

> [!NOTA] **Acesso à Funcionalidade**
> **Caminho:** Configurações > Rotinas provedor > Filtros VoIP > Gerar adicional Telefonia Contratos

## Requisitos de uso
- Utilizar uma integração de telefonia fixa compatível com o sistema;
- Realizar a importação das ligações dos clientes nos [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]];
- Tarifação configurada na plataforma integrada.
  
>[!Example] Plataformas de telefonia fixa compatíveis com o sistema:
> - [[integracao voip - interede|Integração VoIP - Interede]]
> - [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
> - [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
> - [[integracao voip - sippulse|Integração VoIP - SipPulse]]
> - [[integracao voip - summit networks|Integração VoIP - Summit Networks]]
> - [[integracao voip - tysa|Integração VoIP - Tysa]]
> - [[integracao voip - vsc|Integração VoIP - VSC]]
> - [[integracao voip - zeus|Integração VoIP - Zeus]]
> - [[integracao voip - fale sempre - master abril 2025|Integração VOIP - Fale Sempre - MASTER ABRIL 2025]]

## Entrega de Valor
A geração de adicionais de telefonia permite:
- Permite que os provedores dimensionem melhor sua infraestrutura com base no uso real;
- Promove maior controle de custos: os clientes podem monitorar e controlar melhor seus gastos com telefonia e as empresas podem identificar padrões de uso excessivo e ajustar suas políticas internas;
- Permite a cobrança do valor de ligações excedentes ao plano contratado;
- Cobrança do **uso da telefonia fixa baseada no consumo**, isto é, o cliente paga somente pelo o que está consumindo;
- Controle detalhado do consumo de telefonia;

## Estrutura da Funcionalidade
A funcionalidade de geração de adicional de contratos de telefonia é baseada nas seguintes configurações:
- Possuir uma integração de telefonia fixa no sistema com ramais ativos cadastrados;
- Tarefa de importação de ligações e registro de ligações no [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]];
- Configuração dos valores de tarifação de ligações diretamente na plataforma integrada;
- Parametrização de um produto de telefonia padrão para a geração do serviço adicional nos contratos;

## Configuração dos Parâmetros

### [[aba integracoes - formulario de parametros gerais|Aba Integrações - Formulário de Parâmetros gerais]]
Com as ligações de telefonia fixa importadas ao sistema com o valor de tarifação definido na plataforma, é necessário definir um produto padrão de telefonia nos [[formulario parametros gerais|Formulário Parâmetros Gerais]] ou no [[plano de cobranca - voip|Plano de cobrança - VoIP]], que servirá de base para realizar a geração do adicional de telefonia no [[formulario contrato do cliente|Contrato do Cliente]]. Para estabelecer estas definições, siga os passos a seguir:

#### Passo 1: Cadastro do Produto
1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastro > Produtos;
2. Clique em **Novo**;
3. Preencha os campos obrigatórios na aba Produto e Planejamento;
4. Defina o valor do produto como R$0,00;
5. Clique em **Salvar** para validar as modificações e concluir o cadastro do produto.
#### Passo 2: Configuração do Produto Base para o Serviço Adicional
É possível definir um produto padrão que servirá como base para a geração do **serviço adicional** de telefonia em duas configurações alternativas: através da [[aba integracoes - formulario de parametros gerais|Aba Integrações - Formulário de Parâmetros gerais]] como configuração geral (recomendado) ou através do uso do [[plano de cobranca - voip|Plano de cobrança - VoIP]], definido no cadastro do [[ramal sip|Ramal SIP]].

##### 2.1 Produto na [[aba integracoes - formulario de parametros gerais|Aba Integrações - Formulário de Parâmetros gerais]] (recomendado)
Ao realizar a configuração no formulário de [[formulario parametros gerais|Formulário Parâmetros Gerais]], estará definindo este produto como produto padrão para a geração do serviço adicional de telefonia. Para definir um produto padrão para a cobrança dos excedentes, siga os passos abaixo:

1. Acesse o formulário de [[formulario parametros gerais|Formulário Parâmetros Gerais]] através do caminho: Configurações > Parâmetros > Parâmetros gerais;
2. Acesse a aba Integrações;
3. Na seção VoIP, no campo **Produto**, insira o produto de telefonia cadastrado e clique em **Salvar** para concluir a configuração do produto.

##### 2.2 Produto no [[plano de cobranca - voip|Plano de cobrança - VoIP]]
Esta alternativa permite que o produto padrão esteja associado diretamente no plano de cobrança que, por sua vez, fica relacionado no ramal. Siga os passos abaixo para a configuração do produto no plano de cobrança:

1. Acesse o formulário de [[plano de cobranca - voip|Plano de cobrança - VoIP]] através do caminho: Sistema > Plataforma VoIP > Tarifação > Plano de tarifas;
2. Clique em Novo;
3. Preencha os campos:
	- **Nome:** preencha o nome do Plano de Cobrança para identificação;
	- **Produto ligações:** insira o produto de telefonia cadastrado para servir de base de cobrança do excedente;
	  
4. Clique em **Salvar** para validar o ajuste.

>[!SUCCESS] Finalização:
>Com os parâmetros devidamente configurados, poderá efetuar a geração do adicional de telefonia corretamente.
## Configuração Tipo de Documento por Produto para Serviço Adicional
Caso o parâmetro de tipo de documento por produto seja utilizado, é necessário configurar o tipo de documento diretamente no cadastro do produto.
### Passo a Passo: Configuração Tipo de Documento por Produto (Serviço Adicional)
1. Acesse Menu Sistema > Cadastros > Produtos; 
2. Localize o produto utilizado como serviço Adicional (Utilize o filtro para facilitar a localização); 
3. Siga até a aba **Planejamento**; 
4. Localize a seção **Tipo de Documento** e preencha os campos disponíveis. Opções disponíveis: 
- **Tipo de documento para serviços adicionais - Pessoa física**: Define o tipo de Tipo de documento que será vinculado nos serviços adicionais quando o cliente for do tipo pessoa física.
- **Tipo de documento para serviços adicionais - Pessoa Jurídica**: Define o tipo de Tipo de documento que será vinculado nos serviços adicionais quando o cliente for do tipo pessoa jurídica. 
5. Após preencher os campos, clique em **Salvar**.
## Como Gerar o Adicional de Telefonia
A **Geração do Adicional de Telefonia** é uma rotina que deve ser executada manualmente por um operador ([[usuarios|Usuários]] autorizado no sistema). Ao executar, esta rotina verifica as ligações importadas através das tarefas de importação de ligações, que são armazenadas nos [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]. São identificadas as ligações tarifadas e os valores para que, então, seja realizado o cálculo do valor adicional que será incluído nos **Serviços Adicionais** do [[formulario contrato do cliente|Contrato do Cliente]].

A rotina opera baseando-se em filtros previamente selecionados, sendo eles os campos de: **integração**, **ramal** e **datas das ligações**. Portanto, é essencial que o operador forneça estas informações principais para que o sistema gere o serviço adicional para o(s) ramal(is) correto(s) no período especificado. Esta rotina permite uma gestão precisa dos custos adicionais de telefonia, garantindo que os clientes sejam cobrados adequadamente pelo uso excedente ao seu plano contratado.
 
 Para efetuar a geração do adicional de telefonia, siga os passos a seguir:

1. Acesse o formulário de [[formulario rotinas provedor|Formulário Rotinas Provedor]] através do caminho: Configurações > Rotinas > Rotinas provedor;
2. Acesse a aba Filtros VoIP;
3. Preencha os campos:
	- **Integração:** clique na lupa e selecione o cadastro da integração de VoIP em seu sistema;
	- **Ramal:** preencha com o cadastro do ramal que deseja realizar a geração do serviço adicional. Caso o campo fique em branco, irá contemplar todos os ramais cadastrados no sistema;
	- **Data de lançamento:** insira a data em que o serviço adicional será lançado;
	- **Data inicial das ligações:** período inicial do qual será gerado o serviço adicional, serão identificadas as ligações no [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]] do ramal;
	- **Data final das ligações:** período final das ligações no qual será gerado o serviço adicional.
	
4. Após preencher os filtros, clique no botão **Gera adicional Telefonia Contratos** para executar a rotina de geração do serviço adicional de telefonia.
5. Após clicar neste botão, o sistema iniciará uma listagem (baseada nos filtros aplicados) de todos os ramais que forem identificados com ligações tarifadas e gerará o serviço adicional no contrato.

>[!INFO] Serviços adicionais no contrato:
>Para visualizar os serviços adicionais de telefonia no contrato, acesse  **Sistema > Cadastros > Contratos > Serviços adicionais.**<br>
> Caminho alternativo: **Menu Sistema > Cadastros > pasta Contratos > Serviços e descontos adicionais.**<br>
> Após ter gerado o adicional de telefonia, poderá ser gerado o financeiro dos contratos.

## Funcionalidades Principais

### Definição do Produto para Adicionais
- O produto definido será vinculado para gerar adicionais de telefonia;
- Pode ser configurado em: Configurações > Parâmetros Gerais > Integrações > Produtos.
### Geração de Adicionais
1. O sistema gera o serviço adicional com base no uso de telefonia do cliente e os dados de tarifação das ligações importadas;
2. As cobranças são incluídas na fatura do cliente.

## Fluxo de Trabalho

### Fluxo de Cobrança de Ligações Excedentes

```mermaid
graph TD
    A[Uso do serviço de telefonia] --> B[Cálculo do consumo]
    B --> C{Excedeu limite?}
    C -->|Sim| D[Importa as ligações com o valor proporcional da tarifa]
    C -->|Não| E[Não gera adicional]
    D --> F[Gera adicional]
    F --> G[Inclui na fatura]
    E --> G
```

### Fluxo de Cobrança Baseada no Consumo
```mermaid
graph TD
    A[Início do Processo] --> B[Registro de consumo do cliente pelas ligações importadas]
    B --> C[Gerar adicional de telefonia]
	C --> D[Gerar Fatura com Consumo Total]
	D --> E[Enviar Fatura ao Cliente]
    E --> F[Fim do Processo]
```

## Considerações Finais
A geração de adicionais de telefonia é um processo essencial para a correta cobrança dos serviços de telefonia fixa. É importante manter as configurações atualizadas e monitorar regularmente para garantir a precisão das cobranças.

## Etiquetas
#Integracao #IntegracoesVoIP #VoIP #PlanoDeCobranca #TelefoniaFixa #ServicosAdicionais 

## Leia também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - interede|Integração VoIP - Interede]]
 - [[integracao voip - magnus billing|Integração VoIP - Magnus Billing]]
 - [[integracao voip - saperx v2|Integração VoIP - SaperX v2]]
 - [[integracao voip - sippulse|Integração VoIP - SipPulse]]
 - [[integracao voip - summit networks|Integração VoIP - Summit Networks]]
 - [[integracao voip - tysa|Integração VoIP - Tysa]]
 - [[integracao voip - vsc|Integração VoIP - VSC]]
 - [[integracao voip - zeus|Integração VoIP - Zeus]]
 - [[ramal sip|Ramal SIP]]
 - [[ramal sip x clientes|Ramal SIP X Clientes]]
 - [[tarifas - voip|Tarifas - VoIP]]
 - [[plano de cobranca - voip|Plano de cobrança - VoIP]]
 - [[cadastro de produtos|Cadastro de Produtos]]
 - [[aba integracoes - formulario de parametros gerais|Aba Integrações - Formulário de Parâmetros gerais]]
- [[formulario contrato do cliente|Contrato do Cliente]]
- [[aba - servicos adicionais|Aba - Serviços Adicionais]]
- [[como incluir servicos adicionais ao contrato|Como Incluir Serviços Adicionais ao Contrato]]