Guia Completo para o Faturamento do Registro de Detalhes de Chamadas (CDR)

Introdução

Este guia explica como o registro Call Detail Record (CDR) Billing (mais adiante no texto, simplesmente Billing ou Faturamento) é estruturado dentro da tabela cdrbilling, permitindo a criação de dashboards a partir do Grafana e de outras Ferramentas de BI.

Termos e Condições de Faturamento

O Faturamento aplica-se somente aos participantes externos de saída. Esse é o custo do participante externo no CDR específico em relação ao PABX. O faturamento é armazenado na tabela cdrbilling, que está vinculada à tabela principal cdroutput pelo campo cdr_id. Somente os CDRs respondidos podem ter faturamento. Os parâmetros de “Custo da Chamada” (consulte Configuração da Interface de Faturamento) devem ser configurados corretamente para que os dados de faturamento sejam armazenados na tabela cdrbilling.


Assim, os participantes com esses parâmetros de CDR podem ter faturamento:

  • source_entity_type / destination_entity_type = external_line
  • source_participant_is_incoming / destination_participant_is_incoming = false
  • cdr_answered_at = NOT NULL


O Faturamento do Call Detail Record (CDR) é independente do CDR - Call Data Records e não fornece o campo de custo de faturamento. Em vez disso, o custo do faturamento pode ser calculado para cada participante com base no código de faturamento, na taxa de faturamento e na duração do faturamento (veja mais detalhes nos Exemplos Práticos de SQL).

Campos

Esses campos definem e fornecem informações para cada participante do CDR com faturamento.

  • cdr_id:
  • Descrição: Um identificador exclusivo para o registro CDR específico. Esse campo está relacionado ao campo cdr_id na tabela principal cdroutput.
  • Detalhes do Formato:
  • object_creation_timestamp_string: Uma representação hexadecimal de 16 caracteres, com preenchimento zero, do registro de data e hora UTC desde a época.
  • object_id_string: Uma representação hexadecimal, com preenchimento zero, de um contador incrementado automaticamente. O contador é específico para o tipo de objeto (CDR, call_history_id ou participante).
  • Exemplo: 00000000-01db-aef6-c109-60ec0000004c
  • source(destination)_bill_code:
  • source(destination)_bill_rate_name:
  • Descrição: Nome da taxa de cobrança do participante. Valor da coluna “Country Name” das configurações de “Call Costs”. Veja: Configuração da Interface de Faturamento
  • Exemplo: Estados Unidos/Canadá; Alemanha; Austrália…
  • source(destination)_bill_rate:
  • source(destination)_bill_duration:
  • Descrição: duração do faturamento do participante. Com base na duração da conversa (campos CDR cdr_answered_at, cdr_ended_at).
  • Exemplo: 00:00:30.000000 (30 segundos); 00:01:00.000000 (1 minuto)…
  • Veja: Intervalo do PostreSQL
  • migrated:
  • Descrição: Reservado. Não utilizado

Exemplos Práticos de SQL

Custo do Participante do CDR

SELECT

        -- all cdr fields

        c.*,

        -- all billing fields

        b.*,

        -- source participant cost

        b.source_bill_rate * EXTRACT(EPOCH FROM b.source_bill_duration::interval)/60 AS source_participant_bill_cost,

        -- destination participant cost

        b.destination_bill_rate * EXTRACT(EPOCH FROM b.destination_bill_duration::interval)/60 AS destination_participant_bill_cost

FROM public.cdroutput AS c

LEFT JOIN public.cdrbilling AS b ON

        b.cdr_id = c.cdr_id

ORDER BY c.cdr_id;

Aplicação do Painel: Essa consulta calcula o custo do faturamento para ambos os participantes em cada CDR.

Veja Também

Última Atualização

Este documento foi atualizado pela última vez em 15 de maio de 2025

https://www.3cx.com.br/docs/guia-faturamento-registro-chamadas/