# Como Configurar Tarifação - Telefonia VoIP Tysa

## Introdução

>[!TIP] **Tysa**
>A **[Tysa](https://www.tysa.com.br/)** é uma empresa brasileira especializada em soluções para telecomunicações, oferecendo uma plataforma VoIP que possibilita a prestação de serviços de telefonia fixa. O sistema oferece controle centralizado de chamadas, flexibilidade operacional e escalabilidade, permitindo uma gestão eficiente das comunicações telefônicas.

A tarifação para uma plataforma de telefonia fixa refere-se ao processo de cobrança das ligações realizadas pela linha telefônica, podendo ser configurados parâmetros específicos, como o tempo de duração, destino e tipo de chamada. Este processo permite que empresas faturem seus serviços de acordo com esta modalidade de cobrança. 

No sistema, ao utilizar a [[integracao voip - tysa|Integração VoIP - Tysa]], é possível realizar o controle de tarifação a partir da importação das ligações tarifadas então realizar a [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]] para efetuar o faturamento.

>[!NOTE] **Acesso à Funcionalidade**
>**Caminho:** Sistema > Plataforma VoIP > Tarifas

## Entrega de valor
- Garante que todos os serviços prestados sejam corretamente contabilizados e cobrados;
- Comunicação com a plataforma Tysa, permitindo a configuração assertiva da tarifação e importando as ligações já tarifadas. Com isso, unifica o faturamento e a gestão do contrato no sistema;
- Permite a distinção de planos para cada tipo de ligação, realizando um faturamento assertivo.

## Estrutura da Funcionalidade
A funcionalidade é baseada principalmente nas seguintes configurações:
- Configuração de um produto de telefonia fixa;
- Configuração de [[tarifas - voip|Tarifas - VoIP]];
- Configuração de [[plano de cobranca - voip|Plano de cobrança - VoIP]];
- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]].

### Princípios de Funcionamento
Na integração com o sistema, as ligações dos ramais são importadas e analisadas conforme o **plano de cobrança**. Este plano, definido pelo produto de telefonia e tarifa, determina o tipo de chamada (LDN, local, interno, VC1, VC2, VC3) a ser cobrada e a franquia a ser consumida. Se a linha ultrapassar os segundos da franquia, o sistema irá cobrar pelo excedente, importando as ligações com o valor cobrado pelo excedente. As chamadas são importadas pela [[tarefa - importar cdr tysa|Tarefa - Importar CDR Tysa]] e registradas no [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]. O sistema então verifica o tipo de ligação e o plano do ramal para calcular possíveis cobranças adicionais.

>[!INFO] **Serviço adicional:**
>Um serviço adicional no sistema detalha um serviço consumido e faturado além do consumo já previsto no plano contratado.
>
Assim, o **Serviço adicional de telefonia** refere-se à cobrança de ligações excedentes, ou seja, chamadas realizadas além da franquia contratada no plano.

## Configuração da Tarifação
### Passo 1: Configuração de um Produto de Telefonia
Realize o cadastro de um produto de telefonia para vinculá-lo no [[plano de cobranca - voip|Plano de cobrança - VoIP]]. Este produto será considerado e servirá como base na geração do serviço adicional, portanto, **não é necessário configurá-lo com valor**. Para realizar o cadastro deste produto, siga os passos a seguir:

1. Acesse o formulário de [[cadastro de produtos|Cadastro de Produtos]] através do caminho: Sistema > Cadastro > Produtos;
2. Clique no botão **Novo**;
3. Na aba **Produtos** e na aba **Planejamento**, preencha os campos obrigatórios;
4. Clique em **Salvar** para concluir a configuração do produto.

### Passo 2: Configuração de [[plano de cobranca - voip|Plano de cobrança - VoIP]] e [[tarifas - voip|Tarifas - VoIP]]
Com o produto cadastrado, é necessário relacioná-lo ao plano de cobrança para então realizar a geração do adicional de telefonia. Siga os passos a seguir:

1. Acesse o formulário e [[plano de cobranca - voip|Plano de cobrança - VoIP]] através do caminho: Sistema > Plataforma VoIP > Tarifação > Plano de tarifas;
2. Clique no botão **Novo**;
3. Preencha os campos:
	- **Nome:** insira um nome de identificação para o Plano de Cobrança;
	- **Produto ligações:** clique na lupa e selecione o produto de telefonia cadastrado;
	
4. Clique em **Salvar** para registrar o cadastro do plano de cobrança;
5. Direcione-se à seção **Franquia**, preencha o campo **Produto Franquia** com o mesmo produto inserido no campo **Produto ligações**;
6. No campo **Tarifa franquia**, clique sobre a lupa e clique no botão **Novo** para cadastrar a tarifa da franquia;
7. No formulário de [[tarifas - voip|Tarifas - VoIP]], preencha os campos:
	- **Plano de tarifas:** preencha o campo com o plano de cobrança que está cadastrando;
	- **Tipo de chamada:** clique sobre o botão de seleção e indique o tipo de chamada que deseja configurar a tarifação. Os tipos de chamadas disponíveis são LDN, local, interno, VC1, VC2, VC3;
	- **Franquia em segundos:** insira a quantidade de minutos mensais dos quais este tipo de chamada terá. Ao cliente que exceder esta quantidade, o valor é cobrado pelo excedente. Este valor é definido pela plataforma Tysa.
8. Clique em **Salvar** para concluir o cadastro da Tarifa;
9. Retornando ao formulário de **Plano de cobrança**, insira a tarifa cadastrada no campo **Tarifa franquia**. Clique sobre a lupa e selecione a tarifa.
10. Clique em **Salvar** para concluir o cadastro do **Plano de Cobrança** relacionado à **Tarifas**.
   
>[!TIP] **Ramal SIP:**
>Com o plano de cobrança devidamente configurado, poderá ser vinculado ao Ramal no ato de criação ou para atualizar este dado, através do caminho: Sistema > Plataforma VoIP > Ramais > [[ramal sip x clientes|Ramal SIP X Clientes]] > Novo/Editar > campo **Plano de Cobrança.**

### Passo 3: [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]
A rotina de geração do adicional de telefonia baseia-se principalmente nos campos de integração, ramal e datas das ligações. Quando executada, a rotina identifica os ramais selecionados e as ligações tarifadas que possuem em seus respectivos históricos ([[registro de chamadas (cdr)|Registro de Chamadas (CDR)]]) e gera um serviço adicional no [[formulario contrato do cliente|Formulário Contrato do Cliente]]. Para efetuar este procedimento, 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.

Após gerar os serviços adicionais, poderá realizar a geração do financeiro e realizar a cobrança deste valor para o cliente.

### Considerações Importantes:
- As ligações são importadas a partir da configuração da [[tarefa - importar cdr tysa|Tarefa - Importar CDR Tysa]], trazendo o valor de venda preenchido após consumo excedente da franquia;
- Para realizar a cobrança correta, o sistema verifica o tipo da ligação que foi importada, valida o ID do ramal, o plano de cobrança vinculada ao ramal e a tarifa vinculada ao plano de cobrança. Assim, identifica a quantidade de segundos disponibilizados para a linha.

## Funcionalidades Principais
- Importação das ligações com o valor da venda (valor da tarifa importada);
- Automatização do processo de tarifação;
- Cobrança assertiva de excedentes;
- Visualização das ligações importadas em [[registro de chamadas (cdr)|Registro de Chamadas (CDR)]].

## Fluxo de Trabalho

```mermaid
flowchart TD
    A[Cadastro da integração com a plataforma Tysa] --> B[Cadastro do produto de telefonia fixa]
    B --> C[Cadastro do plano de cobrança]
    C --> D[Configuração de tarifação]
    D --> E[Ativação do ramal com o plano de cobrança relacionado]
    E --> F[Importação das ligações]
    F --> G{Há excedentes?}
    G -- Sim --> H[Importa as ligações com valor adicional]
    H --> I[Gera o adicional de telefonia]
    G -- Não --> J[Fim do processo]
```

## Considerações Finais
 A funcionalidade de tarifação para a integração Tysa otimiza a gestão e cobrança das ligações telefônicas de ramais cadastrados. Ao definir limites claros de uso e calcular cobranças adicionais para consumo excedente, ele garante precisão financeira e eficiência operacional, facilitando a administração do uso de telefonia pela empresa. Essa abordagem não só melhora a transparência nos custos, como também auxilia no controle orçamentário e na gestão eficiente dos recursos de telecomunicação. 

## Etiquetas
#Integracoes #IntegracoesVoIP #IntegracaoVoIPTysa #IntegracaoTysa #Tarifacao
## Leia Também
- [[integracoes|Integrações]]
- [[integracoes de telefonia fixa - voip|Integrações de Telefonia Fixa - VoIP]]
- [[integracao voip - tysa|Integração VoIP - Tysa]]
- [[plano de cobranca - voip|Plano de cobrança - VoIP]]
- [[tarifas - voip|Tarifas - VoIP]]
- [[como criar um plano de velocidade voip|Como criar um plano de velocidade VoIP]]
- [[geracao do adicional de telefonia - filtros voip|Geração do Adicional de Telefonia - Filtros VoIP]]
- [[geracao do financeiro recorrente|Geração do Financeiro Recorrente]]
- [[como configurar tarifacao - telefonia voip tysa|Como Configurar Tarifação - Telefonia VoIP Tysa]]