taxmaro

n8n community node for the Taxmaro HR and payroll API

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.1
Author: haybit

Available Nodes

Documentation generating…

Documentation

n8n-nodes-taxmaro

n8n community node for the Taxmaro HR and payroll API (v1).

The node covers all 63 resources / 213 operations of the Taxmaro OpenAPI specification: absence requests, time tracking, allowances, colleagues, companies, contracts, cost centers, master data (banks, countries, health insurances, …) and more.

Installation

In n8n open Settings → Community Nodes → Install and enter n8n-nodes-taxmaro.
See the n8n docs for details.

Credentials

The node offers two ways to sign in (parameter Authentication). Both use the API host https://app.taxmaro.com as Base URL, also if your Taxmaro instance has its own web address (for example https://payroll-….taxmaro.co). Those addresses serve the web interface and reject API logins with HTTP 405.

API Token (recommended)

Create a Taxmaro API Token API credential:

Field Description
Base URL https://app.taxmaro.com
API Token A token you create in the Taxmaro web interface under API-Token → Token generieren

The token is sent as Authorization: Bearer …. It works with accounts that use two-factor login or single sign-on, and it does not store your password in n8n.

Email & Password

Create a Taxmaro API credential:

Field Description
Base URL https://app.taxmaro.com (change it for other environments)
Email / Password Your Taxmaro login

The node logs in via POST /api/v1/users/sessions and sends the returned JWT as Authorization: Bearer …. The session token is refreshed automatically when it expires. Accounts with two-factor login or single sign-on cannot sign in this way; use an API token instead. Workflows created before the API token was added use this option.

Usage

Pick a Resource and an Operation. Resources that exist for several scopes (for example absence requests for a company or a colleague) offer one operation per scope, e.g. Get Many (Company).

  • Path IDs (company, colleague, record, …) are plain fields and accept expressions.
  • Create / Update operations take the JSON request body. It is prefilled with an example from the API documentation.
  • Get Many supports Return All (automatic pagination via page / per_page) or a Limit. Under Query Parameters you can set sorting, search and any filter the API offers (by_year, by_departments[], …); the available filters are listed in the operation description.
  • Export operations (CSV / XLSX) return the file as binary data.
  • Simplify (default on) flattens the JSON:API response into plain objects: id, all attributes and the IDs of related records.
  • Selected Colleague ID (Options) sets the selectedColleagueId header.

Development

npm install
npm run build
npm run lint
npm run dev      # starts n8n with the node loaded

nodes/Taxmaro/operations.generated.ts is generated from the OpenAPI spec:

npm run generate -- /path/to/openapi.json

Notes on the API spec

  • The spec documents "create salary type" under the path /unauthenticated; the node uses POST /companies/{company_id}/salary_types.
  • The spec does not state a server URL; https://app.taxmaro.com is the default in the credential.

License

MIT

Discussion