# Scopes (/api/scopes)

> Vilka scopes som finns och vilka resurser de öppnar.

Scopes sätts **per resurs**, inte per verb. Precis som hos Fortnox finns ingen uppdelning i läs- och skrivrätt: den som har `customer` kan både läsa och ändra kunder. Namnen är Fortnox egna, så en befintlig integration kan begära samma scopes.

| Scope | Resurser | Beskrivning användaren ser vid godkännandet |
|---|---|---|
| `article` | `/3/articles` | Läsa och ändra ditt artikelregister |
| `customer` | `/3/customers` | Läsa och ändra ditt kundregister |
| `invoice` | `/3/invoices`, `/3/invoicepayments` | Läsa och ändra dina fakturor, samt registrera betalningar |
| `bookkeeping` | `/3/accounts`, `/3/vouchers`, `/3/voucherseries`, `/3/financialyears` | Läsa din kontoplan, dina verifikationer och räkenskapsår, samt bokföra nya verifikationer |
| `settings` | `/3/settings/lockedperiod` | Läsa dina bokföringsinställningar, till exempel vilken period som är låst |
| `supplier` | `/3/suppliers` | Läsa och ändra ditt leverantörsregister |
| `supplierinvoice` | `/3/supplierinvoices` | Läsa och ändra dina leverantörsfakturor, samt bokföra dem |
| `salary` | `/3/employees` | Läsa och ändra ditt personalregister, inklusive löneuppgifter och maskerade personnummer |

`supplier` och `supplierinvoice` är skilda scopes, så ett inköpssystem som bara läser leverantörsregistret behöver inte kunna bokföra leverantörsfakturor. `salary` ger åtkomst till personalregistret, inte till lönekörningar, lönespecifikationer eller AGI.

Scopet `mcp` hör till [MCP-servern](/mcp) och öppnar inga `/3/`-resurser.

## Begära scopes [#begära-scopes]

Ange dem mellanslagsseparerade i `scope` vid [auktoriseringen](/api/autentisering). Du kan bara begära scopes som Klirr registrerat för din klient; annars skickas användaren tillbaka med `error=invalid_scope`.

Saknar token det scope en resurs kräver svarar API:t `403`:

```json
{ "ErrorInformation": { "Error": 1, "Message": "Scope saknas för anropet: invoice", "Code": 9000403 } }
```