---
title: "Previsualizar el prorrateo de cambios"
method: POST
path: "/subscriptions/{id}/proration_preview"
tags: ["subscriptions"]
---

# Previsualizar el prorrateo de cambios

`POST /subscriptions/{id}/proration_preview`

Calcula el prorrateo neto de un conjunto de cambios de productos **sin aplicarlos** (equivalente al preview de facturas de Stripe). Envía los mismos `items` y `mode` que enviarías a `PUT /subscriptions/{id}`. Útil para mostrar el monto antes de cobrar con `mode: now_and_charge`.

`chargeable` indica si el neto puede cobrarse de inmediato (positivo y mayor al mínimo de la moneda). Si es `false`, usa `mode: now` (se reflejará en el próximo cobro).

## Path parameters

- `id` string, required

## Headers

- `X-SECRET-KEY` string, required

## Request body

- object
  - `mode` 'next_cycle' | 'now' | 'now_and_charge' — Mismo significado que en `PUT /subscriptions/{id}`. `next_cycle` no genera prorrateo.
  - `items` SubscriptionsIdProrationPreviewPostRequestBodyContentApplicationJsonSchemaItemsItems[] — Lista de cambios a previsualizar (mismo formato que en la actualización).
    - `price_id` string
    - `product_id` string
    - `quantity` integer
    - `deleted` boolean

## Response `200`

Estimación del prorrateo

- SubscriptionsPreviewSubscriptionProrationResponse200
  - `net_amount_in_cents` integer — Prorrateo neto en centavos. Positivo = cobro; negativo = crédito.
  - `currency` string
  - `chargeable` boolean — `true` si el neto puede cobrarse de inmediato (positivo y mayor al mínimo de la moneda).
  - `lines` SubscriptionsIdProrationPreviewPostResponsesContentApplicationJsonSchemaLinesItems[] — Desglose por producto (prorrateos positivos y créditos).
    - `description` string
    - `amount_in_cents` integer

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/f494a078482c/schema)