Pular para o conteúdo principal

Gerenciamento de Serviços

A interface de Gerenciamento 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 , Uso de Serviços , Modificando Serviços , Produtos e Serviços .

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:

Visão da Lista de Serviços{.align-center width="800px"}

Colunas:

  • ID do Serviço - Identificador único
  • Nome do Serviço - Nome descritivo (por exemplo, "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
  • Ativo - Serviços atualmente ativos (visualização padrão)
  • Inativo - Serviços cancelados ou expirados
  • Suspenso - Serviços temporariamente desativados (não pagamento, fraude, etc.)

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

Filtro de 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 de Cliente​

Pesquise e filtre por cliente:

Comece a digitar o nome de um cliente para ver 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 rápidas de ordenação:

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 - Modifica os parâmetros do serviço
  • Adicionais - Navegue e adicione melhorias ao serviço
  • Uso - Visualizar 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 Vários 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

::: warning ::: title 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 fechadas
  • Remover entradas duplicadas ou errôneas

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

Gerenciamento 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/refabricação

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
  • Razões 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 o registro
  • Suspenso → Ativo: Reativa o serviço, retoma a cobrança
  • Inativo → Ativo: Pode acionar o re-provisionamento (use com cautela)

Visualização de Uso do Serviço​

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

Modal de Uso do Serviço{.align-center width="800px"}

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. cota do plano
  • Uso de SMS - Mensagens enviadas vs. cota
  • 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 detalhado do uso
  • Exportar - Baixar relatório de uso (se disponível)

Próximos Auto-Renováveis​

A visualização de Próximos Auto-Renováveis fornece uma interface centralizada para monitorar e gerenciar todas as renovações de serviços programadas em sua organização.

Acessando Auto-Renováveis​

Navegue para:

Ou diretamente:

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

Visão Geral de Auto-Renováveis​

A lista de auto-renováveis exibe renovações programadas em uma tabela com:

Colunas:

  • Cliente - Nome do cliente (link clicável para visão geral do cliente)
  • Serviço - Nome do serviço (link clicável para 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:

Painel de Próximas Auto-Renovações

Como Funciona a Auto-Renovação​

A auto-renovação é programada 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 programada, 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óximos Auto-Renováveis consulta diretamente o CGRateS 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 programada:

  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 programada: 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 cotas do produto
  • O saldo é atualizado no CGRateS
  • Um registro de transação é criado
  • A data de término do serviço é estendida
  • Uma entrada de registro de atividades é criada

Casos de Uso:

  • O cliente solicita renovação antecipada
  • Resolver problemas de serviço redefinindo cotas
  • Testar processos de renovação
  • O cliente deseja usar o serviço antes da renovação programada

Remover Auto-Renovação​

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

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

  2. Confirme a exclusão no modal:

    Isso removerá a auto-renovação programada 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 cobranças automáticas

::: warning ::: title 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 de 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 de 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 de Produto:

  • Nome do produto do ActionPlan do CGRateS
  • Extraído dos metadados da ação programada
  • Sempre mostra o nome do produto, mesmo se o serviço não for encontrado

Coluna de 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 de Renova Em:

  • Data e hora exatas da próxima renovação
  • Tempo relativo legível por humanos (por exemplo, "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 de 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
  • Solução:
    • Verifique se o serviço existe no banco de dados
    • Verifique se o formato do service_uuid corresponde: ServiceType_UUID (por exemplo, FixedWireless_75628fa5)
    • O serviço pode ter sido excluído do CRM, mas ainda está programado no CGRateS

Custo mostrando "N/A"

  • Causa: ID do produto no CGRateS não existe na tabela de Produtos do CRM
  • Soluçã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
  • Solução:
    • Verifique a configuração do ActionPlan do CGRateS
    • Verifique se o ActionTiming está configurado corretamente
    • Verifique os logs do CGRateS em busca de erros

"Renovar Agora" falha

  • Causa: Vários erros de provisionamento
  • Resolução de Problemas:
    • Verifique o modal de status de provisionamento para detalhes de 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
  • Soluçã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 pelas 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:

Vencido:

Serviços com saldo pendente mostram:

Integração CGRateS (Avançado)​

Para serviços integrados com o CGRateS (o motor de faturamento e classificaçã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.

::: note ::: title 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. Gerenciamento Manual

Na operação normal, os atributos e filtros do CGRateS são automaticamente provisionados pelo Ansible durante o fluxo de trabalho inicial de provisionamento 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 classificação correta
  • Aplicam os planos de classificaçã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ítica - 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 incorretas ou testar diferentes configurações
  • Configurações Especiais - Aplicar atributos personalizados que não fazem parte do provisionamento padrão

A interface de gerenciamento 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 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 modelos

::: warning ::: title 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 cobrança 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.

Visualização Colapsada das Seções do CGRateS{.align-center width="800px"}

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 classificaçã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"

Visualização de Edição de Atributos do CGRateS{.align-center width="800px"}

Campos de Atributo:

  • Caminho - O campo a ser modificado (por exemplo, *req.Account, *req.IMSI)
  • Tipo - Como o valor é definido:
    • *constant - Define um valor fixo
    • *variable - Captura valor dos campos de evento 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 classificação
  • Mapear IMSI/MSISDN para serviço
  • Configurar limites de largura de banda (MaxBitrateDL/UL)
  • Definir nomes de políticas (PcefPolicyName)
  • Transformar ou enriquecer eventos de classificaçã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 classificaçã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 (por exemplo, ~*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 - O campo está vazio
    • *exists - O campo existe
    • *notexists - O 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 os atributos se apliquem apenas a contas específicas
  • Filtrar por destino (nacional vs. internacional)
  • Filtragem baseada em tempo (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

Visualização de Sessões Ativas do CGRateS{.align-center width="800px"}

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

Modal de Detalhes da Sessão do CGRateS{.align-center width="800px"}

Casos de Uso:

  • Monitorar chamadas ativas ou sessões de dados
  • Resolver problemas de faturamento
  • Verificar se a sessão está sendo classificada 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 "Atualizar" para obter os dados mais recentes da sessão.

::: note ::: title 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 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 CGRateS (por exemplo, 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 é automaticamente definido 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 CGRateS que não são GET são registradas automaticamente no feed de atividades do cliente, incluindo:

  • Método da API chamado
  • Inquilino utilizado
  • 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 um registro completo de auditoria de todas as mudanças de configuração do CGRateS.

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

"Permissão Negada" ao acessar recursos do CGRateS

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

Atributos ou Filtros não carregando

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

Mudanças não sendo salvas

  • Causa: Erro de validação ou erro da API CGRateS
  • Soluçã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 em busca de detalhes de erro
    • Revise os logs do CGRateS

Nenhuma sessão ativa sendo exibida

  • Causa: Nenhuma sessão atualmente ativa para este serviço
  • Soluçã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
  • Soluçã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)
  • Solução: Isso é intencional - apenas gravações/modificações criam entradas de atividades

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 que Estão para Expirar​

  1. Clique na aba "Ativo"
  2. Ordene por "Data de Término" (crescente)
  3. Serviços que expiram primeiro 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 mudanças

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
  • Solução: Clique na aba "Todos os Resultados" para mostrar todos os status

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

  • Causa: O termo de pesquisa não corresponde aos dados armazenados
  • Solução:
    • Tente uma pesquisa parcial (por exemplo, "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
  • Solução: Marque as caixas ao lado dos serviços que deseja excluir

Ordenação não funcionando

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

Página carrega lentamente

  • Causa: Muitos serviços para exibir
  • Soluçã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 - Gerenciamento de clientes