Beskrivning

Master-data för företag.

Första versionen hanterar endast mappning organisationsnummer/organizationId.

Begreppet “Organisation” Organization (eng) används i Metakatalogen för att beskriva vårt organisationsträd/organisationsstruktur.

För att hanterar företag/föreningar/enskilda firmor mm så har vi valt att kalla detta för “Legal Entity”.

Nyckel är LegalEntityId (guid). Det begrepp/idnummer som hos bolagsverket heter Organisationsnummer kallas här för OrganizationNumber (och inte för LegalEntityNumber)

Ändringar gäller från mitten av juni 2024(TBD)

LegalEntity uppdateras med att hämta data från SSBTGO (Sammansatta bastjänsten för grunddata om organisationer), som använder SCB, Bolagsverket och Skatteverket som källa för information. Informationen hämtas för direkt återanvändning för verksamhetssystem, men på grund av juridiska skäl kommer inte data från Skatteverket att vara tillgänglig, endast data från SCB och Bolagsverket. 

Det finns en möjlighet att utöka API:et för att hämta information även från Skatteverket om behov uppstår. I sådana fall är det endast "en ansluten datakonsuments e-tjänster – å en användares vägnar – som får begära ut information."

I tidigare versioner av LegalEntity var det inte obligatoriskt att ha en faktisk juridisk organisation bakom sig, utan ett LegalEntityId skapades så länge det fanns ett godtagbart organisationsnummer. Nu kommer ett LegalEntityId endast skapas om organisationsnumret finns registrerat hos SCB eller Bolagsverket.

Endpoints

../{organizationNumber}/guid
Beskrivning: Används för att få ett LegalEntityId för en organisation.
Svar:
Returnerar kopplat ID om organisationen redan finns.
Om organisationen inte finns kontrolleras organisationsnumret med Bolagsverket och ett nytt ID skapas om organisationen existerar.
Returnerar felmeddelande (404) om organisationen inte existerar.
Enkel validering av organisationsnumret. Returnerar felmeddelande (400) om numret inte följer standard för organisationsnummer.

../{legalEntityId}/organizationnumber
Beskrivning: Returnerar kopplat organisationsnummer för ett givet LegalEntityId.
Svar:
Returnerar organisationsnummer om ID är korrekt.
Returnerar felmeddelande (404) om ID är felaktigt.

../{legalEntityId}
Beskrivning: Returnerar all tillgänglig information om en organisation baserat på LegalEntityId.
Svar:
Returnerar all tillgänglig information som har hämtats om organisationen.

Livscykelstatus

v1.0 är publicerad
Ändringar från 11 juni 2024 → Hämtar data från SSBTGO

Lösningsbeskrivning

Hantering av personuppgifter

Organisationsnummer för enskilda företagare är ägarens personnummer .

API specifikation

Säkerhetsklassning

Säkerhetsklass 1

Autentiseringsmetod: Oauth2

Teknisk ägare

https://sundsvall.atlassian.net/wiki/spaces/META

För tekniska frågor: 

teamevolution@sundsvall.se

FAQ

<FAQ>