> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assiny.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Parcelamentos

> Acompanhe as vendas parceladas e as parcelas em aberto de cada compra

**Parcelamentos** é a área do painel que reúne as vendas feitas em mais de uma parcela e permite acompanhar em que parcela cada compra está.

## Como acessar

<Steps>
  <Step title="Acesse sua conta">
    Entre no painel da **Assiny** e selecione a organização e o projeto da venda.
  </Step>

  <Step title="Abra Parcelamentos">
    No menu lateral, clique em **Parcelamentos**.

    <Frame caption="A tela de Parcelamentos, aqui com o período aberto para um ano: o seletor Data de início no alto, os cards Visão Geral e Cancelamentos à esquerda, o gráfico Status dos parcelamentos à direita e, abaixo, a busca com os botões Filtros e Exportar tabela.">
      <img src="https://mintcdn.com/assiny-45af61a4/5d46_-zEXTxd6fwJ/vendas/parcelamentos.png?fit=max&auto=format&n=5d46_-zEXTxd6fwJ&q=85&s=057c061c22b1d075ac54f48b27359c3d" alt="Tela de Parcelamentos no painel da Assiny. No alto à direita, o seletor Data de início com um período de um ano. À esquerda, o card Visão Geral com Receita recorrente mensal, Ativos e Novos, e o card Cancelamentos com Cancelamentos totais, Taxa de cancelamento e a barra Distribuição por motivo repartida entre Cancelado pelo usuário e Cancelado por tentativas. À direita, o gráfico Status dos parcelamentos, em percentual, com as colunas Ativos, Finalizados, Canc. usuário e Canc. tentativa. Abaixo, o campo de busca, os botões Filtros e Exportar tabela, a etiqueta do período aplicado e a tabela de parcelamentos, que começa pela coluna ID da 1ª transação; as colunas de nome do comprador, e-mail e produto aparecem tarjadas." width="2880" height="1800" data-path="vendas/parcelamentos.png" />
    </Frame>
  </Step>
</Steps>

## O que a tela mostra

A tela trata o **parcelamento como uma entidade própria**: cada linha é um parcelamento, com o seu **ciclo** e a sua **próxima cobrança**. Não é um recorte da lista de vendas — a venda que originou o parcelamento continua sendo consultada em [Vendas](/vendas/transacoes).

### Visão geral

Os dois cards do topo somam a janela do seletor **Data de início** e repetem essa janela no próprio
título — no print acima, `(Nos últimos 365 dias)`, porque o período foi aberto para um ano. Na
abertura padrão da tela, o título dos cards traz `(Nos últimos 31 dias)`.

| Indicador | O que mostra |
| - | - |
| **Receita recorrente mensal** | Quanto os parcelamentos em andamento geram por mês |
| **Ativos** | Quantos parcelamentos estão em curso |
| **Novos** | Quantos parcelamentos começaram no período |

### Cancelamentos

| Indicador | O que mostra |
| - | - |
| **Cancelamentos totais** | Quantos parcelamentos foram encerrados antes de terminar |
| **Taxa de cancelamento** | O peso desses cancelamentos sobre o total |
| **Distribuição por motivo** | Uma barra que reparte os cancelamentos, em percentual, entre **Cancelado pelo usuário** e **Cancelado por tentativas** |

A **distribuição por motivo** é o número que diz o que fazer. Cancelamento **pelo usuário** é
assunto de oferta e entrega; cancelamento **por tentativas** é assunto de cobrança — cartão sem
limite, dado desatualizado, recusa recorrente.

### Status dos parcelamentos

O gráfico à direita reparte os parcelamentos do período em quatro colunas — **Ativos**,
**Finalizados**, **Canc. usuário** e **Canc. tentativa** —, em percentual, e repete a janela de
datas logo abaixo do título. São os mesmos quatro status descritos adiante.

### Busca, filtros e exportação

Abaixo dos cards fica a tabela, e com ela três controles:

* **Buscar por nome e email** — o campo de busca da lista.
* **Filtros** — abre o painel de filtros e traz um contador do que está aplicado. Cada filtro ativo
  também vira uma etiqueta logo abaixo da busca, com um **X** para remover.
* **Exportar tabela** — leva o recorte que está na tela para arquivo.

| Filtro | Como usar |
| - | - |
| **Status** | Isola um dos quatro status de parcelamento |
| **Data de início** | Recorta pelo dia em que o parcelamento começou |
| **Próxima cobrança** | Recorta por período da cobrança seguinte — é o filtro para enxergar o que vai ser cobrado nos próximos dias |
| **Produtos** | Isola os parcelamentos de um produto |
| **Ciclo** | Isola por ciclo de cobrança |

<Warning>
  **O período desta tela é `Data de início` — e ele já vem preenchido, nos últimos 30 dias.** O
  seletor do alto recorta pelo dia em que o parcelamento *começou*, não pela cobrança mais recente.
  Um parcelamento aberto há seis meses e ainda em curso **não aparece** na tabela nem entra nos
  cards enquanto você não alargar esse período. Antes de concluir que uma venda parcelada sumiu,
  abra a data. É um seletor próprio desta tela: não é o mesmo do [Financeiro](/vendas/financeiro).
</Warning>

Numa conta que ainda não vendeu, a tela abre vazia, com **Estamos aguardando suas primeiras
vendas**.

## Os 4 status de parcelamento

| Status | O que significa |
| - | - |
| **Ativo** | O parcelamento está em curso e as parcelas seguem sendo cobradas |
| **Finalizado** | Todas as parcelas foram cobradas; o parcelamento chegou ao fim |
| **Cancelado pelo usuário** | Encerramento voluntário: partiu do cliente |
| **Cancelado por tentativas** | Encerramento involuntário: a plataforma tentou cobrar e não conseguiu |

Estes quatro status descrevem o **parcelamento**, não a transação. Cada parcela cobrada tem o seu
próprio status dentro dos [11 status de venda](/vendas/status-de-venda) — um parcelamento **Ativo**
pode conter uma parcela **Recusado**.

## Abrir um parcelamento

A seta no fim de cada linha da tabela abre o **Detalhe de parcelamento**.

<Frame caption="O detalhe de um parcelamento: as abas Detalhes e Histórico de cobranças, os blocos Dados da cobrança e Pagamento, e os blocos Cliente e Transação à direita.">
  <img src="https://mintcdn.com/assiny-45af61a4/5d46_-zEXTxd6fwJ/vendas/parcelamento-detalhe.png?fit=max&auto=format&n=5d46_-zEXTxd6fwJ&q=85&s=5fe77d27c7adcf6654b5907532575bca" alt="Detalhe de parcelamento no painel da Assiny, com a trilha Parcelamentos e Detalhe de parcelamento e o botão Comprovante no alto à direita. Abaixo, as abas Detalhes e Histórico de cobranças. O bloco Dados da cobrança traz Data de início, Status do parcelamento, Produto e Oferta vinculada; o bloco Pagamento traz Total, Parcelamento, Status atual da cobrança, Data da próxima cobrança e Cartão cadastrado com os quatro últimos dígitos. À direita, os blocos Cliente e Transação, com nome, telefone, e-mail, ID da primeira transação e link do checkout tarjados." width="2880" height="1800" data-path="vendas/parcelamento-detalhe.png" />
</Frame>

Duas abas dividem a tela: **Detalhes**, que abre por padrão e é a descrita abaixo, e **Histórico de
cobranças**. No alto à direita fica o botão **Comprovante**, com ícone de download.

### Dados da cobrança

| Campo | O que traz |
| - | - |
| **Data de início** | O dia em que o parcelamento começou — é por este campo que a lista filtra |
| **Status do parcelamento** | Um selo com o estado do parcelamento |
| **Produto** | O produto vendido, o seu tipo (por exemplo, **Produto Digital**) e o valor |
| **Oferta vinculada** | A oferta que originou a venda |

### Pagamento

| Campo | O que traz |
| - | - |
| **Total** | O valor cheio da venda |
| **Parcelamento** | Quantas parcelas e de quanto — no print acima, `12x de R$ 148,93` |
| **Status atual da cobrança** | Um selo com o estado da cobrança da vez |
| **Data da próxima cobrança** | O dia em que a próxima parcela é cobrada |
| **Cartão cadastrado** | A bandeira e os **quatro últimos dígitos** do cartão. O painel nunca mostra o número inteiro |

São dois selos com propósitos diferentes: **Status do parcelamento** descreve o parcelamento
inteiro; **Status atual da cobrança**, só a parcela da vez. No print acima os dois marcam
`Reembolsado` — um estado que não está entre as quatro colunas do gráfico da lista.

### Cliente e Transação

À direita ficam dois blocos de identificação:

| Bloco | Campos |
| - | - |
| **Cliente** | Nome · Telefone · E-mail |
| **Transação** | Funil · ID da 1ª transação · Link do checkout |

O **ID da 1ª transação** é o identificador da venda que abriu o parcelamento — o mesmo que a lista
mostra na primeira coluna. Use-o para achar essa venda em [Vendas](/vendas/transacoes).

## Parcelamento comum e Parcelamento Inteligente

São dois caminhos diferentes para a mesma venda parcelada:

<Tabs>
  <Tab title="Parcelamento no cartão">
    O cliente parcela usando o limite do cartão de crédito. A oferta define em quantas vezes ele pode dividir — o padrão do checkout permite até 12x. O número de parcelas chega no campo `installments` da transação; em compras à vista, esse campo vem `1`.
  </Tab>

  <Tab title="Parcelamento Inteligente">
    O cliente parcela **sem usar o limite do cartão**: a Assiny cobra uma parcela por vez, de forma parecida com uma assinatura. Nesse caso, `installments` fica em `1` e o número real de parcelas vai no objeto `smart_installment`.
  </Tab>
</Tabs>

<Warning>
  Em vendas com Parcelamento Inteligente, o número real de parcelas está em `smart_installment.total_installments` — **não** em `installments`.
</Warning>

## O que o webhook envia sobre a parcela

Quando a venda usa o Parcelamento Inteligente, a transação traz um objeto com o estado do parcelamento:

```json Smart installment theme={null}
{
  "smart_installment": {
    "smart_installment_id": "e3255bd0-abcd-abcd-abcd-5502bfc68ae7",
    "total_installments": 8,
    "next_charge": "2025-01-14T13:29:10.296151Z",
    "current_installment": 2
  }
}
```

| Campo | O que significa |
| - | - |
| `total_installments` | Número de parcelas escolhido pelo cliente na compra |
| `current_installment` | Parcela em que o cliente está agora |
| `next_charge` | Data da próxima cobrança |

Fora do Parcelamento Inteligente, `smart_installment` volta como `null`.

<CardGroup cols={2}>
  <Card title="Parcelamento Inteligente" icon="credit-card" href="/apps/smart-installments">
    Ative o app e crie as regras por produto e oferta
  </Card>

  <Card title="Transaction" icon="receipt" href="/webhooks/estrutura/transaction">
    Os campos `installments` e `smart_installment` no payload
  </Card>

  <Card title="Smart Recovery" icon="rotate-left" href="/apps/smart-recovery">
    Recupere quem não tinha limite oferecendo desconto no PIX
  </Card>

  <Card title="Vendas" icon="table-list" href="/vendas/transacoes">
    Veja cada cobrança no extrato de transações
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.