OmniRoam

OmniRoam é um sistema de liquidação de roaming TAP3 da GSMA desenvolvido pela Omnitouch Network Services. O OmniRoam avalia o uso de dados móveis, gera arquivos TAP para parceiros de roaming, envia esses arquivos para uma câmara de compensação e processa os arquivos do Procedimento de Conta Retornada (RAP) que os parceiros enviam de volta.

OmniRoam suporta o formato TAP 3.12 definido em GSMA TD.57 e o formato RAP definido em GSMA TD.32.

Documentação

Operações e monitoramento

• Guia de Operações - Trabalhos agendados, transferência de arquivos, arquivamento, locais de log e manutenção de rotina.
• Referência de Métricas - Métricas do Prometheus e medições do InfluxDB.
• Solução de Problemas - Problemas comuns e suas resoluções.

Configuração

• Referência de Configuração - Referência completa de config.yaml e counters.yaml.

Arquitetura e interfaces

• Arquitetura - Componentes, fluxo de dados e pontos de integração.
• Referência da API HTTP - Os endpoints da API OmniRoam.

Registros e liquidação

• Processamento de CDR - Fontes de CDR, ingestão, avaliação e arredondamento.
• Geração de Arquivos TAP - Estrutura do arquivo TAP, nomenclatura e contadores de sequência.
• Processamento de RAP - Arquivos do Procedimento de Conta Retornada e alertas.
• Validação de TAP - Verificações de validação e códigos de erro GSMA.

O que o OmniRoam faz

OmniRoam liquida o roaming de dados de saída. Uma rede visitada transporta os dados de um assinante da rede de origem. O OmniRoam transforma os registros de uso em um arquivo TAP precificado, envia o arquivo para a rede de origem através de uma câmara de compensação e rastreia a resposta do parceiro.

• Ingestão de CDR - O OmniRoam coleta Registros de Detalhes de Chamadas (CDRs) de gateways de serviço e correlaciona os registros parciais em sessões de dados completas.
• Avaliação - O OmniRoam precifica cada CDR de acordo com uma taxa por parceiro através do Motor de Cobrança.
• Geração de arquivos TAP - O OmniRoam constrói arquivos TAP por parceiro de roaming e os prepara para transferência.
• Transferência de arquivos - O OmniRoam envia arquivos TAP para a câmara de compensação e puxa arquivos TAP e RAP de entrada.
• Processamento de RAP - O OmniRoam lê os arquivos RAP que os parceiros retornam e alerta os operadores sobre rejeições.
• Monitoramento - O OmniRoam expõe métricas do Prometheus, análises do InfluxDB, uma API HTTP e uma interface web.

Visão Geral da Arquitetura

Veja o guia de Arquitetura para o mapa completo de componentes e fluxo de dados.

Estrutura de Configuração

O OmniRoam lê dois arquivos de configuração. A Referência de Configuração documenta cada parâmetro.

• config.yaml - A configuração principal. Ela contém uma seção global config e uma seção partners por parceiro.
• counters.yaml - Os contadores de sequência do arquivo TAP, um par por TADIG destinatário.

config:
  # Configuração global do sistema (caminhos, fusos horários, avaliação, agendamento, métricas)

partners:
  # Configuração por parceiro (taxas, códigos TADIG, configurações de lote)

Referências de Padrões

Padrão	Título	Uso no OmniRoam
GSMA TD.57	Formato de Registro de Dados do Procedimento de Conta Transferida (TAP)	Formato de arquivo TAP 3.12 e códigos de erro de validação
GSMA TD.32	Formato do Procedimento de Conta Retornada (RAP)	Estrutura do arquivo RAP e severidades de retorno
GSMA TD.13	Convenções de Nomenclatura TADIG	Identificadores de operador de 5 caracteres (códigos TADIG)
ISO 4217	Códigos de Moeda	Valores de localCurrency e tapCurrency
E.164	Plano de Numeração Internacional	Formatos de MSISDN e número chamado

Estrutura da Documentação

Por papel

Operadores e administradores:

1. Comece com o Guia de Operações.
2. Revise a Referência de Métricas.
3. Mantenha o guia de Solução de Problemas disponível.

Equipes de roaming e liquidação:

1. Leia Geração de Arquivos TAP.
2. Leia Processamento de RAP.
3. Revise Validação de TAP.

Integradores de sistema:

1. Comece com o guia de Arquitetura.
2. Leia a Referência de Configuração.
3. Revise a Referência da API HTTP.