# Cadastro / Revendas ### **Palavras-chave** revendas, whitelabel, cadastro, gestão, clientes, circuitos, DID, faturas, API ### **Resumo / Objetivo** A página **Revendas** permite a gestão de clientes que utilizam o software no modelo **whitelabel**, oferecendo a eles um acesso exclusivo e simplificado para administrar seus próprios circuitos, DIDs e faturas. Diferente do painel principal, as revendas não possuem todos os campos de configuração disponíveis, garantindo controle centralizado pela plataforma e maior segurança. ### **Conteúdo** A tela inicial de **Revendas** apresenta a lista de todas as revendas cadastradas, exibindo informações essenciais para acompanhamento: [![image.png](https://manual.saperx.com.br/uploads/images/gallery/2025-08/scaled-1680-/iDlFQdYO4gU2G2j6-image.png)](https://manual.saperx.com.br/uploads/images/gallery/2025-08/iDlFQdYO4gU2G2j6-image.png) - **ID**: Identificador único da revenda no sistema. - **Nome**: Nome de identificação da revenda. - **Usuário**: Login utilizado para acesso ao painel whitelabel. - **Saldo**: Valor de crédito disponível para a revenda. - **Data Criação**: Data e hora em que a revenda foi cadastrada. - **Ativo**: Indica se a revenda está habilitada para uso. - **API**: Exibe ou gera credenciais de integração da revenda. - **DID**: Acesso à tela de gerenciamento de DIDs vinculados à revenda. - **Fatura**: Consulta das faturas emitidas para a revenda. - **Acessar Revenda**: Abre o painel exclusivo da revenda, no modo whitelabel, com permissões limitadas. #### **API** A tela de c**onfigurar API** permite gerar e gerenciar as credenciais utilizadas pela revenda para integrar sistemas externos via **API do produto**. Essas credenciais garantem segurança e controle sobre as requisições realizadas, permitindo automação de processos como criação de circuitos, consulta de faturas, gerenciamento de DIDs, entre outros. - **Nome:** Identificação do usuário responsável pelo acesso API da revenda. - **E-mail:** Endereço de e-mail vinculado às credenciais de acesso API. - **Senha:** Senha utilizada para autenticação inicial da API. - **IP Liberado:** Endereço(s) IP autorizado(s) a realizar chamadas para a API. - **Client ID:** Identificador único da aplicação cliente que acessará a API. - **Client Secret:** Chave secreta associada ao **Client ID**, usada para validar a identidade da aplicação. #### **DID** A página de **DIDs da Revenda** permite ao administrador visualizar e gerenciar os números disponíveis para cada revenda. Nesta tela é possível identificar quais DIDs estão vinculados a circuitos, quais permanecem livres para uso e quais configurações estão associadas a cada número. - **Circuito**: Circuito da revenda ao qual o DID está vinculado. - **Número**: Número do DID cadastrado na revenda. - **Cidade**: Mostra a localidade de origem do número (Cidade/Estado). - **Modificado em**: Data e hora da última alteração realizada no DID. - **Aceita ACB**: Informa se o número aceita chamadas a cobrar. - **Enviar DID**: Define a quantidade de dígitos encaminhados ao destino nas chamadas de entrada. - **Siga-me**: Indica se o recurso de desvio de chamadas (siga-me) está habilitado. - **Mensalidade**: Valor mensal associado ao número. #### **Faturas** A página de **Faturas da Revenda** apresenta em detalhes todas as chamadas realizadas pelos circuitos vinculados à revenda. Essa tela é essencial para o controle financeiro e para a conferência de consumo, permitindo ao administrador e ao revendedor acompanhar de forma transparente os custos gerados. No topo da tela, são exibidos indicadores agregados: - **Circuitos:** Quantidade de circuitos ativos na revenda. - **DIDs:** Total de números vinculados à revenda. - **Tempo Total:** Soma do tempo de todas as chamadas. - **Tempo Total Tarifado:** Tempo efetivamente contabilizado para cobrança. - **Valor DID:** Total referente às mensalidades dos DIDs associados. - **Valor Ligações:** Valor acumulado das chamadas realizadas. - **Valor Total:** Soma entre mensalidades de DIDs e chamadas tarifadas. Cada linha da tabela representa uma chamada realizada, com os seguintes campos: - **Mês Referência:** Competência à qual a chamada pertence. - **Data:** Data e hora da chamada. - **Origem:** Número de origem da chamada. - **Destino:** Número discado. - **Tempo Total:** Duração completa da chamada (incluindo ring). - **Tempo Real:** Tempo efetivo da chamada. - **Tempo Tarifado:** Duração considerada para tarifação. - **Tipo:** Classificação da ligação (local, longa distância, celular, internacional etc.). - **Localidade:** Indicação do destino da chamada. - **Valor:** Custo da chamada específica. #### **Acessar Revenda** Ao clicar neste botão, o administrador será direcionado para a plataforma do cliente revendedor. Através desta, ele poderá gerenciar e realizar configurações em todas as funcionalidades disponíveis ao cliente revendedor. --- ## **FAQ - Perguntas Frequentes** **1. O que é uma revenda dentro da plataforma?** É um cliente que utiliza o sistema no modelo whitelabel, com painel próprio para gerenciar seus circuitos, DIDs e faturas. **2. Como funciona o saldo da revenda?** O saldo representa os créditos disponíveis para consumo em chamadas. No modelo pré-pago, a revenda deve manter saldo positivo para permitir tráfego de ligações de seus clientes. **3. Quais as diferenças de configuração entre o painel principal e o painel da revenda?** O painel principal possui configurações avançadas de circuito, tarifação, codecs, ACL, planos, etc. Já o painel da revenda possui apenas funções básicas, focadas em gestão de circuitos e faturamento. **4. Posso criar circuitos diretamente dentro da revenda?** Sim. Cada revenda pode cadastrar seus próprios circuitos, dentro das permissões liberadas pelo administrador principal.