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

# Prenumerationer och fakturering

Varje kundarbetsyta kan ha en prenumeration på en nivå som du säljer. Ditt återförsäljarkort betalar fakturorna för varje arbetsyta. En arbetsytas aktuella prenumeration finns i fältet `subscription` i `workspaces.list`, tillsammans med `has_payment_issue`.

## Tilldela en plan

Prenumerera på en arbetsyta som ännu inte har någon plan. `billing_period` är `monthly_period` (standard) eller `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" }'
```

Skicka en `idempotency_key` som du genererar vid varje tilldelning eller ändring. Om en begäran får timeout kan du försöka igen med samma nyckel utan att arbetsytan prenumererar eller debiteras två gånger.

Tilldelning eller ändring av en plan nekas när `has_payment_issue` är `true`. Visa den obetalda fakturan för kunden, eller betala den via `pay_url`, innan du försöker igen.

## Ändra en plan

`subscriptions.change` tar samma body som `assign`.

* En uppgradering tillämpas direkt.
* En nedgradering eller flytt till en nivå på samma nivå träder i kraft vid slutet av faktureringsperioden. Fram till dess visar prenumerationen den nya nivån i `pending_downgrade_tier` och datumet i `pending_downgrade_at_unix`.

För att behålla arbetsytan på dess nuvarande nivå tar du bort den schemalagda nedgraderingen med `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"
```

När en nedgradering träder i kraft inaktiveras receptionister och telefonnummer utöver den nya planens gränser, och teammedlemmar utöver dess teamstorlek stängs av.

## Avsluta en plan

`subscriptions.unassign` avslutar prenumerationen i slutet av den aktuella faktureringsperioden. Fram till dess visar `cancel_at_unix` när den avslutas, och `subscriptions.restore` ångrar uppsägningen så att planen förnyas som vanligt.

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

## Fakturor

Varje debitering av ditt kort betalar en arbetsytas faktura. `billing.list_invoices` returnerar dem med de senaste först, en sida i taget. En fakturas `status` är en av följande:

| Status | Betydelse                                                                       |
| ------ | ------------------------------------------------------------------------------- |
| `paid` | Kortet har debiterats.                                                          |
| `open` | Kortet försöker fortfarande debiteras. `pay_url` länkar till en betalningssida. |
| `void` | Alla försök misslyckades och arbetsytans plan avslutades.                       |

`billing.get_invoice` lägger till fakturans `lines`. En rad med negativt `amount_cents` är en proportionell kredit, och raderna summerar alltid till debiteringen.

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

## Kommande betalningar

`billing.list_upcoming_payments` uppskattar nästa förnyelse för varje arbetsyta, med den närmaste först. `plan_usd` är planen som förnyelsen debiterar i förskott, vilket är priset för den nedgraderade nivån när en nedgradering är schemalagd. `overage_so_far_usd` är den här periodens användning utöver de inkluderade minuterna hittills. Den debiteras vid förnyelsen och fortsätter att öka fram till dess.

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