Beskrivning

Hämta bolagengagemang för en privatperson från Bolagsverket.

I steg två skall tjänsten byggas ut mot Bolagsverkets Mina Ombud.

I ett första steg anropar vi Bolagsverkets engagemang-tjänst för att hämta vilka bolagsengagemang en privatperson har.

Då alla anrop mot bolagsverket innebär en kostnad, cachas alla svar från bolagsverket i 30 minuter.

Livscykelstatus

Design

Lösningsbeskrivning

Hantering av personuppgifter

API specifikation

Alla anrop mot bolagsverket har två tvingande parametrar vilket även är tvingande in i detta API förutom partyId:

1. serviceName - Det system som anropet initierades ifrån.

2. personalName - Namnet på den person som företagen skall hämtas för.

Hämta företagsengagemang (/engagements)

Request: /engagements/6a5c3d04-412d-11ec-973a-0242ac130003?personalName=Jane%20Doe&serviceName=Kommunen

{
	"partyId": "6a5c3d04-412d-11ec-973a-0242ac130003",
	"personalName": "Jane Doe",
	"serviceName": "Kommunen"
}

Response:

{
    "engagements": [
        {
            "organizationName": "Fritjofs blommor och blad",
            "organizationNumber": "5561234567",
            "organizationId": " 793afd03-3be5-4e14-863f-a61d4859841d"
        },
        {
            "organizationName": "Vanja Jumpers plåt",
            "organizationNumber": "5561234568",
            "organizationId": "85da333a-abe7-4088-8224-5714e85c5f7d"
        }
    ]
    "statusDescriptions": null,
    "status": "OK"
}

Förtydligande response-parametrar:

• engagements: Kan innehålla 0 → n antal engagemang personen har, varje objekt innehåller organisationsnamn och organisationsnummer.

  • organizationId; OBS WIP! Ej implementerad ännu: Kommer vara ett random-genererat UUID tills dess att integrationen mot tjänsten “Organization” blir implementerad.

• statusDescriptions: Innehåller eventuella fel från bolagsverket, men där vi fått ett svar vi kan hantera. T.ex. kan det vara att underliggande system överskred begärd svarstid. Typen är en “Map<String, String>”.

• status: Visar om personens alla engagemang kunde hämtas utan fel. Vid eventuella fel sätts denna till “NOK” och det reflekteras även i parametern statusDescriptions genom att varje felbeskrivning läggs till.

Testdata

Bolagsverket har lagt upp fiktiva personnummer med olika bolagsengagemang, partyId för dessa personer finns upplagda i testmiljön för CitizenMapping och mappar till följande dokument.