tripletex-go

Go API client for Tripletex. It's generated with oapi-codegen

Prerequisites

1. consumerToken
2. employeeToken

Usage

go get github.com/valuetechdev/tripletex-go

import "github.com/valuetechdev/tripletex-go"

func yourFunc() error {
	client := New(tripletex.Credentials{
		ConsumerToken: "your-token",
		EmployeeToken: "your-token",
	})

  // Authenticate
  if err := client.CheckAuth(); err != nil {
    return fmt.Errorf("auth failed: %w", err)
  }

	customersRes, err := client.CustomerSearchWithResponse(context.Background(), &tripletex.CustomerSearchParams{})
  if err != nil {
    return fmt.Errorf("failed to search for customers: %w", err)
  }

  // Do something with customersRes

  return nil
}

Things to know

• Tripletex's OpenAPI specification is valid, but not error-free.
  • There are duplicate types (eg. LeaveOfAbsenceType).
  • No endpoint specifies what the returning content-type is.
  • Emails can returned as empty strings ("").
• We convert the original Tripletex API from Swagger 2.0 to OpenAPI 3 with Swagger's official tooling.