Tripletex.Api 1.0.11

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:

# 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

License

PolyForm Noncommercial 1.0.0