Roteiro: Criar plano comercial com franquias (allowances)¶
Perfil necessário: admin Menus usados: Comercial Risco: baixo (impacta faturamento de linhas novas vinculadas ao plano) Rollback: editar/desativar plano ou remover franquia; linhas já faturadas não retroagem
Pré-requisitos¶
- [ ] Definição comercial: nome, tipo de cobrança, franquias (minutos por tipo de chamada)
- [ ] Mapa de tarifas/tipos que o plano usará (buckets)
Passo a passo¶
1. Criar o plano¶
Caminho: Comercial → Planos
Clique: [Novo Plano]

Preencha (campos principais do dialog):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Nome | sim | PBX-Local-2000 |
identificação comercial |
| Descrição/observações | não | livre | detalhes do plano |
| Status/ativo | sim | booleano | disponibilidade para novas linhas |
Resultado esperado: plano listado; abrir para edição de franquias.
2. Adicionar franquia (allowance)¶
No detalhe do plano:
Clique: [Novo Allowance]
Preencha (conforme dialog de franquia):
| Campo | Obrig. | Formato/exemplo | Efeito |
|---|---|---|---|
| Tipo de chamada alvo | sim | LOC/LDN/MOV etc. | tráfego coberto pela franquia |
| Quantidade | sim | inteiro (minutos/unidades) | tamanho da franquia |
| Vigência/reset | conforme UI | mensal etc. | quando renova |
Resultado esperado: franquia listada no plano; repita por tipo de chamada coberto.
3. Vincular o plano às linhas¶
Caminho: Comercial → Linhas (ou detalhe do cliente)
Edite a linha e selecione o plano em Plano (faturamento):

Resultado esperado: linha usa o plano; consumo passa a ser medido contra as franquias.
4. Acompanhar consumo¶
Caminho: Comercial → Tarifação

Confira uso em tempo real por cliente/linha e ciclos fechados; consumption fora do esperado indica franquia mal dimensionada ou regra de tarifação divergente.
Validação¶
- [ ] Plano ativo com franquias por tipo de chamada
- [ ] Linha vinculada ao plano
- [ ] Tarifação reflete consumo contra a franquia correta
- [ ] CDR de chamada de teste tarifa conforme o plano
Erros comuns¶
| Sintoma | Causa provável | Correção |
|---|---|---|
| Consumo não abate franquia | tipo de chamada divergente (classificação) | conferir classificação real no Classifier |
| Linha nova sem plano default | plano inativo ou não vinculado | ativar plano e vincular na linha |
| Franquia estoura antes do fim do ciclo | dimensionamento/erro de tipo | revisar franquias por tipo |
Impacto operacional¶
- Plano é contrato: alterações afetam faturamento futuro (não retroativo).
- A combinação classificação × franquia define o abatimento; testes de classificação valem ouro aqui.