IOSOR Guias

Evite o desvio de catálogo entre painéis públicos e motores de faturamento em tempo real

Aprenda a manter uma sincronização estrita entre as tabelas de preços do seu portal white-label e os esquemas do ledger para garantir a precisão financeira.

Divergências de preços entre o portal e o faturamento falham retenções pré-pagas. Trate o ledger como fonte única de verdade validando dados no API gateway.

Estabelecendo a fonte única de verdade

O desvio de catálogo ocorre quando o portal exibe preços que divergem do ledger de backend. Em um ambiente white-label, essa discrepância leva a falhas imediatas de reconciliação. Você deve tratar o ledger como a autoridade principal. Cada atualização de preço deve disparar um evento síncrono que se propaga para o cache do portal. Ao aplicar uma validação de esquema rigorosa no gateway de API, você garante que nenhum objeto de preço entre no sistema sem uma entrada correspondente no ledger, evitando modificações de tarifas não autorizadas.

Gerenciando provisionamento JIT e retenções pré-pagas

O IOSOR opera em um modelo JIT, onde os recursos são atribuídos apenas quando solicitados. Quando um usuário seleciona um número, o sistema coloca uma retenção pré-paga no saldo da conta. Essa retenção deve corresponder ao MRC definido no catálogo. Se o catálogo e o motor de faturamento estiverem fora de sincronia, a retenção falhará, resultando em uma solicitação de provisionamento rejeitada. Certifique-se sempre de que as regras de formatação E.164 sejam aplicadas consistentemente no portal e no motor de faturamento.

Lidando com limites financeiros e revisões

A integridade financeira é mantida por meio de gatilhos automatizados. As contas devem manter um piso pré-pago de USD 20 para manter os serviços ativos. Quando uma conta atinge um limite de revisão de USD 1.000/mês, o sistema sinaliza a conta para auditoria manual. Esses limites são codificados no motor de faturamento. Se o portal não refletir esses limites, os usuários podem tentar provisionar serviços que o backend rejeitará imediatamente, levando a uma experiência ruim para o cliente.

Sincronizando eventos de Webhook e DLRs

O faturamento em tempo real depende de relatórios de eventos precisos. Quando um OTP ou SMS é enviado, o DLR deve ser processado de acordo com a taxa atual do catálogo. Se o catálogo tiver desviado, o ledger registrará um débito incorreto. Use webhooks idempotentes para garantir que cada evento seja processado exatamente uma vez. Se ocorrer uma nova tentativa, o motor de faturamento deve verificar o estado do ledger antes de aplicar uma segunda cobrança, evitando cobranças duplicadas.

Integrando a governança do catálogo

Para manter a saúde do sistema, consulte estes guias essenciais para gerenciar sua infraestrutura:

Comece com a IOSOR

Valide a sincronização do seu catálogo no console IOSOR vinculando cada tabela de preços do portal de atendimento diretamente ao esquema do livro-razão backend por meio de webhooks em tempo real. Garanta que as retenções de provisionamento JIT inspecionem o MRC atual do livro-razão antes de bloquear saldos de usuários para novos números. Verifique se as recalculações de tarifas de DLR recebidas referenciam a versão exata do catálogo ativa no momento do envio do evento.

Conclusão IOSOR

Discrepâncias entre os preços do portal público e os motores do livro-razão backend provocam falhas imediatas de reconciliação durante os ciclos de faturamento. Estabelecer o livro-razão de faturamento como fonte única de verdade garante que cotações de atendimento, retenções pré-pagas JIT e cobranças de eventos DLR permaneçam estritamente alinhados em todos os níveis de conta.

Este guia foi útil?

Guias relacionados