Svensk B2B-onboarding: bolagsdata, BankID och avtal

01 · Utgångsläget

Onboarding ser enkel ut tills den möter verkligheten.

Ett nytt företagskonto börjar ofta med tre fält. I verkligheten måste tjänsten förstå vilket bolag det gäller, vem personen är och vad parterna faktiskt har godkänt.

Tänk ett bolag som bygger en webbtjänst eller ett CMS för svenska företagskunder. Kunden ska kunna registrera sitt bolag, logga in säkert och teckna ett avtal innan arbetsytan aktiveras. Om varje del löses separat uppstår snabbt tre datamodeller, tre supportflöden och tre olika sätt att hantera fel.

Det viktiga är därför inte bara att välja API:er. Det är att ge varje komponent ett tydligt ansvar och låta den egna produkten äga den sammanhängande kundresan.

Grundprincipen

Företagsdata svarar på vilket bolag. BankID svarar på vilken person. Avtalet dokumenterar vad som accepterats. Blanda inte ihop de tre bevisen.

02 · Målbilden

Ett flöde för kunden. Tydliga gränser i tekniken.

Kunden ska uppleva en enda onboarding, även när flera specialiserade tjänster arbetar under ytan. En robust målbild kan delas upp i fem steg.

Steg 01

Hitta bolaget

Organisationsnummer eller sökning hämtar verifierad grunddata från BolagsAPI.

Steg 02

Bekräfta personen

Auth by Hugo genomför identifiering med BankID och lämnar tillbaka en säker session.

Steg 03

Skapa arbetsytan

Den egna tjänsten kopplar personen till ett preliminärt företagskonto och rätt behörighet.

Steg 04

Godkänn villkoren

Avtalsklart skickar rätt dokument till rätt mottagare och samlar signaturen.

Steg 05

Aktivera

En signerad händelse aktiverar abonnemanget och sparas i produktens händelselogg.

Separera identitet från behörighet

BankID visar vem personen är, men inte automatiskt vad personen får göra i ert system eller om personen ensam får företräda bolaget i varje situation. Behörighet, firmateckning och interna attestregler behöver modelleras uttryckligen utifrån användningsfallet.

Fortsätt läsa

Lås upp resten av guiden.

Lämna din mejl så låser vi upp hela guiden direkt och skickar PDF-versionen till din inkorg. Om du vill kan vi också följa upp med sådant som är relevant för svensk företagsdata, BankID och signering.

Ditt intresse märks upp somDigital B2B-onboardingBolagsAPI · Auth by Hugo · Avtalsklart

03 · Byggblocken

Tre tjänster med var sitt ansvar.

Företagsdata

BolagsAPI

Sök, grunddata, status, adresser, roller och annan svensk bolagsinformation via REST eller MCP.

bolagsapi.se ↗

Identitet

Auth by Hugo

BankID-baserad identifiering och OIDC-inloggning i ett driftat flöde som kan anpassas till tjänsten.

auth.byhugo.se ↗

Signering

Avtalsklart

Förbered dokument, bjud in mottagare, följ status och samla verifierbara signaturer med BankID.

avtalsklart.se ↗

04 · Arkitektur

Låt den egna produkten vara orkestrerare.

Er applikation bör äga kundresan, den interna statusen och kopplingen mellan bolag, användare och avtal. Leverantörerna äger sina respektive specialistfunktioner. Det gör flödet enklare att testa och möjligt att återuppta efter avbrott.

Lager	Ansvar	Spara internt	Undvik
BolagsAPI	Aktuell företagsinformation	Organisationsnummer, vald snapshot och källtid	Att kopiera hela registret utan behov
Auth	Identifiering och säker session	Internt användar-id och nödvändiga identitetsreferenser	Att använda personnummer som publik nyckel
Er produkt	Behörighet, onboardingstatus och affärsregler	Relationen användare–bolag och tillståndsmaskinen	Att härleda behörighet från inloggning ensam
Avtalsklart	Dokument, mottagare och signeringsbevis	Avtals-id, version, status och tidsstämplar	Att aktivera innan signerad webhook verifierats

Bygg onboarding som en tillståndsmaskin

Använd tydliga tillstånd som bolag valt, identitet klar, avtal skickat, avtal signerat och konto aktivt. Då kan kunden fortsätta där den slutade, supporten se vad som saknas och webhookar behandlas idempotent.

05 · Införande

Börja med den smalaste fungerande kundresan.

Definiera bevisen. Bestäm vilka uppgifter som måste vara kända om bolaget, personen och avtalet innan ett konto får aktiveras.
Bygg ett lyckat huvudflöde. Ett bolag, en administratör, ett avtal och en behörighetsnivå räcker för första versionen.
Lägg till återhämtning. Hantera avbruten BankID-session, dubbletter, försenade webhookar och avtal som inte signeras.
Öppna för fler roller. Först när huvudflödet fungerar bör ni lägga till inbjudningar, flera administratörer och avancerad attest.

Mät flödet, inte bara felen.

Följ tid till valt bolag, lyckad identifiering, skickat avtal och aktiverat konto. Då ser ni exakt var onboarding tappar fart.

06 · Säkerhet och kontroll

Fyra detaljer som avgör om lösningen håller.

Minimera persondata. Spara bara det som behövs för konto, avtal och lagkrav. Använd interna identifierare i resten av systemet.
Verifiera inkommande händelser. Webhookar ska autentiseras, tidsstämplas och kunna behandlas flera gånger utan dubbel effekt.
Versionssätt avtal. Spara exakt vilken dokumentversion och vilka villkor som godkändes.
Logga beslut. En revisionslogg ska visa när bolag valdes, identitet bekräftades, behörighet gavs och konto aktiverades.

07 · Checklista

Redo att gå från skiss till implementation?

Organisationsnummer är primär nyckel för företaget.

Identitet och behörighet är två separata beslut.

Onboarding har explicita, återupptagbara tillstånd.

Alla webhookar är verifierade och idempotenta.

Avtalets version och signeringsstatus sparas.

Supporten kan se var kunden befinner sig.

Persondata minimeras och har gallringsregler.

Aktivering sker först efter kontrollerad sluthändelse.