FAQ — Exemplos de Consultas

Exemplos práticos de consultas OData e como obter os principais indicadores. Substitua meulink pelo domínio do cliente.

1. Filtros e consultas (exemplos de URL)

Valor risco em aberto — na consulta Titulo, some o campo valor_aberto filtrando codigo_estagio_titulo = 6 e codigo_situacao_titulo = 1.

Movimentos de Baixa — retornam na consulta TituloMovimentoBaixa, que liga com Titulo; gravada a cada movimento de baixa/liquidação, com os detalhes da baixa.

Detalhes dos Tipos de Documentos — consulta EspecieDocumento, que liga com Titulo pelo campo CODIGO_ESPECIE_DOCUMENTO.

Filtrar registros atualizados no dia anterior (operações apenas com inteiros):

https://meulink-odata-standard.qprof.com.br/Titulo?$filter=day(date(data_atualizacao)) eq (day(now()) sub 1) and year(date(data_atualizacao)) eq year(now()) and month(date(data_atualizacao)) eq month(now())

Filtrar títulos efetivados na data atual:

https://meulink-odata-standard.qprof.com.br/Titulo?$filter=date(data_efetivacao) eq date(Now())

Filtrar títulos baixados na data atual:

https://meulink-odata-standard.qprof.com.br/Titulo?$filter=date(data_baixado) eq date(Now())

Filtrar registros atualizados na data atual:

https://meulink-odata-standard.qprof.com.br/Titulo?$filter=date(data_atualizacao) eq date(Now())

Filtrar registros atualizados num período específico (títulos têm valor presente e corrigido atualizados na rotina noturna):

https://meulink-odata-standard.qprof.com.br/Titulo?$filter=date(DATA_ATUALIZACAO) ge 2021-12-30 and date(DATA_ATUALIZACAO) le 2022-02-04

Filtrar e retornar campos específicos:

https://meulink-odata-standard.qprof.com.br/Titulo?$select=codigo_empresa, codigo_filial, numero_sequencial_titulo, data_atualizacao&$filter=date(data_atualizacao) eq date(Now()) and codigo_empresa eq 1

Risco pelo valor de face, agrupado por cedente e empresa, do maior para o menor:

https://meulink-odata-standard.qprof.com.br/TITULO?$count=true&$apply=filter(CODIGO_SITUACAO_TITULO EQ 1 AND CODIGO_ESTAGIO_TITULO EQ 6)/groupby((CODIGO_CEDENTE,CODIGO_EMPRESA), aggregate(VALOR_FACE with sum as VALOR_RISCO_FACE, now() with max as DATA_ATUALIZACAO))&$orderby=VALOR_RISCO_FACE DESC

Risco da posição estática (maiores cedentes), agrupado por cedente, de uma empresa específica:

https://meulink-odata-standard.qprof.com.br/TituloPosicaoEstaticaAberto?$count=true&$apply=filter(CODIGO_EMPRESA EQ 1 and (date(data_posicao) eq date(now())))/groupby((CODIGO_PESSOA), aggregate(VALOR_ABERTO with sum as VALOR_ABERTO_POSICAO_ESTATICA))&$orderby=VALOR_ABERTO_POSICAO_ESTATICA DESC

Valores de Débito e Crédito em Conta Corrente:

https://meulink-odata-standard.qprof.com.br/ContaCorrenteCedente?$apply=filter(NUMERO_RECIBO eq null and INDICADOR_CANCELADO eq 'N')/groupby((CODIGO_PESSOA,CODIGO_FILIAL,CODIGO_EMPRESA), aggregate(VALOR_DEBITO with sum as TOTAL_DEBITO, VALOR_CREDITO WITH sum as TOTAL_CREDITO))&$orderby=CODIGO_PESSOA ASC

Dados da consulta SerasaMensagem dos últimos 5 dias:

https://meulink-odata-standard.qprof.com.br/SerasaMensagem?$apply=compute(SERASA_CONSULTA/DATA_CONSULTA AS DATA_CONSULTA)&$filter=DATA_CONSULTA GE(NOW() SUB DURATION'P5D')

2. Como obter indicadores e valores

Taxa Deságio da operação — consulta Aditivo: campo taxa_desagio (taxa informada na operação) e taxa_fator_ajustado (taxa ajustada incluindo tarifas).

Taxa Deságio Original da operação — consulta Aditivo, campo taxa_desagio (informada na tela de operação → aba Aditivos → sub-aba Manter Aditivo em Lote).

Valor Deságio da operação — total na consulta Operacao, campo valor_desagio. Por título na consulta Titulo, campos valor_desagio e valor_desagio_original.

Taxa Serviço / Ad-Valorem — consulta Aditivo, campo taxa_advalorem.

Tarifas da operação — total na consulta Operacao, campo valor_tarifas. Detalhe por tarifa na consulta TarifaAditivo (liga com Aditivo por codigo_empresa, codigo_filial, numero_aditivo). O nome das tarifas vem da consulta TarifaGeral (chave codigo_tarifa).

Impostos Dvrs. — consulta Operacao, campos valor_iof e valor_iof_adcional.

Identificar título Recomprado — consulta Titulo: indicador_recomprado = 'S', codigo_situacao_titulo = 3 (baixado) e codigo_estagio_titulo = 6 (operação paga na tesouraria).

Recompra Sim / Recompra Não — consulta Titulo, campo tipo_cobranca: 4 = Recompra-Sim, 5 = Recompra-Não (ambos são "Recompras").

Recompras — Tipos — consulta ReciboRecompra, coluna tipo_recibo (Pendência financeira ou Recompra Faturado/títulos). Detalhe de pendências: liga com ContaCorrenteCedente por codigo_empresa, codigo_filial, numero_recibo. Detalhe de títulos: liga com TituloMovimentoBaixa pelas mesmas chaves.

Recompra em Operações — consulta ReciboRecompra, colunas valor_debito e valor_credito. Chave com Operacao: codigo_empresa, codigo_filial, numero_operacao. Em Operacao, filtrar indicador_estagio_operacao = 6 (pago na tesouraria); em ReciboRecompra, situacao = 2 (efetivado).

Recompras do relatório "negócios realizados" — ReciboRecompra.valor_debito quando tipo_recibo é RF (Recompra Títulos) ou RT (Recompra Títulos Trustee) e situacao = 2 (efetivado).

Créditos do relatório "negócios realizados" — ReciboRecompra.valor_credito quando tipo_recibo = PF (Recompra Pendências) e situacao = 2.

Débitos do relatório "negócios realizados" — ReciboRecompra.valor_debito quando tipo_recibo = PF e situacao = 2.

Descontos — consulta Titulo, campo valor_desconto: soma dos títulos aceitos no aditivo com codigo_situacao_titulo 1 e 3 e codigo_estagio_titulo 6.

Abatimento Fluxo Futuro em operação — consulta AbatimentoFomentoNP, soma valor_abatimento, ligando com Aditivo por codigo_empresa, codigo_filial, numero_aditivo.

Taxa efetiva final da operação — fórmula: (((valor bruto - valor descontos) / total a pagar(não considerar recibos)) ^ (30 / prazo médio total) - 1) * 100.

Valor bruto da operação — soma de valor_face (consulta Titulo) dos aceitos no aditivo/operação (codigo_situacao_titulo 1 e 3, codigo_estagio_titulo 6); ou diretamente valor_nominal_bruto da consulta Operacao.

Valor descontos da operação — soma de valor_desconto (consulta Titulo) dos aceitos no aditivo/operação (codigo_situacao_titulo 1 e 3, codigo_estagio_titulo 6).

Prazo médio total da operação — soma(dias_calculo_desagio * valor_face) / soma(valor_face) na consulta Titulo, dos aceitos (codigo_situacao_titulo 1 ou 3, codigo_estagio_titulo 6).

Prazo médio da operação — soma((data_vencimento_original - data_efetivacao) * valor_face) / soma(valor_face) na consulta Titulo, dos aceitos (codigo_situacao_titulo 1 ou 3, codigo_estagio_titulo 6). O relatório "negócios realizados" considera apenas títulos com aditivo e tipo_cobranca ≠ 7 (CCB-Duplicatas).

Fator Período — soma(Aditivo.taxa_desagio * Titulo.valor_face) / soma(Titulo.valor_face), filtrando em Titulo codigo_situacao_titulo 1 ou 3 e codigo_estagio_titulo 6.

Total a pagar em uma operação — consulta Operacao: valor_nominal_bruto - valor_desagio - valor_tarifas - valor_advalorem - valor_iof - valor_iof_adcional.

FAQ — Exemplos de Consultas

1. Filtros e consultas (exemplos de URL)#

2. Como obter indicadores e valores#

1. Filtros e consultas (exemplos de URL)

2. Como obter indicadores e valores