Gestão de Serviços

A interface de Gestão de Serviços fornece ferramentas abrangentes para visualizar, filtrar e gerenciar serviços de clientes em toda a sua organização.

Documentação relacionada: Adicionando Serviços <csa_add_service>, Uso de Serviços <csa_service_usage>, Modificando Serviços <csa_modify>, Produtos e Serviços <concepts_products_and_services>.

Acessando a Lista de Serviços

Navegue para:

Ou diretamente:

Isso exibe todos os serviços com capacidades de filtragem, ordenação e gerenciamento em massa.

Visão Geral da Lista de Serviços

A lista de serviços exibe serviços em uma tabela com:

Colunas:

• ID do Serviço - Identificador único
• Nome do Serviço - Nome descritivo (ex.: "Móvel - +44 7700 900123")
• Nome do Cliente - Cliente associado (link clicável)
• Tipo de Serviço - móvel, iptv, internet, voip
• Status - Ativo, Inativo, Suspenso
• Data de Início - Quando o serviço começou
• Data de Término - Quando o serviço expira/termina
• Custo Mensal - Preço de varejo
• Ações - Visualizar, Editar, Adicionais, Uso, Excluir

Filtrando Serviços

Abas de Status

Filtre rapidamente os serviços por status usando a barra de abas:

• Todos os Resultados - Mostra todos os serviços, independentemente do status
• Ativos - Serviços atualmente ativos (visualização padrão)
• Inativos - Serviços cancelados ou expirados
• Suspensos - Serviços temporariamente desativados (não pagamento, fraude, etc.)

Clicar em uma aba atualiza a lista instantaneamente. A aba ativa é destacada.

Filtro por Tipo de Serviço

Filtre por tipo de serviço:

Selecione um ou vários tipos para mostrar apenas os serviços correspondentes.

Casos de Uso:

• Móvel - Visualizar todos os serviços de SIM móvel
• Internet - Mostrar fibra, DSL e wireless fixo
• IPTV - Exibir serviços de assinatura de TV
• VoIP - Listar serviços de voz sobre IP

Filtro por Cliente

Pesquise e filtre por cliente:

Comece a digitar o nome de um cliente para ver os resultados correspondentes:

Selecione um cliente para mostrar apenas seus serviços.

Caso de Uso: Visualizar rapidamente todos os serviços de um cliente específico.

Pesquisa

Pesquisa global em todos os campos de serviço:

Pesquisa:

• Nome do serviço
• ID do serviço
• Nome do cliente
• Números de telefone (para serviços móveis)
• UUID do serviço

Exemplo: Pesquise "0770" para encontrar todos os serviços com números de telefone contendo "0770".

Ordenando Serviços

Clique em qualquer cabeçalho de coluna para ordenar por esse campo:

Colunas Ordenáveis:

• ID do Serviço (padrão: mais recente primeiro)
• Nome do Serviço (alfabético)
• Nome do Cliente (alfabético)
• Tipo de Serviço (alfabético)
• Data de Início (cronológico)
• Data de Término (cronológico)
• Custo Mensal (numérico)

Direção da Ordenação:

• Clique uma vez: Ascendente (A-Z, mais antigo-mais recente, mais baixo-mais alto)
• Clique duas vezes: Descendente (Z-A, mais recente-mais antigo, mais alto-mais baixo)
• A coluna de ordenação ativa mostra o indicador ▲ ou ▼

Dropdown de Ordenação:

O dropdown no canto superior direito fornece predefinições de ordenação rápida:

Visualizando Detalhes do Serviço

Clique em qualquer nome de serviço para abrir a visualização detalhada do serviço.

Abas de Detalhes do Serviço:

1. Visão Geral - Resumo do serviço, status, datas, preços
2. Inventário - Equipamentos atribuídos (cartões SIM, modems, etc.)
3. Transações - Cobranças, créditos, pagamentos
4. Uso - Estatísticas de uso de dados/voz/SMS
5. Adicionais - Adicionais ativos e disponíveis
6. Registro de Atividades - Histórico de alterações

Ações Rápidas

Na lista de serviços, clique no menu de ações (⋮) para operações rápidas:

• Visualizar - Abre os detalhes do serviço
• Editar - Modificar parâmetros do serviço
• Adicionais - Navegar e adicionar melhorias ao serviço
• Uso - Ver uso atual e saldo
• Excluir - Cancelar/remover serviço

Operações em Massa

Selecione vários serviços usando caixas de seleção para realizar ações em massa.

Selecionando Serviços

Seleção Individual:

Clique na caixa de seleção ao lado de cada serviço que deseja selecionar.

Selecionar Todos:

Clique na caixa de seleção no cabeçalho da tabela para selecionar todos os serviços visíveis.

☑ Serviço 1 ☑ Serviço 2 ☑ Serviço 3

Contador de Seleção:

A interface mostra quantos serviços estão selecionados:

Ações em Massa

Uma vez que os serviços estão selecionados, os botões de ação em massa aparecem:

Excluir Múltiplos Serviços:

1. Selecione os serviços a serem excluídos
2. Clique no botão "Excluir Selecionados"
3. Confirme a exclusão no modal

Aviso

A exclusão em massa é permanente e irá:

• Cancelar todos os serviços selecionados
• Marcar o inventário como não atribuído
• Parar todas as cobranças recorrentes
• Criar entradas no registro de atividades

Casos de Uso:

• Limpar serviços de teste
• Cancelar serviços para contas de clientes encerradas
• Remover entradas duplicadas ou errôneas

Melhor Prática: Use filtros para restringir a lista antes das operações em massa para evitar exclusões acidentais.

Gestão de Status do Serviço

Tipos de Status

Os serviços podem ter três status:

Ativo

• O serviço está operacional
• Cobranças se aplicam
• O cliente pode usar o serviço
• Exibido com um distintivo verde

Inativo

• O serviço foi cancelado ou expirou
• Nenhuma cobrança aplicada
• O cliente não pode usar o serviço
• Exibido com um distintivo cinza
• Inventário marcado para retorno/refurbishment

Suspenso

• Serviço temporariamente desativado
• Pode ou não cobrar (configurável)
• O cliente não pode usar o serviço
• Exibido com um distintivo laranja/amarelo
• Motivos comuns: Não pagamento, investigação de fraude, solicitação do cliente

Mudando o Status do Serviço

Para mudar o status de um serviço:

1. Abra os detalhes do serviço
2. Clique no botão "Editar"
3. Mude o dropdown "Status do Serviço"
4. Clique em "Salvar"

O que Acontece:

• Ativo → Inativo: Aciona o playbook de desprovisionamento (se configurado)
• Ativo → Suspenso: Desativa o serviço na OCS/rede, mas mantém registro
• Suspenso → Ativo: Reativa o serviço, retoma a cobrança
• Inativo → Ativo: Pode acionar o re-provisionamento (use com cautela)

Visualização do Uso do Serviço

Clique em "Uso" no menu de ações para abrir o modal de uso.

Informações Exibidas:

• Saldo - Crédito restante ou valor pré-pago
• Uso de Dados - Usado vs. alocado (barra de progresso)
• Uso de Voz - Minutos usados vs. limite do plano
• Uso de SMS - Mensagens enviadas vs. limite
• Data de Expiração - Quando o saldo/plano atual expira

Ações:

• Recarregar - Adicionar crédito ou dados (para serviços pré-pagos)
• Ver Detalhes - Ver detalhamento do uso
• Exportar - Baixar relatório de uso (se disponível)

Próximos Auto-Renovações

A visualização de Próximas Auto-Renovações fornece uma interface centralizada para monitorar e gerenciar todas as renovações de serviços agendadas em sua organização.

Acessando Auto-Renovações

Navegue para:

Ou diretamente:

Isso exibe todos os serviços com renovação automática agendada, ordenados pela próxima data de renovação.

Visão Geral das Auto-Renovações

A lista de auto-renovações exibe renovações agendadas em uma tabela com:

Colunas:

• Cliente - Nome do cliente (link clicável para a visão geral do cliente)
• Serviço - Nome do serviço (link clicável para a visão geral do cliente)
• Produto - Nome do produto/plano sendo renovado
• Custo - Custo da renovação (do preço de varejo do produto)
• Renova em - Data e hora da próxima renovação com formato legível por humanos
• Status - Status do serviço (Ativo, Suspenso, etc.)
• Ações - Renovar agora ou remover a auto-renovação

Exemplo de Exibição:

Como Funciona a Auto-Renovação

A auto-renovação é agendada no CGRateS (o sistema de faturamento) quando um serviço é criado ou modificado. O sistema:

1. Agenda Ação - Cria um ActionPlan no CGRateS com a data de renovação
2. Monitora Saldo - Verifica se o cliente tem saldo suficiente antes da renovação
3. Executa Renovação - Na data agendada, renova automaticamente o serviço
4. Atualiza Registros - Cria transações, atualiza datas de serviço, e registra atividades

Fonte de Dados:

A visualização de Próximas Auto-Renovações consulta o CGRateS diretamente usando a ApierV1.GetScheduledActions API e enriquece os dados com informações de cliente e serviço do banco de dados CRM.

Renovar Agora

Para acionar manualmente uma renovação antes da data agendada:

1. Clique no botão 🔄 (Renovar Agora) para o serviço

2. Revise os detalhes da renovação no modal de confirmação:

   Cliente: Acme Corp Serviço: FixedWireless_75628fa5 Produto: Internet Residencial Mega Custo: $89.99

   Próxima renovação agendada: 11 de Nov, 2025 10:45 AM

   [Cancelar] [Confirmar Renovação]

3. Clique em "Confirmar Renovação" para processar imediatamente

4. Um trabalho de provisionamento é criado e executado

5. Monitore o progresso no modal de status de provisionamento

O que Acontece:

• O serviço é recarregado com as alocações do produto
• O saldo é atualizado no CGRateS
• Um registro de transação é criado
• A data de término do serviço é estendida
• Uma entrada no registro de atividades é criada

Casos de Uso:

• O cliente solicita renovação antecipada
• Resolver problemas de serviço redefinindo alocações
• Testar processos de renovação
• O cliente deseja usar o serviço antes da renovação agendada

Remover Auto-Renovação

Para cancelar a renovação automática de um serviço:

1. Clique no botão 🗑️ (Remover Auto-Renovação) para o serviço

2. Confirme a exclusão no modal:

   Isso removerá a auto-renovação agendada para:

   Cliente: Acme Corp Serviço: FixedWireless_75628fa5 Próxima Renovação: 11 de Nov, 2025 10:45 AM

   O serviço não será renovado automaticamente. Você precisará renovar manualmente ou o serviço expirará na data de término.

   [Cancelar] [Remover Auto-Renovação]

3. Clique em "Remover Auto-Renovação" para confirmar

4. O ActionPlan é removido do CGRateS

5. O serviço expirará naturalmente, a menos que renovado manualmente

O que Acontece:

• O ActionPlan é excluído do CGRateS
• O status do serviço permanece inalterado
• O serviço expirará na sua data de término atual
• O cliente deve renovar manualmente ou o serviço será interrompido

Casos de Uso:

• O cliente está cancelando o serviço
• Mudando para o processo de renovação manual
• O plano de serviço está mudando
• O cliente solicitou parar as cobranças automáticas

Aviso

Remover a auto-renovação significa que o serviço expirará a menos que seja renovado manualmente. Os clientes não receberão a continuidade automática do serviço.

Entendendo a Exibição

Coluna Cliente:

• Mostra o nome do cliente como um link clicável
• Links para a página de visão geral do cliente
• Mostra "N/A" se o serviço não estiver vinculado a um cliente (serviço órfão)

Coluna Serviço:

• Mostra o nome/UUID do serviço
• Links para a página de visão geral do cliente
• Mostra o UUID do serviço se o nome não estiver definido
• Mostra "N/A" se o serviço não puder ser encontrado no banco de dados

Coluna Produto:

• Nome do produto do ActionPlan do CGRateS
• Extraído dos metadados da ação agendada
• Sempre mostra o nome do produto, mesmo que o serviço não seja encontrado

Coluna Custo:

• Custo de varejo da tabela de Produtos no CRM
• Valor que será cobrado na renovação
• Mostra "N/A" se o produto não for encontrado no banco de dados

Coluna Renova em:

• Data e hora exatas da próxima renovação
• Tempo relativo legível por humanos (ex.: "3 horas a partir de agora", "2 dias a partir de agora")
• Consciente do fuso horário (usa o fuso horário do servidor CGRateS)

Coluna Status:

• Status atual do serviço do banco de dados CRM
• Ativo (Verde) - O serviço está operacional
• Suspenso (Laranja) - O serviço está temporariamente desativado
• Desconhecido (Cinza) - Serviço não encontrado no banco de dados ou status não definido

Resolução de Problemas

Serviços mostrando "N/A" para Cliente/Serviço

• Causa: UUID do serviço no CGRateS não corresponde ao service_uuid no banco de dados CRM
• Correção:
  • Verifique se o serviço existe no banco de dados
  • Verifique se o formato do service_uuid corresponde: ServiceType_UUID (ex.: FixedWireless_75628fa5)
  • O serviço pode ter sido excluído do CRM, mas ainda está agendado no CGRateS

Custo mostrando "N/A"

• Causa: ID do produto no CGRateS não existe na tabela de Produtos do CRM
• Correção:
  • Verifique se o produto existe no banco de dados
  • Verifique se o product_id no ActionPlan corresponde a um produto no CRM
  • O produto pode ter sido excluído

"Renova em" não mostrando data

• Causa: NextRunTime não presente na resposta do CGRateS
• Correção:
  • Verifique a configuração do ActionPlan do CGRateS
  • Verifique se o ActionTiming está configurado corretamente
  • Verifique os logs do CGRateS para erros

"Renovar Agora" falha

• Causa: Vários erros de provisionamento
• Resolução de Problemas:
  • Verifique o modal de status de provisionamento para detalhes do erro
  • Verifique se os playbooks do Ansible estão configurados corretamente
  • Verifique a conectividade com a OCS
  • Revise os logs de provisionamento

Auto-renovação removida, mas ainda mostrando

• Causa: Atraso no cache ou problema de sincronização do CGRateS
• Correção:
  • Clique no botão "Atualizar" para recarregar os dados
  • Verifique se o ActionPlan foi realmente removido no CGRateS
  • Verifique a conectividade da API do CGRateS

Paginação

Os serviços são exibidos em páginas para desempenho:

◄ Anterior 1 [2] 3 4 5 Próximo ►

Itens por página: [10 ▼]

• 10
• 25
• 50
• 100

Controles:

• Anterior/Próximo - Navegar entre páginas
• Números de Página - Ir para uma página específica
• Itens por Página - Ajustar quantos serviços aparecem por página

Dica de Desempenho: Use filtros para reduzir o total de resultados em vez de aumentar itens por página.

Distintivos e Indicadores de Serviço

Indicadores visuais ajudam a identificar rapidamente os estados dos serviços:

Distintivos de Status:

Indicador de Auto-Renovação:

Serviços com auto-renovação habilitada mostram:

Expirando em Breve:

Serviços que expiram dentro de 7 dias mostram:

Atrasado:

Serviços com saldo pendente mostram:

Integração CGRateS (Avançado)

Para serviços integrados com CGRateS (o motor de faturamento e tarifação), administradores podem gerenciar configurações avançadas diretamente da visualização do serviço. Isso inclui atributos, filtros e visualização de sessões ativas.

Nota

Os recursos de integração do CGRateS requerem a permissão cgrates_api_access. Apenas administradores têm acesso a esses recursos por padrão. Consulte rbac para configuração de permissões.

Provisionamento Automático vs. Gestão Manual

Na operação normal, atributos e filtros do CGRateS são provisionados automaticamente pelo Ansible durante o fluxo de trabalho de provisionamento inicial do serviço. Quando um novo serviço é criado, os playbooks de provisionamento:

• Criam a conta de serviço no CGRateS
• Configuram atributos (IMSI, MSISDN, identificadores de conta, perfis de velocidade, etc.)
• Configuram filtros para garantir a tarifação correta
• Aplicam os planos de tarifação apropriados

No entanto, há casos em que você pode precisar modificar essas configurações após o serviço ter sido provisionado:

• Mudanças no Perfil de Velocidade - O cliente atualiza/diminui a largura de banda (MaxBitrateDL/UL)
• Ajustes de Políticas - Mudar políticas de QoS ou regras de modelagem de tráfego (PcefPolicyName)
• Mudanças de Número de Telefone - Atualizar MSISDN ou outros identificadores
• Resolução de Problemas - Corrigir configurações erradas ou testar diferentes configurações
• Configurações Especiais - Aplicar atributos personalizados que não fazem parte do provisionamento padrão

A interface de gestão manual permite que os administradores façam essas mudanças diretamente sem reexecutar todo o fluxo de trabalho de provisionamento. Isso é particularmente útil para:

• Mudanças Rápidas - Modificar um único atributo sem esperar pelo provisionamento
• Testes - Experimentar com diferentes configurações
• Suporte ao Cliente - Resolver problemas rapidamente durante chamadas de suporte
• Configurações Personalizadas - Aplicar configurações específicas do serviço que não estão cobertas por templates

Aviso

Mudanças manuais na configuração do CGRateS ignoram o fluxo de trabalho padrão de provisionamento. Certifique-se de entender o impacto de suas mudanças, pois configurações incorretas podem afetar a faturamento e a funcionalidade do serviço. Todas as mudanças são registradas no feed de atividades do cliente para fins de auditoria.

Acessando Recursos do CGRateS

Ao visualizar ou editar um serviço que está provisionado no CGRateS, três seções colapsáveis aparecem na parte inferior do formulário do serviço:

• Atributos do CGRateS - Configurar atributos específicos do serviço
• Filtros do CGRateS - Definir regras de filtragem para o serviço
• Sessões Ativas - Visualizar sessões ativas em tempo real

Cada seção é colapsada por padrão para manter a interface limpa. Clique no cabeçalho da seção para expandir e visualizar/editar a configuração.

As seções colapsadas mostram distintivos de contagem indicando quantos atributos, filtros ou sessões ativas existem para o serviço.

Atributos do CGRateS

Atributos permitem que você defina campos personalizados e transformações que são aplicadas a eventos de tarifação para este serviço específico.

Formato do ID do Atributo: ATTR_ACCOUNT_{service_uuid}

Exemplo: Para o serviço com UUID Mobile_SIM_c2880638, o ID do perfil de atributo é ATTR_ACCOUNT_Mobile_SIM_c2880638

Gerenciando Atributos:

1. Abra a visualização de edição do serviço
2. Expanda a seção "Atributos do CGRateS"
3. Clique no botão "Editar Atributos"
4. Adicione/modifique/remova atributos conforme necessário
5. Clique em "Salvar Atributos"

Campos de Atributo:

• Caminho - O campo a ser modificado (ex.: *req.Account, *req.IMSI)
• Tipo - Como o valor é definido:
  • *constant - Define um valor fixo
  • *variable - Captura valor de campos de eventos usando RSRParser
  • *composed - Anexa valor em vez de sobrescrever
  • *usage_difference - Calcula a duração entre dois campos
  • *sum - Soma múltiplos valores
  • *value_exponent - Computa o expoente de um campo
• Regras - O(s) valor(es) a serem aplicados (pode ter várias regras por atributo)

Exemplo de Configuração de Atributo:

{
  "Path": "*req.Account",
  "Type": "*constant",
  "Value": [{"Rules": "Mobile_SIM_474a380a"}]
}

Casos de Uso Comuns:

• Definir identificador de conta para tarifação
• Mapear IMSI/MSISDN para o serviço
• Configurar limites de largura de banda (MaxBitrateDL/UL)
• Definir nomes de políticas (PcefPolicyName)
• Transformar ou enriquecer eventos de tarifação

Registro de Atividades:

Todas as modificações de atributos são registradas no feed de atividades do cliente com todos os detalhes das mudanças feitas.

Filtros do CGRateS

Filtros definem regras de correspondência que determinam quando a configuração deste serviço deve ser aplicada durante a tarifação.

Formato do ID do Filtro: FLTR_ACCOUNT_{service_uuid}

Exemplo: Para o serviço com UUID Mobile_SIM_c2880638, o ID do filtro é FLTR_ACCOUNT_Mobile_SIM_c2880638

Gerenciando Filtros:

1. Abra a visualização de edição do serviço
2. Expanda a seção "Filtros do CGRateS"
3. Clique no botão "Editar Filtros"
4. Adicione/modifique/remova regras de filtro
5. Clique em "Salvar Filtros"

Campos de Regra de Filtro:

• Elemento - O campo a ser correspondido (ex.: ~*req.Account, ~*req.Destination)
• Tipo - Tipo de correspondência:
  • *string - Correspondência exata de string
  • *prefix - Começa com o valor especificado
  • *suffix - Termina com o valor especificado
  • *empty - Campo está vazio
  • *exists - Campo existe
  • *notexists - Campo não existe
  • *timings - Correspondência de padrões de tempo/data
  • *destinations - Correspondência de padrões de destino
  • *rsr - Correspondência de campo RSR
  • *gt / *gte / *lt / *lte - Comparações numéricas
• Valores - O(s) valor(es) a serem correspondidos (pode ter múltiplos valores por regra)

Exemplo de Configuração de Filtro:

{
  "Element": "~*req.Account",
  "Type": "*string",
  "Values": ["Mobile_SIM_474a380a"]
}

Casos de Uso Comuns:

• Garantir que atributos se apliquem apenas a contas específicas
• Filtrar por destino (nacional vs. internacional)
• Filtragem baseada em tempo (horário de pico vs. fora de pico)
• Filtrar por tipo ou categoria de serviço

Registro de Atividades:

Todas as modificações de filtros são registradas no feed de atividades do cliente.

Sessões Ativas

Visualize sessões ativas em tempo real para este serviço. Isso mostra chamadas em andamento, sessões de dados ou outros eventos faturáveis atualmente em progresso.

Visualizando Sessões Ativas:

1. Abra a visualização de edição do serviço
2. Expanda a seção "Sessões Ativas"
3. Veja a lista de sessões ativas
4. Clique em "Ver Detalhes" em qualquer sessão para ver os dados completos da sessão
5. Clique em "Atualizar" para recarregar a lista de sessões

Informações da Sessão Exibidas:

• Hora de Configuração - Quando a sessão começou
• Uso - Duração atual da sessão (em segundos)
• Destino - Número chamado ou destino

Modal de Detalhes da Sessão:

Clicar em "Ver Detalhes" abre um modal mostrando:

• Informações Básicas:
  • CGRID (ID da sessão)
  • Conta (UUID do serviço)
  • Hora de configuração
  • Uso/duração atual
  • Destino
  • Categoria
• Dados Completos da Sessão:
  • Representação JSON completa da sessão
  • Todos os campos da sessão do CGRateS
  • Estado da sessão em tempo real
  • Visualizador JSON rolável para inspeção

Casos de Uso:

• Monitorar chamadas ativas ou sessões de dados
• Resolver problemas de faturamento
• Verificar se a sessão está sendo tarifada corretamente
• Verificar atributos e valores da sessão
• Auditar o uso ativo do serviço

Taxa de Atualização:

As sessões são buscadas sob demanda quando você expande a seção. Clique em "Atualizar" para obter os dados mais recentes da sessão.

Nota

Apenas sessões correspondentes à conta deste serviço (UUID do serviço) são exibidas. O filtro *string:~*req.Account:{service_uuid} é aplicado automaticamente.

Proxy da API do CGRateS

Todas as operações do CGRateS (atributos, filtros, sessões) usam o endpoint da API proxy do OmniCRM:

Endpoint: POST /crm/ocs/proxy

Campos Obrigatórios:

• method - Método da API do CGRateS (ex.: APIerSv1.GetAttributeProfile)
• params - Array de parâmetros para o método
• customer_id - ID do cliente (para registro de atividades)
• service_id - ID do serviço (para registro de atividades)

Campos Opcionais:

• tenant - Inquilino do CGRateS (padrão para valor de configuração)

Exemplo de Requisição:

{
  "method": "APIerSv1.GetAttributeProfile",
  "params": [{"ID": "ATTR_ACCOUNT_Mobile_SIM_c2880638"}],
  "customer_id": 123,
  "service_id": 456
}

Configuração do Inquilino:

O inquilino é definido automaticamente a partir do arquivo de configuração do OmniCRM (crm_config.yaml) sob ocs.ocsTenant. Isso garante que todas as operações do CGRateS usem o inquilino correto sem codificar valores no frontend.

Requisito de Permissão:

A permissão cgrates_api_access é necessária. Esta permissão é concedida ao papel admin por padrão.

Registro de Atividades:

Todas as operações da API do CGRateS que não são GET são registradas automaticamente no feed de atividades do cliente, incluindo:

• Método da API chamado
• Inquilino usado
• Todos os parâmetros enviados
• ID do serviço em que a operação foi realizada
• Usuário que realizou a operação
• Timestamp

Isso cria uma trilha de auditoria completa de todas as mudanças de configuração do CGRateS.

Resolução de Problemas da Integração do CGRateS

"Permissão Negada" ao acessar recursos do CGRateS

• Causa: O usuário não possui a permissão cgrates_api_access
• Correção: Conceda permissão ao papel do usuário (normalmente recurso apenas para administradores)

Atributos ou Filtros não carregando

• Causa: Problema de conectividade do CGRateS ou perfil não existe
• Correção:
  • Verifique a conectividade do servidor CGRateS na configuração
  • Verifique se a configuração do inquilino está correta
  • Verifique o console do navegador para erros da API
  • O perfil pode não existir ainda (mostrará formulário vazio)

Mudanças não salvando

• Causa: Erro de validação ou erro da API do CGRateS
• Correção:
  • Verifique se os campos obrigatórios (Caminho, Tipo, Elemento) estão preenchidos
  • Verifique se o formato JSON está correto
  • Verifique o registro de atividades para detalhes do erro
  • Revise os logs do CGRateS

Nenhuma sessão ativa sendo exibida

• Causa: Nenhuma sessão atualmente ativa para este serviço
• Correção:
  • Isso é normal se o serviço não estiver em uso
  • Tente atualizar após iniciar uma sessão (chamada, dados, etc.)
  • Verifique se o UUID do serviço corresponde à conta no CGRateS

Detalhes da sessão não atualizando em tempo real

• Causa: Os dados da sessão são buscados sob demanda, não ao vivo
• Correção: Clique no botão "Atualizar" para obter os dados mais recentes da sessão

Registro de atividades não mostrando mudanças do CGRateS

• Causa: Apenas operações que não são GET são registradas (leituras não são registradas)
• Correção: Isso é intencional - apenas gravações/modificações criam entradas de atividade

Fluxos de Trabalho Comuns

Fluxo de Trabalho 1: Encontrar Serviços do Cliente

1. Clique no filtro de Tipo de Serviço (opcional)
2. Clique no filtro de Cliente
3. Digite o nome do cliente
4. Selecione o cliente no dropdown
5. Revise os serviços do cliente

Fluxo de Trabalho 2: Identificar Serviços em Vencimento

1. Clique na aba "Ativos"
2. Ordene por "Data de Término" (crescente)
3. Serviços que expiram mais cedo aparecem primeiro
4. Contate os clientes para renovação

Fluxo de Trabalho 3: Limpar Serviços de Teste

1. Pesquise por "teste" na caixa de pesquisa
2. Revise os resultados para confirmar que são dados de teste
3. Selecione todos os serviços de teste
4. Clique em "Excluir Selecionados"
5. Confirme a exclusão

Fluxo de Trabalho 4: Suspender Cliente Não Pagante

1. Navegue até a conta do cliente
2. Veja a aba de serviços
3. Selecione todos os serviços ativos
4. Mude o status para "Suspenso"
5. Salve as alterações

Fluxo de Trabalho 5: Visualizar Uso do Serviço Móvel

1. Filtre por Tipo de Serviço: Móvel
2. Clique no nome do serviço para abrir os detalhes
3. Clique na aba "Uso"
4. Revise o consumo de dados/voz/SMS
5. Identifique usuários pesados ou excessos

Resolução de Problemas

Serviços não aparecendo na lista

• Causa: Filtro de status ocultando resultados
• Correção: Clique na aba "Todos os Resultados" para mostrar todos os status

Não é possível encontrar serviço na pesquisa

• Causa: Termo de pesquisa não corresponde aos dados armazenados
• Correção:
  • Tente uma pesquisa parcial (ex.: "0770" em vez do número completo)
  • Use o filtro de cliente em vez disso
  • Verifique se há erros de digitação

Botão de exclusão em massa desativado

• Causa: Nenhum serviço selecionado
• Correção: Marque as caixas ao lado dos serviços que deseja excluir

Ordenação não funcionando

• Causa: Coluna não ordenável
• Correção: Apenas colunas com ícones ▲▼ são ordenáveis

Página carrega lentamente

• Causa: Muitos serviços para exibir
• Correção:
  • Aplique filtros para reduzir o conjunto de resultados
  • Reduza itens por página
  • Use a pesquisa para restringir resultados

Documentação Relacionada

• csa_add_service - Adicionando novos serviços
• csa_modify - Modificando serviços e adicionando adicionais
• concepts_products_and_services - Conceitos de produtos e serviços
• basics_customers - Gestão de clientes