Simular Vencimento Futuro (Versão 1.0.0)
POST
/servicos/operacao/simularVencimentoFuturo
{
"resultados": [
{
"sequencial_titulo": 1,
"sucesso": true,
"codigo_empresa": 1,
"codigo_filial": 1,
"seu_numero": "1",
"data_vencimento": "2025-10-22",
"valor_aberto": 1300.0,
"valor_tarifa": 16.0,
"percentual_mora_cedente": 15.0,
"valor_mora_cedente": 1768.0,
"percentual_multa_cedente": 15.0,
"valor_multa_cedente": 195.0,
"percentual_mora_sacado": 15.0,
"valor_mora_sacado": 1768.0,
"percentual_multa_sacado": 15.0,
"valor_multa_sacado": 195.0,
"valor_correcao_monetaria": 0.0,
"valor_pendencia_financeira": 293.18,
"valor_recompra": 0.0,
"valor_multa_recompra": 0.0,
"total_deposito_cedente": 3279.0,
"total_deposito_sacado": 3279.0,
"observacoes": [
"Mora do sacado: informado 12,00% abaixo do mínimo permitido (15,00%). Aplicado 15,00%.",
"Mora do cedente: informado 18,00% acima do máximo permitido (15,00%). Aplicado 15,00%.",
"Multa do sacado: informado 10,00% abaixo do mínimo permitido (15,00%). Aplicado 15,00%.",
"Multa do cedente: informado 20,00% acima do máximo permitido (15,00%). Aplicado 15,00%."
]
}
]
}Estrutura do Json
| Propriedade | Tipo | Descrição |
|---|---|---|
| sequencial_titulo | Number | Sequencial do título no Q'Prof (máx 11). |
| sucesso | Boolean | true em caso de sucesso ou false em caso de erro no processamento do título. |
| mensagem_erro | String | Mensagem de erro quando o título não pôde ser processado (omitido quando nulo). |
| codigo_empresa | Number | Código da empresa. |
| codigo_filial | Number | Código da filial. |
| seu_numero | String | Seu número / número do documento do título. |
| data_vencimento | String | Data de vencimento do título (formato yyyy-MM-dd). |
| valor_aberto | Number | Valor em aberto do título. |
| valor_tarifa | Number | Valor da tarifa. |
| percentual_mora_cedente | Number | Percentual de mora do cedente. |
| valor_mora_cedente | Number | Valor de mora do cedente. |
| percentual_multa_cedente | Number | Percentual de multa do cedente. |
| valor_multa_cedente | Number | Valor de multa do cedente. |
| percentual_mora_sacado | Number | Percentual de mora do sacado. |
| valor_mora_sacado | Number | Valor de mora do sacado. |
| percentual_multa_sacado | Number | Percentual de multa do sacado. |
| valor_multa_sacado | Number | Valor de multa do sacado. |
| valor_correcao_monetaria | Number | Valor de correção monetária. |
| valor_pendencia_financeira | Number | Valor de pendência financeira. |
| valor_recompra | Number | Valor de recompra. |
| valor_multa_recompra | Number | Valor de multa da recompra. |
| total_deposito_cedente | Number | Total do depósito do cedente. |
| total_deposito_sacado | Number | Total do depósito do sacado. |
| observacoes | Array[String] | Lista de mensagens informativas sobre ajustes aplicados ao cálculo. |
Observações Todos os campos acima ficam dentro de cada objeto do array resultados.mensagem_errosó aparece no JSON quando há erro, por isso não consta no exemplo de sucesso acima.observacoesé uma lista de mensagens geradas quando um percentual informado na requisição fica fora da faixa permitida pelo contrato. Nesses casos, o valor é ajustado automaticamente ao limite (o mínimo, se estiver abaixo; o máximo, se estiver acima) e esse valor ajustado é o que passa a ser usado no cálculo e devolvido nos campospercentual_*correspondentes. Cada ajuste gera uma mensagem indicando o campo, o percentual informado, o limite violado e o percentual efetivamente aplicado. Quando nenhum percentual precisa ser ajustado, a lista vem vazia ([]).
Requisição
Parâmetros de Consulta
Parâmetros Header
Parâmetros Bodyapplication/json
Respostas
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://dominio-do-cliente.qprof.com.br/QprofApi/api/servicos/operacao/simularVencimentoFuturo?version=1.0.0' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
"cnpj_empresa": "00.000.000/0000-00",
"data_base": "2026-07-29",
"titulos": [
{
"sequencial_titulo": 1,
"percentual_mora_cedente": null,
"percentual_multa_cedente": null,
"percentual_mora_sacado": null,
"percentual_multa_sacado": null
}
]
}'Response Response Example
200 - Sucesso
{
"resultados": [
{
"sequencial_titulo": 1,
"sucesso": true,
"codigo_empresa": 1,
"codigo_filial": 1,
"seu_numero": "1",
"data_vencimento": "2025-10-22",
"valor_aberto": 1300.0,
"valor_tarifa": 16.0,
"percentual_mora_cedente": 15.0,
"valor_mora_cedente": 1768.0,
"percentual_multa_cedente": 15.0,
"valor_multa_cedente": 195.0,
"percentual_mora_sacado": 15.0,
"valor_mora_sacado": 1768.0,
"percentual_multa_sacado": 15.0,
"valor_multa_sacado": 195.0,
"valor_correcao_monetaria": 0.0,
"valor_pendencia_financeira": 293.18,
"valor_recompra": 0.0,
"valor_multa_recompra": 0.0,
"total_deposito_cedente": 3279.0,
"total_deposito_sacado": 3279.0,
"observacoes": [
"Mora do sacado: informado 12,00% abaixo do mínimo permitido (15,00%). Aplicado 15,00%.",
"Mora do cedente: informado 18,00% acima do máximo permitido (15,00%). Aplicado 15,00%.",
"Multa do sacado: informado 10,00% abaixo do mínimo permitido (15,00%). Aplicado 15,00%.",
"Multa do cedente: informado 20,00% acima do máximo permitido (15,00%). Aplicado 15,00%."
]
}
]
}Modificado em 2026-09-30 11:48:39