Dialect.VismaNetCore 0.4.0-alpha.168

Visma.Net Core

This is an API wrapper written in C# for dotnet core to enable simplified use of the Visma.NET API, both version 2 and version 3. With support for Dependency Injection for smarter use for hosted services

This README is a work in progress and information might be incomplete or outdated.

Usage/Examples

Simplified examples of usage.

Dependency Injection

Console Application

using VismaNetCore;

var services = new ServiceCollection();
services.AddVismaNetClient(vismaNetOptions => {
    vismaNetOptions.GrantType = "client_credentials";
    vismaNetOptions.ClientId = "client_id";
    vismaNetOptions.ClientSecret = "client_secret";
    vismaNetOptions.TenantId = "tenant_id";
    vismaNetOptions.Scopes =
    [
        Scope.ErpServiceCreate,
		Scope.ErpServiceDelete,
		Scope.ErpServiceRead,
		Scope.ErpServiceUpdate,
		Scope.SalesOrderRead,
		Scope.SalesOrderWrite
    ];
})
services.AddSingleton<ImplementingClass>();

var serviceProvider = services.BuildServiceProvider();
var testClient = servicesProvider.GetRequiredService<ImplementingClass>();

await testClient.Test();

public class ImplementingClass
{
	private readonly VismaNetClient _vismaNetClient;

	public ImplementingClass(VismaNetClient vismaNetClient)
	{
		_vismaNetClient = vismaNetClient;
	}

	public async Task Test()
	{
		await _vismaNetClient.RefreshToken();
		var inventoryParameters = new Dictionary<string, string>
		{
			{ "pageSize", "10" }
		};
		var inventory = await _vismaNetClient.InventoryV3.GetInventoryAsync(inventoryParameters);
	}
}

Web Application

Program.cs

using VismaNetCore;
using VismaNetCore.Models.Enums;

var builder = WebApplication.CreateBuilder(args);
// You can also load from appsettings if you fetch that first
builder.Services.AddVismaNetClient(vismaNetOptions => {
    vismaNetOptions.GrantType = "client_credentials";
    vismaNetOptions.ClientId = "client_id";
    vismaNetOptions.ClientSecret = "client_secret";
    vismaNetOptions.TenantId = "tenant_id";
    vismaNetOptions.Scopes =
    [
        Scope.ErpServiceCreate,
		Scope.ErpServiceDelete,
		Scope.ErpServiceRead,
		Scope.ErpServiceUpdate,
		Scope.SalesOrderRead,
		Scope.SalesOrderWrite
    ];
})

WebApplication app = builder.Build();

app.Run();

Endpoints/Inventory/Get.cs

public class Get
{
	private readonly VismaNetClient _vismaNetClient;

	public Get(VismaNetClient vismaNetClient)
	{
		_vismaNetClient = vismaNetClient;
	}

	public void MapEndpoint(IEndpointRouteBuilder app)
	{
		app.MapPost("invoices", async (
			CreateInvoiceRequest request,
			CancellationToken cancellationToken) =>
		{
			// Get or Refresh the token
			await _vismaNetClient.RefreshToken();

			var inventory = await _vismaNetClient.InventoryV3.GetInventoryAsync();

			return Results.Ok(inventory);
		})
		.WithTags("Inventory");
	}
}

Contributing

Contributions are always welcome!

See CONTRIBUTE.md for ways to get started.

Please adhere to this project's contribution guidelines.