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 och öppnar inga /3/-resurser.
Begära scopes
Ange dem mellanslagsseparerade i scope vid auktoriseringen. 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:
{ "ErrorInformation": { "Error": 1, "Message": "Scope saknas för anropet: invoice", "Code": 9000403 } }