API for electronic annual reports

Inlamning

inlamning

Submit an annual report to the separate space belonging to the user for review and electronic signing

The service checks that the electronic annual report is well-formed and stores it in the separate space belonging to the user. If the document passes inspection and the flag mobiltbankid is false, no further action is needed from the client (the annual report should be signed later using the web page). If the document passes inspection and the flag mobiltbankid is set to true, a transaction for direct electronic signing is created and the annual report is received after signing has completed. Please note that in this case the API call returns a code 202 immediately (before the annual report has beed signed). The calling software should poll the /inlamning-status operation to ensure that signing is successful.


/inlamning/{inlamningtoken}

Usage and SDK Samples

curl -X post "https://api.bolagsverket.se/lamna-in-arsredovisning/v1.2/inlamning/{inlamningtoken}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.InlamningApi;

import java.io.File;
import java.util.*;

public class InlamningApiExample {

    public static void main(String[] args) {
        
        InlamningApi apiInstance = new InlamningApi();
        UUID inlamningtoken = inlamningtoken_example; // UUID | Token for submission
        InlamningAnrop anropsobjekt = ; // InlamningAnrop | Other information and the annual report
        try {
            InlamningOK result = apiInstance.inlamning(inlamningtoken, anropsobjekt);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling InlamningApi#inlamning");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.InlamningApi;

public class InlamningApiExample {

    public static void main(String[] args) {
        InlamningApi apiInstance = new InlamningApi();
        UUID inlamningtoken = inlamningtoken_example; // UUID | Token for submission
        InlamningAnrop anropsobjekt = ; // InlamningAnrop | Other information and the annual report
        try {
            InlamningOK result = apiInstance.inlamning(inlamningtoken, anropsobjekt);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling InlamningApi#inlamning");
            e.printStackTrace();
        }
    }
}
UUID *inlamningtoken = inlamningtoken_example; // Token for submission
InlamningAnrop *anropsobjekt = ; // Other information and the annual report

InlamningApi *apiInstance = [[InlamningApi alloc] init];

// Submit an annual report to the separate space belonging to the user for review and electronic signing
[apiInstance inlamningWith:inlamningtoken
    anropsobjekt:anropsobjekt
              completionHandler: ^(InlamningOK output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var ApiForElectronicAnnualReports = require('api_for_electronic_annual_reports');

var api = new ApiForElectronicAnnualReports.InlamningApi()

var inlamningtoken = inlamningtoken_example; // {UUID} Token for submission

var anropsobjekt = ; // {InlamningAnrop} Other information and the annual report


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.inlamning(inlamningtoken, anropsobjekt, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class inlamningExample
    {
        public void main()
        {
            
            var apiInstance = new InlamningApi();
            var inlamningtoken = inlamningtoken_example;  // UUID | Token for submission
            var anropsobjekt = new InlamningAnrop(); // InlamningAnrop | Other information and the annual report

            try
            {
                // Submit an annual report to the separate space belonging to the user for review and electronic signing
                InlamningOK result = apiInstance.inlamning(inlamningtoken, anropsobjekt);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling InlamningApi.inlamning: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\Api\InlamningApi();
$inlamningtoken = inlamningtoken_example; // UUID | Token for submission
$anropsobjekt = ; // InlamningAnrop | Other information and the annual report

try {
    $result = $api_instance->inlamning($inlamningtoken, $anropsobjekt);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling InlamningApi->inlamning: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::InlamningApi;

my $api_instance = WWW::SwaggerClient::InlamningApi->new();
my $inlamningtoken = inlamningtoken_example; # UUID | Token for submission
my $anropsobjekt = WWW::SwaggerClient::Object::InlamningAnrop->new(); # InlamningAnrop | Other information and the annual report

eval { 
    my $result = $api_instance->inlamning(inlamningtoken => $inlamningtoken, anropsobjekt => $anropsobjekt);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling InlamningApi->inlamning: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.InlamningApi()
inlamningtoken = inlamningtoken_example # UUID | Token for submission
anropsobjekt =  # InlamningAnrop | Other information and the annual report

try: 
    # Submit an annual report to the separate space belonging to the user for review and electronic signing
    api_response = api_instance.inlamning(inlamningtoken, anropsobjekt)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling InlamningApi->inlamning: %s\n" % e)

Parameters

Path parameters
Name Description
inlamningtoken*
Body parameters
Name Description
anropsobjekt *

Responses

Status: 200 - Annual report is submitted to separate space for later signature via web.

Status: 202 - The annual report has been submitted to a separate space and a signing transaction has been created. The software should call /inlamning-status to ensure that signing is successful and that the annual report has been received.

Status: 400 - Bad request

Status: 403 - Unauthorized user of service

Status: 404 - Organisation number missing

Status: 500 - Unspecified technical problem

Status: 503 - The service is temporarily unavailable

Status: 504 - Timeout

inlamningStatus

Retrieve the current submission status after submission with direct signing

The service returns actual processing status for an annual report that has been marked for direct signing. Poll this service repeatedly while it returns status code underskrift_pagaende (wait for a few seconds between calls to avoid overload) . When status code arsredovisning_mottagen is returned, the annual report has been received. In this case the reponse will contain a receipt number and a timestamp.


/inlamning-status/{underskrifttoken}

Usage and SDK Samples

curl -X get "https://api.bolagsverket.se/lamna-in-arsredovisning/v1.2/inlamning-status/{underskrifttoken}"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.InlamningApi;

import java.io.File;
import java.util.*;

public class InlamningApiExample {

    public static void main(String[] args) {
        
        InlamningApi apiInstance = new InlamningApi();
        UUID underskrifttoken = underskrifttoken_example; // UUID | Signature token from submission to separate space
        try {
            Inlamningstatus result = apiInstance.inlamningStatus(underskrifttoken);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling InlamningApi#inlamningStatus");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.InlamningApi;

public class InlamningApiExample {

    public static void main(String[] args) {
        InlamningApi apiInstance = new InlamningApi();
        UUID underskrifttoken = underskrifttoken_example; // UUID | Signature token from submission to separate space
        try {
            Inlamningstatus result = apiInstance.inlamningStatus(underskrifttoken);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling InlamningApi#inlamningStatus");
            e.printStackTrace();
        }
    }
}
UUID *underskrifttoken = underskrifttoken_example; // Signature token from submission to separate space

InlamningApi *apiInstance = [[InlamningApi alloc] init];

// Retrieve the current submission status after submission with direct signing
[apiInstance inlamningStatusWith:underskrifttoken
              completionHandler: ^(Inlamningstatus output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var ApiForElectronicAnnualReports = require('api_for_electronic_annual_reports');

var api = new ApiForElectronicAnnualReports.InlamningApi()

var underskrifttoken = underskrifttoken_example; // {UUID} Signature token from submission to separate space


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.inlamningStatus(underskrifttoken, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class inlamningStatusExample
    {
        public void main()
        {
            
            var apiInstance = new InlamningApi();
            var underskrifttoken = underskrifttoken_example;  // UUID | Signature token from submission to separate space

            try
            {
                // Retrieve the current submission status after submission with direct signing
                Inlamningstatus result = apiInstance.inlamningStatus(underskrifttoken);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling InlamningApi.inlamningStatus: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\Api\InlamningApi();
$underskrifttoken = underskrifttoken_example; // UUID | Signature token from submission to separate space

try {
    $result = $api_instance->inlamningStatus($underskrifttoken);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling InlamningApi->inlamningStatus: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::InlamningApi;

my $api_instance = WWW::SwaggerClient::InlamningApi->new();
my $underskrifttoken = underskrifttoken_example; # UUID | Signature token from submission to separate space

eval { 
    my $result = $api_instance->inlamningStatus(underskrifttoken => $underskrifttoken);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling InlamningApi->inlamningStatus: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.InlamningApi()
underskrifttoken = underskrifttoken_example # UUID | Signature token from submission to separate space

try: 
    # Retrieve the current submission status after submission with direct signing
    api_response = api_instance.inlamningStatus(underskrifttoken)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling InlamningApi->inlamningStatus: %s\n" % e)

Parameters

Path parameters
Name Description
underskrifttoken*

Responses

Status: 200 - Current submission status

Status: 400 - Bad request

Status: 403 - Unauthorized user of service

Status: 404 - Missing signature token

Status: 500 - Unspecified technical problem

Status: 503 - The service is temporarily unavailable

Status: 504 - Timeout

skapaInlamningtoken

Create token for submission till eget utrymme

The service creates the token for use when submitting an annual report.


/skapa-inlamningtoken

Usage and SDK Samples

curl -X post "https://api.bolagsverket.se/lamna-in-arsredovisning/v1.2/skapa-inlamningtoken"
import io.swagger.client.*;
import io.swagger.client.auth.*;
import io.swagger.client.model.*;
import io.swagger.client.api.InlamningApi;

import java.io.File;
import java.util.*;

public class InlamningApiExample {

    public static void main(String[] args) {
        
        InlamningApi apiInstance = new InlamningApi();
        SkapaInlamningTokenAnrop anropsobjekt = ; // SkapaInlamningTokenAnrop | Personal identification number and organization number
        try {
            SkapaTokenOK result = apiInstance.skapaInlamningtoken(anropsobjekt);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling InlamningApi#skapaInlamningtoken");
            e.printStackTrace();
        }
    }
}
import io.swagger.client.api.InlamningApi;

public class InlamningApiExample {

    public static void main(String[] args) {
        InlamningApi apiInstance = new InlamningApi();
        SkapaInlamningTokenAnrop anropsobjekt = ; // SkapaInlamningTokenAnrop | Personal identification number and organization number
        try {
            SkapaTokenOK result = apiInstance.skapaInlamningtoken(anropsobjekt);
            System.out.println(result);
        } catch (ApiException e) {
            System.err.println("Exception when calling InlamningApi#skapaInlamningtoken");
            e.printStackTrace();
        }
    }
}
SkapaInlamningTokenAnrop *anropsobjekt = ; // Personal identification number and organization number

InlamningApi *apiInstance = [[InlamningApi alloc] init];

// Create token for submission till eget utrymme
[apiInstance skapaInlamningtokenWith:anropsobjekt
              completionHandler: ^(SkapaTokenOK output, NSError* error) {
                            if (output) {
                                NSLog(@"%@", output);
                            }
                            if (error) {
                                NSLog(@"Error: %@", error);
                            }
                        }];

var ApiForElectronicAnnualReports = require('api_for_electronic_annual_reports');

var api = new ApiForElectronicAnnualReports.InlamningApi()

var anropsobjekt = ; // {SkapaInlamningTokenAnrop} Personal identification number and organization number


var callback = function(error, data, response) {
  if (error) {
    console.error(error);
  } else {
    console.log('API called successfully. Returned data: ' + data);
  }
};
api.skapaInlamningtoken(anropsobjekt, callback);

using System;
using System.Diagnostics;
using IO.Swagger.Api;
using IO.Swagger.Client;
using IO.Swagger.Model;

namespace Example
{
    public class skapaInlamningtokenExample
    {
        public void main()
        {
            
            var apiInstance = new InlamningApi();
            var anropsobjekt = new SkapaInlamningTokenAnrop(); // SkapaInlamningTokenAnrop | Personal identification number and organization number

            try
            {
                // Create token for submission till eget utrymme
                SkapaTokenOK result = apiInstance.skapaInlamningtoken(anropsobjekt);
                Debug.WriteLine(result);
            }
            catch (Exception e)
            {
                Debug.Print("Exception when calling InlamningApi.skapaInlamningtoken: " + e.Message );
            }
        }
    }
}
<?php
require_once(__DIR__ . '/vendor/autoload.php');

$api_instance = new Swagger\Client\Api\InlamningApi();
$anropsobjekt = ; // SkapaInlamningTokenAnrop | Personal identification number and organization number

try {
    $result = $api_instance->skapaInlamningtoken($anropsobjekt);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling InlamningApi->skapaInlamningtoken: ', $e->getMessage(), PHP_EOL;
}
?>
use Data::Dumper;
use WWW::SwaggerClient::Configuration;
use WWW::SwaggerClient::InlamningApi;

my $api_instance = WWW::SwaggerClient::InlamningApi->new();
my $anropsobjekt = WWW::SwaggerClient::Object::SkapaInlamningTokenAnrop->new(); # SkapaInlamningTokenAnrop | Personal identification number and organization number

eval { 
    my $result = $api_instance->skapaInlamningtoken(anropsobjekt => $anropsobjekt);
    print Dumper($result);
};
if ($@) {
    warn "Exception when calling InlamningApi->skapaInlamningtoken: $@\n";
}
from __future__ import print_statement
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint

# create an instance of the API class
api_instance = swagger_client.InlamningApi()
anropsobjekt =  # SkapaInlamningTokenAnrop | Personal identification number and organization number

try: 
    # Create token for submission till eget utrymme
    api_response = api_instance.skapaInlamningtoken(anropsobjekt)
    pprint(api_response)
except ApiException as e:
    print("Exception when calling InlamningApi->skapaInlamningtoken: %s\n" % e)

Parameters

Body parameters
Name Description
anropsobjekt *

Responses

Status: 200 - Tasks received

Status: 400 - Bad request

Status: 403 - Unauthorized user of service

Status: 404 - Personal identification number is missing

Status: 500 - Unspecified technical problem

Status: 503 - The service is temporarily unavailable

Status: 504 - Timeout

Generated 2019-01-14T20:58:21.383+01:00