---
title: "Retornar previsão de recebimento da reserva por período"
method: GET
path: "/v4/comercial/reservas/{idReserva}/previsao-recebimento"
tags: ["Reservas"]
---

# Retornar previsão de recebimento da reserva por período

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

## Request

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

Retorna a previsão de recebimento da reserva agrupada pelo período escolhido,
comparando o cronograma original da tabela de preço com a proposta (parcelas
cadastradas na reserva). O parâmetro `base` controla quais blocos aparecem
(`vgv`, `vp` ou `ambos`).

## Path parameters

- `idReserva` integer, required

## Query parameters

- `tipoPeriodo` 'anual' | 'mensal' | 'trimestral' | 'semestral'
- `base` 'vgv' | 'vp' | 'ambos'
- `idTabela` integer
- `idTabelaMinima` integer

## Response `200`

Previsão calculada

- object
  - `status` string
  - `code` integer
  - `data` PrevisaoRecebimentoResponse
    - `filtros` object
      - `tipoPeriodo` 'anual' | 'mensal' | 'trimestral' | 'semestral'
      - `base` 'vgv' | 'vp' | 'ambos'
      - `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.
      - `idTabelaMinimaResolvido` integer, nullable: idtabela_minima efetivamente usado no cálculo. null quando a reserva não tem tabela mínima.
    - `periodos` PrevisaoRecebimentoPeriodo[]
      - `periodo` string
      - `vgv` PrevisaoBaseValores
        - `tabela` number, float
        - `proposta` number, float
        - `diferenca` number, float: proposta − tabela
        - `tabelaMinima` number, float, nullable: Valor da tabela mínima no período. null quando a reserva não tem tabela_minima (nem idTabelaMinima informado).
        - `diferencaMinima` number, float, nullable: proposta − tabelaMinima. null quando a reserva não tem tabela mínima.
      - `vp` PrevisaoBaseValores
        - `tabela` number, float
        - `proposta` number, float
        - `diferenca` number, float: proposta − tabela
        - `tabelaMinima` number, float, nullable: Valor da tabela mínima no período. null quando a reserva não tem tabela_minima (nem idTabelaMinima informado).
        - `diferencaMinima` number, float, nullable: proposta − tabelaMinima. null quando a reserva não tem tabela mínima.

## 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)