---
url: https://docs.ouvixpro.ai/visoes/renovacao.md
description: >-
  Renovação: Prime Mensal R$ 179,90 → Recorrente R$ 129,90: quem voltou pra
  pagar, quem ouviu a oferta e quem migrou. Campos, exemplo e a tela pronta em
  painel.tela.renovacao.
---

# Renovação

Prime Mensal R$ 179,90 → Recorrente R$ 129,90: quem voltou pra pagar, quem ouviu a oferta e quem migrou.

Os números abaixo estão em `painel` na resposta de `GET /v1/painel`. A chamada sempre leva `Id_unidade` e o período. Toda lista de atendimentos vem em ordem de data e horário, do mais cedo para o mais tarde.

```bash
curl "https://api.ouvixpro.ai/v1/painel?Id_unidade=375&de=2026-10-06&ate=2026-10-06" \
  -H "Authorization: Bearer $OUVIX_API_KEY"
```

::: tip Quer a tela pronta?
Esta mesma visão já vem montada em `painel.tela.renovacao` (cards com texto, cor e lista de evidências) e, mais leve, em `GET /v1/tela?tela=renovacao`. O guia [Montando a tela](/guia/telas#renovacao) mostra bloco a bloco.
:::

| Campo | Tipo | O que é |
| --- | --- | --- |
| `protocolo` | object | Venda e renovação: funil (conversas → apresentou o recorrente → fechou), listas fechadas / abertas / semDesfecho, passos do protocolo, planos e objeções. Campos na tabela "Dentro de protocolo". |

## Dentro de `protocolo`

A renovação usa o mesmo objeto `painel.protocolo` da página Protocolo. Os campos de renovação:

| Campo | Tipo | O que é |
| --- | --- | --- |
| `renovacoesN` | number | Conversas de renovação (aluno no Prime Mensal que podia ir pro Recorrente). |
| `oferecidas` | number | Renovações em que o recorrente foi oferecido. |
| `migradas` | number | Renovações que migraram para o recorrente. |
| `renovacoes` | array | Conversas de renovação, em ordem de horário, com id. |
| `migradasLista` | array | Renovações que migraram, com id. |
| `ficaramLista` | array | Renovações que ficaram no plano antigo, com id. |
| `passosRenovacao` | array | Passos do protocolo de renovação, no mesmo formato de passosVenda. |
| `motivosRenovacao` | array | Por que não migrou: motivo (cartao, pensar, totalpass, outro), label e qtd. |

## Exemplo

```json
{
  "Id_unidade": "375",
  "visao": "recepcao",
  "de": "2026-10-06",
  "ate": "2026-10-06",
  "turno": "todos",
  "painel": {
    "protocolo": {
      "vendasN": 10,
      "recorrenteN": 8,
      "fechouN": 6,
      "fechadas": [
        {
          "id": "2026-10-06:atend_35",
          "horario": "17:40:28",
          "fechou": true,
          "protocolo": {
            "cena": "venda_nova",
            "plano_fechado": "recorrente"
          }
        }
      ],
      "abertas": [
        {
          "id": "2026-10-06:atend_27",
          "horario": "13:16:41",
          "fechou": false,
          "motivo_nao_fechou": "volta_depois",
          "desfecho_venda": {
            "eh_venda": true,
            "fechou": false,
            "plano_fechado": null,
            "evidencia": "sem documento sem nada nem cartão mas eu fecho amanhã",
            "proximo_passo": "Volta amanhã para fechar o quadrimestral."
          }
        }
      ],
      "semDesfecho": [
        {
          "id": "2026-10-06:atend_4",
          "horario": "06:36:20",
          "fechou": null,
          "truncado": true
        }
      ],
      "objetivoPct": 0,
      "escadaPct": 40,
      "recorrentePct": 80,
      "registroPct": 10,
      "fechamentoPct": 60,
      "planos": [
        {
          "plano": "recorrente",
          "label": "Recorrente R$ 129,90",
          "qtd": 2
        },
        {
          "plano": "quadrimestral",
          "label": "Quadrimestral R$ 99,90",
          "qtd": 2
        }
      ],
      "objecoes": [],
      "renovacoesN": 0,
      "oferecidas": 0,
      "migradas": 0,
      "motivosRenovacao": []
    }
  }
}
```