Enterprise API

Qlave Platform API

Swagger-inspirerad upplevelse med enterprise-säkerhet, mTLS, spårbarhet och signerade webhooks. Byggt för faktura-, betal- och BankID-flöden.

SwaggerKontakta oss
Klar för prod

SLA, status-sida, audit-logg och rollout med canaries.

AuthFakturorAttestBokföringBetalningBankIDWebhooksTicketsHRSDKSwagger UI
OpenAPI 3.0.3JSONSwagger-lik vy
Översikt
Signerade webhooksmTLS-stöd
Bas-URL
https://api.qlave.com/v1Prod
Sandbox
https://sandbox.api.qlave.com/v1Test
Auth
OAuth2 Client Credentials + mTLS
Idempotency
X-Idempotency-Key på skriv
Version
OpenAPI 1.0.0JSON
Status
SLA, audit-logg, trace
Prod-SLAAudit-loggSpårbarhetCanary rollouts
Auth

JWT med klientuppgifter och valfri mTLS.

POST/auth/token
auth
Hämta åtkomsttoken

Returnerar JWT. Kombinera med mTLS för server-to-server.

curl -X POST https://api.qlave.com/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{"client_id":"...","client_secret":"...","scope":"invoices.read"}'
{
  "access_token": "eyJhbGciOi...",
  "token_type": "Bearer",
  "expires_in": 3600
}
Fakturor, distribution och attest

Skapa, leverera och attestera fakturor med Peppol, Kivra och e-faktura samt påminnelse/inkasso.

POST/invoices
invoicesfakturahantering
Skapa faktura

Peppol/Kivra/e-faktura, idempotency-key och leveransval vid skapande.

POST /invoices
Authorization: Bearer <token>
X-Idempotency-Key: <uuid>
{
  "customer_id": "cust_123",
  "amount": 1299,
  "currency": "SEK",
  "due_date": "2024-10-01",
  "delivery": {"channel": "peppol"}
}
POST/invoices/{id}/deliver
distribution
Leverera faktura

Email, Kivra, e-faktura eller Peppol med schemaläggning och status-URL.

PUT/invoices/{id}/attest
attestering
Attestera faktura

Lås dokumentet efter attest. Korrelations-ID loggas automatiskt.

POST/invoices/{id}/remind
collection
Skicka påminnelse

E-post, Kivra eller brev med valfri påminnelseavgift och nytt förfallodatum.

POST/invoices/{id}/collections
collection
Överlämna till inkasso

Välj partner (t.ex. Intrum) och handover-datum. Spåras i cases.

Attest

Godkännande och låsning av dokument inkl. vidarebefordran och kommentarer.

PUT/invoices/{id}/attest
attestering
Attestera faktura

Lås dokumentet efter attest. Korrelations-ID loggas automatiskt.

POST/invoices/{id}/attest/approve
attestenterprise-pro
Godkänn

Markerar fakturan som godkänd av aktuell attestant.

POST/invoices/{id}/attest/reject
attestenterprise-pro
Neka

Avvisar attest med obligatorisk orsak.

POST/invoices/{id}/attest/forward
attestenterprise-pro
Vidarebefordra

Skickar vidare till ny attestant och loggar spårbarhet.

POST/invoices/{id}/attest/comment
attestenterprise-pro
Kommentera

Lägger till kommentar utan beslut i attestflödet.

GET/attest/requests
attestscope:attest.read
Lista attestärenden

Filter status/assigned_to, scope: attest.read

GET/attest/requests/{id}
attestscope:attest.read
Hämta attestärende

Returnerar ärendet med historik, scope: attest.read

POST/attest/requests/{id}/submit
attestscope:attest.write
Skapa/submit

Skapar eller lämnar in ärendet, scope: attest.write

POST/attest/requests/{id}/review
attestscope:attest.write
Granska

Markerar som granskad utan beslut, scope: attest.write

POST/attest/requests/{id}/approve
attestscope:attest.write
Godkänn ärende

Godkänner och loggar actor_id, scope: attest.write

POST/attest/requests/{id}/reject
attestscope:attest.write
Neka ärende

Avvisar med orsak, scope: attest.write

POST/attest/requests/{id}/forward
attestscope:attest.manage
Vidarebefordra

Skickar till annan attestant/kredit, scope: attest.manage

POST/attest/requests/{id}/comment
attestscope:attest.write
Kommentera

Lägger till kommentar utan beslut, scope: attest.write

POST/attest/requests/{id}/escalate
attestscope:attest.manage
Eskalera

Eskalera till högre nivå, scope: attest.manage

POST/attest/requests/{id}/credit-check
attestscope:attest.manage
Kreditkontroll

Initierar kreditkontroll, scope: attest.manage

POST/attest/requests/{id}/send-to-finance
attestscope:attest.manage
Skicka till ekonomi

Överlämnar till ekonomi, scope: attest.manage

GET/attest/requests/{id}/status
attestscope:attest.read
Status

Aktuell status, scope: attest.read

GET/attest/requests/{id}/history
attestscope:attest.read
Historik

Alla steg och beslut, scope: attest.read

GET/attest/users
attest-adminscope:attest.admin
Lista användare

Attestbehörigheter och roller, scope: attest.admin

POST/attest/users/{id}/assign
attest-adminscope:attest.admin
Tilldela ärende

Sätt assignee för ett ärende, scope: attest.admin

GET/attest/settings
attest-adminscope:attest.admin
Inställningar

Nivåer, regler och roller, scope: attest.admin

Bokföring

Export, verifikat och status för redovisning.

POST/invoices/export
bokforing
Begär export

SIE4/CSV för period. Returnerar export_id.

GET/invoices/export/{export_id}
bokforing
Exportstatus

Status + download_url för export.

POST/accounting/vouchers
bokforing
Skapa verifikat

Genererar verifikat för intervall (SIE/CSV).

Betalningar och Autogiro

Swish, kort, Autogiro och refunds. End-to-end spårbarhet och status-URL:er.

POST/payments/swish
betalningarfakturahantering
Skapa Swish-betalning

Initiera Swish med invoice_id och telefon. Får payment_id + status_url.

POST/invoices/{id}/pay
betalningarinvoices
Initiera kort/Autogiro

method: swish | card | autogiro. Returnerar payment session och status_url.

POST/payments/autogiro/mandates
betalningar
Autogiro-mandat

Registrera kundens samtycke (IBAN/clearing) och få mandate_id + status.

POST /payments/autogiro/mandates
{
  "customer_id": "cust_123",
  "account": "SE45 5000 0000 0583 9825 7466",
  "consent_text": "Godkänner Autogiro-dragningar",
  "webhook_url": "https://qrona.se/hooks/autogiro"
}
POST/payments/refund/{id}
betalningar
Refund

Återbetala Swish eller kort-betalning. Idempotent per payment.

BankID

Auth och signering med autoStartToken och status polling.

POST/bankid/auth
bankid
Starta BankID auth

orderRef och autoStartToken returneras. Använd user_agent för device matching.

POST/bankid/sign
bankidauth
BankID sign

Skicka text att signera. Passar attestflöden och avtal.

Webhooks

Signerade med HMAC-SHA256. Retries via API eller portal.

POST/webhooks
webhooksintegrations
Registrera webhook

Ange url + events. Får secret för signatur (X-Qlave-Signature).

{
  "url": "https://qrona.se/hooks/qlave",
  "events": ["invoice.sent", "payment.succeeded"]
}
POST/webhooks/retry
webhooks
Retry misslyckade leveranser

hours + typer. Planerar omleverans av misslyckade events.

Ärenden (Tickets)

Support- och ekonomiärenden kopplade till kunder och fakturor.

GET/cases
arende
Lista ärenden

Filtrera på status eller kund. Returnerar ärenden (tickets).

POST/cases
arendefakturahantering
Skapa ärende

Knyt till kund eller faktura för support/ekonomi.

GET/cases/{id}
arende
Hämta ärende

Returnerar ticket med status, assignee och kopplingar.

PATCH/cases/{id}
arende
Uppdatera ärende

Ändra status eller assignee.

HR

Anställda, roller och åtkomst.

GET/hr/employees
hr
Lista anställda

Filter på department och status.

POST/hr/employees
hr
Skapa anställd

Lägg till person med roll och e-post.

GET/hr/employees/{id}
hr
Hämta anställd

Detaljer för en anställd.

DELETE/hr/employees/{id}
hr
Avaktivera anställd

Sätter status inactive och drar tillbaka access.

SDK & support

Behöver du SDK eller Postman?

Vi genererar SDK (TypeScript/Java/Kotlin) direkt från /openapi.json, tillhandahåller Postman-kollektion och kör mTLS-cert-hantering för prod/sandbox.

Öppna Swagger UIBoka teknisk genomgång