---
title: Så hanterar du konton och användare för white label via Partner API
description: Visar hur en white label-partner skapar kundkonton, användare, bankkonton och Peppol-ID via Partner API, och vilka regler som gäller.
---

[Hoppa till innehåll](https://knowledge.qvalia.com/sv/konton-och-anvandare-for-white-label-via-partner-api#main-content)

- [Svenska](https://knowledge.qvalia.com/sv/konton-och-anvandare-for-white-label-via-partner-api)
- [English](https://knowledge.qvalia.com/white-label-accounts-and-users)

Svenska

Visa undermenyer för översättningar

[Skapa ticket](https://knowledge.qvalia.com/sv/kb-tickets/new?hsLang=sv) [Kundportal](https://servicedesk.qvalia.com/tickets?hsLang=sv)

[![Qvalia Logo New Blue transparent.png\]](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png)](https://qvalia.com/se/)

Öppna huvudnavigering

Stäng huvudnavigering

- - [Svenska](https://knowledge.qvalia.com/sv/konton-och-anvandare-for-white-label-via-partner-api)
    - [English](https://knowledge.qvalia.com/white-label-accounts-and-users)

  Svenska
  
  Visa undermenyer för översättningar
- [Skapa ticket](https://knowledge.qvalia.com/sv/kb-tickets/new)
- [Kundportal](https://servicedesk.qvalia.com/tickets)

 Hur kan vi hjälpa dig?

- Det finns inga förslag eftersom sökfältet är tomt.

1. [Kunskapsbank](https://knowledge.qvalia.com/sv?hsLang=sv)
2. [Partner](https://knowledge.qvalia.com/sv/partner?hsLang=sv)

# Så hanterar du konton och användare för white label via Partner API

## Alla kundkonton och användare i white label-portalen hanteras via Qvalias Partner API. Innan ni går live bör ert utvecklingsteam känna till API:et och ha flödet för att skapa konton igång i testmiljön.

- Varje kund behöver ett eget Qvalia-konto.
- Varje person som ska använda portalen måste finnas som användare på kundens konto, oavsett vilken inloggningsmetod du väljer.
- Användarens e-postadress är inloggningsnyckeln.
- API-integration måste vara aktiverad på varje kundkonto, annars kan du inte hantera kontot via API:et.

Den fullständiga referensen finns i [dokumentationen för Partner API](https://api.qvalia.io/api-documentation/apis/partner-api/partner-api).

### Miljöer och autentisering

 Miljö

 Bas-URL

 Test

`https://api-test.qvalia.com`

 Produktion

`https://api.qvalia.com`

Anrop autentiseras med en API-nyckel i headern `Authorization`, eller med en bearer-JWT som hämtas från Authentication API. API-uppgifterna är bara till för anrop mellan servrar och får aldrig exponeras i en webbläsare.

### Operationer du kommer att använda

Alla sökvägar ligger under `/partner/{partnerRegNo}`.

 Resurs

 Operationer

 Sökväg

 Konton

 Lista, skapa, läsa, uppdatera

`/account`, `/account/{accountRegNo}`

 Användare

 Lista, skapa, läsa, uppdatera, ta bort

`/account/{accountRegNo}/user[/{userEmail}]`

 Bankkonton

 Lista, skapa, läsa, uppdatera, ta bort

`/account/{accountRegNo}/bankaccount[/{bankAccount}]`

 Peppol-ID

 Lista, läsa, lägga till eller uppdatera (PUT), ta bort

`/account/{accountRegNo}/peppol[/{peppolId}]`

 Peppol-uppslag

 Slå upp valfri deltagare i Peppol

`/peppol/lookup/{peppolId}`

### Skapa ett kundkonto

Skapa kontot med `POST /partner/{partnerRegNo}/account`. Aktivera API-integration så att du kan hantera kontot via API:et, och de funktioner kunden ska ha:

`{`

`  "accountRegNo": "FI01234567",`

`  "name": "Customer Oy",`

`  "address": "Esimerkkikatu 1",`

`  "postalCode": "00100",`

`  "city": "Helsinki",`

`  "country": "FI",`

`  "currency": "EUR",`

`  "appFeatures": {`

`    "apiIntegration": { "active": true },`

`    "invoiceManagement": { "active": true },`

`    "orderManagement": { "active": true }`

`  }`

`}`

Loggar dina användare in genom att din applikation skickar vidare en token (JWT) lägger du också till funktionen `whiteLabel` med ditt partneralias i `appFeatures`. Aliaset måste stämma med parametern `wl` i inloggningsanropet. Det behövs inte om användarna loggar in med Qvalias portalinloggning.

`"whiteLabel": { "active": true, "wl_partners": [" "] }`

### Lägg till användare på varje konto

Skapa användare med `POST /partner/{partnerRegNo}/account/{accountRegNo}/user`. Med Qvalias portalinloggning är e-postadressen användarnamnet. Med tokeninloggning måste den vara identisk med parametern `email` i inloggningsanropet, annars nekas inloggningen.

`{`

`  "email": "user@customer.example",`

`  "name": "Example User",`

`  "language": "fi",`

`  "privilege": "admin"`

`}`

### Bra att veta

- `accountRegNo`, `name`, `address`, `postalCode` och `country` (ISO 3166 alpha-2) är obligatoriska. `accountRegNo` är det värde som används som `account` i inloggningsanropet.
- API-integration måste vara aktiverad på varje underkonto, annars kan du inte hantera det via API:et.
- Användare kräver `email`, `name` och `language` (`en`, `sv` eller `fi`), med behörigheten `viewer`, `user` eller `admin`.
- Håll användarna i synk med ditt eget system: lägg till, uppdatera och ta bort dem via API:et när personer tillkommer eller slutar.
- I en white label-uppsättning används det bankkonto som är markerat `is_default` på fakturor som kunden skapar. Bara ett konto kan vara standard.
- Peppol-ID skapas och uppdateras med `PUT` av hela objektet. Läs först det aktuella objektet och skicka sedan den ändrade versionen.
- Registrera CreditNote varje gång du registrerar Invoice.
- Anropsgränser gäller per konto. Vid `429` väntar du det antal sekunder som anges i `Retry-After` innan du försöker igen.
- Fel returneras i ett gemensamt format. Styr på den stabila koden i `type`, till exempel `E_VALIDATION`, inte på meddelandetexten. Se [Vanliga API-fel och vad de betyder](https://knowledge.qvalia.com/sv/api-error-codes-and-responses?hsLang=sv).

### Om det fortfarande inte fungerar

- Kontrollera att API-integration är aktiverad på kontot och att du anropar rätt miljö med uppgifterna för just den miljön.
- Ha ditt partnerregistreringsnummer, `accountRegNo`, endpointen, tidpunkten för anropet och koden i `type` från felsvaret till hands.
- Kontakta din partneransvariga på Qvalia, eller Qvalias support via [qvalia.com/contact-support](https://qvalia.com/contact-support).

- [Allmänt](https://knowledge.qvalia.com/sv/allm%C3%A4nt?hsLang=sv#main-content)

    - [Peppol](https://knowledge.qvalia.com/sv/allm%C3%A4nt?hsLang=sv#peppol)
- [Partner](https://knowledge.qvalia.com/sv/partner?hsLang=sv)
- [Loggar och spårbarhet](https://knowledge.qvalia.com/sv/loggar-och-sp%C3%A5rbarhet?hsLang=sv)
- [Integrationer](https://knowledge.qvalia.com/sv/integrationer?hsLang=sv)
- [Fakturahantering](https://knowledge.qvalia.com/sv/fakturahantering?hsLang=sv)
- [Orderhantering](https://knowledge.qvalia.com/sv/orderhantering?hsLang=sv)
- [Datahantering](https://knowledge.qvalia.com/sv/datahantering?hsLang=sv)
- [Säkerhet och regelefterlevnad](https://knowledge.qvalia.com/sv/s%C3%A4kerhet-och-regelefterlevnad?hsLang=sv)
- [Konto](https://knowledge.qvalia.com/sv/konto?hsLang=sv)
- [Felsökning](https://knowledge.qvalia.com/sv/fels%C3%B6kning?hsLang=sv)

[![Chill listening crop-3](https://knowledge.qvalia.com/hs-fs/hubfs/Qvalia%20Logo%20New%20Blue%20transparent.png?width=107&height=24&name=Qvalia%20Logo%20New%20Blue%20transparent.png "Chill listening crop-3")](https://qvalia.com/)

Kunskapsbank

Copyright © 2025, Qvalia