https://github.com/onify/blueprint-bolagsverket-get-ssbten

Onify Blueprint: Get SSBTEN data from Bolagsverket
https://github.com/onify/blueprint-bolagsverket-get-ssbten

bolagsverket flow onify onify-blueprint onify-blueprints soap soap-web-services

Last synced: about 5 hours ago
JSON representation

Onify Blueprint: Get SSBTEN data from Bolagsverket

• Host: GitHub
• URL: https://github.com/onify/blueprint-bolagsverket-get-ssbten
• Owner: onify
• License: mit
• Created: 2023-11-20T10:32:42.000Z (12 months ago)
• Default Branch: main
• Last Pushed: 2023-11-20T10:59:29.000Z (12 months ago)
• Last Synced: 2023-11-23T12:26:32.391Z (12 months ago)
• Topics: bolagsverket, flow, onify, onify-blueprint, onify-blueprints, soap, soap-web-services
• Language: JavaScript
• Homepage: https://onify.co
• Size: 174 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![Onify Blueprints](https://files.readme.io/8ba3f14-onify-blueprints-logo.png)

[![Project Status: WIP – Initial development is in progress, but there has not yet been a stable, usable release suitable for the public.](https://www.repostatus.org/badges/latest/wip.svg)](https://www.repostatus.org/#wip)

![Test suite](https://github.com/onify/blueprint-bolagsverket-get-ssbten/workflows/Test%20suite/badge.svg)

# Onify Blueprint: Get orgdata from Bolagsverket (SSBT)

Bolagsverket's [SSBT (Sammansatt bastjänst) service](https://bolagsverket.se/omoss/utvecklingavdigitalatjanster/densammansattabastjanstenforgrundlaggandeuppgifteromforetag/saharfungerardensammansattabastjansten.2229.html) was created with the aim to streamline companies reporting to the government and reducing their administrative burden. SSBT delivers consolidated company information based on source data from Bolagsverket, Skatteverket, and SCB.

> Note: SSBT is an information service only for public actors based in Sweden, that is to say, authorities, municipalities, and regions. 

This blueprint primarily demonstrates how to retrieve a specified persons business engagements via SSBTEN.

> Note: This has only been tested against SSBT testversion (SSBTEN) using Bolagsverket fixed test scenarios, see [connection guide (swedish)](https://bolagsverket.se/download/18.46f4138717c599ee403ab292/1688449960663/anslutningsanvisning-for-atkomst-till-ssbt.pdf) and [checklist (swedish)](https://bolagsverket.se/download/18.46f4138717c599ee403ab290/1638951612751/checklista-for-test-vid-anvandning-av-ssbt.pdf) for more information.

![Onify Blueprint: Get orgdata from Bolagsverket SSBT](blueprint.png "Blueprint")

## Requirements

These are the technical requirements.

* [Onify Hub](https://github.com/onify/install)

* [Onify Hub Functions](https://github.com/onify/hub-functions)

* [Camunda Modeler](https://camunda.com/download/modeler/)

* Certificate via TeliaSonera (root certificate)

* Firewall opening (external ip allowed by Bolagsverket in their firewall) 

## Setup

### Bolagsverket

As mentioned in the requirements, you need a certificate from TeliaSonera. Here is how you prepare the certificate for use against test service (SSBTEN).

**Download and prepare certificate for Onify**

Go to https://repository.trust.teliasonera.com/teliasonerarootcav1.cer and download the certificate.

Now when you have downloaded (replace `` below) the certificate you need to convert it to base64 format so it can be used as a setting in Onify. Here is how you do it with powershell:

```powershell

$cerContent = Get-Content -Path "path_to_teliasonerarootcav1.cer" -AsByteStream

$base64Content = [System.Convert]::ToBase64String($cerContent)

$pemContent = "-----BEGIN CERTIFICATE-----`n"

$pemContent += ($base64Content -split '(.{64})' | Where-Object { $_ }) -join "`n"

$pemContent += "`n-----END CERTIFICATE-----"

$certObject = [PSCustomObject]@{

    certificate = $pemContent

}

$jsonContent = $certObject | ConvertTo-Json

$jsonContent

```

> Note: Keep the json for for later...

### Onify

Add the following settings in Onify:

|Key|Value|Type|Tag|Role|

|---|-----|----|---|----|

|bolagsverket_ssbt_certificate_authority|`{certificate": "-----BEGIN CERTIFICATE-----\nMIIFODCCAyC.....}` (the json output from the powershell snippet above)|object|ssbt, bolagsverket|admin|

|bolagsverket_ssbten_url|`https://ssbtgu-accept2.bolagsverket.se/ssbten-dft-web/SsbtServicePorts/Test/SsbtEnTestService?wsdl` - URL to SSBTEN service|string|ssbt, bolagsverket|admin

> Note: Create settings via admin interface and add a leading `_` in key. This is required for flow to work.

## Test

1. Open the BPMN diagram in Camunda Modeler.

2. Deploy the BPMN diagram (click `Deploy current diagram` and follow the steps).

3. Run it (click `Start current diagram`).

## Support

* Community/forum: https://support.onify.co/discuss

* Documentation: https://support.onify.co/docs

* Support and SLA: https://support.onify.co/docs/get-support

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.