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

# Subskrypcje i rozliczenia

Każdy obszar roboczy klienta może mieć jedną subskrypcję poziomu, który sprzedajesz. Twoja karta partnera handlowego opłaca faktury wszystkich obszarów roboczych. Bieżąca subskrypcja obszaru roboczego znajduje się w polu `subscription` w `workspaces.list`, wraz z `has_payment_issue`.

## Przypisz plan

Zasubskrybuj obszar roboczy, który nie ma jeszcze planu. `billing_period` to `monthly_period` (domyślnie) lub `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" }'
```

Przy każdym przypisaniu lub zmianie wyślij wygenerowany przez siebie `idempotency_key`. Jeśli żądanie przekroczy limit czasu, ponowienie go z tym samym kluczem nie zasubskrybuje ani nie obciąży obszaru roboczego dwa razy.

Przypisanie lub zmiana planu zostanie odrzucona, gdy `has_payment_issue` ma wartość `true`. Przed ponowną próbą pokaż klientowi niezapłaconą fakturę lub opłać ją przez `pay_url`.

## Zmień plan

`subscriptions.change` przyjmuje ten sam body co `assign`.

* Przejście na wyższy plan działa od razu.
* Przejście na niższy plan lub na poziom o tej samej klasie zaczyna obowiązywać po zakończeniu okresu rozliczeniowego. Do tego czasu subskrypcja pokazuje nowy poziom w `pending_downgrade_tier` i datę w `pending_downgrade_at_unix`.

Aby pozostawić obszar roboczy na obecnym poziomie, anuluj zaplanowane obniżenie za pomocą `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"
```

Gdy obniżenie planu zacznie obowiązywać, recepcjoniści i numery telefonów ponad limity nowego planu zostaną wyłączeni, a członkowie zespołu ponad jego limit wielkości zespołu — zawieszeni.

## Zakończ plan

`subscriptions.unassign` kończy subskrypcję z końcem bieżącego okresu rozliczeniowego. Do tego czasu `cancel_at_unix` pokazuje, kiedy się zakończy, a `subscriptions.restore` cofa anulowanie, aby plan odnowił się normalnie.

```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"
```

## Faktury

Każde obciążenie twojej karty opłaca fakturę jednego obszaru roboczego. `billing.list_invoices` zwraca je od najnowszych, po jednej stronie naraz. `status` faktury ma jedną z wartości:

| Status | Znaczenie                                                                      |
| ------ | ------------------------------------------------------------------------------ |
| `paid` | Karta została obciążona.                                                       |
| `open` | Trwają ponowne próby obciążenia karty. `pay_url` prowadzi do strony płatności. |
| `void` | Wyczerpano ponowne próby, a plan obszaru roboczego został zakończony.          |

`billing.get_invoice` dodaje `lines` faktury. Wiersz z ujemnym `amount_cents` to uznanie proporcjonalne, a suma wierszy zawsze równa się obciążeniu.

```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"
```

## Nadchodzące płatności

`billing.list_upcoming_payments` szacuje kolejne odnowienie każdego obszaru roboczego, od najbliższego. `plan_usd` to plan, za który odnowienie pobiera opłatę z góry; gdy zaplanowano obniżenie, jest to cena niższego poziomu. `overage_so_far_usd` to dotychczasowe użycie w tym okresie ponad zawarte w planie minuty. Zostanie naliczone przy odnowieniu i będzie rosło do tego czasu.

```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"
```