> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt.

# Suscripciones y facturación

Cada espacio de trabajo de cliente puede tener una suscripción a un nivel que vendas. La tarjeta de tu cuenta de distribuidor paga las facturas de todos los espacios de trabajo. La suscripción actual de un espacio de trabajo está en el campo `subscription` de `workspaces.list`, junto con `has_payment_issue`.

## Asigna un plan

Suscribe un espacio de trabajo que aún no tenga plan. `billing_period` puede ser `monthly_period` (el valor predeterminado) o `annual_period`.

```python
from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

elevenlabs.reception.subscriptions.assign(
    "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7",
    tier_id="smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
    billing_period="annual_period",
    idempotency_key="assign-8f1c2a7e-2026-11-03",
)
```

```typescript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient();

await elevenlabs.reception.subscriptions.assign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7", {
  tierId: "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0",
  billingPeriod: "annual_period",
  idempotencyKey: "assign-8f1c2a7e-2026-11-03",
});
```

```bash
curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tier_id": "smbtier_4401k8r2c6hxe9tq3vz7m5wd1nb0", "billing_period": "annual_period", "idempotency_key": "assign-8f1c2a7e-2026-11-03" }'
```

Envía un `idempotency_key` que generes en cada asignación o cambio. Si se agota el tiempo de espera de una solicitud, volver a intentarlo con la misma clave evita suscribir o cobrar dos veces al espacio de trabajo.

La asignación o el cambio de plan se rechazan mientras `has_payment_issue` sea `true`. Muestra la factura impagada a tu cliente o págala mediante su `pay_url` antes de volver a intentarlo.

## Cambia un plan

`subscriptions.change` acepta el mismo cuerpo que `assign`.

* Una mejora de plan se aplica de inmediato.
* Una reducción de plan o un cambio a un nivel del mismo rango entra en vigor al final del periodo de facturación. Hasta entonces, la suscripción muestra el nuevo nivel en `pending_downgrade_tier` y la fecha en `pending_downgrade_at_unix`.

Para mantener el espacio de trabajo en su nivel actual, elimina la reducción de plan programada con `subscriptions.cancel_pending_downgrade`.

```python
elevenlabs.reception.subscriptions.change(
    "8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7",
    tier_id="smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5",
)

elevenlabs.reception.subscriptions.cancel_pending_downgrade("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")
```

```typescript
await elevenlabs.reception.subscriptions.change("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7", {
  tierId: "smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5",
});

await elevenlabs.reception.subscriptions.cancelPendingDowngrade("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7");
```

```bash
curl -X PATCH "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription" \
  -H "xi-api-key: $ELEVENLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tier_id": "smbtier_4401k8r2d3pfw8ys6bq2n9ja7kc5" }'

curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription/cancel-downgrade" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

Cuando entra en vigor una reducción de plan, se desactivan los recepcionistas y números de teléfono que excedan los límites del nuevo plan, y se suspenden los miembros del equipo que excedan su tamaño máximo.

## Cancela un plan

`subscriptions.unassign` finaliza la suscripción al término del periodo de facturación actual. Hasta entonces, `cancel_at_unix` indica cuándo finaliza, y `subscriptions.restore` deshace la cancelación para que el plan se renueve normalmente.

```python
elevenlabs.reception.subscriptions.unassign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")

elevenlabs.reception.subscriptions.restore("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7")
```

```typescript
await elevenlabs.reception.subscriptions.unassign("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7");

await elevenlabs.reception.subscriptions.restore("8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7");
```

```bash
curl -X DELETE "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"

curl -X POST "https://api.elevenlabs.io/v1/reception/reseller/workspaces/8f1c2a7e4b9d4e6fa3c5b2d1e0f9a8b7/subscription/restore" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

## Facturas

Cada cargo en tu tarjeta paga la factura de un espacio de trabajo. `billing.list_invoices` las devuelve de la más reciente a la más antigua, una página cada vez. El `status` de una factura puede ser:

| Estado | Significado                                                                                 |
| ------ | ------------------------------------------------------------------------------------------- |
| `paid` | Se ha realizado el cargo en la tarjeta.                                                     |
| `open` | Se sigue intentando realizar el cargo en la tarjeta. `pay_url` enlaza a una página de pago. |
| `void` | Se agotaron los reintentos y se canceló el plan del espacio de trabajo.                     |

`billing.get_invoice` añade las `lines` de la factura. Una línea con un `amount_cents` negativo es un crédito por prorrateo, y las líneas siempre suman el cargo total.

```python
page = elevenlabs.reception.billing.list_invoices(page_size=25)
for invoice in page.invoices:
    print(invoice.workspace_name, invoice.status, invoice.amount_cents / 100, invoice.currency)

detail = elevenlabs.reception.billing.get_invoice(page.invoices[0].invoice_id)
for line in detail.lines:
    print(line.kind, line.description, line.amount_cents)
```

```typescript
const page = await elevenlabs.reception.billing.listInvoices({ pageSize: 25 });
for (const invoice of page.invoices) {
  console.log(invoice.workspaceName, invoice.status, invoice.amountCents / 100, invoice.currency);
}

const detail = await elevenlabs.reception.billing.getInvoice(page.invoices[0].invoiceId);
for (const line of detail.lines) {
  console.log(line.kind, line.description, line.amountCents);
}
```

```bash
curl "https://api.elevenlabs.io/v1/reception/reseller/billing/invoices?page_size=25" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```

## Próximos pagos

`billing.list_upcoming_payments` calcula la próxima renovación de cada espacio de trabajo, empezando por la más próxima. `plan_usd` es el plan que se cobra por adelantado en la renovación, que corresponde al precio del nivel reducido cuando hay una reducción de plan programada. `overage_so_far_usd` es el uso de este periodo que hasta ahora excede los minutos incluidos. Se cobra en la renovación y sigue aumentando hasta entonces.

```python
upcoming = elevenlabs.reception.billing.list_upcoming_payments()
for payment in upcoming.payments:
    print(
        payment.workspace_name,
        payment.subscription.billing_period_end_unix,
        payment.plan_usd + payment.overage_so_far_usd,
    )
```

```typescript
const upcoming = await elevenlabs.reception.billing.listUpcomingPayments();
for (const payment of upcoming.payments) {
  console.log(
    payment.workspaceName,
    payment.subscription.billingPeriodEndUnix,
    payment.planUsd + payment.overageSoFarUsd
  );
}
```

```bash
curl "https://api.elevenlabs.io/v1/reception/reseller/billing/upcoming" \
  -H "xi-api-key: $ELEVENLABS_API_KEY"
```