Relatório de Chamadas DID - CDR

Status: Atualizado via Análise de Código (v2.0)

Este Ponto de Acesso fornece a listagem detalhada do CDR DID (Relatório de Ligações DID - Entrantes).

Endereço de Chamada da API

GET /api/cdrDid/API_TOKEN/API_KEY(/id_cliente)

Comportamento por Nível de Acesso

Nível Master ou Revenda: Pode especificar o id_cliente como último parâmetro da URL ou via parâmetro id_record.
Nível Assinante: Não é necessário informar o ID; a API retornará automaticamente os dados do assinante autenticado.

Parâmetros de Consulta (Query Strings)

Além dos parâmetros de data e paginação, novos filtros de busca foram implementados:

Parâmetro	Tipo	Descrição
`date_ini`	Date	Data inicial (padrão: data atual) `AAAA-MM-DD`
`date_end`	Date	Data final (padrão: data atual) `AAAA-MM-DD`
`time_ini`	Time	Hora inicial (padrão: `00:00:00`)
`time_end`	Time	Hora final (padrão: `23:59:59`)
`start`	Int	Offset (pular X registros)
`limit`	Int	Limite de registros por página
`source`	String	(Novo) Filtra pelo número de origem (Busca parcial)
`destination`	String	(Novo) Filtra pelo destino limpo (Busca parcial)
`extension`	Int	(Novo) Filtra pelo ID do Ramal (`device_id`)
`id_record`	Int	ID do Cliente (alternativa ao parâmetro de URL)

Exemplo de Chamada Atualizada

curl -X GET 'https://sip.nextbilling.com.br/api/cdrDid/TOKEN/KEY?source=119&limit=10'

Estrutura de Resposta (JSON)

O objeto de retorno foi expandido com informações técnicas adicionais.

Exemplo de Retorno

{
   "error": 0,
   "reason": "OK",
   "total_records": 150,
   "total_time": 40898,
   "total_time_text": "681 min 38 seg",
   "total_value": "0,00000",
   "total_value_connection": "0,00000",
   "limit": 10,
   "offset": 0,
   "records": 1,
   "data": [
      {
         "id": 12345,
         "customer_id": 999,
         "calldate": "2026-03-02 11:41:12",
         "clid": "DID: 1140000000 => 3090 <1140000000>",
         "source": "1140000000",
         "destination": "1140000000",
         "region": "Sao Paulo",
         "type": "c",
         "duration": "479",
         "duration2": "7 min 59 seg",
         "total_price": "0,00000",
         "connection_price": "0,00000",
         "price_per_minute": "0,00000",
         "prefix": "00000",
         "source_ip": "189.X.X.X",
         "useragent": "Plataforma IP",
         "disposition": "1",
         "did_id": 45,
         "device_id": 1020
      }
   ]
}

Descrição dos Novos Campos no `data[]`

id: Identificador único do registro de chamada.
customer_id: ID do cliente associado à chamada.
did_id: ID interno do número DID (disponível para Master e Revenda).
device_id: ID do ramal que recebeu a chamada.

Tabela de Status de Chamada (`disposition`)

Valor	Descrição
0	Cancelado
1	Atendido
2	Ocupado
3	Não Atendido
4	Indisponível
5	Congestionado
X	Desconhecido