---
title: "Retornar fluxo de recebimento mensal da reserva"
method: GET
path: "/v4/comercial/reservas/{idReserva}/fluxo-recebimento"
tags: ["Reservas"]
---

# Retornar fluxo de recebimento mensal da reserva

`GET /v4/comercial/reservas/{idReserva}/fluxo-recebimento`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api`
- URL: `https://integracao.cvcrm.com.br/api/v4/comercial/reservas/{idReserva}/fluxo-recebimento`
- Auth: HTTP bearer

Retorna o fluxo de recebimento mensal de uma reserva, mesma estrutura exibida no modal
"Fluxo de Recebimento Mensal" da tela de aprovação de condição. Os filtros (`valor`,
`comissao`, `juros`, `incluirCustas`) determinam qual das 8 variantes de cálculo é devolvida.

## Path parameters

- `idReserva` integer, required

## Query parameters

- `valor` 'vgv' | 'vp'
- `comissao` 'nominal' | 'liquido'
- `juros` 'sem-juros' | 'com-juros'
- `incluirCustas` boolean
- `idTabela` integer
- `idTabelaMinima` integer

## Response `200`

Fluxo de recebimento mensal calculado

- object
  - `status` string
  - `code` integer
  - `data` FluxoRecebimentoResponse
    - `filtros` FluxoRecebimentoFiltros
      - `valor` 'vgv' | 'vp'
      - `comissao` 'nominal' | 'liquido'
      - `juros` 'sem-juros' | 'com-juros'
      - `incluirCustas` boolean
      - `idTabela` integer, nullable: Override do idtabela informado na requisição. null quando não informado.
      - `idTabelaMinima` integer, nullable: Override do idtabela_minima informado na requisição. null quando não informado.
      - `idTabelaResolvido` integer, nullable: idtabela efetivamente usado no cálculo (filtro, reserva ou primeira tabela ativa). null quando não há tabela.
      - `nomeTabelaResolvido` string, nullable: Nome da tabela efetivamente usada no cálculo (idTabelaResolvido). null quando não há tabela.
      - `idTabelaMinimaResolvido` integer, nullable: idtabela_minima efetivamente usado no cálculo. null quando a reserva não tem tabela mínima.
    - `reserva` ReservaJurosCadastro: Dados de origem da reserva (juros, renda, VPL, valor de contrato e comissões), independentes dos filtros.
      - `jurosCadastro` number, float: Juros cadastrado da reserva (reservas.juros_cadastro).
      - `jurosAposEntregaCadastro` number, float: Juros após entrega cadastrado da reserva (reservas.juros_apos_entrega_cadastro).
      - `renda` number, float: Renda total da reserva (cliente + associados que participam da renda).
      - `percentualComprometimentoRenda` number, float: Percentual de comprometimento de renda (total das condições mensais / renda total * 100).
      - `vplReserva` number, float: Valor presente líquido da reserva (reservas.vpl_reserva).
      - `valorContrato` number, float: Valor de contrato da reserva (reservas.valor_contrato).
      - `valorPremio` number, float: Soma das regras de prêmio (comissaoTipo='P') do contrato pagas pela condição da reserva.
      - `valorComissao` number, float: Soma das regras de comissão (comissaoTipo='C') do contrato pagas pela condição da reserva.
      - `vplReservaLiquido` number, float: vplReserva menos o total das comissões do contrato.
      - `valorContratoLiquido` number, float: valorContrato menos o total das comissões do contrato.
    - `provisao` object: Provisão de recebimento (entrada / até chaves / pós chaves) da proposta vs tabela vs tabela mínima.
      - `proposta` ProvisaoBloco
        - `entrada` number, float: Valor da 1ª condição (entrada).
        - `ateChave` number, float: Soma das parcelas com vencimento anterior à data de entrega.
        - `posChave` number, float: Soma das parcelas com vencimento a partir da data de entrega.
        - `qtdMeses` integer: Meses entre o 1º e o último vencimento.
        - `total` number, float: entrada + ateChave + posChave.
        - `entradaPercentual` number, float
        - `ateChavePercentual` number, float
        - `posChavePercentual` number, float
      - `tabela` ProvisaoBloco
        - `entrada` number, float: Valor da 1ª condição (entrada).
        - `ateChave` number, float: Soma das parcelas com vencimento anterior à data de entrega.
        - `posChave` number, float: Soma das parcelas com vencimento a partir da data de entrega.
        - `qtdMeses` integer: Meses entre o 1º e o último vencimento.
        - `total` number, float: entrada + ateChave + posChave.
        - `entradaPercentual` number, float
        - `ateChavePercentual` number, float
        - `posChavePercentual` number, float
      - `minima` ProvisaoBloco
        - `entrada` number, float: Valor da 1ª condição (entrada).
        - `ateChave` number, float: Soma das parcelas com vencimento anterior à data de entrega.
        - `posChave` number, float: Soma das parcelas com vencimento a partir da data de entrega.
        - `qtdMeses` integer: Meses entre o 1º e o último vencimento.
        - `total` number, float: entrada + ateChave + posChave.
        - `entradaPercentual` number, float
        - `ateChavePercentual` number, float
        - `posChavePercentual` number, float
    - `totais` FluxoRecebimentoTotais
      - `totalCondicoes` number, float
      - `totalAcumulado` number, float
      - `pctPropostaFinal` number, float
      - `pctTabelaFinal` number, float
      - `pctTabelaMinimaFinal` number, float, nullable: % acumulado final sobre a tabela mínima. null quando a reserva não tem tabela mínima.
    - `periodos` FluxoRecebimentoPeriodo[]
      - `ordem` integer
      - `periodo` string: ano/mês
      - `ato` number, float
      - `financiamento` number, float
      - `mensal` number, float
      - `semestral` number, float
      - `anual` number, float
      - `condicoes` number, float: Valor recebido no período
      - `acumulado` number, float: Acumulado até o período
      - `pctTabela` number, float: % acumulado sobre o valor da tabela
      - `pctProposta` number, float: % acumulado sobre o total da proposta
      - `pctTabelaMinima` number, float, nullable: % acumulado sobre o valor da tabela mínima. null quando a reserva não tem tabela mínima (nem idTabelaMinima).

## Other responses

- `400`: Filtros inválidos
- `401`: Não autenticado
- `403`: Sem permissão
- `404`: Reserva inexistente ou sem parcelas
- `500`: Erro inesperado

---

[API](https://skmtc.dev/cvcrm/apis/servi-os-internos-do-construtor-de-vendas.md) - [All operations](https://skmtc.dev/cvcrm/apis/servi-os-internos-do-construtor-de-vendas/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/servi-os-internos-do-construtor-de-vendas/revisions/9f2fd517acbb?raw)