# Cadastro / Circuitos ### **Palavras-chave** circuitos, SIP, cadastro, contas, clientes, tarifação, faturas, DID, CDR ### **Resumo / Objetivo** A página **Circuitos** concentra a gestão das contas SIP vinculadas aos clientes do sistema. Cada circuito representa uma conta que será utilizada para tráfego de chamadas e tarifação, permitindo o acompanhamento detalhado de uso, faturamento e status operacional. A interface apresenta uma visão consolidada de todos os circuitos cadastrados, facilitando a administração e garantindo agilidade no acesso às principais ações. ### **Conteúdo** A página de **Circuitos** apresenta todos os circuitos cadastrados no sistema, exibindo informações essenciais para acompanhamento técnico e administrativo. [![image.png](https://manual.saperx.com.br/uploads/images/gallery/2025-08/scaled-1680-/MLE2UU49jqiKuq2U-image.png)](https://manual.saperx.com.br/uploads/images/gallery/2025-08/MLE2UU49jqiKuq2U-image.png) Abaixo, detalhamos todos os campos da interface: - **Circuito:** Número do circuito (conta SIP) para registro. - **Nome:** Nome de identificação do cliente vinculado ao circuito. - **Plano Nacional:** Indica o plano de tarifação aplicado ao circuito. - **Central:** Mostra em qual central (Core Server) o circuito está registrado. - **Saldo:** Exibe o saldo de ligações disponível. - Em planos pré pago: É o valor de saldo disponível para realizar ligações. - Em planos controle/pós pago: É o valor de saldo utilizado no completamento das ligações. - **IP:** Endereço IP da origem do registro. - **Status:** Exibe o status do circuito (online/offline) e a latência em milissegundos. #### **Saldo** A tela de **Histórico de Crédito** permite o gerenciamento do saldo dos circuitos configurados com plano de tarifação **pré-pago**. O saldo registrado será consumido conforme o cliente realiza ligações, garantindo que apenas chamadas com crédito disponível possam ser completadas. [![image.png](https://manual.saperx.com.br/uploads/images/gallery/2025-08/scaled-1680-/7ol3f6jnbGEWArCs-image.png)](https://manual.saperx.com.br/uploads/images/gallery/2025-08/7ol3f6jnbGEWArCs-image.png) O **campo de Saldo Atual** exibe o valor disponível no momento, servindo de referência para novas operações. Na área de **Ajuste de Saldo**, o administrador pode inserir valores em duas modalidades: - **Crédito** → valores positivos adicionados ao saldo, liberando recursos para o cliente realizar ligações. - **Débito** → valores negativos, que reduzem o saldo disponível ou podem até gerar saldo negativo. Todos os lançamentos ficam registrados na tabela de histórico, que apresenta: - **Data:** Data do cadastro do saldo. - **Saldo anterior ao crédito:** Valor do saldo no momento da operação. - **Valor creditado:** Valor creditado ou subtraído na operação. - **Observação:** Usuário que realizou a operação. Esse registro detalhado garante rastreabilidade e transparência em todas as movimentações de saldo realizadas nos circuitos. #### **Status SIP** A tela de **Status SIP** permite acompanhar o histórico de registros SIP de cada circuito nos últimos **30 dias**. Essa funcionalidade é essencial para monitorar a disponibilidade e rastrear a origem dos registros de um cliente. [![image.png](https://manual.saperx.com.br/uploads/images/gallery/2025-08/scaled-1680-/IsIuiitvDPzEl8zJ-image.png)](https://manual.saperx.com.br/uploads/images/gallery/2025-08/IsIuiitvDPzEl8zJ-image.png) Ao acessar um circuito, o sistema exibe informações detalhadas como: - **Data e hora do registro** – momento em que o circuito se autenticou na plataforma; - **Contact (IP de origem e porta)** – endereço utilizado para o registro, útil para identificar a rede de origem; - **User Agent** – software ou dispositivo utilizado para o registro (ex.: Asterisk, softphone, ATA, Telefone IP, etc); - **Último Online / Último Offline** – histórico de conectividade do circuito; - **Status atual** – indica se o circuito está *Online* ou *Offline*. Como a plataforma suporta múltiplos registros por circuito, caso o cliente utilize diferentes dispositivos (por exemplo, um softphone e um Telefone IP simultaneamente), todos os IPs e user agents são armazenados no histórico. ### **Configurações de circuito** A seguir estão descritas todos os parâmetros de configurações encontrados na edição de um circuito. Estes parâmetros definem configurações técnicas, de faturamento e permissões dos circuitos na plataforma. [![edição-circuito.png](https://manual.saperx.com.br/uploads/images/gallery/2025-08/scaled-1680-/Zpe3vJM2CQMSGjb0-edicao-circuito.png)](https://manual.saperx.com.br/uploads/images/gallery/2025-08/Zpe3vJM2CQMSGjb0-edicao-circuito.png) **Identificação de cliente** - **Criar Novo Cliente:** Quando habilitado, permite criar e um novo cliente e vincular o circuito direto da edição do circuito. - **Cliente:** Cliente ao qual o circuito está vinculado. **Configurações básicas** - **Status:** Define o status de operação do circuito. - Ativado - O circuito está em operação; - Bloqueio Parcial - O circuito está apto para receber chamadas porém não completa ligações. - Bloqueio Total - O circuito não recebe nem realiza ligações; - Cancelado - O circuito está fora de operação; - **Nome do Circuito:** Nome de identificação do cliente vinculado ao circuito. - **Circuito:** Número da conta SIP/IAX utilizada para registro do circuito. - **Senha:** Senha para registro do circuito. - **Plano de Discagem:** Rota personalizada que contém as regras de discagem utilizadas para complemento de chamadas. - **LC/LDN/LDI/VC1/VC2/VC3:** Permite habilitar ou desabilitar o completamento de chamadas e acordo com seu tipo. - **Bina:** Quando habilitado, encaminha o número de origem para o circuito de destino da ligação. - **CallerID-A:** quando habilitado, determina o tipo de tratamento será feito no número de A em ligações de **saída.** - Totalmente Aberto - A responsabilidade de encaminhar o número DID que deve binar no destino é do cliente. - DID; Piloto - Espera-se que o cliente envie um DID que esteja vinculado a este circuito. Caso contrário, a plataforma utilizará o menor número (Piloto) como número de A. - DID; Hangup - Espera-se que o cliente envie um DID que esteja vinculado a este circuito. Caso contrário, a plataforma desligará (Hangup) a chamada. - **ERP-ID Contrato:** Campo opcional para inserir o ID de identificação do cliente de um sistema ERP. - **Circuito Transbordo:** Permite transbordar a chamada para outro circuito de acordo com um determinado tipo de evento. - **Transbordar quando:** Eventos que definem quando um transbordo de circuito será aplicado. **Faturamento** - **Consumo mínimo:** Determina ao circuito um consumo mínimo. O valor definido neste campo será o valor total da fatura caso a soma do valor de ligações + valor da mensalidade seja menor. - **Dia de fechamento:** Define o dia de fechamento das faturas. - **Cobrança:** Tipo de cobrança que será aplicado ao circuito: - Pré-pago: O circuito necessita de um valor creditado no campo [**saldo**](#bkmrk-saldo) para completar ligações. - Pós-pago: O circuito poderá completar ligações à vontade, pagando o valor final após o fechamento da fatura. - Controle: O circuito poderá consumir em ligações apenas o valor cadastrado no campo **Valor Controle**. Se o circuito possuir um plano com franquia, o valor controle será utilizado somente após o consumo total da franquia. - **Limite Extra:** Determina ao circuito um valor extra para completamento de ligações após o consumo do valor controle. - **Layout Fatura:** Determina o layout da apresentação de informações da fatura. - STFC - Fatura no padrão exigido pela Anatel, contendo 02 casas decimais. Ideal para a telefonia do Brasil. - Atacado - Fatura com 05 casas decimais. Ideal para atendimento de grandes clientes de telefonia. - **Plano:** Determina o plano de tarifação das ligações do circuito. - **Plano Internacional:** Determina o plano de tarifação das ligações internacionais do circuito. - **Alerta de Saldo:** Quando habilitado, encaminha um e-mail de notificação após o circuito atingir determinado valor em ligações. - **Moeda:** Determina a moeda de cobrança das ligações. - **Arredondamento:** Efetua um arredondamento nos milissegundos da chamada para o segundo mais próximo. **Configuração Técnica** - **Protocolo:** Determina a tecnologia utilizada no circuito. - **Canais Simultâneos IN:** Determina a quantidade de canais suportados no circuito nas chamadas de entrada. - **Canais Simultâneos OUT:** Determina a quantidade de canais suportados no circuito nas chamadas de saída. - **Canais Simultâneos Total:** Determina a quantidade de canais suportados no circuito nas chamadas de entrada e saída. - **Contatos:** Quantidade de registros simultâneos permitidos ao circuito. - **DTMF:** Determina a tecnoligia DTMF utilizada na configuração do circuito. - **Forcar CLI:** Permite definir o valor do número de A nas ligações de saída. Quando configurado, sobrepõe qualquer função que define o número de A nas ligações de saída. - **CODEC:** Permite selecionar os CODECS padrão na configuração do circuito. - **Insecure:** Utilizado em configurações de apontamento IP to IP. A configuração isenta o circuito de informar usuário e senha nas sinalizações de INVITE. - **Range Liberada (ACL):** Define o endereço IP ou range de IPs permitidos para registro do circuito. - **IP/DNS Host:** Define o endereço IP de origem das sinalizações SIP. - **Port:** Porta de destino das sinalizações SIP onde o circuito está configurado. - **TechPrefix:** Utilizado nas chamadas de saída, o TechPrefix define uma TAG que deve ser informada antes do número de B em ligações de saída. - **Qualify:** Habilita a plataforma a realizar o monitoramento dos circuitos registrados. **Gestão Web** - **Senha Web:** Senha de acesso do painel de faturas do circuito. - **Habilitar ACB:** Permite ao cliente configurar o recebimento de chamadas ACB através do painel de faturas. - **Habilitar Blacklist:** Permite ao cliente inserir/remover números na blacklist através do painel de faturas. - **Habilitar Siga-me:** Permite ao cliente configurar a função de siga-me através do painel de faturas. #### **Filtros** Por padrão, a lista de circuitos apresenta apenas circuitos ativos na plataforma. A opção de filtros permite listar os circuitos bloqueados ou cancelados na plataforma. [![image.png](https://manual.saperx.com.br/uploads/images/gallery/2025-08/scaled-1680-/UrMEMLf60TP5bZLX-image.png)](https://manual.saperx.com.br/uploads/images/gallery/2025-08/UrMEMLf60TP5bZLX-image.png) #### **Configurar Fatura** As opções de configurar fatura permitem selecionar os campos que serão apresentados na fatura dos clientes. --- ## **FAQ – Perguntas frequentes** **1. Qual a diferença entre os tipos de status do circuito?** - **Ativado**: Circuito em operação, apto a originar e receber chamadas. - **Bloqueio Parcial**: Apenas recebe chamadas, não pode originar. - **Bloqueio Total**: Não recebe nem origina chamadas. - **Cancelado**: Circuito fora de operação, sem uso. **2. Como funciona o saldo em diferentes tipos de cobrança?** - **Pré-pago**: É necessário crédito disponível no saldo para completar chamadas. - **Pós-pago**: As chamadas são completadas livremente, sendo cobradas na fatura no fechamento. - **Controle**: O circuito consome apenas o valor definido no campo **Valor Controle**. Caso tenha franquia, o controle é aplicado após o consumo total da franquia. **3. O que acontece se o circuito atingir o limite de canais simultâneos configurados?** Chamadas adicionais não serão completadas. **4. Qual a função do “Consumo Mínimo”?** Garante uma fatura mínima. Se o consumo total + mensalidade for inferior ao consumo mínimo configurado, a fatura será emitida pelo valor do consumo mínimo. **5. Quando usar STFC e quando usar Atacado no layout de fatura?** - **STFC**: Formato exigido pela Anatel, com duas casas decimais (uso comum no Brasil). - **Atacado**: Fatura com até cinco casas decimais, voltada para clientes de atacado e operadoras. **6. O que é o CallerID-A e quais são os modos disponíveis?** Define como o número de origem (A) será tratado em chamadas de saída: - **Totalmente Aberto**: O cliente define qual número será exibido. - **DID; Piloto**: Exige que o cliente envie um DID válido. Caso contrário, a plataforma utiliza o menor número (Piloto). - **DID; Hangup**: Exige um DID válido. Caso contrário, a chamada é encerrada automaticamente. **7. Qual a diferença entre Canais IN, OUT e Total?** - **IN**: Limite de canais para chamadas de entrada. - **OUT**: Limite de canais para chamadas de saída. - **Total**: Soma de canais de entrada e saída permitidos. **8. Para que serve o campo “Circuito Transbordo”?** Permite redirecionar chamadas para outro circuito em casos específicos (ex.: ocupado, offline, congestionado). **9. O que significa a opção Forçar CLI?** Define manualmente o número de origem (A) em chamadas de saída, sobrepondo qualquer configuração enviada pelo cliente. **10. Como funciona o Histórico de Crédito?** Mostra todas as movimentações de saldo do circuito, incluindo créditos e débitos. Cada lançamento registra: data, saldo anterior, valor creditado/debitado e o usuário responsável. **11. O que é o Status SIP e qual sua utilidade?** Apresenta o histórico de registros SIP do circuito nos últimos 30 dias. Útil para: - Identificar IPs de origem e portas utilizadas. - Rastrear User Agents (softphone, ATA, PABX, etc.). - Acompanhar disponibilidade (último online/offline). **12. O que acontece se eu habilitar “Habilitar Blacklist”, “Siga-me” ou “ACB”?** Essas opções permitem ao cliente final **autogerenciar** essas funções diretamente no painel de faturas: - **Blacklist**: Bloqueio de números indesejados. - **Siga-me**: Desvio de chamadas para outro destino. - **ACB**: Aceitar chamadas a cobrar. **13. Como funcionam os filtros da página de Circuitos?** Por padrão, são exibidos apenas circuitos ativos. O filtro permite visualizar também circuitos bloqueados ou cancelados.