SwedishIdentityNumbers

A .NET library for working with Swedish identity numbers.

Overview

The SwedishIdentityNumbers library provides a set of classes for working with Swedish identity numbers:

• Personnummer for personal identity numbers
• Samordningsnummer for coordination numbers
• Organisationsnummer for organization numbers

Each of these classes inherits from the abstract base class SwedishIdentityNumber, which provides common functionality for validating and working with identity numbers.

Installation

Install SwedishIdentityNumbers via NuGet:

dotnet add package SwedishIdentityNumbers

Or search for SwedishIdentityNumbers in the NuGet package manager in Visual Studio.

Usage

Create a Personnummer

using SwedishIdentityNumbers;

var personnummer = new Personnummer("8507301234"); // also allows 850730-1234
// throws 
// ArgumentNullException if null
// ArgumentException if empty
// FormatException if not of the correct format
// ValidationException if the check digit is wrong

Get the Date of Birth (a DateOnly) from a Personnummer

var dateOfBirth = personnummer.DateOfBirth;

Get the Legal Sex (an enum Male/Female) from a Personnummer

var legalSex = personnummer.LegalSex;

Try to create a Personnummer

using SwedishIdentityNumbers;

if (Personnummer.TryCreate("8507301234", out var personnummer)) // also allows 850730-1234
{
    // Successfully created
}

Create a Samordningsnummer

using SwedishIdentityNumbers;

var samordningsnummer = new Samordningsnummer("8507901234"); // also allows 850790-1234
// throws 
// ArgumentNullException if null
// ArgumentException if empty
// FormatException if not of the correct format
// ValidationException if the check digit is wrong

Get the Date of Birth (a DateOnly) from a Samordningsnummer

var dateOfBirth = samordningsnummer.DateOfBirth;

Get the Legal Sex (an enum Male/Female) from a Samordningsnummer

var legalSex = samordningsnummer.LegalSex;

Working with Organisationsnummer

using SwedishIdentityNumbers;

var organisationsnummer = new Organisationsnummer("5560360793"); // also allows 165560360793 and 556036-0793
// throws 
// ArgumentNullException if null
// ArgumentException if empty
// FormatException if not of the correct format
// ValidationException if the check digit is wrong

Determine the Probable Swedish Company Form

var companyForm = organisationsnummer.ProbableSwedishCompanyForm;

Swedish Company Forms

The library includes a SwedishCompanyForm enum, representing different forms of companies in Sweden. This enum is used in conjunction with the Organisationsnummer class to identify the probable form of a company based on its organization number. The different enum values represent various types of company forms, ranging from Joint Stock Companies to Government Agencies. The implementation and enum values are based on information from Bolagsverket.

public enum SwedishCompanyForm
{
    JointStockCompany,  // Aktiebolag, filialer, banker, försäkringsbolag och europabolag
    GeneralPartnership, // Handelsbolag och kommanditbolag
    HousingCooperative, // Bostadsrättsföreningar, ekonomiska föreningar, etc.
    ReligiousCommunity, // Trossamfund
    GovernmentAgency,   // Statlig myndighet
    Unknown             // Okänd
}

Development

To work on SwedishIdentityNumbers, clone the repo and open SwedishIdentityNumbers.sln in Visual Studio or your preferred editor.

Testing

Run the tests in SwedishIdentityNumbers.Tests to ensure everything is working correctly.

License

SwedishIdentityNumbers is licensed under the MIT License. See the LICENSE file for details.