Tripletex SDK

.NET 9 SDK and CLI for the Tripletex API v2 (Norwegian accounting/ERP).

CLI

A standalone command-line tool for common Tripletex tasks like logging hours.

Install

Download the latest binary for your platform from GitHub Releases:

Platform	File
macOS (Apple Silicon)	tripletex-osx-arm64.tar.gz
macOS (Intel)	tripletex-osx-x64.tar.gz
Linux (x64)	tripletex-linux-x64.tar.gz
Linux (arm64)	tripletex-linux-arm64.tar.gz
Windows (x64)	tripletex-win-x64.zip

# macOS / Linux
tar -xzf tripletex-osx-arm64.tar.gz
sudo mv tripletex /usr/local/bin/

Setup

tripletex config set --consumer-token YOUR_TOKEN --employee-token YOUR_TOKEN

Usage

# Log hours (interactive wizard)
tripletex timesheet log

# Log hours directly
tripletex timesheet log 7.5 --date 2026-03-05 --comment "Feature work"

# Log a full week (Mon-Fri)
tripletex timesheet log-week 2026-03-02 7.5 7.5 7.5 7.5 7.5

# List entries
tripletex timesheet list --from-date 2026-03-01 --to-date 2026-03-31

# Show recent entries
tripletex timesheet recent

# View/clear saved defaults
tripletex config show
tripletex config unset --all

Claude Code Skill

A Claude Code skill is included at .claude/commands/tripletex.md. It lets Claude use the CLI on your behalf via natural language:

/tripletex log 7.5 hours today
/tripletex show my recent timesheet entries
/tripletex search for projects matching "Website"

The skill is also installed globally if you copy it to ~/.claude/commands/.

---

SDK (NuGet library)

Installation

dotnet add package Tripletex.Api

Quick start

using Tripletex.Api;

var client = new TripletexClient(new TripletexOptions
{
    ConsumerToken = "your-consumer-token",
    EmployeeToken = "your-employee-token",
    Environment = TripletexEnvironment.Test, // or Production
});

Timesheet — log hours

// Log 7.5 hours to a project/activity
var entry = await client.Timesheet.LogHoursAsync(
    activityId: 1234,
    projectId: 5678,
    date: new DateOnly(2026, 3, 5),
    hours: 7.5m,
    comment: "Feature development"
);

// Fill a whole week (Mon-Fri, 7.5h each)
var week = await client.Timesheet.LogWeekAsync(
    activityId: 1234,
    projectId: 5678,
    weekStart: new DateOnly(2026, 3, 2),
    hoursPerDay: [7.5m, 7.5m, 7.5m, 7.5m, 7.5m, 0, 0]
);

Timesheet — query entries

// Search with filters
var results = await client.Timesheet.SearchAsync(new TimesheetSearchOptions
{
    EmployeeId = 42,
    DateFrom = new DateOnly(2026, 3, 1),
    DateTo = new DateOnly(2026, 3, 31),
});

// Auto-paginate all results as IAsyncEnumerable
await foreach (var entry in client.Timesheet.ListAsync(new TimesheetSearchOptions
{
    ProjectId = 5678,
    DateFrom = new DateOnly(2026, 1, 1),
}))
{
    Console.WriteLine($"{entry.Date}: {entry.Hours}h - {entry.Comment}");
}

// Total hours for a period
var totals = await client.Timesheet.GetTotalHoursAsync(
    employeeId: 42,
    dateFrom: new DateOnly(2026, 3, 1),
    dateTo: new DateOnly(2026, 3, 31)
);

Timesheet — approve/manage

await client.Timesheet.ApproveMonthAsync(employeeId: 42, monthYear: "2026-03");
await client.Timesheet.UnapproveMonthAsync(employeeId: 42, monthYear: "2026-03");

Other resources

var employees = await client.Employee.SearchAsync(lastName: "Hansen");
var projects = await client.Project.SearchAsync(name: "Website");
var invoice = await client.Invoice.GetAsync(123);
var customers = await client.Customer.SearchAsync(name: "Acme");

Dependency injection (ASP.NET Core)

builder.Services.AddTripletex(options =>
{
    options.ConsumerToken = builder.Configuration["Tripletex:ConsumerToken"]!;
    options.EmployeeToken = builder.Configuration["Tripletex:EmployeeToken"]!;
    options.Environment = TripletexEnvironment.Production;
});

Then inject TripletexClient wherever needed.

Features

• Session token management — auto-creates and refreshes tokens
• Rate limit handling — auto-retries on 429 with backoff
• Auto-pagination — IAsyncEnumerable<T> over all list endpoints
• Field selection — typed builder for the fields query param
• Error handling — Tripletex errors deserialized into TripletexApiException
• Path rewriting — handles Tripletex's :action and >summary URL conventions

Configuration

Option	Default	Description
ConsumerToken	required	Your Tripletex consumer token
EmployeeToken	required	Your Tripletex employee token
Environment	Production	Production or Test
SessionLifetime	24 hours	How long session tokens last
MaxRetries	3	Max retries on rate limit (429)
RetryBaseDelay	1 second	Base delay for exponential backoff

License

PolyForm Noncommercial 1.0.0